WorkBuddy 自定义模型
WorkBuddy 自定义模型怎么接 QCode.cc:国内版与国际版入口、models.json 路径、接口地址怎么填、错误码 4100,可用 GPT 与国产模型。
需要 API Key? 前往注册 →端点与 Base URL →
本页目录
最后核实:2026-11-10 · 📄 依据官方文档(国内站 workbuddy.cn 更新日志最新条目 5.11.0(2026-11-03,灰度中);国际站 workbuddy.ai 更新日志最新条目 5.9.4)
接入速览¶
| 项目 | 说明 |
|---|---|
| 能不能用自己的 key | 能。桌面端在设置页「模型」里选 自定义 / Custom,手动填 URL、API Key 与模型名 |
| 可用模型 | Claude ❌(自定义模型仅 OpenAI Chat Completions)· GPT ✅ · 国产 ✅ · Gemini ❌ |
| 协议与接口地址 | OpenAI Chat Completions:填完整路径 https://api.qcode.cc/openai/v1/chat/completions(「自定义协议」关闭时只填到 https://api.qcode.cc/openai/v1 也可以) |
| 国内版(workbuddy.cn) | 设置页「模型」;配置保存在 workbuddy/models.json,兼容 ~/.codebuddy/models.json |
| 国际版(workbuddy.ai) | Avatar > System Settings > Models;配置文件 ~/.workbuddy-ai/models.json |
| 移动端 | 没有自定义模型入口 |
| 官方文档 | 国内:模型配置 · 国际:Model Configuration |
WorkBuddy 是腾讯云 CodeBuddy 团队推出的桌面 AI 智能体,偏办公交付(纪要、表格、PPT、轻度代码),国际站是 workbuddy.ai。官方 llms.txt 写明它「与编程方向的 CodeBuddy 共享同一底座」;CodeBuddy(IDE / CLI 编程助手)的 QCode 接入见 CodeBuddy 自定义模型。它不是 Claude Code 的替代品:仓库级重构、测试、CI 仍应走 Claude Code 或 Codex CLI。
本文只讲一件事:把 QCode.cc 配成 WorkBuddy 的自定义模型,让同一把 cr_ 密钥在 WorkBuddy 里调用我们在售的 GPT / GLM / Kimi / DeepSeek / Qwen。
在 QCode 上可用 GPT 与国产型号。 WorkBuddy 的自定义模型走 OpenAI Chat Completions 协议,这条协议在 QCode 上可用 GPT 与国产型号(DeepSeek / GLM / Kimi / Qwen)。Claude 型号走 QCode 的 Anthropic 端点(
https://api.qcode.cc/api),WorkBuddy 的自定义模型不走该协议;在 OpenAI 端点填claude-…会返回model_not_available_on_endpoint。需要 Claude 时,请用支持 Anthropic 端点的工具,例如 Claude Code、 ZCode、Qoder。详见 接入点与 API 格式。
QCode.cc 与腾讯、WorkBuddy、CodeBuddy 均无隶属关系。界面文案以你安装的 WorkBuddy 版本为准;字段含义以官方模型配置为准(国内 · 国际)。国际站官方写明:Custom model integration currently uses the OpenAI-compatible Chat Completions API。
前置条件¶
- 已安装桌面版 WorkBuddy(国内版 workbuddy.cn,国际版 workbuddy.ai;安装步骤见官方 Mac / Windows 指南)。移动端没有自定义模型入口,见下文「常见问题」
- 拥有 QCode.cc API Key(
cr_开头),在 控制台 获取 - 同一把 Key 三种协议都能用。WorkBuddy 的自定义模型走 OpenAI Chat Completions,对应 QCode 的
/openai/v1/chat/completions。协议与BASE_URL口径见 接入点与 API 格式
用图形界面接入(推荐)¶
官方模型页写明:自定义模型可通过可视化界面配置,支持添加、编辑和删除,无需手动编辑配置文件。国内版官方原文:「如果你的模型服务不在上方列表中,可选择自定义/Custom,手动填写 URL、API Key 与模型名接入」。腾讯云 TokenHub 的 WorkBuddy 接入说明也是同一条路径。
- 国内版:启动 WorkBuddy → 左下角账户 → 设置 → 左侧选 模型;国际版:
Avatar > System Settings > Models - 在自定义模型里点 添加模型
- 提供商选 自定义 / Custom
- 按表填写后保存,再在对话页的模型选择器里选中刚加的模型
- 国际版官方还有 Test Connection(Checks whether the API can respond),保存前先测一次;官方提醒保存成功不等于连接成功
| 字段 | 填写值 | 说明 |
|---|---|---|
| 提供商 | 自定义 / Custom |
不要选腾讯云 Token Plan 等内置套餐 |
| 接口地址 | https://api.qcode.cc/openai/v1/chat/completions |
中国大陆优先 https://asia.qcode.cc/openai/v1/chat/completions |
| API Key | 你的 QCode.cc 密钥(cr_ 开头) |
不要带前后空格 |
| 模型名称 | 例如 gpt-6.1-sol |
必须是 qcode.cc/models 上的真实 id,逐字符一致 |
| 高级配置 | 按需勾选「工具调用」「图片输入」「推理模式」 | 可选;国际站官方建议按服务实际支持的能力填写,不要全部打开 |
同一把 Key 可以加多条自定义模型,只改「模型名称」,接口地址和 Key 保持不变。例如再加一条 glm-5.3、一条 deepseek-v4-pro。
接口地址怎么填(自定义协议)¶
官方「自定义协议」开关(在高级配置里)的行为是:
| 开关 | 行为 |
|---|---|
| 关闭(默认) | 使用标准 /chat/completions 路径,自动校验并补全接口地址 |
| 开启 | 按你填写的 URL 原样发请求,跳过路径校验与自动补全 |
国际站官方还写明三点:开关关闭时会把地址规范成以 /chat/completions 结尾,服务商要求的其它路径段不会自动补;开关关闭时既可以填带 /v1 的 base URL,也可以填完整 URL(you can enter the base URL containing /v1 or the full URL when the toggle is disabled);多数情况下不需要打开这个开关。它只改变地址的处理方式,不是通用的协议转换器。
所以接 QCode 时填完整路径 https://api.qcode.cc/openai/v1/chat/completions:开关关闭时它本来就以 /chat/completions 结尾,开关打开时按原样发送,两种状态都对;它也正是手写 models.json 时 url 要填的值(见下文),腾讯云 TokenHub 的 WorkBuddy 接入说明同样填的是以 /v1/chat/completions 结尾的完整地址。WorkBuddy 桌面端最终以连通测试结果为准。
- 开关关闭时只填到
https://api.qcode.cc/openai/v1也可以(与 环境变量配置 里 OpenAI 兼容工具的OPENAI_BASE_URL一致),WorkBuddy 会补/chat/completions - 保留
/v1:WorkBuddy 只补/chat/completions,不会补其它路径段,QCode 的 Chat 路径是/openai/v1/chat/completions - QCode 用的是标准路径,「自定义协议」保持关闭即可;打开时只能填完整路径
- 末尾不要带
/,原因与其它 SDK 相同:多一个斜杠会拼出//chat/completions
三个接入域业务能力相同,只是网络路由不同。同一把 Key 通用:
| 节点 | 接口地址 |
|---|---|
| 国际(Route 53) | https://api.qcode.cc/openai/v1/chat/completions |
| 亚洲(大陆推荐) | https://asia.qcode.cc/openai/v1/chat/completions |
| 北美 / 欧洲 | https://us.qcode.cc/openai/v1/chat/completions |
配置存在哪、会不会上传¶
国内版与国际版的文件路径不同,请分开看(逐字取自两站官方页):
| 版本 | 官方写法 |
|---|---|
| 国内(workbuddy.cn) | 配置参数(含 API Key)仅保存在本地 workbuddy/models.json 中,不上传云端;已通过 ~/.codebuddy/models.json 配置的自定义模型在界面升级后仍可正常使用 |
| 国际(workbuddy.ai) | The default user-level configuration file is ~/.workbuddy-ai/models.json. On Windows, it is located at %USERPROFILE%\.workbuddy-ai\models.json |
国际版官方还写:如果改过用户配置目录,以模型设置页显示的路径为准;含 API Key 的配置文件不要上传到公共仓库。国内站官方页只写了 workbuddy/models.json,没有写出它所在的目录;请以本机实际文件为准,或者直接在界面里管理。
另外:
- 官方「积分消耗说明」写明:自定义模型产生的全部费用由您向第三方支付(这里是 QCode.cc,按 token 计费)
- 官方更新日志:5.1.1 起 models.json 配置热更新,修改后无需重启即可生效
日常管理请用界面,不必改文件。必须手写 models.json 时,字段表和 url 规则见 CodeBuddy 自定义模型。CodeBuddy 官方文档原文:「url 字段必须是接口完整路径,一般以 /chat/completions 结尾」(https://api.openai.com/v1 列为错误示例),所以 QCode 的 url 填 https://api.qcode.cc/openai/v1/chat/completions。同一底座的 CodeBuddy Code CLI 已实测:models.json 的 url 填这个完整路径即可连通(CodeBuddy Code 2.182.0,2026-11-10)。WorkBuddy 自己的文件没有单独的字段表,手写前先在界面里加一条,再对照本地文件,不要从第三方博客抄 schema。
推荐先配哪些模型¶
下列 id 于 2026-11-10 对照 qcode.cc/models 在售清单确认。单价不在本页复制,以 qcode.cc/models 实时值为准(管理员可调费率)。
| 模型 id | 适合 |
|---|---|
gpt-6.1-sol |
GPT 系,复杂编码与专业工作 |
gpt-5.6-terra |
GPT 系日常档 |
glm-5.3 |
智谱旗舰,中文办公常见 |
kimi-k3 |
月之暗面旗舰,长上下文 |
deepseek-v4-pro |
DeepSeek 旗舰 |
qwen3.8-max |
通义旗舰 |
同族里还有更轻的 glm-5.3-flash、deepseek-v4-flash、deepseek-v4.1-flash、qwen3.8-flash、qwen3.7-plus,当前都在售;上一代的 glm-5.1 与 kimi-k2.6 已下架,填了会报错。选型原则见 模型选择指南;不要把未出现在 qcode.cc/models 上的名字填进「模型名称」。
WorkBuddy 这条链路走 OpenAI Chat Completions,不要把 ANTHROPIC_BASE_URL(https://api.qcode.cc/api)填进接口地址——那是 Claude Code / Anthropic SDK 用的前缀。
验证¶
先确认 QCode 的 OpenAI 路径对你的网络是通的(与 接入点与 API 格式 第 4 节同一条自测):
KEY="cr_你的密钥"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
https://api.qcode.cc/openai/v1/chat/completions \
-H "Authorization: Bearer $KEY"
# → 400 = 路径与密钥都通(缺请求体属预期)
# → 401 = 密钥无效;404 = 路径前缀错了
中国大陆把主机换成 asia.qcode.cc 再测一次。然后回到 WorkBuddy,选中刚加的模型发一句「ping」。能收到回复即接入成功。
路径通但 WorkBuddy 仍报错时,按上一节核对:接口地址保留了 /v1、末尾没有斜杠,打开「自定义协议」时填的是以 /chat/completions 结尾的完整路径,模型 id 逐字符等于上表。
常见问题¶
保存后模型选择器里看不到¶
自 5.1.1 起官方更新日志写明 models.json 配置热更新,通常保存即生效;若选择器里仍没有,完全退出 WorkBuddy(不要只关窗口留托盘)再打开,并到设置 → 模型里确认这条自定义模型没有被删。
错误码 4100(自定义模型没有配置接口地址或 API Key)¶
国内站官方错误码页原文:「当前选择的自定义模型没有配置接口地址或 API Key,请求不会发出。」处理方案:点击提示卡片中的「前往配置」,补全该模型的接口地址和 API Key 后再使用;这类模型在模型选择器里会置灰、不能选中,并标有异常图标,补全并保存后即恢复可用,无需重启。官方模型页说明,指向本机的模型(如本地 Ollama)不需要 API Key,不受影响。
手机上找不到自定义模型¶
官方移动端模型页原文:「移动端不提供「配置自定义模型」的入口,模型列表里只列可用的模型。」请在桌面版配置。
国际版和国内版配置要分开吗¶
按官方文档,两个版本的配置文件路径不同(国内 workbuddy/models.json,国际 ~/.workbuddy-ai/models.json),装了哪个版本就在哪个版本里配置;QCode 的地址和密钥在两边填法相同。
请求 404¶
- 接口地址填
https://api.qcode.cc/openai/v1/chat/completions(自定义协议关闭时填https://api.qcode.cc/openai/v1也可以) - 自定义协议开启时只能填完整路径;只填到
/openai/v1会原样发出、缺少/chat/completions - 保留
/v1,末尾不要/ - 不要误填
https://api.qcode.cc/api(那是 Anthropic Messages 前缀)
请求 401¶
密钥必须是 cr_ 开头、无空格。到 qcode.cc/dashboard 确认密钥有效。WorkBuddy 把 Key 存在本地,换 Key 后要回到这条自定义模型里改,不会自动同步。
模型名填了但回复很怪 / 直接失败¶
「模型名称」必须是本端点在售 id,例如 gpt-5.6-terra,不是展示名「GPT 5.6 Terra」,也不是其它平台的别名。实时清单:qcode.cc/models 或带密钥 GET https://api.qcode.cc/openai/v1/models(这条列表才是 WorkBuddy 能填的集合,不含 Claude)。
会不会把对话上传给腾讯?¶
官方模型页的口径:WorkBuddy 在自定义模型场景下是通信链路,把输入转发到你配置的第三方;API Key 仅本地保存。具体以 官方模型配置 和腾讯用户协议为准。发到 QCode 的请求可在 probe.qcode.cc 用同一把 Key 查看。
WorkBuddy 能替代 Claude Code 吗?¶
不能当作一对一替换。WorkBuddy 优化办公多 Agent 交付;Claude Code / Codex 优化仓库内编码循环。可以同时用:办公文档走 WorkBuddy,改代码走 CC Switch 切到的 Claude Code,两套工具共用一把 QCode Key,配额规则见 计费说明。
下一步¶
- 接入点与 API 格式 — 三种协议、三个域名、
BASE_URL对照 - CodeBuddy 自定义模型 — 同一团队的编程工具,
models.json字段表与 Responses 写法 - CC Switch 配置 — 在 Claude Code / Codex 之间切换同一把 Key
- 模型选择指南 — 日常默认用哪一档
- 计费说明 — 套餐与配额
- 实时型号与单价:qcode.cc/models
还没有 QCode.cc API Key?前往 qcode.cc/pricing 选套餐。
开始使用 QCode
一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models