CodeBuddy 自定义模型接入免费 API：models.json 配置硅基流动 / 阿里云百炼教程

准备

• CodeBuddy IDE 或 CodeBuddy CLI（文档说明插件版暂不支持 models.json）
• 模型平台 API Key（硅基流动、阿里云百炼等兼容 OpenAI 的平台）

步骤

1. 01

   找到（或新建）models.json

   CodeBuddy 文档说明配置分两级：

   • 用户级：~/.codebuddy/models.json，对所有项目生效；
   • 项目级：<项目根目录>/.codebuddy/models.json，优先级更高，同 id 的模型会覆盖用户级。

   个人 Key 建议放用户级，避免随项目提交到仓库。

2. 02

   写入模型配置

   关键规则（来自官方文档）：目前仅支持 OpenAI 接口格式；url 必须是接口完整路径，一般以 /chat/completions 结尾，只写到 /v1 是错的。

   下面同时配置硅基流动和百炼北京地域（Base URL 取自两家官方文档，再拼上 /chat/completions）。模型 ID 以各平台模型列表为准，supportsToolCall 等能力开关按模型实际能力填写：

   json复制

   {
     "models": [
       {
         "id": "Pro/deepseek-ai/DeepSeek-R1",
         "name": "DeepSeek-R1（硅基流动）",
         "vendor": "SiliconFlow",
         "url": "https://api.siliconflow.cn/v1/chat/completions",
         "apiKey": "你的硅基流动Key",
         "supportsToolCall": true,
         "supportsImages": false,
         "supportsReasoning": true
       },
       {
         "id": "qwen-plus",
         "name": "Qwen Plus（百炼）",
         "vendor": "Bailian",
         "url": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
         "apiKey": "你的百炼Key",
         "supportsToolCall": true,
         "supportsImages": false
       }
     ]
   }

3. 03

   保存即生效，在下拉框里选模型

   文档说明 models.json 支持热重载（1 秒防抖），保存后自动同步。通过 models.json 添加的模型会带 custom 标签，在模型下拉列表里选中即可使用。

4. 04

   （可选）用 availableModels 精简下拉列表

   只想看到自己常用的几个模型时，加一个 availableModels 数组，只有列出的 ID 会显示（可混合内置模型和自定义模型）。

   json复制

   {
     "availableModels": ["qwen-plus", "Pro/deepseek-ai/DeepSeek-R1"]
   }

注意事项

• apiKey 是明文：文档说明 apiKey 填实际密钥值。别把带 Key 的 models.json 放进项目目录提交到 Git。
• 插件版不支持：CodeBuddy 的 VS Code / JetBrains 插件暂不支持 models.json，需要用 IDE 或 CLI。
• WorkBuddy 同理：腾讯云 WorkBuddy 也读取 ~/.codebuddy/models.json，配置方法见本站《WorkBuddy 接入免费大模型 API》。
• 百炼新人免费额度只适用于北京地域，且按模型独立计算。

常见问题

相关优惠

• 新人 · 阿里云百炼新人免费额度每个模型 100 万 Tokens（70+ 模型，总额超 7000 万），90 天有效
• 新人 · 火山引擎火山方舟新用户免费推理额度每个模型 50 万 tokens（以控制台显示为准）
• 额度 · 火山引擎豆包大模型送 50 万 tokens注册送 50 万 tokens

信息来源

• CodeBuddy · models.json 配置指南www.codebuddy.ai/docs/zh/ide/Features/models
• 腾讯云代码助手 · 模型配置cloud.tencent.com/document/product/1749/116119
• SiliconFlow · Cline（Base URL）docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-cline
• 阿里云百炼 · 获取与配置 API Key（Base URL）help.aliyun.com/zh/model-studio/get-api-key

最后核实日期：2026-10-09 · 政策可能随时调整，请以官方页面为准