Cherry Studio

Cherry Studio 支持 OpenAI 兼容服务。下面以手动配置为准，不同版本的菜单名称可能略有变化。

准备信息

• API 密钥：在控制台创建的令牌；
• API 地址：https://coffeecatbox.cc；
• OpenAI Base URL：https://coffeecatbox.cc/v1；
• 模型名称：从控制台模型广场复制。

配置步骤

1. 打开 Cherry Studio，进入 设置 → 模型服务。
2. 添加服务商，选择 OpenAI 或 OpenAI 兼容。
3. 在 API 密钥中粘贴令牌。
4. Base URL 填写 https://coffeecatbox.cc/v1。
5. 添加模型，模型 ID 必须与控制台显示完全一致。
6. 点击连接检查；成功后保存。
7. 新建对话并选择刚添加的模型。

控制台一键导入

登录猫咖啡 API 控制台后，令牌页面可能提供 Cherry Studio 快捷导入。使用后仍建议检查 Base URL 和模型列表是否正确。

连接测试失败

404 或路径错误

查看客户端日志中的请求地址。如果出现：

https://coffeecatbox.cc/v1/v1/chat/completions

说明客户端和配置都追加了 /v1。把 Base URL 改为 https://coffeecatbox.cc 后重试。

模型不存在

不要凭记忆输入模型名。回到控制台模型广场复制准确标识，并检查令牌的模型限制。

401 未授权

重新复制令牌，确认没有多余空格、引号或换行。仍失败时创建新令牌测试。

推荐设置

• 为 Cherry Studio 单独创建令牌；
• 开启流式输出以更快看到首字；
• 图片对话选择支持视觉输入的模型；
• 长对话定期新建会话，控制上下文费用。