5分钟让 Cherry Studio 跑上 DeepSeek：从安装到首轮的完整上手指南
【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent
Cherry Studio 是一款跨平台的开源桌面 AI 客户端，把多模型对话与 300+ 预设助手收进同一个应用。照下面 4 步操作，5 分钟内你就能拥有一个用上 DeepSeek V4 的 Agent，全程不用搭环境，只需填 3 个字段。
接入 DeepSeek 后，Cherry Studio 能干什么
Cherry Studio 把主流大模型服务统一装进一个 App，内置 AI 翻译、知识库与 MCP 服务。DeepSeek V4 接入后自带 100 万 token 上下文与深度思考，相当于给你的每一次对话和知识库检索都加上了超长记忆和先想再答的能力。
动手前，先把两件事备好
✅ 电脑系统是 Windows、macOS 或 Linux 之一，Cherry Studio 对三个平台都提供安装包，无需 Node.js 之类的依赖。 ✅ 已从 DeepSeek 开放平台拿到一个 API Key。
配置界面里要填的 3 个字段如下，建议提前把值记在草稿里：
| 参数 | 应填值 | 填错的后果 |
|---|---|---|
| API 密钥 | 你的完整 DeepSeek Key，别留空格和截断 | 鉴权失败，服务连不上 |
| API 地址 | https://api.deepseek.com，默认值不动即可 | 请求打向错误域名，拉取模型失败 |
| 模型 | deepseek-v4-pro或deepseek-v4-flash | 对话里没有可选模型 |
选型一句话：编码和复杂推理用deepseek-v4-pro，日常问答求快求省用deepseek-v4-flash，两者可同时加入列表。
跑起来只需 4 步
第 1 步：装客户端
从官方发布页下载对应平台的安装包——Windows 是.exe，macOS 是.dmg（Intel 与 Apple Silicon 通用），Linux 可选.AppImage/.deb/.rpm——一路默认安装即可。
第 2 步：填上 DeepSeek 密钥
打开应用，点左下角齿轮进入设置，在左侧导航打开模型服务，找到内置供应商列表里的DeepSeek，把 API Key 粘贴到API 密钥字段，API 地址保持默认https://api.deepseek.com。
第 3 步：拉取模型并启用服务
点击获取模型列表，把deepseek-v4-pro和deepseek-v4-flash加入模型列表，再打开页面右上角的供应商开关，接入即告完成。
第 4 步：建一个 Agent，聊第一轮
进入顶部智能体页，点+ 智能体，填写名称，模型选deepseek-v4-pro，按需挑选权限模式后点添加，打开新建的 Agent 就能对话了。
想要编码和复杂任务拿出最强推理时，点输入框工具栏的灯泡图标，在思维链长度菜单里选穷究，Cherry Studio 会自动映射为reasoning_effort: "max"。
连不上？先查这 3 个地方
- ⚠️拉模型列表失败：API 地址被改动过，把域名逐字核对回
https://api.deepseek.com再试。 - 🔑鉴权失败（401）：Key 不完整或粘错字段，从开放平台重新复制完整密钥，确认粘在API 密钥而非地址栏。
- ⚠️对话里找不到 V4 模型：模型列表没勾，回到服务页点一次获取模型列表，确认
deepseek-v4-pro已勾选。
想深入看看
- Cherry Studio 完整接入指南，含知识库、AI 翻译、MCP 等进阶用法：docs/cherry_studio.zh-CN.md
- 其余 23 款工具的 DeepSeek 接入指南目录与简介：README.zh-CN.md
- 各工具配置界面截图合集：docs/assets/
- 想把全部指南落到本地，克隆仓库即可：
git clone https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
