codebuddy 桌面版 如何配置自己的模型

CodeBuddy 桌面版 配置自定义模型

通过编辑 models.json 文件来添加和管理自定义模型。

1. 找到配置文件： 建议在用户级进行全局配置，文件路径通常为：~/.codebuddy/models.json（适用于所有项目）。
2. 编辑并添加模型： 打开该 JSON 文件，按照以下结构添加你的自定义模型。你需要替换其中的 id、name、url（API 完整路径）和 apiKey 等信息：

{
  "models": [
    {
      "id": "my-custom-model",
      "name": "My Custom LLM",
      "vendor": "CustomVendor",
      "url": "https://your-api-endpoint.com/v1/chat/completions",
      "apiKey": "你的API密钥",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false,
      "supportsReasoning": true
    }
  ]
}

配置提示：

• 关联模型（relatedModels）：如果你希望主模型在特定场景（如轻量级任务 lite 或深度推理 reasoning）自动切换到其他小模型，可以在模型条目里显式声明 relatedModels。如果没有声明，所有场景都会默认回退到主模型自己。
• 环境变量优先级：你也可以通过设置环境变量（如 CODEBUDDY_MODEL）来指定模型，环境变量的优先级通常高于配置文件。

核心配置字段说明

配置自定义模型时通常需要关注以下核心字段：

字段	说明	是否必填
id	模型的唯一标识符	是
name	模型在界面上显示的名称	否
url	API 端点的完整 URL 路径	否
apiKey	调用模型所需的 API 密钥	否
supportsToolCall	该模型是否支持工具调用（Function Calling）	否
supportsImages	该模型是否支持图片输入（多模态）	否

注意事项：

• 网络环境：配置第三方模型（如 OpenAI、Google）时，请确保你的网络环境能够正常访问对应的海外 API 服务器，必要时需在 VS Code 或系统中配置代理。
• 接口协议：自定义模型的 API 接口通常需要兼容 OpenAI 的接口协议（如 /v1/chat/completions），以确保 CodeBuddy 能正常解析返回的数据。