WorkBuddy 自定义模型

WorkBuddy 自定义模型怎么接 QCode.cc:国内版与国际版入口、models.json 路径、接口地址怎么填、错误码 4100,可用 GPT 与国产模型。

更新于 2026-11-10

需要 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 接入说明也是同一条路径。

  1. 国内版:启动 WorkBuddy → 左下角账户 → 设置 → 左侧选 模型;国际版:Avatar > System Settings > Models
  2. 在自定义模型里点 添加模型
  3. 提供商选 自定义 / Custom
  4. 按表填写后保存,再在对话页的模型选择器里选中刚加的模型
  5. 国际版官方还有 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

  1. 接口地址填 https://api.qcode.cc/openai/v1/chat/completions(自定义协议关闭时填 https://api.qcode.cc/openai/v1 也可以)
  2. 自定义协议开启时只能填完整路径;只填到 /openai/v1 会原样发出、缺少 /chat/completions
  3. 保留 /v1,末尾不要 /
  4. 不要误填 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,配额规则见 计费说明。

下一步

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

开始使用 QCode

一把 API Key 同时用于 Claude Code、Codex 等工具;按 token 计费,各模型单价见 qcode.cc/models

企业团队版 →