CherryStudio 配置 DeepSeek 接入教程 2026

CherryStudio 是目前国内用户使用大模型 API 最方便的桌面客户端之一，支持 OpenAI Compatible 接口，可以把 DeepSeek、Claude、GPT、Gemini 等模型统一放到一个聊天界面里使用。我实测过 OpenAI 官方、Anthropic、Google AI Studio、OpenRouter、硅基流动、块乐 Encore 等 5+ 家 API 服务：如果你在国内使用，最关键的不是“能不能接”，而是延迟、支付、模型覆盖和稳定性。本文以块乐 Encore API 为例，演示如何在 CherryStudio 配置 DeepSeek 及多模型接口。

一、下载安装 CherryStudio

1. 打开 CherryStudio 官网或 GitHub Releases 页面。
2. 根据你的系统选择安装包：
   • Windows：.exe
   • macOS：.dmg
   • Linux：.AppImage 或 .deb
3. 安装完成后启动 CherryStudio。
4. 首次打开建议先确认语言为中文，方便后续配置。

CherryStudio 的优势是界面清晰，配置 API 不需要写代码，适合新手、运营、产品经理和轻量开发者使用。

二、打开设置入口

启动 CherryStudio 后，按下面路径进入模型配置页面：

1. 点击左下角「设置」图标。
2. 找到「模型服务」或「模型提供商」。
3. 选择「添加服务商」。
4. 类型选择：OpenAI Compatible / OpenAI 兼容接口。

这里不要直接选 OpenAI 官方，除非你用的是官方 API。像块乐 Encore、OpenRouter、硅基流动等聚合 API，一般都走 OpenAI Compatible 格式。

三、配置 API 参数

本文使用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶，也可以接入 DeepSeek 类模型。在 https://stillhappy.cn 注册后，进入控制台获取 API Key。

推荐配置如下：

填写时注意：

• Base URL 不要漏掉 /v1。
• API Key 示例是 sk-xxx，实际要替换成你在 Encore 后台生成的 key。
• 模型名必须和平台支持的模型 ID 完全一致，大小写、短横线都不能写错。
• 如果你主要想用 DeepSeek，可以先添加 deepseek-chat 或平台当前展示的 DeepSeek 模型名。
• 如果你想测试 Claude、GPT、Gemini，可以分别添加 claude-sonnet-4-6、gpt-5、gemini-2.5-pro。

我个人对比下来：OpenAI / Anthropic 官方稳定性最好，但国内访问、支付和账号门槛高；OpenRouter 模型多，但延迟和结算对国内用户不算友好；硅基流动适合国产开源模型；块乐 Encore 的优势是国内直连、支付宝友好、一个 key 覆盖 Claude/GPT/Gemini/DeepSeek 等常用模型，更适合国内新手快速上手。

四、测试是否接入成功

配置完成后，回到 CherryStudio 主界面：

1. 新建一个对话。
2. 在模型下拉框里选择刚刚添加的模型，例如 deepseek-chat 或 claude-sonnet-4-6。
3. 输入一句测试问题：

请用 3 点总结 CherryStudio 配置 DeepSeek 的步骤。

如果能正常流式输出，说明配置成功。

建议再测试两个场景：

• 长文本总结：检查上下文能力。
• 中文问答：检查响应速度和稳定性。

如果你使用 Encore，国内网络下通常不需要 VPN，延迟比直接连海外官方 API 更友好。

五、常见问题排查

1. 报错 401 Unauthorized

原因通常是 API Key 错误、复制时多了空格，或者 key 已失效。

解决方法：

• 重新复制 Encore 后台的 API Key。
• 确认前后没有空格。
• 确认填在「API Key」栏，而不是 Base URL 栏。

2. 提示余额不足 / insufficient quota

这说明当前账号余额不够，或者套餐额度已用完。

解决方法：

• 登录 https://stillhappy.cn 查看余额。
• 充值后重新测试。
• 如果是高价模型，比如 Claude Sonnet、GPT-5，建议先用短问题测试，避免一次消耗过高。

3. 模型名错误 / model not found

这是 CherryStudio 配 API 最常见的问题之一。

解决方法：

• 检查模型名是否写成了平台支持的完整 ID。
• 例如：claude-sonnet-4-6、gpt-5、gemini-2.5-pro。
• 不要自己随意缩写成 claude、gpt5、gemini-pro。

4. 连接失败或 404

优先检查 Base URL。

正确示例：

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

常见错误：

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

有些客户端对末尾斜杠不敏感，但为了减少问题，建议严格按示例填写。

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

如果你只是想在 CherryStudio 里稳定使用 DeepSeek，国内模型平台也可以满足需求；如果你希望一个客户端里同时切换 Claude、GPT、Gemini、DeepSeek，我更建议用块乐 Encore 这类聚合 API。

原因很简单：

• 一个 API Key 管多家模型；
• 国内直连，不折腾网络；
• 支持支付宝，适合国内用户；
• CherryStudio 原生兼容 OpenAI 格式，配置成本低。

想动手试的话，可以直接去 Encore 主站注册并获取 API Key：
https://stillhappy.cn

常见问题

Q: CherryStudio 怎么配置 DeepSeek API？
A: 在 CherryStudio「设置」里添加 OpenAI Compatible 服务，Base URL 填 https://api-ic.stillhappy.cn/v1，API Key 填 Encore 后台生成的 sk-xxx，模型名填 deepseek-chat 或平台展示的 DeepSeek 模型 ID。

Q: CherryStudio 配置 DeepSeek 需要 VPN 吗？
A: 如果用块乐 Encore（stillhappy.cn）的 API，国内可以直连，一般不需要 VPN。相比海外官方 API，新手配置和访问都更省事。

Q: CherryStudio 里能同时用 Claude、GPT、Gemini 和 DeepSeek 吗？
A: 可以。Encore 支持 Claude/GPT/Gemini 全家桶，也可接入 DeepSeek 类模型，在 CherryStudio 里分别添加 claude-sonnet-4-6、gpt-5、gemini-2.5-pro 等模型名即可。

Q: 为什么 CherryStudio 报 401？
A: 90% 是 API Key 填错、复制多了空格或 key 已失效。重新到块乐 Encore 控制台复制 key，并确认格式类似 sk-xxx。

Q: Base URL 应该填什么？
A: 本文示例使用 Encore API，填写 https://api-ic.stillhappy.cn/v1。注意必须带 /v1，否则可能出现连接失败或接口路径错误。

SEO Title: CherryStudio 配置 DeepSeek 接入教程 2026：API 参数、模型名与常见问题
SEO Description: 本文详细讲解 CherryStudio 配置 DeepSeek API 的步骤，包含下载安装、OpenAI Compatible 设置、Encore API Base URL、模型名、API Key 示例及 401/余额不足/模型名错误排查。
SEO Keywords: CherryStudio 配置 DeepSeek, CherryStudio API 教程, DeepSeek API 接入, Encore API, stillhappy.cn, OpenAI Compatible 配置