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

二、接入 GPT / Codex 模型
1. 添加提供商
进入 模型服务,点击左侧列表底部的 「+ 添加」,在弹出的「添加提供商」对话框中填写:
- 提供商名称:自定义,例如
CCTQ-GPT - 提供商类型:选择
OpenAI-Response
填好后点击 确定。

2. 填写密钥与地址
在新建的提供商页面填写:
- API 密钥:你的令牌 Key
- API 地址:填
https://www.cctq.ai/v1(下方预览会自动显示https://www.cctq.ai/v1/responses)
填好后点击右侧 「获取模型列表」。

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

添加完成后,提供商下即可看到已启用的模型。

4. 选择模型并对话
回到 首页 聊天界面,点击顶部的模型选择器,在 CCTQ-GPT 分组下选择刚添加的模型。

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

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

2. 填写密钥与地址
- API 密钥:你的令牌 Key
- API 地址:同样填
https://www.cctq.ai/v1(下方预览会自动显示https://www.cctq.ai/v1/messages)
填好后点击右侧 「获取模型列表」。

3. 添加模型
在模型列表中找到需要的模型(如 claude-sonnet-5),点击右侧 「+」 添加。

添加完成后,提供商下即可看到已启用的 Claude 模型。

4. 选择模型并对话
回到 首页 聊天界面,点击顶部的模型选择器,在 CCTQ-Claude 分组下选择刚添加的模型。

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

