Cherry Studio

Cherry Studio 是一个跨平台桌面 AI 客户端，支持 Windows、macOS、Linux，内置多家模型供应商，也能添加自定义 OpenAI 兼容服务商。把 Sakrylle 作为自定义供应商加进去，就可以在它里面直接调用 GPT 与 Claude 模型。

• 官网：https://cherry-ai.com
• 仓库：https://github.com/CherryHQ/cherry-studio
• 官方文档：https://docs.cherry-ai.com

前置准备

1. 安装 Cherry Studio 桌面端
2. 在 Sakrylle 控制台 创建一个 API Key
3. 控制台里查好账户余额是否充足

配置步骤

OpenAI 兼容入口

1. 打开 Cherry Studio，点击左下角 设置（齿轮图标）
2. 进入 模型服务（Model Providers）
3. 滚到列表底部，点击 添加 创建一个新的服务商
4. 弹窗里填：
   • 服务商名称：Sakrylle (OpenAI)
   • 服务商类型：选择 OpenAI
5. 创建完成后，回到该服务商详情页，依次填写：
   • API 秘钥：粘贴你在 Sakrylle 控制台创建的 Key
   • API 地址：https://api.sakrylle.com/v1
6. 点击 API 秘钥栏右侧的 检查 按钮做连通性测试，应当返回成功
7. 在下方 模型 区域点击 管理，把要用的模型加入：
   • gpt-5.6-sol（推荐默认）
   • gpt-5.4、gpt-5.5 等按需添加
8. 右上角的开关确保该服务商处于 启用 状态

Anthropic 原生入口

Cherry Studio 1.9 起，新增 Anthropic 类型的服务商。如果你想用原生 Claude API：

1. 同上 添加 服务商，类型选择 Anthropic
2. 填写：
   • API 秘钥：你的 Sakrylle Key
   • API 地址：https://api.sakrylle.com（注意：这里不带 /v1，Anthropic SDK 会自动拼）
3. 管理 模型里添加：
   • claude-haiku-4-5-20251001
   • claude-sonnet-4-6、claude-opus-4-7 按需

如果你的 Cherry Studio 版本较旧，Anthropic 服务商类型可能不存在。这种情况只用 OpenAI 兼容入口即可——Sakrylle 的 /v1/chat/completions 也支持透传到 Claude，只是不能用 Anthropic 特有字段（如 tool_use 原生格式）。

使用

进入主聊天界面，顶部模型选择器里选择你刚加好的模型，开始对话。

常见问题

• 模型列表为空 / 检查失败 401：API Key 错了或被删了。回 API Keys 页面重新建一个
• 检查失败 connection refused / timeout：API 地址写错了，OpenAI 类型必须以 /v1 结尾，Anthropic 类型不带 /v1
• 流式回复一卡一卡：Cherry Studio 设置 → 模型服务 → 找到对应服务商，确认未开启代理或 VPN 干扰；网络问题排查后还是不行可在该服务商关闭"流式输出"先用非流式
• 402 余额不足：到控制台 充值