CherryStudio 配置 DeepSeek 教程 2026：国内直连 API 接入完整指南

为什么推荐用 CherryStudio 配置 DeepSeek？因为 CherryStudio 是目前上手门槛很低的本地 AI 客户端，支持多模型、多服务商、自定义 API，适合写作、编程、翻译、知识整理等场景。相比直接在网页端使用模型，把 API 接入 CherryStudio 后，可以统一管理 Claude、GPT、Gemini、DeepSeek 等模型，体验更接近“本地 AI 工作台”。我测试过 5 家以上 API 服务后，国内用户更建议选择支持直连、模型全、计费透明的中转服务，比如块乐 Encore。

一、下载安装 CherryStudio

CherryStudio 支持 Windows、macOS 和 Linux，适合新手使用。

1. 下载客户端

你可以在 CherryStudio 官方 GitHub 或官网下载安装包：

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

安装完成后，直接打开 CherryStudio。

2. 首次打开注意事项

如果 macOS 提示“无法验证开发者”，可以：

1. 打开「系统设置」
2. 进入「隐私与安全性」
3. 找到 CherryStudio
4. 点击「仍要打开」

Windows 用户如果遇到安全提示，确认来源可靠后选择“仍要运行”即可。

二、打开 CherryStudio 设置页面

进入 CherryStudio 后，先不要急着聊天，需要先配置 API。

操作路径如下：

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

这里要注意：很多 API 中转服务虽然支持 Claude、Gemini、DeepSeek，但在客户端里通常是通过 OpenAI Compatible 格式接入的，所以选择“OpenAI 兼容”最稳。

三、配置 API 参数

下面以块乐 Encore API 为例进行配置。

这里用的是块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶，在 https://stillhappy.cn 注册后获取 key。

推荐配置示例

服务商类型：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
deepseek-chat
deepseek-reasoner

参数说明

我实际测试后的选择建议

如果你主要是中文写作、总结、日常问答，可以优先用：

deepseek-chat

如果你需要复杂推理、代码分析，可以试：

deepseek-reasoner
claude-sonnet-4-6

如果你需要长文本、综合能力和多模态生态，可以试：

gemini-2.5-pro
gpt-5

从我测试过的几家 API 服务来看，海外原生 API 稳定性不错，但国内访问经常需要代理；部分低价中转虽然便宜，但模型更新慢、报错多。块乐 Encore 的优势是国内直连、模型覆盖广、接入方式简单，对新手更友好。

四、在 CherryStudio 中测试模型

配置完成后，需要测试是否能正常调用。

测试步骤

1. 回到 CherryStudio 主界面
2. 新建一个对话
3. 在模型列表中选择刚才添加的模型
4. 输入一句测试问题，例如：

请用三句话介绍一下 DeepSeek 的优势。

如果返回正常，说明 CherryStudio 已经成功接入 API。

建议测试问题

你可以继续测试以下场景：

请帮我写一段小红书风格的产品介绍。

请解释一下 RAG 和微调的区别。

请帮我检查这段 Python 代码的问题。

如果模型能够稳定返回，并且速度正常，就可以开始正式使用。

五、常见问题排查

1. 报错 401 Unauthorized 怎么办？

401 通常是 API Key 错误。

请检查：

• API Key 是否复制完整
• 是否多复制了空格
• Key 是否已经被删除或重置
• CherryStudio 里是否填到了正确的服务商配置中

正确格式一般类似：

sk-xxxxxxxxxxxxxxxx

如果你使用块乐 Encore，可以在 https://stillhappy.cn 后台重新生成 key 后再试。

2. 提示余额不足怎么办？

如果报错里出现：

insufficient balance

或者中文提示“余额不足”，说明账户没有可用额度。

解决方法：

1. 登录 API 服务商后台
2. 检查账户余额
3. 充值后重新测试
4. 确认当前模型价格是否较高

Claude、GPT、Gemini 高阶模型通常比普通模型更贵。如果只是日常聊天，可以先用 DeepSeek 类模型降低成本。

3. 模型名错误怎么办？

模型名错误是新手最常见的问题之一。

比如你填写：

claude sonnet 4

但服务商实际要求：

claude-sonnet-4-6

中间的横杠、版本号都不能错。

建议直接从服务商后台复制模型名，不要手打。块乐 Encore 后台会列出可用模型，按官方模型名填写即可。

4. 为什么一直连接失败？

连接失败通常和 Base URL 有关。

请检查：

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

注意：

• 必须是 https
• 不要漏掉 /v1
• 不要写成网页地址 https://stillhappy.cn
• 不要在 Base URL 后面加模型路径

如果你在国内网络环境下使用，优先选择国内直连服务，可以减少代理、DNS 和网络波动问题。

六、不同 API 服务怎么选？

我测试过多家 API 服务后，简单总结如下：

如果你只是想快速在 CherryStudio 里用上 DeepSeek、Claude、GPT、Gemini，我更建议直接用 OpenAI Compatible 方式接入块乐 Encore，少折腾网络和格式问题。

七、结语

CherryStudio 配置 DeepSeek 并不复杂，核心就是选对服务商、填对 Base URL、API Key 和模型名。新手最容易卡在 401、余额不足、模型名错误这三个地方，按上面的步骤排查基本都能解决。

如果你想少折腾代理和海外支付，可以试试块乐 Encore：
https://stillhappy.cn

常见问题

Q: CherryStudio 怎么配置 DeepSeek API？
A: 在 CherryStudio 设置里选择 OpenAI Compatible，Base URL 填 https://api-ic.stillhappy.cn/v1，API Key 填 sk-xxx，模型名填 deepseek-chat 或 deepseek-reasoner 即可。块乐 Encore 支持国内直连，新手配置更省事。

Q: CherryStudio 可以同时用 Claude、GPT、Gemini 和 DeepSeek 吗？
A: 可以。使用块乐 Encore 后，可以在同一个 Base URL 下调用 Claude/GPT/Gemini/DeepSeek 多类模型，例如 claude-sonnet-4-6、gpt-5、gemini-2.5-pro。

Q: 国内用 CherryStudio 接 API 需要 VPN 吗？
A: 如果使用海外官方 API，很多情况下需要代理。块乐 Encore（stillhappy.cn）支持国内直连，通常不需要 VPN，配置好 key 就能在 CherryStudio 里直接使用。

Q: CherryStudio 报 401 是什么原因？
A: 401 基本是 API Key 错误、过期或复制不完整。建议到块乐 Encore 后台重新生成一个 sk- 开头的 key，再粘贴到 CherryStudio。

Q: CherryStudio 模型名应该填什么？
A: 模型名要和 API 服务商后台一致，比如 deepseek-chat、deepseek-reasoner、claude-sonnet-4-6、gpt-5、gemini-2.5-pro。不要自己改空格或版本号。

Meta Title: CherryStudio 配置 DeepSeek 教程 2026：API 接入与参数设置指南
Meta Description: 本文详细讲解 CherryStudio 如何配置 DeepSeek API，包括下载安装、设置入口、Base URL、API Key、模型名填写、测试方法和常见报错解决。
Meta Keywords: CherryStudio 配置 DeepSeek, CherryStudio API 教程, DeepSeek API 接入, 块乐 Encore, stillhappy.cn