WorkBuddy 集成

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

更新于 2026-09-25

本页目录

接入速览
前置条件
用图形界面接入（推荐）
- 接口地址怎么填（自定义协议）
- 配置存在哪、会不会上传
推荐先配哪些模型
验证
常见问题
下一步

最后核实：2026-09-18 · 📄 依据官方文档（WorkBuddy 5.5.6（官网 2026-09 查阅；Win10+ / macOS 12+，无 Linux 桌面包））

接入速览 ¶

项目	说明
可用模型	Claude ❌（自定义模型仅 OpenAI Chat Completions）· GPT ✅ · 国产 ✅ · Gemini ❌
协议与 Base URL	OpenAI Chat：接口地址填 `https://api.qcode.cc/openai/v1`
配置位置	应用内：设置 → 模型 → 自定义模型（高级工具分组）
官方文档	codebuddy.cn/work

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

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

🔴 WorkBuddy 用不了 Claude 模型。 WorkBuddy 的自定义模型只支持 OpenAI Chat Completions 协议，而 QCode 的 OpenAI 腿不接受 Claude 模型（填 claude-… 会返回 model_not_available_on_endpoint）。因此在 WorkBuddy 里可以正常使用 GPT 系与国产四家族，但不能使用 Claude。要用 Claude，请改用支持 Anthropic 协议的客户端 —— Claude Code、Cline、 Zed 等。详见接入点与 API 格式。

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

前置条件 ¶

已安装 WorkBuddy（Windows 10+ / macOS 12+，无 Linux 桌面包；官网：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_` 开头）	不要带前后空格
模型名称	例如 `gpt-6-sol`	必须是 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`

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

官方说明：

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

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

模型 id	适合
`gpt-5.6-terra`	GPT 系日常档
`glm-5.2`	智谱旗舰，中文办公常见
`kimi-k3`	月之暗面旗舰，长上下文
`deepseek-v4-pro`	DeepSeek 旗舰，单价最低的一档之一
`qwen3.8-max`	通义旗舰

验证 ¶

先确认 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 = 路径前缀错了