TRAE / CodeBuddy 串接教學

字節 TRAE 與騰訊 CodeBuddy 兩款 AI 程式設計 IDE，新增自訂模型即可接入

• 介面：OpenAI Chat Completions
• 網址寫法：寫到 /v1（https://gpt.cherrychat.org/v1）
• 推薦模型：claude-sonnet-5-5、gpt-6.1-sol
• 平台：macOS、Windows、VS Code、JetBrains

串接步驟

1. TRAE：開啟新增模型視窗

   在 IDE 視窗或 Agent 視窗進入「設定」>「模型」，點「新增模型」，在彈窗裡選「自訂模型」。

2. TRAE：填寫自訂模型

   「API 格式」選「OpenAI Chat Completions 格式」；「完整 URL」開關保持關閉，「自訂請求網址」填到 /v1。GPT 系列模型在「進階設定」的「模型系列」裡選「GPT-5 系列」。Claude 模型也可以改選「Anthropic Messages 格式」，這時網址只填 https://gpt.cherrychat.org。

   • 自訂請求網址：https://gpt.cherrychat.org/v1（「完整 URL」開關關閉時填到 /v1）
   • 模型 ID：claude-sonnet-5-5
   • API 金鑰：sk-你的金鑰

3. TRAE：新增並選用

   點「新增模型」，TRAE 會呼叫介面檢測 key，通過後模型出現在清單裡。在對話框右下角點目前模型名稱，切換到它即可。

4. CodeBuddy：編輯 models.json

   開啟 ~/.codebuddy/models.json（Windows 是 %USERPROFILE%\.codebuddy\models.json），沒有就新建，貼上下方內容。url 必須寫全到 /chat/completions；apiKey 填 key 本身。儲存後自動生效，模型下拉選單會出現帶 custom 標籤的新模型。

   • url（完整網址）：https://gpt.cherrychat.org/v1/chat/completions（CodeBuddy 必須寫完整路徑）
   • apiKey：sk-你的金鑰

   ~/.codebuddy/models.json

   {
     "models": [
       {
         "id": "claude-sonnet-5-5",
         "name": "claude-sonnet-5-5",
         "vendor": "OpenAI",
         "apiKey": "sk-你的金鑰",
         "url": "https://gpt.cherrychat.org/v1/chat/completions",
         "maxInputTokens": 128000,
         "maxOutputTokens": 8192,
         "supportsToolCall": true,
         "supportsImages": false
       }
     ]
   }

容易踩的坑

• 兩個工具網址寫法不同：TRAE 關閉「完整 URL」時填到 /v1（https://gpt.cherrychat.org/v1）；CodeBuddy 的 url 必須寫全到 https://gpt.cherrychat.org/v1/chat/completions。
• TRAE 裡用 GPT 系列時，「模型系列」選「GPT-5 系列」，它會改用 max_completion_tokens，否則可能出現 400 參數錯誤。
• CodeBuddy 目前只支援 OpenAI（Chat）格式；要用智慧體模式，supportsToolCall 必須是 true。
• 專案裡的 .codebuddy/models.json 會覆蓋使用者目錄的同名設定；裡面有 key，不要提交到 Git。
• 中國版與國際版介面文字略有差異，以軟體裡的實際名稱為準。

錯誤訊息 → 原因 → 怎麼辦

教學核對於 2026-11-02。工具介面改版後可能和這裡略有不同，以官方文件為準。

API 串接 · API 模型價格

Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 內容由 AI 生成，請仔細甄別