Use NeverMetered with OpenCode
Open-source terminal agent with an OpenAI-compatible provider.
qwen3.8-27bYOUR_API_KEY with your key.- 1
Create an API key
Create a key in API keys and name it after the tool, for example “OpenCode”. A dedicated key per tool lets you see its usage separately and give it its own parallel-stream cap. The key is shown once; the snippets below use
YOUR_API_KEYwhere it goes. - 2
Install OpenCode
Already have OpenCode? Skip this step. Open a terminal first: on macOS press ⌘ Space, type Terminal and press Return; on Windows open the Start menu, type PowerShell and press Enter. On Windows this uses npm, which needs Node.js;
scoop install opencodeworks too.curl -fsSL https://opencode.ai/install | bash - 3
Add the provider
Save this as
opencode.jsonin your project, or merge it into~/.config/opencode/opencode.jsonto use it everywhere.opencode.json{ "$schema": "https://opencode.ai/config.json", "provider": { "nevermetered": { "npm": "@ai-sdk/openai-compatible", "name": "NeverMetered", "options": { "baseURL": "https://api.nevermetered.com/v1", "apiKey": "{env:NEVERMETERED_API_KEY}" }, "models": { "qwen3.8-27b": { "name": "qwen3.8-27b", "limit": { "context": 131072, "output": 65536 } } } } }, "model": "nevermetered/qwen3.8-27b" } - 4
Export your key and start OpenCode
export NEVERMETERED_API_KEY="YOUR_API_KEY" opencode - 5
Keep it for new terminals (optional)
The command above only lasts for the current terminal. Save it once so every new terminal has it.
# zsh (the macOS default) echo 'export NEVERMETERED_API_KEY="YOUR_API_KEY"' >> ~/.zshrc # bash echo 'export NEVERMETERED_API_KEY="YOUR_API_KEY"' >> ~/.bashrc - 6
Verify it works
Run a single prompt. The request shows up in Requests within a few seconds, with its input, cached and output tokens.
opencode run "Reply with the word ready"
- The
limitblock tells OpenCode the real context window and your output cap, so it compacts long sessions before the engine rejects them. - Subagents and parallel tool runs each use one of your parallel streams.
Troubleshooting
404 model_not_found- Use a model id exactly as
GET /v1/modelslists it, for exampleqwen3.8-27b. Plans can restrict which models a key may call. 400 context_length_exceeded- The conversation outgrew the 128K context window (input + output). Let the tool compact or start a fresh session, or get a larger window on your plan.
429 concurrency_limit_exceeded- All your parallel streams are busy and your queue allowance is full. Lower the tool's parallelism (subagents, batch size), or get more streams on your plan.
- Answers stop mid-sentence
- The response hit your plan's output cap of 65,536 tokens (finish reason
lengthormax_tokens). Ask for shorter steps, or upgrade for a higher cap. 403 email_verification_required- Free requests need a verified email. Click the link in your verification email (you can resend it from the dashboard), or upgrade.
429 daily_quota_exceeded- You've used today's free requests; agents send one request per step, so they go quickly. The allowance resets at 00:00 UTC, and paid plans have no daily limit.
503/504 request_queue_timeout- The service stayed busy longer than the queue timeout and nothing was generated. Retry with backoff, and give the tool a generous request timeout.
503 service_unavailable- No GPU capacity is online at the moment. It's temporary and your setup is fine: retry in a little while, and check the status page.