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 生成，请仔细甄别