Chatbox 配置教程
本教程基于 Chatbox v1.21.1(Windows)演示,其他版本界面可能略有差异。
关于外接兼容性
任何第三方外接客户端,与官方接口对接时存在较多兼容性差异。本教程仅演示基础接入方式,无法保证每一个模型 / 智能体都能完美运行、零报错。如遇个别模型或功能不兼容,属正常现象,可尝试更换模型或参考官方文档调整。
优先推荐在官方推出的产品中使用对应模型。
在 Chatbox 中 GPT 与 Claude 走不同的接口类型,需要分别添加两个提供商。二者填写的 API 主机不同,请注意区分。
一、打开设置
打开 Chatbox,点击左下角的 设置。

二、接入 GPT / Codex 模型
1. 添加提供商
进入 模型提供方,点击左侧列表底部的 「+ 添加」。

在弹出的搜索框中,点击 「添加自定义提供商」(配置自定义 OpenAI 兼容服务商)。

在「添加模型提供方」对话框中填写:
- 名称:自定义,例如
CCTQ-GPT - API 模式:选择
OpenAI Responses API 兼容
填好后点击 添加。

2. 填写密钥与地址
在提供方页面填写:
- API 密钥:你的令牌 Key
- API 主机:填
https://www.cctq.ai(不带/v1) - API 路径:保持默认
/responses(下方预览会自动显示https://www.cctq.ai/v1/responses)
填好后点击右侧 「获取」。

在弹出的模型列表中,找到需要的模型(如 gpt-5.6-sol),点击右侧 「+」 添加。

添加完成后即可看到已启用的模型,点击右上角 ESC / × 关闭设置。

3. 选择模型并对话
回到主界面,点击右下角的模型选择器,在 CCTQ-GPT 分组下选择刚添加的模型(如 gpt-5.6-sol),再点击 「新对话」。

随便发送一条消息(如「你好」),能收到正常回复即表示配置成功。

三、接入 Claude 模型
Claude 走 Claude 接口,需要再新建一个提供商,步骤与上面一致,仅「API 模式」与「API 主机」不同。
1. 添加提供商
同样进入 模型提供方 → 底部 「+ 添加」 → 「添加自定义提供商」,在对话框中填写:
- 名称:自定义,例如
CCTQ-Claude - API 模式:选择
Claude API 兼容
填好后点击 添加。

2. 填写密钥与地址
- API 密钥:你的令牌 Key
- API 主机:填
https://www.cctq.ai/v1(注意此处要带/v1,与 GPT 不同) - API 路径:保持默认
/messages(下方预览会自动显示https://www.cctq.ai/v1/messages)
填好后点击右侧 「获取」。

在模型列表中找到需要的模型(如 claude-opus-4-8),点击右侧 「+」 添加。

添加完成后即可看到已启用的 Claude 模型,点击右上角 ESC / × 关闭设置。

3. 选择模型并对话
回到主界面,点击右下角的模型选择器,在 CCTQ-Claude 分组下选择刚添加的模型(如 claude-opus-4-8),再点击 「新对话」。

随便发送一条消息(如「你好」),能收到正常回复即表示配置成功。

