WorkBuddy 配置教程

本教程介绍如何在 WorkBuddy（腾讯云代码助手 CodeBuddy 的命令行/Agent 工具）中接入第三方大模型 API。配置完成后，WorkBuddy 会通过 QuickRouter OpenAI 兼容接口调用 Claude、GPT、DeepSeek、Gemini、Qwen 等 400+ 模型。

一、前置条件

二、自定义模型接入方式

WorkBuddy 内置主流大模型，如果你的模型服务不在内置列表中，可选择自定义 / Custom，手动填写接口地址（URL）、API Key 与模型名接入。配置参数（含 API Key）仅保存在本地 workbuddy/models.json 中，不上传云端。

WorkBuddy 提供两种添加自定义模型的方式：

方式一：可视化界面配置

下图为 WorkBuddy 自定义模型配置界面，红色标注了需要填写的 QuickRouter 配置项：

方式二：编辑 models.json

找到本地配置文件 workbuddy/models.json（用户级全局配置）。也可在项目级目录下放置同名文件，项目级会覆盖用户级同名模型定义。在文件中追加 QuickRouter 模型配置：

{
  "quickrouter-claude": {
    "name": "QuickRouter Claude",
    "url": "https://api.quickrouter.ai/v1/chat/completions",
    "apiKey": "sk-你的QuickRouter令牌",
    "model": "claude-opus-4-8",
    "maxInputTokens": 200000
  },
  "quickrouter-gpt": {
    "name": "QuickRouter GPT",
    "url": "https://api.quickrouter.ai/v1/chat/completions",
    "apiKey": "sk-你的QuickRouter令牌",
    "model": "gpt-5.5",
    "maxInputTokens": 272000
  }
}

三、配置国内可用大模型中转站（QuickRouter）

本节对应方案二：把 WorkBuddy 的模型后端指向 QuickRouter 中转站。核心是编辑本机的 models.json，把 QuickRouter 的模型 ID、接口地址、API Key 和上下文参数写进去，然后重启 WorkBuddy。

第 1 步：获取 QuickRouter 接口信息

第 2 步：写入 models.json

把以下配置追加到 workbuddy/models.json，按需替换 model 字段：

{
  "quickrouter": {
    "name": "QuickRouter",
    "url": "https://api.quickrouter.ai/v1/chat/completions",
    "apiKey": "sk-你的QuickRouter令牌",
    "model": "claude-opus-4-8",
    "maxInputTokens": 200000
  }
}

第 3 步：重启 WorkBuddy 并切换模型

保存配置后重启 WorkBuddy。在 WorkBuddy 内切换到刚添加的 QuickRouter 模型，发送一条测试消息验证是否正常返回。

四、可选模型参考

把 model 字段改成 QuickRouter token 已放行的模型即可，常用模型名：

claude-opus-4-8
claude-fable-5
gpt-5.5
grok-4.5
deepseek-v4-pro
glm-5.2

五、常见问题排查

WorkBuddy API 中转配置要点

如果你通过搜索「WorkBuddy 配置第三方大模型 api 教程」「WorkBuddy 接入中转站」「WorkBuddy models.json 配置」进入本页，优先检查三件事：接口地址（url）是否以 /v1/chat/completions 结尾、API Key 是否有效、model 字段是否是 QuickRouter 价格页上的完整模型名。多数调用失败都和这三项有关。

相关入口

• API 中转站说明
• OpenAI API 中转配置
• Claude API 国内使用
• 模型价格和分组