CodeBuddy 自定义模型接入指南记录：DeepSeek 官网 & 火山引擎 Code Plan

CodeBuddy 自定义模型接入指南：DeepSeek 官网 & 火山引擎 Code Plan

CodeBuddy 支持通过 models.json 配置文件接入任意兼容 OpenAI 接口格式的自定义模型。本文将分享两种实用的接入方式：DeepSeek 官方 API 和 火山引擎 Code Plan，并给出可直接使用的配置模板。

一、配置文件位置

• 用户级（全局生效）：~/.codebuddy/models.json
• 项目级（仅当前项目）：.codebuddy/models.json（项目根目录下）

创建对应文件后，CodeBuddy 会自动热加载，无需重启。

二、通用配置项说明

字段	说明
id	模型唯一标识符，用于 CodeBuddy 内部识别
name	下拉菜单中显示的模型名称
vendor	模型提供商（可任意填写）
url	API 端点地址（需以 /chat/completions 结尾，部分服务商可能例外）
apiKey	调用 API 所需的密钥（本地个人使用可明文填写，注意不要上传到公开仓库）
maxInputTokens	最大输入上下文长度
maxOutputTokens	最大生成 token 数
supportsToolCall	是否支持函数调用 / 工具
supportsImages	是否支持图片输入
availableModels	白名单：仅在列表中出现的模型会显示（不配置则显示所有）

三、方式一：接入 DeepSeek 官方 API

DeepSeek 官方提供标准的 OpenAI 兼容接口，配置简单稳定。

配置模板

{
  "models": [
    {
      "id": "deepseek-chat",
      "name": "DeepSeek V3",
      "vendor": "DeepSeek",
      "url": "https://api.deepseek.com/v1/chat/completions",
      "apiKey": "sk-你的真实API密钥",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false
    },
    {
      "id": "deepseek-reasoner",
      "name": "DeepSeek R1",
      "vendor": "DeepSeek",
      "url": "https://api.deepseek.com/v1/chat/completions",
      "apiKey": "sk-你的真实API密钥",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": ["deepseek-chat", "deepseek-reasoner"]
}

获取 API Key：登录 DeepSeek 开放平台，在「API Keys」页面创建。

四、方式二：接入火山引擎 Code Plan

火山引擎的 Code Plan 提供 DeepSeek 等模型的推理服务，接入方式略有不同。

1. 获取必要信息

• API Key：在火山引擎控制台的「模型推理 → 接入管理」中创建接入点，系统会生成以 ark- 开头的密钥。
• 模型接入点 ID：同样在接入点详情页获取，格式通常为 ep-xxxxxxxx-xxxxxx。
• API 端点：https://ark.cn-beijing.volces.com/api/coding/v3（注意：CodeBuddy 理论上要求以 /chat/completions 结尾，但实测不加后缀也能工作；如果遇到 404 错误，请尝试 .../v3/chat/completions）

2. 配置模板（多模型共用同一 Key）

{
  "models": [
    {
      "id": "deepseek-v4-pro",
      "name": "DeepSeek V4 Pro (火山)",
      "vendor": "VolcanoEngine",
      "url": "https://ark.cn-beijing.volces.com/api/coding/v3",
      "apiKey": "ark-你的真实密钥",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false,
      "relatedModels": {
        "lite": "deepseek-v4-flash",
        "reasoning": "deepseek-v4-pro"
      }
    },
    {
      "id": "deepseek-v4-flash",
      "name": "DeepSeek V4 Flash (火山)",
      "vendor": "VolcanoEngine",
      "url": "https://ark.cn-beijing.volces.com/api/coding/v3",
      "apiKey": "ark-你的真实密钥",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": ["deepseek-v4-pro", "deepseek-v4-flash"]
}

特别说明：

• 上述配置中的 id 字段（如 deepseek-v4-pro）并非火山引擎的接入点 ID，而是自定义的模型别名。CodeBuddy 在调用时会将此 id 作为请求体中的 model 字段发送。请确保您使用的模型服务端能识别该名称（火山引擎 Code Plan 通常支持标准的 DeepSeek 模型名）。
• 如果服务端要求必须使用接入点 ID（如 ep-xxxxx），请将 id 改为实际的接入点 ID。

最后重启下 Codebuddy 就可以正常使用了。暂时个人使用下来 Codebuddy 部分场景下比 Trae 工作的好的多，比如联合 开发 ESP32 ，对于 ESP idf 的理解 显然 Codebuddy 要好很多