CodeBuddy 自訂模型：Claude 與 GPT

CodeBuddy 是騰訊雲的 AI 程式編輯器；它的 models.json 接受完整 OpenAI 相容端點，所以一把 Code By AI 金鑰就能跑 Claude 與 GPT。

CodeBuddy 從 ~/.codebuddy/models.json（使用者層級）或 <workspace>/.codebuddy/models.json（專案層級）讀取自訂模型。專案項目會覆蓋同 id 的使用者項目；檔案儲存後約一秒會熱重載。

一條命令配置（macOS / Linux）

Copy
1
curl -fsSL https://www.codebyai.net/setup.sh | sh -s -- --codebuddy

腳本會以隱藏輸入索要 API Key，把 gpt-5.6-terra 與 claude-sonnet-5 加進使用者層級的 ~/.codebuddy/models.json，備份原檔並設為僅本人可讀寫。CodeBuddy 會自動重新載入這個檔案，直接在模型選擇器挑選即可。重跑可輪換金鑰；| sh -s -- --uninstall 會還原原檔。專案層級的 .codebuddy/models.json 若定義了相同 id，仍會覆蓋這些項目。CodeBuddy 外掛版不讀 models.json，請使用 IDE 或 CLI。下面的手動步驟做的是同一件事。

1. 建立 Code By AI API Key

登入 Code By AI，打開 API Keys 頁面建立金鑰。金鑰形如 sk-proj-...。

2. 編輯 models.json

打開 ~/.codebuddy/models.json，把下面內容合併進既有物件；原本的模型請保留：

Copy
1
{
2
  "models": [
3
    {
4
      "id": "gpt-5.6-terra",
5
      "name": "CodeByAI GPT",
6
      "vendor": "Custom",
7
      "url": "https://www.codebyai.net/api/agent/v1/chat/completions",
8
      "apiKey": "sk-proj-xxxx",
9
      "maxInputTokens": 200000,
10
      "maxOutputTokens": 65536,
11
      "supportsToolCall": true,
12
      "supportsImages": false,
13
      "supportsReasoning": false
14
    },
15
    {
16
      "id": "claude-sonnet-5",
17
      "name": "CodeByAI Claude",
18
      "vendor": "Custom",
19
      "url": "https://www.codebyai.net/api/agent/v1/chat/completions",
20
      "apiKey": "sk-proj-xxxx",
21
      "maxInputTokens": 200000,
22
      "maxOutputTokens": 65536,
23
      "supportsToolCall": true,
24
      "supportsImages": false,
25
      "supportsReasoning": false
26
    }
27
  ]
28
}

CodeBuddy 只支援 OpenAI 介面格式，所以 url 必須是完整的 Chat Completions 路徑。Claude ID 仍可使用：閘道會把 claude-* 轉往 Claude 通道，並依 Claude 價格計費。

3. 選模型

儲存檔案。CodeBuddy 會自動重載；打開模型選擇器，選 CodeByAI GPT 或 CodeByAI Claude。如果你有維護 availableModels，兩個 ID 都要加進去，否則這份清單會被忽略、顯示所有已設定模型。

模型欄位

• maxInputTokens 與 maxOutputTokens 要和模型真實限制一致；閘道模型使用 200,000 與 65,536。
• Agent 任務請保持 supportsToolCall: true。
• supportsImages 與 supportsReasoning 可選；只有模型真的支援圖片或推理參數時才開。

疑難排解

• 404 — url 填成了 base URL，或結尾不是 /chat/completions。請用完整路徑 https://www.codebyai.net/api/agent/v1/chat/completions。
• 401／金鑰無效 — 金鑰前後有空白、已被刪除或已過期。到 API Keys 頁面重新建立。
• 餘額不足 — 到 Wallet 頁面儲值。
• 模型被隱藏 — 非空的 availableModels 清單沒有包含它的 ID。把 ID 加進去，或移除清單。
• 檔案沒有生效 — JSON 無效會中止重載。CodeBuddy 的檔案是純 JSON；請移除註解與尾隨逗號。