CodeBuddy 自定义模型：models.json 怎么写、url 怎么填（2026 年 11 月）
能。截至 2026-11-10，CodeBuddy 官方《models.json 配置指南》写明：自定义模型写在用户级 ~/.codebuddy/models.json（项目级是项目根目录下的 .codebuddy/models.json），目前仅支持 OpenAI 接口格式，CLI 另可把 api 设为 openai-responses。按 CodeBuddy Code 2.182.0 实测，不登录腾讯账号即可调用 QCode：Chat 条目的 url 填完整路径 https://api.qcode.cc/openai/v1/chat/completions，Responses 条目的 url 填 https://api.qcode.cc/openai/v1，环境变量 CODEBUDDY_BASE_URL 填 https://api.qcode.cc/openai/v1，三种都通过。
更新于 2026-11-10
把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
四条要点：官方文档与 2026-11-10 实测
CLI 2.182.0 实测通过
截至 2026-11-10，按 CodeBuddy Code 2.182.0 实测：不登录腾讯账号，models.json 里的 Chat 与 Responses 条目、环境变量 CODEBUDDY_BASE_URL 都能调用 QCode。Key 用 cr_ 开头的 QCode Key，按 token 计费，各模型单价见 /models。
Chat 的 url 要写到 /chat/completions
官方原文：「url 字段必须是接口完整路径,一般以 /chat/completions 结尾」，https://api.openai.com/v1 列在错误示例里。所以 QCode 的 Chat 条目填 https://api.qcode.cc/openai/v1/chat/completions；只写到 /v1 时请求路径不完整。
加了 api 字段，url 只写 base
CLI 文档：api 设为 openai-responses 后，请求发往 {url}/responses，url 填 base URL，末尾带不带 /responses 都可以。QCode 填 https://api.qcode.cc/openai/v1，型号用 GPT，例如 gpt-6.1-terra。IDE 的字段表没有 api，Responses 条目写给 CLI 用。
IDE 读同一份文件，apiKey 写密钥本身
IDE 文档写的是同样的文件路径与 Chat 字段，apiKey 的说明是「实际密钥值，非环境变量名」；CLI 的 apiKey 与 url 支持 ${VAR_NAME} 引用。IDE 与 CLI 共用一份 ~/.codebuddy/models.json 时，每个条目都直接写 cr_ 开头的密钥，CLI 同样接受。
CodeBuddy 能不能用自己的 API Key？
能。截至 2026-11-10，CodeBuddy 官方《models.json 配置指南》写明，自定义模型写在 models.json：用户级 ~/.codebuddy/models.json 适用于所有项目，项目根目录下的 .codebuddy/models.json 优先级更高；目前仅支持 OpenAI 接口格式的 API，CLI 另支持把 api 设为 openai-responses。CodeBuddy 是腾讯云的 AI 编程工具，腾讯云产品概述写它同时支持插件、IDE 和 CLI 三种编程形态：插件装进 VS Code 或 JetBrains 系列，CodeBuddy IDE 是独立 IDE，CodeBuddy Code 是命令行工具（命令 codebuddy）。国内站 codebuddy.cn 与国际站 codebuddy.ai 的文档里，models.json 路径相同。这条协议在 QCode 上可用 GPT 与国产型号（DeepSeek、GLM、Kimi、Qwen）；需要 Claude 的读者，可用支持 Anthropic 端点的 Claude Code、ZCode 或 Qoder，同一把 Key 通用。同一团队的办公产品 WorkBuddy 同样走 OpenAI Chat Completions，models.json 路径不同，见 /workbuddy-guide。
截至 2026-11-10：CLI v2.180.0 起自定义模型不带平台身份请求头
国际站 CLI 版本历史把 v2.180.0 记在 2026-11-04、v2.182.0 记在 2026-11-09。v2.180.0 发布说明写明「自定义模型不再携带平台身份请求头」：自定义模型直连第三方端点时，身份信息不再随请求发往用户自配的服务。国内站 IDE 版本历史的最新一条是 4.12.4（2026-11-06），models.json 的文档路径不变。截至 2026-11-10，按 CodeBuddy Code 2.182.0 实测，不登录腾讯账号即可通过 OpenAI Chat 与 Responses 调用 QCode。
时间线
国际站 CLI 版本历史记下 v2.180.0；该版发布说明写明自定义模型不再携带平台身份请求头。
国际站 CLI 版本历史记下 v2.182.0，即本页实测所用的版本。
按 CodeBuddy Code 2.182.0 实测：Chat 的完整路径、Responses 的 /openai/v1、CODEBUDDY_BASE_URL 三种写法都调用 QCode 成功，全程未登录腾讯账号。
官方文档写明的，和由 2026-11-10 实测补上的
CodeBuddy 官方文档写明的
① 文件位置：用户级 ~/.codebuddy/models.json 适用于所有项目；项目级是项目根目录下的 .codebuddy/models.json，优先级更高。按项目级、用户级、内置默认配置的顺序合并：相同 id 覆盖，不同 id 追加；项目级的 availableModels 完全覆盖用户级，不合并。② 目前仅支持 OpenAI 接口格式的 API；Chat 的 url 必须是接口完整路径，一般以 /chat/completions 结尾。③ 字段：id（必填）、name、vendor、apiKey、url、maxInputTokens、maxOutputTokens、supportsToolCall、supportsImages、supportsReasoning；CLI 另有 api、temperature（0-2）与 relatedModels。④ api 设为 openai-responses 后改走 OpenAI Responses API，请求发往 {url}/responses；只有模型配置里显式写的 api 会切换协议。⑤ CLI 的 apiKey 与 url 支持 ${VAR_NAME}，在 CLI 启动时解析；变量不存在时保留原始占位符，API 调用会失败。⑥ 建议把 models.json 的权限设为 600，不要把含实际密钥的配置文件提交到版本控制。⑦ 配置文件支持热重载，有 1 秒防抖；通过 models.json 添加的模型自动带 custom 标签。⑧ CLI 环境变量：CODEBUDDY_API_KEY 在非交互模式 (-p) 下始终使用；CODEBUDDY_BASE_URL 覆盖 API 端点地址，通常与 CODEBUDDY_API_KEY 配合使用；CODEBUDDY_MODEL 覆盖默认代理模型。
文档没写清、由 2026-11-10 实测补上的
截至 2026-11-10，按 CodeBuddy Code 2.182.0 实测：① CODEBUDDY_BASE_URL 走 OpenAI Chat，CLI 会在地址后补 /chat/completions，所以填 https://api.qcode.cc/openai/v1，--model 选 GPT 或国产型号 ID；这条路线不需要 models.json。② 用 models.json 和用 CODEBUDDY_BASE_URL 都不需要先登录腾讯账号。③ Responses 条目的 url 填 https://api.qcode.cc/openai 也能调通；上文与 QCode 接入文档统一用 https://api.qcode.cc/openai/v1，与 CODEBUDDY_BASE_URL 的写法一致。④ IDE 的写法依据官方 IDE 文档。
IDE 与 CLI：同一份 models.json，写法差两处
CodeBuddy IDE（依据官方文档）
读同样的 ~/.codebuddy/models.json 与项目级文件。Chat 条目的 url 写完整路径 https://api.qcode.cc/openai/v1/chat/completions；apiKey 直接写 cr_ 开头的密钥（IDE 文档：实际密钥值，非环境变量名）；字段表没有 api。在模型下拉里，自定义条目带 custom 标签。
CodeBuddy Code CLI（2.182.0 实测）
Chat 条目同样写完整路径；加了 api: openai-responses 的条目，url 只写 https://api.qcode.cc/openai/v1，型号用 GPT；apiKey 可以写成 ${QCODE_API_KEY}。也可以不写 models.json，只设 CODEBUDDY_BASE_URL=https://api.qcode.cc/openai/v1 与 CODEBUDDY_API_KEY。
怎么在 CodeBuddy 里接上 QCode
① 装 CLI（只用 IDE 可跳过，IDE 到 codebuddy.cn 或 codebuddy.ai 下载）：官方前置要求 Node.js 18.20 或更高，运行 npm install -g @tencent-ai/codebuddy-code，再用 codebuddy --version 确认（本页实测为 2.182.0）。② 新建 ~/.codebuddy/models.json，在 models 数组里写一个 Chat 条目：id 填 deepseek-v4-flash，name 自定，vendor 填 QCode，url 填 https://api.qcode.cc/openai/v1/chat/completions，apiKey 填 ${QCODE_API_KEY}（CLI）或 cr_ 开头的密钥本身（IDE），supportsToolCall 填 true，maxInputTokens 与 maxOutputTokens 按所选模型的实际能力填。③ 要用 Responses（CLI），再加一个条目：id 填 gpt-6.1-terra，api 填 openai-responses，url 填 https://api.qcode.cc/openai/v1，其余字段同上。④ CLI：先 export QCODE_API_KEY=cr_xxx，再运行 codebuddy -p 加一句短提示，并用 --model 指定条目的 id，回复正常即配通。IDE：打开模型下拉，选带 custom 标签的条目发一句消息。⑤ 按官方建议把文件权限设为 600，不要把含真实密钥的文件提交到版本控制。中国大陆网络可把 api.qcode.cc 换成 asia.qcode.cc，路径不变。
用 QCode 的 API Key 跑 CodeBuddy
截至 2026-11-10，一把 QCode API Key 同时提供 Anthropic 与 OpenAI 两种兼容接口。CodeBuddy 的自定义模型走 OpenAI 接口：Chat 条目的 url 写完整路径 https://api.qcode.cc/openai/v1/chat/completions，Responses 条目与 CODEBUDDY_BASE_URL 写到 https://api.qcode.cc/openai/v1。这条协议在 QCode 上可用 GPT 与国产型号，常用的有 gpt-6.1-sol、gpt-6.1-terra、deepseek-v4-flash、deepseek-v4-pro、glm-5.3、kimi-k3、qwen3.8-max；Claude 型号走 Anthropic 端点 https://api.qcode.cc/api，在 Claude Code、ZCode、Qoder 等工具里用同一把 Key 即可。按 token 计费，各模型单价见 /models。三步开始：① 注册并充值（支持支付宝等主流支付方式）；② 购买个人套餐或按量包，复制以 cr_ 开头的 API Key；③ 按上文写好 models.json，QCode 文档 https://docs.qcode.cc/docs/ide/codebuddy 有完整 JSON 与验证命令。不想包月？按量包（/pay-as-you-go）¥26 起买一笔额度，7 天内用完为止；已有个人套餐的用户额度不够时买加油包。
常见问题
CodeBuddy 自定义模型在哪里配置？
在 models.json 里。用户级 ~/.codebuddy/models.json 适用于所有项目，项目根目录下的 .codebuddy/models.json 优先级更高，IDE 与 CLI 读同样的路径。截至 2026-11-10，全部字段见官方《models.json 配置指南》；文件支持热重载（1 秒防抖），保存后不必重启。
models.json 的 url 要不要带 /chat/completions？
Chat 条目要带。官方原文：「url 字段必须是接口完整路径,一般以 /chat/completions 结尾」，https://api.openai.com/v1 被列为错误示例，所以 QCode 填 https://api.qcode.cc/openai/v1/chat/completions。写了 api: openai-responses 的条目相反：url 填 base（https://api.qcode.cc/openai/v1），请求发往 {url}/responses，末尾带不带 /responses 都可以。遇到 404 时，先检查 Chat 条目的 url 是否写到了 /chat/completions。
CodeBuddy 要登录才能用自定义模型吗？
不用。截至 2026-11-10，按 CodeBuddy Code 2.182.0 实测，不登录腾讯账号，通过 models.json 和通过 CODEBUDDY_BASE_URL 都能调用 QCode 并返回结果。IDE 的配置依据官方 IDE 文档。另据 v2.180.0 发布说明，自定义模型不再携带平台身份请求头。
CodeBuddy 能用 Claude / GPT 吗？
能用 GPT 与国产型号。CodeBuddy 的自定义模型走 OpenAI 接口，这条协议在 QCode 上可用 GPT 与 DeepSeek、GLM、Kimi、Qwen：Chat 条目可填 gpt-6.1-sol、deepseek-v4-flash、glm-5.3、kimi-k3、qwen3.8-max，CLI 的 Responses 条目可填 gpt-6.1-terra。Claude 型号走 QCode 的 Anthropic 端点 https://api.qcode.cc/api，需要 Claude 时用支持该端点的 Claude Code、ZCode 或 Qoder，同一把 Key 通用。
CODEBUDDY_BASE_URL 怎么填？
填 https://api.qcode.cc/openai/v1，CODEBUDDY_API_KEY 填 cr_ 开头的 QCode Key，--model 填 GPT 或国产型号 ID。截至 2026-11-10，按 CodeBuddy Code 2.182.0 实测，这个变量走 OpenAI Chat，CLI 会在地址后补 /chat/completions，这条路线不需要 models.json；填成 https://api.qcode.cc/api 时请求会发到 /api/chat/completions，QCode 返回 HTTP 400。官方说明：CODEBUDDY_BASE_URL 覆盖 API 端点地址，通常与 CODEBUDDY_API_KEY 配合使用；CODEBUDDY_MODEL 覆盖默认代理模型。
CodeBuddy 和 WorkBuddy 的 models.json 一样吗？
路径不一样。WorkBuddy 官方写明它与编程方向的 CodeBuddy 共享同一底座；国内版把配置保存在本地 workbuddy/models.json，并写明已通过 ~/.codebuddy/models.json 配置的自定义模型在界面升级后仍可正常使用；国际版默认文件是 ~/.workbuddy-ai/models.json。WorkBuddy 的自定义模型同样走 OpenAI Chat Completions，手写时 url 也填完整路径 https://api.qcode.cc/openai/v1/chat/completions，入口与界面步骤见 /workbuddy-guide。
资料来源
CodeBuddy：codebuddy.cn 与 codebuddy.ai 的《models.json 配置指南》（IDE 与 CLI）、CLI 环境变量页与安装页、CLI v2.180.0 发布说明与国际站版本历史、国内站 IDE 版本历史、腾讯云 CodeBuddy 产品概述；WorkBuddy：workbuddy.cn 与 workbuddy.ai 的模型配置页、workbuddy.cn/llms.txt。均于 2026-11-10 核对。QCode：接入点与 API 格式文档、CodeBuddy 接入文档、qcode.cc/models 的在售型号。CLI 实测：CodeBuddy Code 2.182.0，2026-11-10。
相关阅读
按量包
一次买一笔额度，7 天有效，不订阅；续买累加到同一把 Key
腾讯 WorkBuddy 指南
办公多 Agent 概览、Custom API 角度与编程工具边界
ZCode 自定义模型怎么设置，怎么接入 Claude 与国产模型（2026-11）
ZCode 能用自己的 API Key：桌面版 Add Provider 与 CLI provider_config.json 怎么填，Anthropic、OpenAI Chat、Responses 地址要不要带 /v1，CLI 0.17.1 实测结论。
加密货币充值指南
9 种币、56 条网络，0 平台手续费购买 AI 编程 API 额度。
本页于 2026-11-10 对照 CodeBuddy 官方文档核对，QCode 接入按 CodeBuddy Code CLI 2.182.0 实测；IDE 写法依据官方 IDE 文档。QCode.cc 与腾讯、CodeBuddy 无隶属关系。界面与字段以你安装的版本为准，型号以 /models 为准。