OpenCode

新增 OpenCode 自訂 provider，連接憑證並選擇模型。

安裝與準備

1. 用下方官方 npm 套件安裝 OpenCode，再執行 opencode --version，需先安裝 Node.js 與 npm。
2. 在 API 金鑰建立 routerra.ai 金鑰，從模型複製此金鑰可存取的模型 ID。範例使用 Chat Completions 協定，編碼任務需要工具呼叫支援。

npm install -g opencode-ai
opencode --version

註冊並連接 routerra

3. 在專案根目錄建立或合併 opencode.json。需對所有專案生效則使用 ~/.config/opencode/opencode.json。一致替換所有 YOUR_MODEL_ID；routerra/ 是 OpenCode 的 provider 前綴，不屬於上游模型 ID。
4. 啟動 opencode，執行 /connect，選擇 Other，輸入 provider ID routerra 並貼上金鑰。ID 必須與 JSON 物件鍵完全一致。憑證另外儲存於 ~/.local/share/opencode/auth.json。執行 /models 選擇已設定模型。修改設定檔後重啟 OpenCode。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "routerra/YOUR_MODEL_ID",
  "provider": {
    "routerra": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "routerra.ai",
      "options": { "baseURL": "https://routerra.ai/v1" },
      "models": { "YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" } }
    }
  }
}

檢查連線

provider 未出現時，檢查載入的是專案還是全域設定，以及是否包含 provider.routerra.models。透過其他 /connect ID 儲存的金鑰無法用於此 provider。若模型僅支援 /responses，將 npm 改為 @ai-sdk/openai；範例的 @ai-sdk/openai-compatible 呼叫 /chat/completions。測試簡短回覆與唯讀檔案查詢，再查看 routerra.ai 用量中的模型。