Cherry Studio 配置

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

通过配置 DouDi.ai 作为服务商，你可以在 Cherry Studio 中使用 GPT、Claude、Grok、DeepSeek 等当前可用模型，只需一个 API Key。

三种协议说明

Cherry Studio 支持通过以下三种协议接入 DouDi.ai：

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。

前提条件

• 已注册 DouDi.ai 账号并获取 API Key（前往获取  ）
• 已安装 Cherry Studio（下载地址  ）

配置步骤

第 1 步：打开设置

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

第 2 步：添加模型提供商

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

OpenAI Chat

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

OpenAI Response

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

Claude

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

第 3 步：填写 API 配置

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

OpenAI Chat

配置项	值
API 密钥	你的 DouDi.ai API Key
API 地址	https://doudi.ai/v1

OpenAI Response

配置项	值
API 密钥	你的 DouDi.ai API Key
API 地址	https://doudi.ai/v1

Claude

配置项	值
API 密钥	你的 DouDi.ai API Key
API 地址	https://doudi.ai/anthropic

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

第 4 步：添加模型

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

OpenAI Chat

OpenAI Response

Claude

第 5 步：验证配置

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

OpenAI Chat

OpenAI Response

Claude

开始使用

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

常见问题

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

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

Q: 检测时提示连接失败

1. 确认 API Key 从 DouDi.ai 控制台  完整复制，无多余空格
2. 确认 API 地址填写正确
3. 确认网络连接正常

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

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

本页按 DouDi.ai 接入语境整理，覆盖同类教程的结构和步骤。 实际模型、分组、价格和权限以 DouDi 控制台为准。