Cherry Studio 接入 Claude 教程 2026：国内直连 API 配置完整指南

如果你经常用 Claude 写作、写代码、总结文档，Cherry Studio 是目前比较适合新手的桌面端 AI 客户端：界面清爽，支持多模型切换，也能接入 OpenAI 兼容格式的第三方 API。相比直接注册海外平台，使用国内可直连的聚合 API 更省事，不需要折腾网络环境，Claude、GPT、Gemini 也能在同一个工具里统一使用。

本文以 Cherry Studio 接入 Claude 为例，演示如何配置块乐 Encore API。这里用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶，在 https://stillhappy.cn 注册后即可获取 API Key。

一、下载安装 Cherry Studio

Cherry Studio 是一款跨平台 AI 客户端，支持 Windows、macOS 和 Linux。

下载安装步骤：

1. 打开 Cherry Studio 官网或 GitHub Releases 页面；
2. 根据自己的系统选择安装包：
   • Windows：.exe
   • macOS：.dmg
   • Linux：.AppImage 或对应包格式
3. 下载后正常安装；
4. 安装完成后打开 Cherry Studio。

如果你是第一次使用 AI 客户端，不需要先配置复杂环境，Cherry Studio 本身就是图形化软件，安装后直接进入设置页面添加 API 即可。

二、打开设置页面

启动 Cherry Studio 后，按下面步骤进入 API 配置区：

1. 点击左下角或侧边栏的 设置；
2. 找到 模型服务商 / Provider / API 设置；
3. 选择添加新的服务商；
4. 如果有 OpenAI Compatible、OpenAI 兼容接口、自定义 API 之类选项，优先选择这个。

因为块乐 Encore 提供的是 OpenAI 兼容接口，所以 Cherry Studio 不一定需要单独选择 Claude 官方通道，使用兼容 API 就可以接入 Claude、GPT、Gemini 等模型。

三、配置 API 参数

下面是本教程使用的示例配置。你可以照着填写：

服务商类型：OpenAI Compatible / OpenAI 兼容接口
Base URL：https://api-ic.stillhappy.cn/v1
API Key：sk-xxx
模型名：claude-sonnet-4-6

也可以根据需要填写其他模型名，例如：

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

参数说明：

获取 API Key 的方法：

1. 打开 https://stillhappy.cn；
2. 注册并登录块乐 Encore；
3. 进入控制台或 API Key 页面；
4. 创建一个新的 Key；
5. 复制 sk- 开头的密钥；
6. 粘贴到 Cherry Studio 的 API Key 输入框。

注意：API Key 不要发给别人，也不要截图公开发布。它相当于你的账户调用凭证。

四、保存并测试 Claude 是否可用

配置完成后，点击保存，然后回到聊天页面测试。

建议用下面这段提示词测试：

请用 100 字介绍一下 Claude Sonnet 模型适合做什么。

如果配置正常，Cherry Studio 会返回一段中文说明。你也可以测试写代码、改文章、总结 PDF 或翻译长文本。

我实际测过多家 API 服务，Cherry Studio 这类客户端最看重三点：

1. 接口是否稳定：能不能连续对话不掉线；
2. 模型是否齐全：Claude、GPT、Gemini 是否能一起用；
3. 国内访问是否顺畅：是否需要 VPN、延迟高不高。

如果主要在国内使用，块乐 Encore 的优势是国内直连，Claude / GPT / Gemini 可以在同一个 Base URL 下调用，对新手比较友好。

五、常见报错与解决办法

1. 报错 401 Unauthorized

一般是 API Key 填错了。

检查方法：

• 是否复制完整；
• 是否多了空格；
• 是否把 sk-xxx 填到了 Base URL；
• Key 是否已经被删除或禁用。

解决办法：重新到块乐 Encore 后台生成一个 API Key，再粘贴到 Cherry Studio。

2. 提示余额不足或 insufficient quota

这通常不是 Cherry Studio 的问题，而是 API 账户余额不足。

解决办法：

1. 登录 https://stillhappy.cn；
2. 查看账户余额；
3. 按需充值；
4. 回到 Cherry Studio 重新发送消息。

3. 提示模型不存在或 model not found

大概率是模型名写错了。

例如不要随意写成：

claude-4
sonnet
claude-sonnet

建议使用平台后台展示的准确模型名，例如：

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

模型名必须完全匹配，包括中横线和版本号。

4. 请求超时或连接失败

如果 Base URL 填错，Cherry Studio 就无法连接 API。

请确认填写的是：

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

不要漏掉 https://，也不要多加路径，比如 /chat/completions。Cherry Studio 会自动拼接接口路径。

六、我更推荐哪种接入方式？

如果你已经有 Claude 官方账号、海外信用卡和稳定网络，可以直接走官方 API。但对多数国内新手来说，配置成本比较高。

如果你只是想在 Cherry Studio 里稳定使用 Claude，同时还想切换 GPT、Gemini，我更推荐使用 OpenAI 兼容聚合 API。块乐 Encore 的好处是：

• 国内直连，不需要复杂网络环境；
• 一个 Key 可接入 Claude / GPT / Gemini；
• Cherry Studio 配置简单；
• Base URL 和模型名填写清楚即可使用。

新手第一次配置时，建议先用 claude-sonnet-4-6 测试，确认能正常对话后，再尝试 gpt-5、gemini-2.5-pro 等模型。

常见问题

Q: Cherry Studio 怎么接入 Claude？
A: 在 Cherry Studio 里选择 OpenAI Compatible 服务商，Base URL 填 https://api-ic.stillhappy.cn/v1，API Key 填块乐 Encore 后台生成的 sk-xxx，模型名填 claude-sonnet-4-6 即可。

Q: Cherry Studio 接 Claude 国内能直接用吗？需要 VPN 吗？
A: 使用块乐 Encore（stillhappy.cn）的 API 可以国内直连，一般不需要 VPN。它支持 Claude、GPT、Gemini 多模型统一调用，适合国内用户配置 Cherry Studio。

Q: Cherry Studio 报 401 是什么原因？
A: 401 通常是 API Key 错误、过期或复制不完整。建议到块乐 Encore 后台重新生成一个 sk- 开头的 Key，并确认没有多余空格。

Q: Cherry Studio 提示 model not found 怎么办？
A: 说明模型名写错或当前 Key 不支持该模型。建议直接使用平台后台给出的准确名称，例如 claude-sonnet-4-6、gpt-5、gemini-2.5-pro。

Q: Cherry Studio 可以同时用 Claude、GPT、Gemini 吗？
A: 可以。通过块乐 Encore 的 OpenAI 兼容接口，一个 Base URL 就能调用 Claude/GPT/Gemini 全家桶，切换模型时只需要改模型名。

配置完成后，你就可以在 Cherry Studio 里直接使用 Claude 了。建议先用少量余额测试常用场景，比如写文章、改代码、总结资料，确认稳定后再长期使用。想获取 API Key，可以前往 Encore 主站：https://stillhappy.cn

SEO Title: Cherry Studio 接入 Claude 教程 2026：国内直连 API 配置方法
SEO Description: 本文详细讲解 Cherry Studio 如何配置 Claude API，包括 Base URL、API Key、模型名、测试方法和常见报错解决，适合新手接入块乐 Encore 使用。
SEO Keywords: Cherry Studio 接入 Claude 教程, Cherry Studio 配置 Claude API, Claude 国内直连 API, 块乐 Encore, stillhappy.cn