CodeBuddy 桌面版 配置自定义模型
通过编辑 models.json 文件来添加和管理自定义模型。
- 找到配置文件 ： 建议在用户级进行全局配置，文件路径通常为：
~/.codebuddy/models.json(适用于所有项目)。 - 编辑并添加模型 ： 打开该 JSON 文件，按照以下结构添加你的自定义模型。你需要替换其中的
id、name、url(API 完整路径)和apiKey等信息：
json
{
"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 能正常解析返回的数据。