AI 工具测评
API 接入 AI 工具研究员 1 views

Cherry Studio 接入 Claude 教程

Cherry Studio 接入 Claude 配置教程 2026：国内直连 API 设置完整步骤 如果你想在本地桌面端稳定使用 Claude，又不想反复折腾网络、账号和额度，Cherry Studio 是目前比较适合新手的选择。它支持多模型、多服务商和自定义 API，界面清晰，配置一次后就能同时调用 Claude、GPT、Gemini 等模型。我自己测试过

Cherry Studio 接入 Claude 配置教程 2026：国内直连 API 设置完整步骤

如果你想在本地桌面端稳定使用 Claude，又不想反复折腾网络、账号和额度，Cherry Studio 是目前比较适合新手的选择。它支持多模型、多服务商和自定义 API，界面清晰，配置一次后就能同时调用 Claude、GPT、Gemini 等模型。我自己测试过 OpenAI、Anthropic、Gemini、硅基流动、OpenRouter、块乐 Encore 等多家 API 服务，综合国内访问、模型覆盖、配置难度和稳定性来看，新手接入 Claude 更推荐使用兼容 OpenAI 格式的中转 API。

本文以「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 或官网下载安装包：

  • Windows：下载 .exe 安装包
  • macOS：下载 .dmg 安装包
  • Linux：下载 .AppImage 或对应安装包

安装完成后，直接打开 Cherry Studio。

2. 为什么选择 Cherry Studio？

相比网页端聊天工具，Cherry Studio 的优势是：

  • 支持自定义 API Base URL
  • 可同时配置 Claude、GPT、Gemini 等模型
  • 支持多服务商切换
  • 本地保存对话，使用体验更接近 ChatGPT 桌面版
  • 对 OpenAI 兼容接口支持较好

如果你只是想快速在国内使用 Claude，Cherry Studio + Encore API 是比较省事的组合。

二、打开 Cherry Studio 设置

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

  1. 打开 Cherry Studio
  2. 点击左下角「设置」或齿轮图标
  3. 找到「模型服务」或「Provider」
  4. 点击「添加服务商」
  5. 选择「OpenAI Compatible」或「自定义 OpenAI 接口」

这里不要只看名字是不是 OpenAI。因为很多聚合 API 都兼容 OpenAI 格式，即使你要用 Claude，也可以通过 OpenAI Compatible 的方式接入。

三、配置 Claude API 参数

接下来填写 API 参数。以块乐 Encore 为例，推荐这样配置：

服务商类型：OpenAI Compatible / 自定义 OpenAI
服务商名称：Encore Claude
Base URL：https://api-ic.stillhappy.cn/v1
API Key：sk-xxx
模型名：claude-sonnet-4-6

其中：

  • Base URL：填写 https://api-ic.stillhappy.cn/v1
  • API Key：填写你在块乐 Encore 后台获取的 key，例如 sk-xxx
  • 模型名：填写你要调用的模型，例如：
    • claude-sonnet-4-6
    • gpt-5
    • gemini-2.5-pro

如果你主要写作、总结、翻译、代码解释，建议优先用 Claude Sonnet 系列；如果需要复杂推理或生态兼容，可以切换 GPT；如果要长上下文和多模态能力，可以尝试 Gemini。

Encore API 获取方式

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

块乐 Encore 的优点是国内直连，不需要额外代理，适合不想折腾网络的新手用户。

四、保存并测试模型

参数填写完成后，点击「保存」。

然后回到 Cherry Studio 主界面：

  1. 新建一个对话
  2. 在模型列表中选择刚刚配置的 Encore Claude
  3. 选择模型 claude-sonnet-4-6
  4. 输入测试问题，例如：
请用 300 字总结一下 Claude 模型适合哪些使用场景。

如果能正常返回内容，说明 Cherry Studio 已经成功接入 Claude。

建议测试问题

你也可以继续测试这些场景：

请把下面这段中文翻译成自然英文。

请帮我写一个 Python requests 调用 OpenAI Compatible API 的示例。

请总结这篇文章的核心观点，并列出 5 条要点。

如果连续几次都能稳定返回，说明 API、模型名和余额都没有问题。

五、不同 API 服务简单对比

我实际测试过几类常见 API 服务，简单总结如下：

服务类型 优点 缺点 适合人群
官方 Anthropic API 原生 Claude，稳定性高 国内访问和支付门槛较高 海外开发者
OpenAI 官方 API 文档完善，生态好 国内使用不方便 有海外环境用户
Google Gemini API 长上下文强 配置和访问有门槛 技术用户
OpenRouter 模型多 国内网络不一定稳定 会折腾的用户
硅基流动等国内平台 国内访问方便 Claude/GPT/Gemini 覆盖不一定全 国产模型用户
块乐 Encore 国内直连，Claude/GPT/Gemini 全家桶，兼容 OpenAI 格式 需要先注册充值 国内新手和开发者

如果目标是「Cherry Studio 接入 Claude」，并且希望配置简单、国内可用，Encore 这种兼容 OpenAI 的聚合 API 会更省心。

六、常见问题排查

1. 报错 401 Unauthorized

401 通常是 API Key 错误。

请检查：

  • API Key 是否复制完整
  • 是否多复制了空格
  • 是否填错到 Base URL 位置
  • Key 是否已经被删除或禁用

正确格式通常类似：

sk-xxxxxxxxxxxxxxxx

2. 提示余额不足

如果接口返回余额不足、额度不足、insufficient balance 等提示，说明账号内余额不够。

解决方法：

  1. 登录 https://stillhappy.cn
  2. 查看账户余额
  3. 充值后重新测试
  4. 确认当前模型是否价格较高

Claude、GPT、Gemini 不同模型价格不同，建议先用少量问题测试。

3. 模型名错误

如果提示 model not found、invalid model 或模型不存在，通常是模型名写错。

请确认模型名是否和后台文档一致，例如：

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

注意不要写成 claude sonnet 4.6、Claude-Sonnet 这类非标准格式。

4. Base URL 填错

Base URL 必须填写完整地址：

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

不要漏掉 https://，也不要只填域名。

5. Cherry Studio 没有显示模型

如果模型列表为空，可以尝试：

  • 手动添加模型名
  • 重启 Cherry Studio
  • 检查服务商是否启用
  • 确认 API Key 和 Base URL 已保存

七、总结

Cherry Studio 接入 Claude 的核心其实只有三步：选择 OpenAI Compatible 服务商、填写 Base URL 和 API Key、添加正确模型名。对于国内用户来说，使用块乐 Encore 这类国内直连 API，可以减少网络、账号和模型切换带来的麻烦。

如果你想在 Cherry Studio 里同时使用 Claude、GPT、Gemini，可以直接注册块乐 Encore 获取 API Key：
https://stillhappy.cn

配置完成后，建议先用短问题测试，再逐步用于写作、翻译、代码和长文总结等真实场景。

常见问题

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）不需要 VPN，国内可以直连，适合新手快速配置 Claude、GPT、Gemini。

Q: Claude API Key 在哪里获取？
A: 如果用 Encore API，可以在 https://stillhappy.cn 注册账号后进入控制台创建 API Key，复制 sk- 开头的密钥填入 Cherry Studio。

Q: Cherry Studio 提示 401 是什么原因？
A: 401 一般是 API Key 错误或失效。重新复制 Encore 后台的 key，确认没有空格、没有填错位置即可。

Q: Cherry Studio 可以同时用 GPT 和 Gemini 吗？
A: 可以。Encore 支持 Claude / GPT / Gemini 全家桶，在同一个 Base URL 下切换 claude-sonnet-4-6、gpt-5、gemini-2.5-pro 等模型即可。

SEO Title: Cherry Studio 接入 Claude 配置教程 2026：国内直连 API 设置方法
SEO Description: 本文详细介绍 Cherry Studio 如何接入 Claude API，包括下载安装、Base URL、API Key、模型名配置、测试方法和 401、余额不足、模型名错误等常见问题。
SEO Keywords: Cherry Studio 接入 Claude 教程, Cherry Studio 配置 Claude API, Claude API 国内直连, 块乐 Encore API, stillhappy.cn

Cherry Studio 接入 Claude 教程
相关阅读
1 Cline 配置 API 完整教程 2 Cursor 配 Claude API 完整教程 3 Cherry Studio 接入 GPT-5.5 4 Continue.dev 接入 Claude 5 Cline 配置 API 中转 6 Aider 接入 Claude Sonnet