AI 中转指南
AI 工具 AI 工具研究员 1 views

Cherry Studio 安装配置

Cherry Studio 安装配置教程 2025 如果你想在一个桌面端 AI 客户端里统一接入 Claude、GPT、Gemini 等主流模型， Cherry Studio 是非常适合新手入门的选择。它界面清爽、配置灵活、支持多模型切换，适合写作、编程、翻译和日常问答。相比每个官网单独登录，直接配置一个兼容 API 的聚合入口会更省事。本文就用 块乐 En

Cherry Studio 安装配置教程 2025

如果你想在一个桌面端 AI 客户端里统一接入 Claude、GPT、Gemini 等主流模型，Cherry Studio 是非常适合新手入门的选择。它界面清爽、配置灵活、支持多模型切换，适合写作、编程、翻译和日常问答。相比每个官网单独登录，直接配置一个兼容 API 的聚合入口会更省事。本文就用 块乐 Encore API 为例，带你一步一步完成 Cherry Studio 安装和配置。

一、先了解：Cherry Studio 能做什么

Cherry Studio 是一款本地桌面 AI 客户端，你可以把它理解为“统一的 AI 聊天工作台”。配置好 API 后，你就可以：

  • 在一个界面里切换不同大模型
  • 用 Claude 写长文、用 GPT 做代码、用 Gemini 做总结
  • 保存对话、整理知识、提高日常办公效率
  • 不用每次切换多个网站和账号

这也是很多用户选择它的原因：安装简单、接入方便、体验接近原生聊天工具。

二、下载安装 Cherry Studio

1）获取安装包

先前往 Cherry Studio 官方发布页或官网，下载适合你系统的版本：

  • Windows：下载 .exe
  • macOS：下载 .dmg
  • Linux：选择对应发行版包

如果你是第一次接触，建议优先安装稳定版，不要先用测试版，避免界面差异影响配置。

2）完成安装

下载后按系统提示安装即可：

  • Windows：双击安装包，下一步安装
  • macOS：拖入应用程序文件夹
  • Linux：按对应方式安装软件包

安装完成后，打开 Cherry Studio。

三、打开设置页面

进入 Cherry Studio 后，先不要急着聊天，第一步是把 API 接好。

通常设置入口在以下位置之一：

  • 左下角 设置 / Settings
  • 顶部菜单栏中的 设置
  • 侧边栏中的 模型服务商 / Provider / API 配置

不同版本界面可能略有区别，但核心思路都是一样的：
找到“模型提供商”或“API 配置”页面，然后新增一个兼容 OpenAI 格式的接口。

四、配置 API 参数

这一部分是重点。本文使用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶。
你可以先到这里注册并获取 key：

注册后，在控制台获取你的 API Key，然后回到 Cherry Studio 填写参数。

五、Cherry Studio 中正确填写参数

在 Cherry Studio 中新增一个 API 提供商时，按下面填写即可。

1）Base URL

填写：

https://api-ic.stillhappy.cn/v1

这是接口入口地址。
注意：

  • 一般要带上 /v1
  • 不要多写空格
  • 不要写成官网地址，必须是 API 地址

2）API Key

填写你的密钥，格式类似：

sk-xxx

示例：

sk-abc123example456

注意：

  • API Key 区分大小写
  • 前后不要有空格
  • 复制时不要带引号

3）模型名

Cherry Studio 通常支持手动填写模型名。
你可以根据用途填不同模型，例如：

claude-sonnet-4-6

或：

gpt-5

或：

gemini-2.5-pro

如果你不确定先用哪个，建议这样选择：

  • 写作 / 总结 / 长文本：claude-sonnet-4-6
  • 代码 / 通用对话：gpt-5
  • 多场景分析 / 归纳：gemini-2.5-pro

4）Provider 类型怎么选

如果 Cherry Studio 提供以下选项，优先这样选：

  • OpenAI Compatible
  • OpenAI API
  • 自定义 OpenAI 格式接口

因为很多聚合 API 都兼容 OpenAI 风格，Cherry Studio 也最容易识别这种方式。

5）推荐配置示例

你可以参考下面这组参数直接填写：

Provider: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-abc123example456
Model: claude-sonnet-4-6

如果你想切换 GPT：

Provider: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-abc123example456
Model: gpt-5

如果你想切换 Gemini：

Provider: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-abc123example456
Model: gemini-2.5-pro

六、保存配置并新建会话

参数填好后，点击：

  • 保存
  • 测试连接
  • 或 确认

保存成功后，回到聊天页面，新建一个对话，然后在模型选择器里选中刚才配置的模型。

如果 Cherry Studio 支持多模型管理，你也可以一次保存多个模型，例如：

  • claude-sonnet-4-6
  • gpt-5
  • gemini-2.5-pro

这样后续切换更方便。

七、如何测试是否接入成功

配置完成后，建议立刻做一个最简单的测试。

在聊天框发送：

你好，请用一句话介绍你自己。

如果模型正常返回内容，说明 API 已接入成功。

你也可以继续测试下面几类问题：

1）测试中文对话

请帮我写一段 100 字的自我介绍。

2）测试代码能力

请用 Python 写一个冒泡排序示例。

3）测试长文总结

请总结一下学习 AI 工具配置时最常见的三个坑。

如果能够稳定回复，说明：

  • Base URL 正确
  • API Key 有效
  • 模型名可用
  • 账号余额正常

八、推荐的新手使用方式

如果你是第一次使用 Cherry Studio，建议按下面顺序来：

  1. 先只配置一个模型
    • 例如先用 claude-sonnet-4-6
  2. 确认能正常聊天
  3. 再增加第二个和第三个模型
    • 如 gpt-5
    • 如 gemini-2.5-pro
  4. 为不同用途建立不同预设
    • 写作助手
    • 编程助手
    • 翻译助手

这样做的好处是：
先把链路跑通，再逐步优化，不容易因为一次配置太多而找不到错误原因。

九、常见问题排查

下面是 Cherry Studio 安装配置时最常见的几个问题。

问题 1：报错 401 Unauthorized

现象：

  • 提示 401
  • 提示未授权
  • 提示 invalid api key

原因通常有：

  • API Key 填错了
  • 复制时带了空格
  • key 已失效或未开通
  • Base URL 配对错误

解决方法：

  1. 重新复制 API Key
  2. 检查是否是 sk-xxx 格式
  3. 确认 Base URL 是否为：
https://api-ic.stillhappy.cn/v1
  1. 到 Encore 后台确认 key 状态是否正常

问题 2：提示余额不足 / quota exceeded

现象：

  • 返回余额不足
  • quota exceeded
  • insufficient balance

原因：

  • 账户可用额度不足
  • 模型调用成本较高
  • 当前 key 没有足够余额

解决方法：

  1. 登录 Encore 控制台查看余额
  2. 充值或更换有额度的 key
  3. 先用成本较低的模型测试

建议先发一句最简单的话测试，确认不是参数问题，再排查余额。

问题 3：模型名错误，无法调用

现象：

  • 提示 model not found
  • 提示模型不存在
  • 提示 unsupported model

原因：

  • 模型名拼写错误
  • 多写或少写字符
  • 当前账户暂未开放该模型

正确示例：

claude-sonnet-4-6
gpt-5
gemini-2.5-pro

解决方法：

  1. 严格按可用模型名填写
  2. 不要自己随意简写
  3. 如果不确定，先用平台文档或后台可用模型列表确认

问题 4：填了 URL 还是连接失败

原因可能有：

  • 少写 /v1
  • 把官网地址当成了 API 地址
  • Cherry Studio 的 Provider 类型没选对

正确写法：

https://api-ic.stillhappy.cn/v1

建议：

  • Provider 选择 OpenAI Compatible
  • 不要填写成 https://stillhappy.cn
  • 不要遗漏协议头 https://

问题 5：能发消息但回复很慢

原因可能有：

  • 当前模型负载较高
  • 问题太长
  • 网络偶发波动
  • 使用了推理更重的模型

解决方法：

  1. 先用短问题测试
  2. 切换其他模型试试
  3. 重新发起对话
  4. 检查本地网络是否稳定

十、一个最简可用配置清单

如果你只想快速跑通，可以直接对照下面填写：

Provider: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model: claude-sonnet-4-6

跑通后再尝试：

Model: gpt-5

或：

Model: gemini-2.5-pro

这就是最适合新手的方式：
先成功，再优化；先单模型，再多模型。

十一、总结

Cherry Studio 的优势在于：一个客户端，统一管理多个大模型。只要你把 API 参数填对，整个使用体验会非常顺滑。本文使用的是 块乐 Encore 的 API，支持 Claude / GPT / Gemini，而且国内直连，对中文用户来说配置门槛更低。

如果你之前总觉得 AI 工具接入麻烦，其实真正关键的就三项：

  • Base URL
  • API Key
  • 模型名

把这三项配置正确，基本就能顺利用起来。

现在就动手试试吧，配置成功后，你会发现 Cherry Studio 确实是非常适合长期使用的 AI 桌面工作台。
Encore 主站地址：

SEO Meta

Meta Title：Cherry Studio 安装配置教程 2025：国内直连接入 Claude/GPT/Gemini API
Meta Description：详细讲解 Cherry Studio 安装配置方法，包含 Base URL、API Key、模型名示例，使用块乐 Encore API 国内直连接入 Claude、GPT、Gemini。
Meta Keywords：Cherry Studio 安装配置, Cherry Studio API 接入, Cherry Studio 教程, Encore API, Claude API, GPT API, Gemini API

Cherry Studio 安装配置
相关阅读
1 NextChat 部署到 Vercel 2 Cursor 中文使用教程