在 OpenCode CLI 中接入

在 opencode 配置文件里加一个 openai-compatible provider。

本文介绍如何把 OpenCode CLI 接到本平台，用同一个令牌调用 Claude、GPT、Gemini 等模型。全程只需要三个值：接入地址、令牌、模型名。

开始之前请先在控制台创建一个令牌（sk- 开头），并确认账户里有余额。还没有令牌的话，先看 5 分钟发出第一个请求。

配置

编辑 opencode 的配置文件（通常是 ~/.config/opencode/opencode.json），加一个 provider 并列出你要用的模型。

填哪里	填什么
baseURL	`https://api.router.ai/v1`
apiKey	`sk-` 开头的令牌
模型 key	`claude-sonnet-5`

{
  "provider": {
    "router": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Router AI",
      "options": {
        "baseURL": "https://api.router.ai/v1",
        "apiKey": "sk-你的令牌"
      },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "gpt-5.5": { "name": "GPT-5.5" }
      }
    }
  }
}

验证

配置完先别急着跑复杂任务。让它回答一句「你好」，能正常回话就说明链路通了。想单独确认令牌本身有没有问题，可以在终端直接调一次接口：

curl https://api.router.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5","messages":[{"role":"user","content":"你好"}]}'

返回 JSON 里有 choices 就是正常的。之后在控制台的计费流水里能看到这笔调用。

常见问题

models 下面的 key 必须是本平台的模型名原文，它会被原样发到接口；name 只是界面显示用的。想让密钥不落盘，可以把 apiKey 换成环境变量引用。

报 401

令牌填错、多了空格，或者复制时漏了开头的 sk-。重新复制一次完整令牌。

报 404

九成是地址结尾对不上：OpenAI 兼容格式要 /v1 结尾，Anthropic 和 Gemini 原生格式则不要带 /v1。对照上面表格再核一次。

报 402 / 提示余额不足

账户余额不够。见充值方式与到账时间。

模型不存在

模型名必须和平台目录里完全一致（大小写、连字符都算）。在模型广场页可以直接复制准确的名字。

博客