在 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 / 提示餘額不足

帳戶餘額不夠。見充值方式與到帳時間。

模型不存在

模型名必須和平臺目錄裡完全一致（大小寫、連字元都算）。在模型廣場頁可以直接複製準確的名字。

部落格