WorkBuddy

通过 models.json 配置文件，在同一个 API Key 下接入多个自定义模型。

仅 CLI 形态与 CodeBuddy IDE 支持

models.json 自定义模型仅在 WorkBuddy 的 CLI 形态和 CodeBuddy IDE 中可用，插件版暂不支持。

装完先打开一次并登录，让它自动生成配置目录。

配置文件放哪

环境	路径
Windows	`%USERPROFILE%\.workbuddy\models.json`
macOS	`~/.workbuddy/models.json`
项目级（仅对该项目生效）	`<项目目录>/.codebuddy/models.json`
Linux 云端 / 沙盒	`~/.codebuddy/models.json`（通常是 `/root/.codebuddy/models.json`）

项目级优先于用户级。部分版本读的是 .codebuddy 而非 .workbuddy，两处都放一份最保险。

Linux 原生桌面客户端的发布方式尚未确认，以官方下载页为准。

云端沙盒不会读本机配置

工作目录是 /workspace 的云端 / 沙盒环境，必须把配置写进沙盒内的 ~/.codebuddy/models.json。你本机 Windows 或 macOS 上的配置不会同步进去。

打开配置目录：

Windows：Win+R → %USERPROFILE%\.workbuddy
macOS：Finder 按 Cmd+Shift+G 输入 ~/.workbuddy，或终端 mkdir -p ~/.workbuddy
Linux 沙盒：mkdir -p ~/.codebuddy

写 models.json

根结构必须是对象

必须是 { "models": [ ... ] }，不能是裸数组 [ ... ]，否则 WorkBuddy 加载不出来。

{
  "models": [
    {
      "id": "deepseek-v4-pro",
      "name": "deepseek-v4-pro",
      "vendor": "Custom",
      "url": "https://api.smartwan.com/v1/chat/completions",
      "apiKey": "sk-你的Token",
      "supportsToolCall": true,
      "supportsImages": false,
      "supportsReasoning": false
    },
    {
      "id": "kimi-k2.6",
      "name": "kimi-k2.6",
      "vendor": "Custom",
      "url": "https://api.smartwan.com/v1/chat/completions",
      "apiKey": "sk-你的Token",
      "supportsToolCall": true,
      "supportsImages": false,
      "supportsReasoning": false
    },
    {
      "id": "claude-sonnet-5",
      "name": "claude-sonnet-5",
      "vendor": "Custom",
      "url": "https://api.smartwan.com/v1/chat/completions",
      "apiKey": "sk-你的Token",
      "supportsToolCall": true,
      "supportsImages": true,
      "supportsReasoning": false
    }
  ]
}

要加模型就在 "models" 数组里按同样格式追加一个对象，改 id 和 name 即可——vendor、url、apiKey 三个字段保持不变，同一个 Key 下所有模型共用。

JSON 不支持注释，别把说明文字粘进文件。

字段说明

字段	说明
`id`	调用时传给接口的模型名，须与模型列表一致
`url`	完整接口路径，必须以 `/chat/completions` 结尾
`apiKey`	你的 API Key，所有模型共用一个
`supportsToolCall`	是否支持工具调用，按模型实际能力填
`supportsImages`	是否支持图片输入
`supportsReasoning`	是否展示推理过程

后三个能力开关要按模型实际支持情况填，填错会导致调用异常。

models.json 含明文密钥

不要提交到 Git、上传公开仓库或放进截图。项目级配置记得加进 .gitignore。

生效与验证

配置支持热重载（约 1 秒防抖）。没刷新就按 Ctrl+Shift+P → Developer: Reload Window，或彻底退出重启。

打开模型选择器搜 custom:，能看到带 custom 标签的自定义模型，选中发条消息能回复即成功。

遇到问题

现象	处理
选择器里看不到自定义模型	检查根结构是不是 `{ "models": [...] }`；确认文件目录正确；改完 Reload Window
云端项目读不到配置	配置要写进沙盒内的 `~/.codebuddy/models.json`
调用报 404	`url` 必须是完整路径，以 `/chat/completions` 结尾

能加图像生成模型吗？ 不能。gpt-image-2 这类只支持 /v1/images/generations，而 WorkBuddy 自定义模型只支持 /chat/completions，加了也调用失败。

配置文件放哪​

写 models.json​

字段说明​

生效与验证​

遇到问题​

配置文件放哪

写 models.json

字段说明

生效与验证

遇到问题