DeepSeek V4.1 接入 CodeBuddy 完整指南

DeepSeek V4.1 接入 CodeBuddy 完整指南

CodeBuddy 是腾讯云代码助手，有 VS Code / JetBrains 插件和 CLI 两种形态，核心 Agent 能力叫 Craft——能自主读项目、拆任务、改多文件、跑测试并反思修复。它默认用混元等内置模型，但官方文档明确给出了自定义模型方案，DeepSeek 属于首批有完整接入文档的第三方模型。

把 CodeBuddy 接上 DeepSeek 的收益：内置模型的调用额度按订阅供给，接上自己的 Key 后按量计费、成本自己看得到，还能用上 1M 上下文。

接入方式总览

两种方式可以混用，但同一个模型只在一处声明。

第一步：IDE 插件接法（models.json）

按官方文档的模型声明格式，写 models.json：

1{
2  "models": [
3    {
4      "id": "deepseek-flash",
5      "name": "DeepSeek V4.1 Flash",
6      "vendor": "DeepSeek",
7      "url": "https://api.deepseek.com/v1/chat/completions",
8      "apiKey": "${DEEPSEEK_API_KEY}",
9      "maxInputTokens": 1000000,
10      "maxOutputTokens": 8192,
11      "supportsToolCall": true,
12      "supportsImages": false
13    },
14    {
15      "id": "deepseek-v4-pro",
16      "name": "DeepSeek V4 Pro",
17      "vendor": "DeepSeek",
18      "url": "https://api.deepseek.com/v1/chat/completions",
19      "apiKey": "${DEEPSEEK_API_KEY}",
20      "maxInputTokens": 128000,
21      "maxOutputTokens": 8192,
22      "supportsToolCall": true,
23      "supportsImages": false,
24      "relatedModels": {
25        "lite": "deepseek-flash",
26        "reasoning": "deepseek-v4-pro"
27      }
28    }
29  ],
30  "availableModels": ["deepseek-flash", "deepseek-v4-pro"]
31}

几个关键点：

1. apiKey 用 ${DEEPSEEK_API_KEY} 环境变量占位，别把明文 Key 写进会提交的配置文件；变量在启动 CodeBuddy 前 export 好
2. availableModels 必须列出模型 ID——只写 models 不写 availableModels，模型不会出现在选择列表，这是最常见的遗漏
3. url 是完整的 chat/completions 端点，和 Cline 那类只填 Base URL 的插件不同，别少写路径
4. supportsImages: false——DeepSeek 是纯文本模型，关掉图片能力避免智能体误发图片请求
5. 保存后热重载有约 1 秒防抖，稍等再刷新模型列表

第二步：关联模型分工（省钱关键）

CodeBuddy 会在一次会话里按场景切换模型：简单活儿用小模型，重推理才上大模型。这个分工通过 relatedModels 字段声明：

1"relatedModels": {
2  "lite": "deepseek-flash",
3  "reasoning": "deepseek-v4-pro"
4}

• lite：后台提取、摘要这类低价值请求，生效中
• reasoning：需要深度思考的复杂推理，生效中
• subagent / vision / longContext 三个类型官方已定义但暂未开放，写了不报错也不生效

注意：自定义模型不继承内置模型的默认关联配置。不声明 relatedModels 时，轻量和推理场景都会回退到主模型——主模型是 flash 就全用 flash，主模型是 pro 就全用 pro。想分工，显式声明。

第三步：CLI 接法（环境变量）

不维护 models.json 的话，纯环境变量也能对接 DeepSeek：

1# 端点与密钥
2export CODEBUDDY_BASE_URL="https://api.deepseek.com"
3export CODEBUDDY_API_KEY="sk-你的key"
4
5# 主 Agent 默认模型
6export CODEBUDDY_MODEL="deepseek-v4-pro"
7# 复杂推理用的大模型
8export CODEBUDDY_BIG_SLOW_MODEL="deepseek-v4-pro"
9# 后台/轻量任务用的小模型
10export CODEBUDDY_SMALL_FAST_MODEL="deepseek-flash"
11
12codebuddy --model deepseek-v4-pro

这几个变量也可以写进 settings.json 的 env 字段，每个会话自动应用，适合团队统一配置。启动时用 --model 可以显式指定主模型，覆盖环境变量默认值。

需要思考模式的注意：DeepSeek 的思考模式通过 Anthropic 兼容格式调用更完整。CodeBuddy 支持 Anthropic 协议的第三方服务，把 CODEBUDDY_BASE_URL 设为 https://api.deepseek.com/anthropic 即可走这条链路，模型变量同样填 deepseek-v4-pro。

Craft 智能体 + DeepSeek 用法

Craft 是 CodeBuddy 的核心 Agent：描述需求，它自己读项目、拆任务、改多个文件、跑测试，失败会反思重试。用自定义模型驱动 Craft 的建议：

1. 主模型给 deepseek-v4-pro。Craft 的多步编排对推理能力敏感，flash 当主力容易出现「改一步错一步」；把 flash 留给 lite 场景跑量
2. 重要项目先提交 Git。Craft 会连续创建和修改文件，有基线在才敢放手
3. 复杂需求先对话过方案。直接开 Craft 跑大需求，方向错了它会认真地跑很远，先在普通对话里把方案敲定更省 token

与其他方案怎么选

常见问题排查

安全习惯：CodeBuddy 能执行终端命令，别在生产凭证目录里自由放权；apiKey 一律用环境变量占位，明文 Key 不进版本库。