WorkBuddy 集成

把 QCode.cc 配成腾讯 WorkBuddy 的自定义模型：图形界面填 URL / API Key / 模型名，一把 cr_ 密钥调用 Claude、GPT 与国产模型

WorkBuddy 集成 ¶

WorkBuddy 是腾讯云推出的桌面 AI 智能体，偏办公交付（纪要、表格、PPT、轻度代码），和 CodeBuddy（IDE / CLI 编程助手）同属一个产品族。它不是 Claude Code 的替代品：仓库级重构、测试、CI 仍应走 Claude Code 或 Codex CLI。

本文只讲一件事：把 QCode.cc 配成 WorkBuddy 的自定义模型，让同一把 cr_ 密钥在 WorkBuddy 里调用我们在售的 Claude / GPT / GLM / Kimi / DeepSeek / Qwen。

QCode.cc 与腾讯、WorkBuddy、CodeBuddy 均无隶属关系。界面文案以你安装的 WorkBuddy 版本为准；字段含义以官方模型配置为准。

前置条件 ¶

已安装 WorkBuddy（官网：codebuddy.cn/work；安装步骤见官方 Mac / Windows 指南）
拥有 QCode.cc API Key（cr_ 开头），在控制台获取
同一把 Key 三种协议都能用。WorkBuddy 的自定义模型走 OpenAI Chat Completions，对应 QCode 的 /openai/v1/chat/completions。协议与 BASE_URL 口径见接入点与 API 格式

用图形界面接入（推荐）¶

官方模型页写明：自定义模型应通过设置页的可视化界面添加，不必手改配置文件。腾讯云 TokenHub 的 WorkBuddy 接入说明也是同一条路径。

启动 WorkBuddy → 左下角账户 → 设置
左侧选模型 → 自定义模型里点 添加模型
提供商选 自定义 / Custom
按表填写后保存，再在对话页的模型选择器里选中刚加的模型

字段	填写值	说明
提供商	`自定义` / `Custom`	不要选腾讯云 Token Plan 等内置套餐
接口地址	`https://api.qcode.cc/openai/v1`	中国大陆优先 `https://asia.qcode.cc/openai/v1`
API Key	你的 QCode.cc 密钥（`cr_` 开头）	不要带前后空格
模型名称	例如 `claude-sonnet-5`	必须是 qcode.cc/models 上的真实 id，逐字符一致
高级能力	按需勾选「工具调用」「图片格式」「推理模式」	TokenHub 官方示例建议按任务需要勾选，不是强制

同一把 Key 可以加多条自定义模型，只改「模型名称」，接口地址和 Key 保持不变。例如再加一条 glm-5.2、一条 deepseek-v4-pro。

接口地址怎么填（自定义协议）¶

官方「自定义协议」开关的行为是：

开关	行为
关闭（默认）	使用标准 `/chat/completions` 路径，自动校验并补全接口地址
开启	按你填写的 URL 原样发请求，跳过路径校验与自动补全

因此默认应填到 /openai/v1 为止（与环境变量配置里 OpenAI 兼容工具的 OPENAI_BASE_URL 一致），让 WorkBuddy 自己补 /chat/completions。

不要在默认关着「自定义协议」时把地址写成 .../openai/v1/chat/completions，可能被再拼一次路径而 404
如果默认补全后请求失败，再按 TokenHub 官方示例的写法，把完整地址 https://api.qcode.cc/openai/v1/chat/completions 填进去，并打开「自定义协议」
末尾不要带 /，原因与其它 SDK 相同：多一个斜杠会拼出 //chat/completions

四个接入域业务能力相同，只是网络路由不同。同一把 Key 通用：

节点	接口地址（自定义协议关闭时）
国际（Route 53）	`https://api.qcode.cc/openai/v1`
亚洲（大陆推荐）	`https://asia.qcode.cc/openai/v1`
美国	`https://us.qcode.cc/openai/v1`
欧洲	`https://eu.qcode.cc/openai/v1`

配置存在哪、会不会上传 ¶

官方说明：

配置参数（含 API Key）只保存在本地 workbuddy/models.json，不上传云端
旧版通过 ~/.codebuddy/models.json 配过的自定义模型，界面升级后仍可用，并可以在 UI 里查看 / 编辑 / 删除
自定义模型产生的 Token 费用由你向第三方（这里是 QCode.cc）支付，不走 WorkBuddy 内置积分

本页不提供手写 models.json 的字段模板。官方已改为 UI 为主；字段名以你本机版本和官方模型配置为准。需要批量改时，先在 UI 里加一条，再对照本地文件，不要从第三方博客抄 schema。

模型 id	当时单价（输入 / 输出）	上下文 / 输出	适合
`claude-sonnet-5`	$2.00 / $10.00	1M / 128K	日常默认。新一代平衡档
`claude-opus-5`	$5.00 / $25.00	1M / 128K	复杂推理、长文稿、难拆的任务
`claude-sonnet-4-6`	$3.00 / $15.00	1M / 64K	仍在售的上一代 Sonnet，可当对照
`gpt-5.6-terra`	$2.00 / $12.00	400K / 128K	GPT 系日常档
`glm-5.2`	$1.40 / $4.40	200K / 131K	智谱旗舰，中文办公常见
`kimi-k3`	$3.00 / $15.00	1M / 131K	月之暗面旗舰，长上下文
`deepseek-v4-pro`	$0.43 / $0.87	1M / 384K	DeepSeek 旗舰，单价最低的一档之一
`qwen3.7-max`	$2.50 / $7.50	1M / 131K	通义旗舰

验证 ¶

先确认 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 仍报错时，按上一节核对：接口地址有没有多余的 /chat/completions 或尾斜杠、自定义协议开关是否与填写方式匹配、模型 id 是否逐字符等于上表。

常见问题 ¶

保存后模型选择器里看不到 ¶

完全退出 WorkBuddy 再打开（不要只关窗口留托盘）。官方称配置保存后会持久化；若仍没有，到设置 → 模型里确认这条自定义模型还在，没有被删。

请求 404 ¶

自定义协议关闭时，接口地址填 https://api.qcode.cc/openai/v1，不要自己加上 /chat/completions
自定义协议开启时，填完整 https://api.qcode.cc/openai/v1/chat/completions
末尾不要 /
不要误填 https://api.qcode.cc/api（那是 Anthropic Messages 前缀）

接入点与 API 格式 — 三种协议、四个域名、BASE_URL 对照
CC Switch 配置 — 在 Claude Code / Codex 之间切换同一把 Key
模型选择指南 — 日常默认用哪一档
计费说明 — 套餐与配额
实时型号与单价：qcode.cc/models

还没有 QCode.cc API Key？前往 qcode.cc/pricing 选套餐。

WorkBuddy 集成