Use NeverMetered with OpenCode

Open-source terminal agent with an OpenAI-compatible provider.

OpenAI Chat
Model
qwen3.8-27b
128K context on the free plan65,536 max output tokens on the free planReplace YOUR_API_KEY with your key.
  1. 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_KEY where it goes.

  2. 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 opencode works too.

    curl -fsSL https://opencode.ai/install | bash
  3. 3

    Add the provider

    Save this as opencode.json in your project, or merge it into ~/.config/opencode/opencode.json to 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. 4

    Export your key and start OpenCode

    export NEVERMETERED_API_KEY="YOUR_API_KEY"
    opencode
  5. 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. 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"
Tips
  • The limit block 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/models lists it, for example qwen3.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 length or max_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.