AI in IDE logoAI in IDE

在 OpenCode 中使用 Claude：自訂 Base URL 設定

只要一段設定，就能把 OpenCode 內建的 Anthropic provider 指向 AI in IDE，不需要 Anthropic 帳號即可使用 Claude Opus 5.5、Sonnet 5.5 或 Haiku 4.5。

已於 2026-11-06 以 OpenCode 1.2.27 測試：依下方設定，opencode run 透過 claude-sonnet-5-5 與 claude-haiku-4-5-20251001 都有回覆。

快速設定

  1. 建立 API Key。 打開 API Keys 建立金鑰，渠道選 AWSQ 或 CCMAX。Codex 或 Gemini 金鑰會在 Claude 端點被拒絕。
  2. 匯出金鑰。 在 ~/.zshrc 或 ~/.bashrc 加入 export AIINIDE_API_KEY="YOUR_DASHBOARD_API_KEY"，然後開一個新的終端機。
  3. 寫入 provider 覆寫設定。 要套用到所有專案就寫進 ~/.config/opencode/opencode.json，只用於單一專案則寫進專案根目錄的 opencode.json：
1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "provider": {
4
    "anthropic": {
5
      "options": {
6
        "baseURL": "https://api.aiinide.com/v1",
7
        "apiKey": "{env:AIINIDE_API_KEY}"
8
      }
9
    }
10
  },
11
  "model": "anthropic/claude-sonnet-5-5"
12
}
  1. 驗證。 執行 opencode run "Reply with exactly: OK"。標頭會顯示 claude-sonnet-5-5，回覆是 OK。這筆請求會出現在 Usage。

Base URL 結尾必須是 /v1

OpenCode 的 Anthropic provider 會自己加上 /messages，所以需要填 https://api.aiinide.com/v1。只填主機位址時，它會呼叫 /messages，並以 Error: Not Found 失敗。Claude Code 剛好相反：它會加上 /v1/messages，所以要填主機位址。不要把其中一個工具的值複製到另一個工具。

支援模型

OpenCode 中的模型 ID渠道適合
anthropic/claude-opus-5-5AWSQ、CCMAX高難度重構、長時間自動執行
anthropic/claude-sonnet-5-5AWSQ、CCMAX日常寫程式
anthropic/claude-haiku-4-5-20251001AWSQ、CCMAX快速修改、便宜的驗證呼叫

修改設定中的 model 即可切換預設模型。請使用 GET /v1/models 回傳的完整 ID。費率與渠道倍率請看模型與定價。

常見問題

OpenCode 接 AI in IDE 要用哪個 Base URL？

https://api.aiinide.com/v1。OpenCode 會在後面加上 /messages；只填主機位址會回傳 Not Found。

需要執行 /connect 嗎？

不需要。apiKey 選項會從 AIINIDE_API_KEY 讀取金鑰，所以 auth.json 裡不會儲存任何東西。執行 opencode auth list 可以查看那裡是否還存著舊的 Anthropic 金鑰。

這會影響 OpenCode 的其他 provider 嗎？

不會。只有 anthropic provider 被導向。OpenAI、Google 與其他 provider 仍使用各自的端點與金鑰。

可以不把金鑰放進專案儲存庫嗎？

可以。把金鑰放在環境變數，再用 {env:AIINIDE_API_KEY} 引用。只包含這個引用的專案 opencode.json 可以放心提交。

相關頁面

在 OpenCode 中使用 Claude：自訂 Base URL 設定｜AI in IDE