使用文档 / Cherry Studio
Cherry Studio
Cherry Studio 桌面端接入教程。
Cherry Studio 适合把多个模型统一接到一个桌面客户端管理,对多数普通用户是最省事的接入方式。
(一) 接入前准备
- 一个可用的
sk-...令牌 - 至少一个准备使用的模型名称
- 已安装的 Cherry Studio 客户端
(二) 添加 玄枢 服务商
打开 Cherry Studio,新增一个自定义服务商,按下面填写:
| 字段 | 建议值 |
|---|---|
| 服务商名称 | 玄枢 |
| 提供商类型 | GPT 模型选 OpenAI;Claude 模型选 Anthropic |
| API Key | 你的 sk-... |
| API 地址 | OpenAI 类填 https://api.ai-trailblazer.com/v1;Claude 类填 https://api.ai-trailblazer.com |
(三) 添加模型
保存后进入模型管理页面,手动把要用的模型加进去:
- GPT / Codex 类(分组
gpt-pro):gpt-6.1-sol、gpt-6-astra、gpt-6-sol、gpt-5.6-terra、gpt-5.6-sol、gpt-5.5、codex-auto-review - Claude 类(分组
CCPro):claude-opus-5-5、claude-opus-5、claude-opus-4-8、claude-opus-4-7、claude-opus-4-6、claude-sonnet-5-5、claude-sonnet-5、claude-sonnet-4-6、claude-sonnet-4-5-20250929、claude-haiku-5-5、claude-haiku-4-5-20251001、claude-fable-5-1、claude-fable-5
(四) 推荐操作顺序
- 打开设置 → 模型服务
- 新增自定义服务商,按上面字段填写
- 保存
- 进入模型管理,手动添加模型名称
- 新建对话并切换到刚添加的模型
常见问题
- 401:Key 填错或已禁用。
- 模型列表为空:Cherry Studio 需手动添加模型名,不会自动拉取。
- 地址别填反:OpenAI 类用
https://api.ai-trailblazer.com/v1,Claude 类用https://api.ai-trailblazer.com。