WorkBuddy / CodeBuddy | ModelRouter 文档

在 WorkBuddy 或 CodeBuddy 中添加ModelRouter的模型，写一个 models.json 即可。

WorkBuddy 和 CodeBuddy 是腾讯推出的 AI 助手，都支持通过 models.json 添加自定义模型，两者的配置方法相同，只是文件位置不同。本站的 DeepSeek、GLM、Kimi 系列都可以添加。

工具	配置文件位置（macOS / Linux）	Windows
WorkBuddy	`~/.workbuddy/models.json`	`%USERPROFILE%\.workbuddy\models.json`
CodeBuddy	`~/.codebuddy/models.json`	`%USERPROFILE%\.codebuddy\models.json`

给 AI 助手的一段话

WorkBuddy 本身就是 AI 助手，可以直接把下面这段话发给它，让它自己写好配置。这段话会包含你的完整密钥，接收它的 AI 服务会看到，请只发给你信任的 AI 助手。把 YOUR_API_KEY 换成你的密钥，deepseek-v4-pro 换成你要用的模型 ID。

提示

在控制台 API 密钥页面点密钥右侧的 接入配置，选 WorkBuddy 后点 复制给 Agent，复制到的内容已经填好了你的密钥。

请帮我把 WorkBuddy 接入ModelRouter（OpenAI 兼容的 API 服务）。

1. 打开配置文件 ~/.workbuddy/models.json（Windows 为 %USERPROFILE%\.workbuddy\models.json），不存在就新建，所在目录不存在也一并创建。
2. 写入下面的内容。如果文件已存在，把这个模型追加到 models 数组里；已有相同 id 的条目就替换它。保留其他内容。

```json
{
  "models": [
    {
      "id": "deepseek-v4-pro",
      "name": "deepseek-v4-pro",
      "vendor": "ModelRouter",
      "apiKey": "YOUR_API_KEY",
      "url": "https://modelrouter.club/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": false
    }
  ]
}
```

3. 保存后提醒我重启 WorkBuddy，并在模型列表里选择 deepseek-v4-pro。

这段话里有我的 API 密钥：只把它写进本地配置文件，回复时不要完整复述，也不要提交到代码仓库。

准备

安装 WorkBuddy 或 CodeBuddy，并登录。
在 API 密钥页面创建一个密钥，并确认钱包有余额。
在模型广场选好模型，复制模型 ID，例如 deepseek-v4-pro。

第 1 步：打开 models.json

文件不存在时会自动新建。下面以 WorkBuddy 为例，CodeBuddy 把命令里的 .workbuddy 换成 .codebuddy：

mkdir -p ~/.workbuddy && touch ~/.workbuddy/models.json && open -e ~/.workbuddy/models.json

第 2 步：粘贴配置

把下面的内容粘贴进去并保存。apiKey 换成你的密钥，id 换成你的模型 ID。要添加多个模型，就在 models 数组里多写几项：

{
  "models": [
    {
      "id": "deepseek-v4-pro",
      "name": "DeepSeek V4 Pro",
      "vendor": "ModelRouter",
      "apiKey": "YOUR_API_KEY",
      "url": "https://modelrouter.club/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": false
    },
    {
      "id": "glm-5.3",
      "name": "GLM-5.3",
      "vendor": "ModelRouter",
      "apiKey": "YOUR_API_KEY",
      "url": "https://modelrouter.club/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": false
    }
  ]
}

各字段的作用

字段	说明
`id`	本站的模型 ID，必须和模型广场里的完全一致，这是实际发给接口的值
`name`	模型下拉框里显示的名字，可以随便起
`vendor`	服务商名称，只用于显示
`apiKey`	本站 API 密钥
`url`	填完整接口地址 `https://modelrouter.club/v1/chat/completions`
`supportsToolCall`	必须为 `true`。设为 `false` 时，WorkBuddy 会去掉请求里的工具调用，助手就没法读写文件、执行命令
`supportsImages`	本站文本模型不支持图片输入，填 `false`

说明

只想在界面里显示本站的模型，可以在文件最外层加 "availableModels": ["deepseek-v4-pro", "glm-5.3"]。不加时，本站模型会和 WorkBuddy 自带的模型一起显示。

第 3 步：选择模型并验证

保存文件后，WorkBuddy 会自动重新读取配置；没有出现新模型时，重启一次 WorkBuddy。

在对话框的模型下拉列表里选择你刚添加的模型。
发一句"读取当前目录下的任意一个文件，告诉我它的第一行"，确认模型能正常回答并调用工具。

每次调用的用量和费用都可以在使用日志里查到。

也可以在界面里添加

WorkBuddy 的界面也支持添加自定义模型，按下面三项填写即可：

界面里的字段	填写
接口地址 / URL	`https://modelrouter.club/v1/chat/completions`
API Key	本站 API 密钥
模型 ID	本站的模型 ID，例如 `deepseek-v4-pro`，不是模型的显示名

常见问题

报 404

接口地址填错了。填 https://modelrouter.club/v1/chat/completions 或 https://modelrouter.club/v1，不要只填 https://modelrouter.club：WorkBuddy 会在地址后面补 /chat/completions，只填根地址会漏掉 /v1。

提示模型不存在（model_not_found）

id 或界面里的"模型 ID"填成了显示名。例如 deep-seek-4-Pro、DeepSeek V4 Pro 都不对，要填模型广场里复制的 deepseek-v4-pro。

模型能聊天，但不会读写文件、执行命令

检查 supportsToolCall 是否为 true。

下拉列表里看不到新模型

确认文件放在正确的目录（WorkBuddy 是 .workbuddy，CodeBuddy 是 .codebuddy），并且是合法的 JSON，然后重启一次客户端。

用下面的命令在本机检查 JSON 格式，只检查格式，不会显示或上传密钥：macOS / Linux 运行 python3 -m json.tool ~/.workbuddy/models.json > /dev/null && echo OK，Windows PowerShell 运行 Get-Content "$env:USERPROFILE\.workbuddy\models.json" -Raw | ConvertFrom-Json | Out-Null，没有报错就说明格式正确。

提示余额不足或密钥无效（401 / 403）

密钥填错、被禁用、过期或额度用完，都会返回 Invalid token。到控制台检查密钥状态和钱包余额，详见错误排查。