Router9
Documentation
Integrations

OpenCode

Use Router9 as a custom provider in OpenCode

OpenCode logo

OpenCode is an open-source terminal coding agent. It loads models through the Vercel AI SDK, so you can add Router9 as a custom OpenAI-compatible provider.

Setup

Add Router9 to your opencode.json (project root) or ~/.config/opencode/opencode.json (global):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "router9": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Router9",
      "options": {
        "baseURL": "https://api.router9.com/v1",
        "apiKey": "{env:ROUTER9_API_KEY}"
      },
      "models": {
        "gpt-4o": { "name": "GPT-4o" },
        "claude-sonnet-4-20250514": { "name": "Claude Sonnet 4" }
      }
    }
  }
}

API Key

export ROUTER9_API_KEY=sk-r9k-your-key-here

The {env:ROUTER9_API_KEY} placeholder in the config resolves this at runtime.

Selecting the Model

OpenCode references models as provider/model. Pick router9/gpt-4o from the model switcher, or set it as the default in your config:

{
  "model": "router9/gpt-4o"
}

Add Skills via MCP

Add Router9's hosted MCP server as a remote MCP in your opencode.json:

{
  "mcp": {
    "router9": {
      "type": "remote",
      "url": "https://api.router9.com/v1/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer sk-r9k-your-key"
      }
    }
  }
}

See Install MCP Server for details.

Tips

  • List any model id Router9 supports under models — each becomes selectable as router9/<id>.
  • Use {env:...} rather than hard-coding the key so it stays out of version control.
  • See the OpenCode providers docs for advanced options like custom headers.

On this page