Cherry Studio 配置教程

Cherry Studio 是一个多模型桌面客户端，支持通过自定义服务商接入第三方 AI 平台。如果你想在 Cherry Studio 里使用 Ai Go Code 提供的 Claude、GPT 和 Gemini 模型，最稳妥的方式就是按模型族分别创建服务商。

这篇教程会按实际操作顺序，带你从下载安装到开始聊天完整走一遍。你可以先只配 Claude，确认能用之后，再继续补 GPT 和 Gemini。

准备工作#

开始之前，请先准备好以下内容：

1. 已安装最新版本的 Cherry Studio。
2. 一个 Ai Go Code 账号。
3. 一个可用于第三方客户端的 API Key。

重要说明#

正式开始之前，先记住下面这几个最容易踩坑的点：

• 推荐使用“自定义服务商”，不要强行复用 Cherry Studio 里的官方服务商。
• API 地址 只填根地址 https://api.aigocode.com，不要手动补 /v1、/v1beta 或 /v1/chat/completions。
• 最稳妥的做法是按模型族分别创建服务商：Claude 用 Anthropic 类型，GPT 用 OpenAI 类型，Gemini 用 Gemini 类型。
• 创建 API Key 时，要选择支持第三方调用的分组，否则客户端里可能会连不上。

第一步：下载安装 Cherry Studio#

如果你还没有安装 Cherry Studio，可以先前往 Cherry Studio 官方下载页 下载并安装。

安装完成后打开客户端，后面的配置都在 设置 -> 模型服务 里完成。

先点击设置入口：

进入模型服务页面后，你会看到当前已配置的服务商列表：

第二步：创建可用于第三方客户端的 API Key#

接下来去 Ai Go Code 后台创建一个 API Key：

1. 登录 Ai Go Code。
2. 进入 控制台 API Key 页面。
3. 创建一个新的 API Key。
4. 复制并保存好这个 Key，后面三个服务商都会用到它。

最关键的一点是：创建 Key 时一定要选支持第三方调用的分组。

第三步：先添加 Claude 服务商#

如果你是第一次配置，最推荐先从 Claude 开始。因为只要 Claude 能正常返回结果，后面的 GPT 和 Gemini 基本就是照着再配一遍。

如果你还想用 Claude，就先新增一个服务商。路径是 设置 -> 模型服务 -> + 添加。

这次服务商类型改成 Anthropic：

建议填写：

模型先添加下面这个即可：

claude-opus-4-6

配置完成后大概会是下面这个样子：

如果能正常测试通过，说明第一个服务商已经打通了。最后别忘了把服务商右上角开关打开，否则模型不会出现在聊天窗口里。

第四步：继续添加 GPT 服务商#

接下来再添加 GPT 服务商。还是在模型服务页面点击左下角 + 添加，新建一个 OpenAI 类型的服务商：

建议按下面这样填写：

保存后，继续点击 添加 或 管理，把模型加进来。你可以先尝试：

gpt-5.4

如果当前账号或分组里没有这个模型，就改成：

gpt-5.3-codex

下面这张图就是 GPT 模型配置的示意：

加完之后，记得点击测试按钮。如果提示“连接成功”，说明 GPT 这一路已经打通了。

第五步：最后添加 Gemini 服务商#

Gemini 的配置方式也一样，只是服务商类型改成 Gemini。

建议填写：

模型建议先加：

gemini-3.1-pro-preview

如果 Cherry Studio 的模型管理窗口能自动拉取模型列表，优先直接从列表里选；如果拉不到，再手动填模型 ID。

第六步：回到聊天界面开始使用#

当 Claude、GPT、Gemini 这些服务商都配置好之后，就可以回到主界面开始聊天了。

先打开聊天对话窗口：

然后在模型选择器里切换到刚刚添加的 Ai Go Code 模型：

如果你有几个模型会经常切换使用，可以把它们置顶：

选好模型后，直接发送一句测试消息，比如 你好，请介绍一下你自己。能正常回复，就说明整个配置已经完成。

推荐的最小配置#

如果你不想一开始就配很多内容，可以先只完成下面这一套：

• 新增一个 Anthropic 类型服务商。
• API 地址填 https://api.aigocode.com。
• 添加 claude-opus-4-6。
• 验证能正常对话后，再继续加 GPT 或 Gemini。

这样最省事，也最不容易踩坑。

常见问题#

API 地址为什么不能直接填 /v1/chat/completions？#

因为 Cherry Studio 会根据服务商类型自动拼接请求路径。大多数情况下只需要填写根地址 https://api.aigocode.com，填太完整反而容易导致请求失败。

为什么配置成功了，但模型列表里看不到？#

优先检查下面几项：

• 服务商右上角开关是否已经打开。
• 你是不是只在弹窗里看到了模型，但没有点右侧 + 真正加入模型列表。
• 模型 ID 是否拼写正确。
• 当前服务商类型是否和模型族匹配。

可以只建一个服务商，把所有模型都放进去吗？#

如果你只使用 Claude 模型，可以只建一个 Anthropic 类型服务商。

但如果你还要同时使用 GPT 和 Gemini，更推荐分别建立 OpenAI 和 Gemini 类型服务商。这样兼容性更稳，出问题时也更容易排查。