CoreCode文件

接入

OpenCode

最後更新:

OpenCode 是開源的終端程式設計 Agent,支援任意 OpenAI 相容的提供方。在它的設定檔案里加一個 CoreCode 提供方,就能在同一個 OpenCode 裡切換 Claude、GPT、Grok 和 Gemini。設定寫法來自 OpenCode 的 提供方文件。

更省事的方式裝了 Magpie 的話,在 Magpie 的 Agents 頁給 OpenCode 選一個 corecode/… 模型即可,不用手寫下面的設定。

安裝

npm install -g opencode-ai

裝好後執行 opencode --version,能列印版本號就說明裝好了。

建立金鑰

在 API 金鑰 頁建立金鑰,分組用 auto。OpenCode 不是 Claude Code,「僅限CC」分組會拒絕它的請求;只用 Claude 的話也可以選「Claude 滿血(可外接)」。

設定

編輯 ~/.config/opencode/opencode.json,沒有就新建(也可以放在專案目錄裡,只對這個專案生效):

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "corecode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CoreCode",
      "options": {
        "baseURL": "https://corecode.live/v1",
        "apiKey": "{env:CORECODE_API_KEY}"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "claude-opus-5-5": { "name": "Claude Opus 5.5" },
        "gpt-6.1-sol": { "name": "GPT-6.1 Sol" },
        "grok-4.7": { "name": "Grok 4.7" },
        "gemini-3.8-flash-high": { "name": "Gemini 3.8 Flash" }
      }
    }
  }
}

models 裡的名字要和 模型定價 頁一致,按需增刪。然後把金鑰放進環境變數:

export CORECODE_API_KEY=sk-你的金鑰

想永久生效,把這一行加進 ~/.zshrc 或 ~/.bashrc;Windows 用 setx CORECODE_API_KEY sk-你的金鑰,然後重開終端。

檢查是否生效

opencode run -m corecode/claude-sonnet-5-5 "回覆 ok"

返回 ok 即接通。在 OpenCode 裡輸入 /models,能看到 CoreCode 下的模型,選中即可切換。

常見問題

/models 裡看不到 CoreCode

檢查 JSON 格式是否正確,以及檔案是否放在 ~/.config/opencode/ 或當前專案目錄裡。

401 或 403

401 是沒讀到金鑰:確認執行 opencode 的終端裡有 CORECODE_API_KEY。403 先看餘額,再確認金鑰分組不是「僅限CC」。