Why OpenCode problems show up
OpenCode is a terminal coding agent that brings its own provider configuration. Most failures come from configuration, not from the model. This page lists the problems developers search for and the fix for each.
Provider authentication failed
Symptom: the agent starts but every request returns 401 or an auth error.
Fix: confirm the base URL and the key format. If you point OpenCode at Fikra API, set the base URL to https://api.fikraapi.co.ke/v1 and use a Fikra key. A normal key keeps the usual API catalog; a Fikra Code key reaches the Fikra Code catalog.
Model not found or unsupported model
Symptom: a request fails with a model error.
Fix: use a model id from the live catalog at https://fikraapi.co.ke/code/models. Only model ids marked In API are currently callable. A typo or a planned model will fail.
Context window exceeded
Symptom: a long session errors or the agent truncates.
Fix: compact the session or start a new one. Keep the working set small. On a small model, avoid pasting large files.
Rate limit errors
Symptom: 429 responses under heavy use.
Fix: slow down, retry after the indicated delay, or move to a plan with higher limits. Fikra API publishes limits in the response headers.
TUI uses too much memory
Symptom: the terminal UI stutters or the machine swaps.
Fix: run in a lighter terminal, close other heavy apps, and prefer a terminal agent over an IDE agent on 4 to 8 GB machines.
MCP server fails
Symptom: an MCP tool is missing or errors.
Fix: check the MCP command path and environment. Run the MCP server manually first. If it fails outside the agent, the problem is the server, not the agent.
Shell or sandbox errors
Symptom: commands fail with permission errors.
Fix: check the approval and sandbox settings. If you trust the workspace, use a permissive profile for that folder only.
Slow or dropped connection
Symptom: streams stall or the install restarts.
Fix: use resumable installs and streaming. Retry instead of reinstalling. On Fikra Code, the installer resumes downloads.
Where Fikra helps
If your OpenCode problems come from provider setup, point it at Fikra API. The surface is OpenAI-compatible, the catalog is live, and the same key works in Fikra Code. Start at https://fikraapi.co.ke/code/docs.