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

Cherry Studio 接入 Claude 教程

Cherry Studio 接入 Claude 教程 2025 很多人用 Cherry Studio，是因为它本地体验好、界面清爽、适合把多个大模型统一管理。如果你想在一个客户端里直接使用 Claude，同时也保留 GPT、Gemini 等模型的切换能力，那么给 Cherry Studio 配置一个稳定的 API 就非常实用。本文用新手能跟上的方式，带你一步

Cherry Studio 接入 Claude 教程 2025

很多人用 Cherry Studio，是因为它本地体验好、界面清爽、适合把多个大模型统一管理。如果你想在一个客户端里直接使用 Claude，同时也保留 GPT、Gemini 等模型的切换能力，那么给 Cherry Studio 配置一个稳定的 API 就非常实用。本文用新手能跟上的方式，带你一步步完成 Cherry Studio 接入 Claude。

一、准备工作：先了解这次要配置什么

这篇教程里，我们用的是 块乐 Encore 的 API，特点是：

  • 国内直连
  • 支持 Claude / GPT / Gemini 全家桶
  • 注册后即可获取 API Key
  • 适合在 Cherry Studio 这类客户端中统一接入

获取地址：

你最终在 Cherry Studio 里要填的核心参数，一般就是这几项：

Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
模型名: claude-sonnet-4-6

除了 Claude，你也可以切换其他模型，例如：

gpt-5
gemini-2.5-pro

二、下载安装 Cherry Studio

如果你还没有安装 Cherry Studio，先完成客户端安装。

1. 下载客户端

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

  • Windows
  • macOS
  • Linux

建议优先下载稳定版，不要一开始就使用测试版，避免界面和菜单与教程不一致。

2. 安装并启动

下载完成后，按系统提示安装即可。首次打开 Cherry Studio 后，你会看到主界面，一般左侧是会话区，中间是聊天窗口，设置入口通常在左下角头像、齿轮图标或顶部菜单中。

三、打开设置，找到模型提供方配置入口

安装完成后，下一步就是进入设置页面。

操作步骤

  1. 打开 Cherry Studio
  2. 点击左下角的 设置 或 齿轮图标
  3. 找到类似以下名称的菜单：
    • 模型服务商
    • 提供商
    • Model Provider
    • API 设置

不同版本的 Cherry Studio，名称可能略有区别，但核心思路一样：找到新增 API 提供方的位置。

你要做的事

在这里添加一个兼容 OpenAI 格式的接口，或者选择“自定义提供商”。因为很多聚合 API 都支持 OpenAI 兼容协议，所以 Cherry Studio 能比较方便地接入。

四、配置 API：把 Claude 接入 Cherry Studio

这是最关键的一步。下面给你一套可以直接参考的配置示例。

1. 先获取 API Key

打开块乐 Encore 官网注册并登录：

进入后台后，找到 API Key 管理 或类似页面，创建一个新的 Key。你会得到类似这样的密钥：

sk-xxx

复制保存好，不要泄露给他人。

2. 在 Cherry Studio 中新增接口配置

在 Cherry Studio 的模型提供方页面，点击：

  • 新增提供商
  • 或 添加自定义 API
  • 或 Add Provider

然后填写以下参数。

Claude 配置示例

名称: Claude / Encore
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
模型名: claude-sonnet-4-6

如果界面里有“接口类型”“兼容格式”等选项，可以优先选择：

OpenAI Compatible

推荐填写方式

参数项 示例值
Provider Name Encore Claude
Base URL https://api-ic.stillhappy.cn/v1
API Key sk-xxx
Model claude-sonnet-4-6

3. 补充：其他模型也能一起配

如果你不只想用 Claude，也可以在同一个 API 里继续添加其他模型。

例如：

GPT 模型示例

Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
模型名: gpt-5

Gemini 模型示例

Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
模型名: gemini-2.5-pro

这样做的好处是：你可以在 Cherry Studio 里一键切换不同模型，而不用来回换平台。

4. 保存配置

填写完成后，点击：

  • 保存
  • 应用
  • 确认

如果 Cherry Studio 支持“拉取模型列表”或“刷新模型”，可以顺手点一下。
如果没有自动拉取功能，也可以手动输入模型名。

五、测试是否接入成功

配置完成后，不要急着正式使用，先做一次简单测试。

测试方法

  1. 回到 Cherry Studio 主界面
  2. 新建一个聊天会话
  3. 在模型选择栏中切换到你刚刚添加的模型：
    • claude-sonnet-4-6
  4. 输入一段简单提示词，例如：
请用 100 字介绍一下 Cherry Studio 的用途。

判断是否成功

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

如果你还能看到响应速度正常、没有报错、上下文连续对话也可用，那就表示配置已经基本没问题了。

建议再测 2 个问题

为了确认不是偶然成功，建议再测两类请求：

1）普通问答

帮我列出 5 个适合新手的 AI 客户端。

2）长一点的写作任务

写一段 200 字的产品介绍，语气专业一点。

如果两类请求都能正常输出，说明你的 API、模型名、Base URL 基本都配置正确。

六、常见问题排查

下面是新手最常遇到的几个问题，建议对照检查。

1. 报错 401 Unauthorized

现象

发送消息后，系统提示：

  • 401
  • Unauthorized
  • Invalid API Key

原因

通常是以下几种情况：

  • API Key 填错了
  • 多复制了空格
  • Key 已失效
  • 选错了接口地址

解决方法

重点检查这三项：

Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
模型名: claude-sonnet-4-6

尤其注意：

  • sk-xxx 前后不要有空格
  • 不要把官网地址错填成 API 地址
  • Base URL 要带 /v1

2. 提示余额不足 / 配额不足

现象

报错可能类似：

  • Insufficient Balance
  • Quota Exceeded
  • 余额不足

原因

账户内可用额度不够，或者当前 key 没有可用配额。

解决方法

  1. 登录块乐 Encore 后台：https://stillhappy.cn
  2. 检查账户余额
  3. 查看该 Key 是否被限制
  4. 必要时充值或重新创建 Key

如果你切的是高成本模型，消耗也会更快，Claude、GPT、Gemini 不同模型的费用可能不同。

3. 模型名填写错误

现象

报错可能是：

  • Model not found
  • Invalid model
  • No such model

原因

模型名称必须严格按平台支持的名字填写，少一个字符都可能报错。

正确示例

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

解决方法

  • 不要自己凭感觉缩写
  • 不要写成中文名
  • 到后台确认当前支持的模型列表
  • 复制模型名时注意中横线和小数点位置

4. Base URL 填错，导致一直连接失败

现象

  • 无响应
  • 网络错误
  • 404 / 405
  • 接口无法访问

原因

最常见的是把地址填成了官网地址，或者少写了 /v1。

正确示例

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

错误示例

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

Cherry Studio 对接口路径通常比较敏感，建议完全按示例填写。

5. 已经保存了，但模型列表不显示

原因

某些版本的 Cherry Studio 不会自动拉取模型，或者需要你手动添加模型名。

解决方法

  • 手动新增模型
  • 直接填写：claude-sonnet-4-6
  • 保存后重启 Cherry Studio
  • 再次进入会话页面切换模型

七、推荐的新手配置方案

如果你是第一次用，建议直接按下面这套最简方案来。

Claude 首选方案

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

备用模型方案

Provider Name: Encore GPT
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model: gpt-5

Provider Name: Encore Gemini
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model: gemini-2.5-pro

这样你在 Cherry Studio 里就能快速体验：

  • Claude 写作与分析
  • GPT 通用对话与工具调用
  • Gemini 多场景补充使用

八、总结

Cherry Studio 接入 Claude 并不复杂，核心就是三件事：

  1. 安装 Cherry Studio
  2. 获取可用 API Key
  3. 正确填写 Base URL、模型名和密钥

这篇教程里用的是块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶。如果你希望在一个客户端里统一管理多个模型，这种方式会非常省心。

建议你现在就动手试一下，先按本文配置 claude-sonnet-4-6，成功后再继续添加 gpt-5 和 gemini-2.5-pro。
Encore 主站链接：

Meta Title: Cherry Studio 接入 Claude 教程 2025：API 配置完整步骤
Meta Description: 详细讲解 Cherry Studio 如何接入 Claude，包含 Base URL、API Key、模型名配置示例，并附 401、余额不足、模型名错误等常见问题解决方案。
Meta Keywords: Cherry Studio 接入 Claude 教程, Cherry Studio API 配置, Claude API 教程, Encore API, stillhappy.cn

Cherry Studio 接入 Claude 教程
相关阅读
1 Cursor 配 Claude API 完整教程 2 NextChat 配置 OpenAI API