Chatbox 配置 Claude API:自定义提供方与 API Host 填法
截至 2026-11-22,在 Chatbox 1.24.6 里接 QCode 是一条固定路径:Settings → Model Provider → + Add,搜 custom 选 Add Custom Provider,API Mode 选 Claude API Compatible,API Host 填 https://api.qcode.cc/api/v1(Claude 模式不会自动补 /v1,Preview 应是 https://api.qcode.cc/api/v1/messages),API Key 粘 cr_ 开头的 key,点 + New 手填 claude-sonnet-5,Check 出现 Connection successful。要同时用 GPT,就用同一把 key 再建一个 OpenAI API Compatible,Host 填 https://api.qcode.cc/openai/v1,模型 gpt-6.2-sol;2026-11-22 在 Windows 11 上实测。
更新于 2026-11-22
把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费,实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
四个先记住的值
官网 Windows 安装包版本
官网英文下载页的 Windows 64-bit 给的是 Chatbox-1.24.6-Setup.exe,约 230 MiB;GitHub Releases 上标 Latest 的还是 v1.24.4,比官网安装包旧。
Claude 模式的 API Host 要写全
Claude API Compatible 只会把 Host 和 Path 直接拼起来,不会补 /v1。Host 填 https://api.qcode.cc/api/v1,Preview 才是 https://api.qcode.cc/api/v1/messages。
OpenAI 模式的 API Host
同一把 cr_ 开头的 key 再建 OpenAI API Compatible,API Host 填 https://api.qcode.cc/openai/v1,Preview 是 https://api.qcode.cc/openai/v1/chat/completions,模型填 gpt-6.2-sol。
模型 ID 手填,不会自动拉取
模型列表不会自动拉取:点 + New 打开 Edit Model,Model ID 手填 claude-sonnet-5,再点 Save。GPT 那个服务商同样用 + New 手填 gpt-6.2-sol。
Chatbox 接 QCode 走的是自定义提供方
Chatbox 是桌面聊天客户端,接 QCode 要在 Settings 的 Model Provider 里加一个自定义提供方。点列表最底部的 + Add 打开提供方目录,搜索框输入 custom,选 Add Custom Provider,弹窗里填 Name 和 API Mode。API Mode 下拉原样有四项:OpenAI API Compatible(GPT 与国产模型)、OpenAI Responses API Compatible、Claude API Compatible(Claude 系型号,接 QCode 的 Claude 选这一项)、Google Gemini API Compatible。Claude 模型只走 QCode 的 Anthropic 协议端点,所以 Claude 系型号放 Claude API Compatible,GPT 放 OpenAI API Compatible,两者共用同一把 cr_ key。
2026-11-22 核对的版本与连通性
2026-11-22 在 Windows 11 上装的是官网英文下载页给的 Chatbox 1.24.6:Desktop App 里 Windows 一行写着 64-bit,点 Download 后 Downloads 里是 Chatbox-1.24.6-Setup.exe(约 230 MiB);GitHub Releases 页 Downloads 里的 Windows (x64) 也能用,但那里的 Latest 是 v1.24.4,比官网安装包旧。同一天的实测里,Claude API Compatible 的 claude-sonnet-5 与 OpenAI API Compatible 的 gpt-6.2-sol 都 Check 成功,都出现 Connection successful。
实测记录(2026-11-22)
装官网安装包时第一屏选 Only for me (user) 再点 Next,不需要管理员;确认默认安装位置后点 Install,装完勾着 Run Chatbox 点 Finish,程序会自动打开。安装包不弹 SmartScreen、不要 UAC。
Claude 模式接通:API Path 留空,点 + New 手填 claude-sonnet-5,Check 后 Model Test Results 显示 Connection successful,Text Request、Vision Request、Tool Use Request 三项都打勾。回到对话里发 Say hello in one short sentence,几秒后收到 Hello!,下面小字是 claude-sonnet-5 与 tokens。
QCode OpenAI 用同一把 key 接通:API Mode 选 OpenAI API Compatible,模型 gpt-6.2-sol 点 Check 后同样显示 Connection successful。Claude 与 GPT 两个服务商就这样共用一把 cr_ key,不用再配别的东西。
实测能逐字核到的,与三处容易配错的地方
已核实(2026-11-22 在 Windows 11 英文界面上的实测)
- 1版本:官网包 1.24.6(GitHub Latest 是 v1.24.4)。
- 2首启:Only for me (user)、无管理员;Skip guide,不登录。
- 3Claude:Claude API Compatible,Host 填
https://api.qcode.cc/api/v1。 - 4模型:+ New 手填
claude-sonnet-5,Check 后三项打勾。 - 5GPT:OpenAI API Compatible,Host 填
https://api.qcode.cc/openai/v1,模型gpt-6.2-sol。 - 6对话:More Providers (BYOK) 选
claude-sonnet-5,小字是 tokens。
三处容易配错的地方
- 1API Host:Chatbox 的 Claude 类型只把 Host 和 Path 直接拼起来,不会补 /v1,所以要写
https://api.qcode.cc/api/v1,Preview 应是https://api.qcode.cc/api/v1/messages。 - 2欢迎页:不用登录、不用账号,点 Skip guide 就能进去;接 QCode 也不需要 Chatbox 账号,地址和 cr_ key 都在本地配置。
- 3第二个服务商:Add provider 弹窗会记住上一次填过的 Name 和 API Mode,要先清空名字、再显式选回 OpenAI API Compatible,不选就会继承上一个提供方的 Claude 模式。
两种模式:Claude API Compatible 与 OpenAI API Compatible
Claude API Compatible:Claude 系型号
API Mode 选 Claude API Compatible,API Host 填 https://api.qcode.cc/api/v1,API Path 留空,Preview 显示 https://api.qcode.cc/api/v1/messages,模型点 + New 手填 claude-sonnet-5。Claude 模型只走 QCode 的 Anthropic 协议端点,这一栏就是它的入口,别把 Claude 模型填到 OpenAI 那一栏。
OpenAI API Compatible:GPT 与国产模型
API Mode 选 OpenAI API Compatible,API Host 填 https://api.qcode.cc/openai/v1,API Path 留空,Preview 显示 https://api.qcode.cc/openai/v1/chat/completions,模型填 gpt-6.2-sol。它和 Claude 那个服务商共用同一把 cr_ key,但地址不同,两个 Host 别混填。
照做的十步:从下载到第一条回复
- 1打开 chatboxai.app/en/download,Desktop App 里 Windows 一行写着 64-bit,点右边 Download,Downloads 里得到 Chatbox-1.24.6-Setup.exe(约 230 MiB)。
- 2双击安装包,第一屏选 Only for me (user) 点 Next(不需要管理员),确认默认安装位置点 Install,完成时勾着 Run Chatbox 点 Finish。
- 3首次启动的欢迎页点 Skip guide 跳过引导,接 QCode 不用登录、不用账号。
- 4点左下角 Settings,左侧选 Model Provider,点列表最底部的 + Add。
- 5在提供方目录的搜索框输入 custom,选 Add Custom Provider。
- 6Name 填 QCode Claude,API Mode 选 Claude API Compatible,点 Add。
- 7API Host 填
https://api.qcode.cc/api/v1,API Path 不用填,Preview 应变成https://api.qcode.cc/api/v1/messages(Claude 类型不会自动补 /v1)。 - 8把控制台复制的 cr_ 密钥粘到 API Key,框里只显示圆点。
- 9点 + New 打开 Edit Model,Model ID 手填
claude-sonnet-5,点 Save;再点 Check 并选claude-sonnet-5,看到 Connection successful 与 Text Request、Vision Request、Tool Use Request 三项打勾。 - 10新建对话,点右下角模型选择器,More Providers (BYOK) 下选 QCode Claude 的
claude-sonnet-5,发一句 Say hello in one short sentence,几秒后收到 Hello!,下面小字是claude-sonnet-5与 tokens。
QCode 侧的接法:一把 key、两个服务商
同一把 cr_ 开头的 key 可以建两个服务商:Claude 用 Claude API Compatible,API Host 填 https://api.qcode.cc/api/v1;GPT 用 OpenAI API Compatible,API Host 填 https://api.qcode.cc/openai/v1。
Claude 模型只走 Anthropic 协议的端点 https://api.qcode.cc/api,QCode 的 OpenAI 端点对 Claude 模型返回 model_not_available_on_endpoint,所以别把 Claude 模型填到 OpenAI 那一栏。asia.qcode.cc 与 us.qcode.cc 接受完全相同的路径与同一把 key,只需替换 Base URL 里的 api.qcode.cc。
按 token 计费,各模型单价见 /models。同一个 key 到 probe.qcode.cc 可以查看请求是否到达 QCode。不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。
图文教程:在 Chatbox 里接通 QCode
QCode 文档里的 Chatbox 图文教程从下载安装讲到第一条回复,配有截图,跟着做能把 Claude 与 GPT 两个服务商都接通。下面两张截图是连接设置里要核对的界面:第一张看 Claude 模式下的 API Host 与 Preview,第二张看 OpenAI 模式下的 Host、Preview 和模型名。
Chatbox 1.24.6,2026-11-22 实测;截图为英文界面,界面文字随版本变化,以你手上的版本为准。
常见问题
Chatbox 选 Claude API Compatible 后,API Host 填什么?
填 https://api.qcode.cc/api/v1,末尾的 /v1 不能省。Chatbox 的 Claude 类型只会把 Host 和 Path 直接拼起来,不会自动补 /v1,填完看 Preview:正确时显示 https://api.qcode.cc/api/v1/messages。API Path 一栏不用填,灰字提示是 /messages。
Chatbox 的 Preview 里少了 /v1 怎么办?
把 API Host 改成 https://api.qcode.cc/api/v1。Preview 是按 Host 加 /messages 拼出来的,Host 只填到 /api 时 Preview 会是 https://api.qcode.cc/api/messages,那不是 QCode 的 Claude 接口地址。核对三处:API Mode 是 Claude API Compatible、API Host 结尾带 /v1、API Path 留空;改完再点 Check,看到 Connection successful 才算好。
Chatbox 的模型列表是空的,要手动填模型 ID 吗?
要。模型列表不会自动拉取,点 + New 打开 Edit Model,Model ID 手填 claude-sonnet-5,再点 Save。OpenAI 那个服务商同样用 + New 手填 gpt-6.2-sol。模型区另有 Reset 和 Fetch 按钮;接 QCode 按上面的 + New 手填即可。
点 Check 后看到什么才算接通?
出现 Model Test Results 并且写着 Connection successful 才算接通,下面的 Text Request、Vision Request、Tool Use Request 三项都要打勾。Claude 服务商选 claude-sonnet-5 检查,OpenAI 服务商选 gpt-6.2-sol 检查,两个都过了再回对话里用。
用 Chatbox 接 QCode 需要登录 Chatbox 账号吗?欢迎页选哪个?
不需要。首次启动的欢迎页有两张卡片,选 Skip guide 跳过引导,不用登录、不用账号;接 QCode 只要有地址和 cr_ 开头的 key,两者都填在本地设置里。
想同时用 GPT,第二个服务商怎么建?为什么它一打开就是 Claude 模式?
同一把 cr_ key 再走一遍 + Add → 搜 custom → Add Custom Provider,Name 填 QCode OpenAI,API Mode 手动选回 OpenAI API Compatible,API Host 填 https://api.qcode.cc/openai/v1,Preview 是 https://api.qcode.cc/openai/v1/chat/completions,模型 gpt-6.2-sol,再 Check 一次。它一打开就是 Claude 模式,是因为 Add provider 弹窗会记住上一次填过的 Name 和 API Mode;先清空名字、再显式选回 OpenAI API Compatible,不选就会继承上一个提供方的 Claude 模式。
参考来源
2026-11-22 在 Windows 11 英文界面上的实测(Chatbox 1.24.6);Chatbox 官网英文下载页(1.24.6);Chatbox GitHub Releases(Latest 为 v1.24.4);QCode 文档 Chatbox 图文教程。
相关阅读
按量包:不包月,7 天有效
一次购买额度、7 天内按需使用,支持个人套餐随时叠加加油包,各模型单价见 /models。
Cherry Studio 配置 Claude API:2.2.3 的栏位、地址与报错(2026-11)
2.2.3 没有类型下拉:Claude 填 Anthropic 栏 https://api.qcode.cc/api,GPT 填 OpenAI 栏 https://api.qcode.cc/openai,同一把 cr_ key 建两个服务商。
Claude Code 自定义端点配置
两个环境变量、settings.json 写法、apiKeyHelper,以及网页版不走网关的官方限制。
加密货币充值指南
9 种币、56 条网络,0 平台手续费购买 AI 编程 API 额度。
QCode.cc 是独立的 API 接入服务,与 Anthropic、OpenAI、Chatbox 均无隶属关系,也未获其背书。Chatbox 的界面与文案以 chatboxai.app 与官方安装包为准,版本更新后按钮位置和文字可能变化。QCode 在售型号与实时单价以 qcode.cc/models 为准;以上事实核对于 2026-11-22。