Cherry Studio 配置教程
已经安装 Cherry Studio 时，优先从 Chutibe API Key 页面 一键打开；如果系统没有唤起应用，再按第二部分手动配置。
一键导入
1. 从 Key 页面打开 Cherry Studio
进入 API Key 页面，找到准备使用的 Key。点击右侧 更多 → 聊天 → Cherry Studio。
浏览器第一次调用 Cherry Studio 时，系统可能询问是否允许打开外部应用。请选择允许。
2. 确认服务商
Cherry Studio 打开后，确认新增服务商已经带入下面两项：
| 配置项 | 应显示 |
|---|---|
| API 地址 | https://api.chutibe.com |
| API Key | 当前选择的 Chutibe Key |
Key 应显示为遮罩内容，不需要再次粘贴。
3. 添加模型并启用
进入新增服务商，点击 管理 获取模型列表；如果没有自动返回模型，就手动添加当前模型目录中的模型 ID。最后打开服务商右上角的启用开关。
新建一个对话并发送短消息。能够正常回复，说明配置完成。
没有打开 Cherry Studio
确认 Cherry Studio 已安装并启动过一次，再回到 Key 页面重试。浏览器拦截外部应用时，允许 cherrystudio:// 协议打开应用。
手动配置
1. 添加服务商
打开 Cherry Studio 的 设置 → 模型服务，滚动到服务商列表底部并点击 添加。名称填写 Chutibe，提供商类型选择 OpenAI。
2. 填写地址和 Key
| 配置项 | 填写内容 |
|---|---|
| API Key | 从 API Key 页面 复制 |
| API 地址 | https://api.chutibe.com |
这里填写根地址，不要追加 /v1 或具体接口路径。Cherry Studio 会根据模型能力拼接请求路径。
3. 获取模型并启用
点击 管理 自动获取模型，或手动输入模型 ID。选择至少一个当前账号可用的模型，保存后打开右上角启用开关。
手动配置后仍然失败
| 现象 | 优先检查 |
|---|---|
401 | Key 是否完整、启用并属于当 前账号 |
404 | API 地址是否错误追加了 /v1 |
| 模型不存在 | 模型 ID 是否在当前账号的可用列表中 |
| 找不到模型 | 点击“管理”重新获取，或手动添加完整模型 ID |