主题
Cherry Studio 接入
Cherry Studio 是一款国产桌面 AI 客户端，UI 漂亮、支持多模型并排对比。本页讲怎么把 Shuro 接进去。
一分钟版本
设置 → 模型服务 → 添加 Provider（类型 OpenAI）→ API 地址 https://shuro.vip/v1 → 填 Key → 手动添加模型 ID。完事。
前置条件
- 一个 Shuro API Key — 没有？看 获取 API Key
- Cherry Studio 桌面版 — cherry-ai.com/download 下对应平台安装包
方式一：OpenAI 兼容 Provider（推荐）
一个 Provider 同时用 Claude 和 GPT 全部 9 款模型。
- 左侧栏 ⚙️ 「设置」
- 「模型服务」（Providers）→ 「添加」
- 填：
| 字段 | 值 |
|---|---|
| 提供商类型 | OpenAI |
| API 地址 | https://shuro.vip/v1 |
| API Key | <您的 API Key> |
- 保存并启用该 Provider
API 地址要带 /v1
Cherry Studio 走 OpenAI 协议，Base URL 必须带 /v1（和 GUI 聊天客户端 通用规则一致）。若你的版本会自动拼接后缀导致 404，试试去掉 /v1 再保存。
添加模型
Shuro 的模型列表需要手动填模型 ID（点该 Provider 下的「管理」/「添加模型」）。常用几款：
claude-opus-4-7
claude-sonnet-4-6
claude-haiku-4-5-20251001
gpt-5.5
gpt-5.4全部 9 款模型的 ID、倍率、上下文长度见 支持的模型。
别用官方旧 ID
claude-3.5-sonnet 这类旧写法 Shuro 不一定有，会报「模型未找到」。照抄上面的 ID。
验证
回到聊天界面，顶部模型选择器选刚加的模型，发一句「回复 pong」。收到回复即成功。
方式二：Anthropic 类型 Provider（仅 Claude）
Claude 全系支持 Anthropic 原生协议。如果你的 Cherry Studio 版本支持添加 Anthropic 类型 Provider，也可以这样接：
| 字段 | 值 |
|---|---|
| 提供商类型 | Anthropic |
| API 地址 | https://shuro.vip |
| API Key | <您的 API Key> |
注意两点：
- Anthropic 协议 Base URL 不带
/v1（客户端自己会拼/v1/messages） - 只能添加 Claude 系列模型；
gpt-5.5等 GPT 系列仅支持 OpenAI 协议，必须走方式一
两种方式可以共存：一个 Anthropic Provider 挂 Claude，一个 OpenAI Provider 挂 GPT。协议差异详见 接口与端点。
玩法：多模型对比
Cherry Studio 支持同一个问题让多个模型同时回答。用 Shuro 一把 Key 就能把 claude-opus-4-7、claude-sonnet-4-6、gpt-5.5 拉到一起对比，不用管多家账号。
常见问题
401 / Invalid token
Key 写错、没生效或被禁用。逐项排查见 401 排查。顺带检查 API 地址末尾的 /v1 是否漏了。
模型未找到
模型 ID 拼错，用上文列表照抄，或对照 支持的模型。
请求超时 / 无响应
相关页面
- GUI 聊天客户端总览 — ChatBox / NextChat / LobeChat 一页配齐
- LobeChat 接入
- 计费与倍率