Cherry Studio 里模型接不上，常见卡点不是“软件坏了”，而是 Provider 类型、API Key、API Host、模型 ID 这几项没有对齐。OpenAI、Claude、Gemini 三家服务看起来都在“模型服务”里配置，实际走的协议不一样：OpenAI 走 OpenAI 类型，Claude 走 Anthropic 类型，Gemini 走 Google Gemini 类型。类型选错，Key 再正确也可能报错。

开始前要准备什么

你需要准备三样东西：服务商账号、API Key、要使用的模型 ID。OpenAI 的 Key 来自 OpenAI 平台；Claude 的 Key 来自 Anthropic Console；Gemini 的 Key 来自 Google AI Studio 或 Google Cloud 相关入口。Cherry Studio 只负责保存配置和发起调用，账号余额、模型权限、区域访问仍由服务商决定。

安装好 Cherry Studio 后，打开左侧齿轮图标进入设置，再进入“模型服务”。这里会看到已有 Provider，也能通过底部的添加按钮创建自定义服务商。官方自定义服务商文档列出的类型包括 OpenAI、Gemini、Anthropic、Azure OpenAI；这说明服务商名称可以自己起，协议类型不能乱选。

OpenAI 接入方法

打开 OpenAI 平台的 API Key 页面，创建一个新的 secret key。复制时注意不要多带空格，也不要只复制前后几位。回到 Cherry Studio 的“模型服务”，找到 OpenAI Provider，粘贴刚创建的 Key。

API Host 如果使用 OpenAI 官方服务，通常保留默认地址即可；如果你接的是兼容 OpenAI 协议的企业网关或中转服务，就按对应网关文档填写 Base URL。这里不要把 Claude 原生 Key 或 Gemini 原生 Key 塞进 OpenAI Provider，除非你的网关文档明确说明它提供 OpenAI 兼容接口。

Key 和地址填好后，点“检查”看连接是否通过。接着点“管理”或“新增”，把账号可用的模型 ID 加进去，例如当前账号可见的 GPT 系列模型。右上角 Provider 开关要打开，聊天页里才能选到这个模型。

Claude 接入方法

Claude 在 Cherry Studio 里对应 Anthropic Provider。先到 Anthropic Console 创建 API Key，再回到 Cherry Studio 的模型服务页，找到 Anthropic 或新增一个类型为 Anthropic 的服务商。

API Key 填 Anthropic Key，API Host 使用 Anthropic 协议地址；如果你用企业代理或第三方网关，要确认网关提供的是 Anthropic 协议，而不是只提供 OpenAI 兼容协议。Cherry Agent 这类 Agent 场景更依赖 Anthropic 协议端点，协议选错时经常表现为模型能列出来，工具调用或 Agent 请求却失败。

添加模型时填账号或网关支持的 Claude 模型 ID。填完后打开 Provider 开关，在聊天页新建一次短对话测试。测试问题建议很短，例如“回复 OK”，这样能把账号、网络、模型名问题和长上下文问题分开排查。

Gemini 接入方法

Gemini 对应 Google Gemini Provider。官方文档给出的路径是先准备 Google Cloud 项目，再到 Google AI Studio 的 API Key 页面创建 Key。已经有项目和 Key 的账号，可以直接进入 Cherry Studio 配置。

在“模型服务”里找到 Gemini Provider，填入 Key。API Host 如果走 Google 官方服务，保留默认配置；如果使用兼容网关，就按网关文档提供的地址填写。国内部分网络环境可能无法直连 Google Gemini 服务，连接失败时要把网络路径和代理设置纳入排查。

模型 ID 要填账号可用的 Gemini 模型。不要凭印象随手填一个名字，最好从 Google AI Studio、服务商控制台或网关模型列表里复制。添加模型后打开右上角开关，在聊天页选择 Gemini 模型发一条短消息验证。

三家一起配置时怎么放

如果你想在 Cherry Studio 里保留 OpenAI、Claude、Gemini 三套入口，建议按三个独立 Provider 管理，不要混在一个自定义服务商里。这样做有两个好处：聊天页选择模型时更清楚，连接失败时也能直接定位是哪一家服务的问题。

自定义 Provider 更适合网关类服务。比如你的公司内部网关把多个模型统一成 OpenAI 兼容接口，那就创建一个 OpenAI 类型的自定义 Provider；如果网关提供 Anthropic 协议端点给 Claude，就创建 Anthropic 类型；如果网关提供 Gemini 协议，就创建 Gemini 类型。看协议，不看模型品牌名。

连接失败怎么看

点击“检查”失败时，先看 Key 是否完整，再看 API Host 是否写成了服务商要求的地址。常见错误包括少了路径、把网页地址当 API 地址、复制 Key 时多带空格、模型 ID 不属于当前账号、Provider 开关没有打开。

如果错误只出现在 OpenAI 或 Gemini 官方服务上，还要看当前网络能否访问对应 API。官方文档也提醒过，部分区域不能直接访问 OpenAI 或 Google Gemini 服务，需要自行处理网络路径。Claude 同样需要能访问 Anthropic API。

如果你使用第三方网关，排查顺序改成：网关余额、网关 Key、网关 Base URL、网关支持的模型 ID、Cherry Studio 里的 Provider 类型。只要其中一项和网关文档不一致，Cherry Studio 这边就可能表现为检查失败或发消息无响应。

可直接照着做的顺序

1. 打开 Cherry Studio 左侧齿轮图标，进入“模型服务”。

2. 选择 OpenAI、Anthropic、Google Gemini 中对应的 Provider。

3. 填入该服务商生成的 API Key。

4. 按官方服务或网关文档确认 API Host。

5. 点“检查”验证 Key 和地址。

6. 点“管理”或“新增”，添加账号可用的模型 ID。

7. 打开 Provider 右上角开关。

8. 回到聊天页，选择刚添加的模型，发一条短消息测试。

把这套流程跑通后，Cherry Studio 才算真正接上模型。OpenAI 看 Key、余额和兼容地址；Claude 看 Anthropic Provider 和协议端点；Gemini 看 Google 项目、AI Studio Key 和网络路径。配置页能检查通过，聊天页能收到短回复，再去调默认模型、助手、知识库和 Agent，会少很多误判。