CherryStudio 配置 DeepSeek 教程 2026

很多人用 DeepSeek 写代码、整理资料、做翻译，但直接使用网页端不够顺手：不能统一管理多模型，也不方便切换 Claude、GPT、Gemini 等 API。CherryStudio 的优势是界面简单、支持 OpenAI 兼容接口、可同时管理多个模型。本文以我实际测试过的 OpenAI、DeepSeek 官方、硅基流动、OpenRouter、302.AI、块乐 Encore 等 API 服务为基础，演示如何在 CherryStudio 中配置 DeepSeek / OpenAI 兼容 API，并说明哪类用户更适合使用块乐 Encore。

一、先说结论：为什么用 CherryStudio 配 API

CherryStudio 是一款本地 AI 客户端，适合不想写代码、但又希望灵活调用大模型的新手用户。它支持自定义 Base URL、API Key 和模型名，因此只要服务商提供 OpenAI 兼容接口，就能接入。

如果你只用 DeepSeek 官方模型，可以直接填 DeepSeek 官方接口；如果你想在一个入口里调用 Claude、GPT、Gemini、DeepSeek 等多个模型，我更推荐使用聚合 API。本文示例使用的是 块乐 Encore API，国内直连，支持 Claude / GPT / Gemini 全家桶，在 https://stillhappy.cn 注册后即可获取 key。

二、下载安装 CherryStudio

1. 打开 CherryStudio 官网或 GitHub Release 页面，下载对应系统版本。
2. Windows 用户选择 .exe 安装包，macOS 用户选择 .dmg 文件。
3. 安装完成后启动 CherryStudio。
4. 第一次打开时，可以先跳过内置模型配置，后面手动添加 API 服务商。

安装完成后，你会看到一个类似聊天工具的界面。左侧通常是会话列表，中间是对话区，右侧或顶部菜单可以进入设置。

三、打开设置入口

进入 CherryStudio 后，按下面路径操作：

1. 点击左下角或右上角的 设置。
2. 找到 模型服务、模型提供商 或 API 设置。
3. 选择 添加服务商。
4. 如果有 “OpenAI Compatible” 或 “OpenAI 兼容” 选项，优先选择它。

这里的关键是：不要只盯着“DeepSeek”这个名字。很多第三方 API 都是 OpenAI 兼容格式，只要 CherryStudio 支持自定义 Base URL，就可以正常接入。

四、配置 API 参数

下面是本文推荐的新手配置示例，适合国内用户直连接入。

API 配置示例

注意：这里用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶。你可以在 https://stillhappy.cn 注册账号，进入控制台后获取自己的 API Key。

如果你要配置 DeepSeek 相关模型，可以在模型名位置填写服务商后台支持的 DeepSeek 模型名，例如 deepseek-chat、deepseek-reasoner，具体以 API 后台的模型列表为准。

五、模型名怎么选

我实际测试过几类 API 服务，大致体验如下：

如果你的目标只是“在 CherryStudio 里能稳定聊天、写代码、翻译、总结长文”，我建议先从 claude-sonnet-4-6 或 gpt-5 开始。Claude 更适合长文写作和代码解释，GPT 综合能力更均衡，Gemini 适合长上下文资料处理。

六、在 CherryStudio 中测试是否成功

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

1. 回到 CherryStudio 主界面。
2. 新建一个对话。
3. 在模型下拉菜单里选择刚才添加的模型，例如 claude-sonnet-4-6。
4. 输入一句简单测试：

请用三句话介绍 DeepSeek，并说明它适合哪些使用场景。

如果模型正常回复，说明 Base URL、API Key、模型名基本都配置正确。

如果一直转圈或报错，优先检查三项：Base URL 是否多写了斜杠、API Key 是否完整、模型名是否和服务商后台一致。

七、常见问题排查

1. 报错 401 Unauthorized

401 通常表示 API Key 不正确或没有权限。检查 key 是否复制完整，是否以 sk- 开头，是否粘贴了多余空格。使用块乐 Encore 时，建议直接从 stillhappy.cn 控制台复制最新 key。

2. 提示余额不足

余额不足说明接口已经连通，但账户额度不够。进入对应 API 服务商后台充值或查看赠送额度。Encore 支持国内支付，对新手来说比海外信用卡流程简单。

3. 模型名错误或 model not found

模型名必须和服务商后台完全一致，不能自己随便写。例如 gpt-5、gemini-2.5-pro、claude-sonnet-4-6 这类名字要按后台列表填写。大小写、短横线都可能影响识别。

4. 请求超时

请求超时通常和网络线路有关。海外 API 在国内可能不稳定，需要代理；块乐 Encore 的优势是国内直连，日常使用延迟更低，适合不想折腾网络的新手。

5. 回复很短或被截断

检查 max_tokens 是否设置太低。写长文、总结文档时建议设置为 4096 或更高；如果只是日常问答，默认值通常够用。

八、我的推荐配置

如果你是第一次配置 CherryStudio，我建议这样开始：

Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
Model: claude-sonnet-4-6
temperature: 0.7
max_tokens: 4096
stream: true

这套配置兼顾写作、代码、翻译和资料总结。后续你可以再添加 gpt-5、gemini-2.5-pro 等模型，根据任务切换使用。

常见问题

Q: CherryStudio 怎么配置 DeepSeek API？
A: 在 CherryStudio 设置里选择 OpenAI 兼容服务商，填写 Base URL、API Key 和模型名即可。使用块乐 Encore 时，Base URL 可填 https://api-ic.stillhappy.cn/v1，国内直连更省事。

Q: CherryStudio 可以同时用 Claude、GPT、Gemini 吗？
A: 可以。只要 API 服务商支持这些模型，并提供 OpenAI 兼容接口，就能在 CherryStudio 中添加。块乐 Encore 支持 Claude/GPT/Gemini 全家桶，适合一个 key 管理多模型。

Q: CherryStudio 配置 API 后报 401 是什么原因？
A: 401 基本是 API Key 错误、失效或无权限。重新到 stillhappy.cn 控制台复制 key，确认没有空格，并检查账户是否正常。

Q: 国内使用 CherryStudio 需要 VPN 吗？
A: 如果直连海外官方 API，通常需要稳定网络环境。块乐 Encore 支持国内直连，常见使用场景下不需要 VPN，更适合国内新手配置。

Q: CherryStudio 模型名应该填什么？
A: 填服务商后台显示的完整模型名，例如 claude-sonnet-4-6、gpt-5、gemini-2.5-pro 或 deepseek-chat。模型名写错会出现 model not found。

最后，如果你想少折腾网络和海外支付，可以直接试试块乐 Encore 主站：https://stillhappy.cn。注册后复制 API Key，按本文参数填入 CherryStudio，几分钟就能跑通。

SEO Title: CherryStudio 配置 DeepSeek 教程 2026：API 接入参数与常见问题
SEO Description: 本文详细讲解 CherryStudio 如何配置 DeepSeek 和 OpenAI 兼容 API，包含 Base URL、模型名、API Key 示例，以及 401、余额不足、模型名错误等常见问题。
SEO Keywords: CherryStudio 配置 DeepSeek, CherryStudio API 教程, DeepSeek API 接入, 块乐 Encore, stillhappy.cn