Cherry Studio 配置

在 Cherry Studio 中通过 OpenAI Chat、OpenAI Response、Claude、Gemini 四种协议接入 Flatrouter。

Cherry Studio 是一款跨平台的 AI 桌面客户端（支持 Windows、macOS、Linux），支持多模型对话、知识库和工作流，是目前功能最丰富的开源 AI 客户端之一。

通过配置 Flatrouter 作为服务商，你可以在 Cherry Studio 中使用 GPT、Claude、Gemini、DeepSeek 等 100+ 大模型，只需一个 API Key。

四种协议说明

Cherry Studio 支持通过以下四种协议接入 Flatrouter：

OpenAI Chat — 基于 /v1/chat/completions，适用于 GPT 系列模型，如 openai/gpt-4.1、openai/gpt-5.3-chat
OpenAI Response — 基于 /v1/responses，适用于 GPT 系列模型，如 openai/gpt-4.1、openai/gpt-5.4-mini
Claude — 基于 /anthropic/v1/messages，适用于 Claude 系列模型，如 anthropic/claude-sonnet-4.6、anthropic/claude-opus-4.6
Gemini — 基于 /gemini/v1beta/models，适用于 Gemini 系列模型，如 google/gemini-3.1-pro-preview、google/gemini-3.1-flash-lite-preview

启动 Cherry Studio，点击左下角的设置图标。

进入左侧 模型服务，滚动到底部，点击 + 添加。在弹出的对话框中填写提供商名称，并选择对应的提供商类型。

OpenAI Chat — 提供商类型选择 OpenAI，点击确定。

OpenAI Response — 提供商类型选择 OpenAI（后续在配置页开启 Response 模式），点击确定。

Claude — 提供商类型选择 Anthropic，点击确定。

Gemini — 提供商类型选择 Gemini，点击确定。

在对应提供商的配置页中填写 API 密钥和 API 地址。

协议	API 密钥	API 地址
OpenAI Chat / Response	你的 Flatrouter API Key	`https://api.flatrouter.com/v1`
Claude	你的 Flatrouter API Key	`https://api.flatrouter.com/anthropic`
Gemini	你的 Flatrouter API Key	`https://api.flatrouter.com/gemini`

确认页面右上角的开关处于 开启（ON） 状态，否则该提供商不会出现在模型选择器中。

点击模型区域的管理按钮自动拉取模型列表，点击模型右侧的 + 添加到启用列表。

点击检测按钮，选择任意模型进行测试，显示检测通过即配置成功。

回到主界面，点击对话顶部的模型选择器，在对应提供商分组下选择模型，即可开始对话。

Q: 点击「管理」后模型列表为空

检查 API 地址是否填写正确（末尾不加斜杠），以及 API 密钥是否完整复制，无多余空格。

Q: 检测时提示连接失败

Q: 提供商不出现在模型选择器中

检查配置页右上角的开关是否已开启。