CodeBuddy 配置自定义模型：models.json 详解

CodeBuddy 的自定义模型写在 models.json 里，CodeBuddy IDE 和 CodeBuddy Code（CLI）都读取这个文件。

文件位置

用户级：~/.codebuddy/models.json
项目级：项目目录下的 .codebuddy/models.json

合并规则：

两边 id 相同的模型，项目级覆盖用户级
availableModels 列表：项目级会整个替换用户级，不做合并
保存后大约 1 秒自动重新加载，添加的模型在列表里会带 custom 标记

配置示例

以 DeepSeek 为例：

{
  "models": [
    {
      "id": "deepseek-chat",
      "name": "DeepSeek",
      "vendor": "DeepSeek",
      "url": "https://api.deepseek.com/v1/chat/completions",
      "apiKey": "${DEEPSEEK_API_KEY}",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": ["deepseek-chat"]
}

字段说明

字段	说明
`id`	发给接口的模型名
`name`	在模型列表里显示的名字
`vendor`	服务商名称，例如 `OpenAI`、`DeepSeek`
`url`	完整的接口路径，通常以 `/chat/completions` 结尾
`apiKey`	API Key，支持 `${环境变量名}` 语法，避免明文写在文件里
`maxInputTokens` / `maxOutputTokens`	上下文和输出长度上限
`supportsToolCall`	是否支持工具调用，智能体模式需要为 `true`
`supportsImages`	是否支持图片输入
`availableModels`	在选择器里显示哪些模型

接本地 Ollama

{
  "id": "qwen3-coder",
  "name": "本地 Qwen3 Coder",
  "vendor": "Ollama",
  "url": "http://localhost:11434/v1/chat/completions",
  "apiKey": "ollama",
  "supportsToolCall": true
}

注意

目前只支持 OpenAI 接口格式
url 要写到 /chat/completions，只写到 /v1 会请求失败
字段名以官方文档为准，版本更新后可能增加新的选项