五分钟把 DeepSeek 接进 Cherry Studio：下载安装到跑通对话的完整指南
【免费下载链接】awesome-deepseek-agent项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-agent
Cherry Studio 是一款跨平台开源桌面 AI 客户端，内置 300+ 预设助手、知识库和 MCP 服务，能在同一个应用里统一接入各家大模型。本文带你从下载安装到配好 DeepSeek、跑通第一次对话，全程只需点几下鼠标，约五分钟搞定。
动手前确认三样：系统、安装包、API Key
- ✅ 系统是 Windows、macOS 或 Linux 之一，能跑对应安装包（.exe / .dmg / .AppImage / .deb / .rpm）
- ✅ 已从 Cherry Studio 官网下载好对应平台的安装包
- ✅ 已在 DeepSeek 开放平台创建 API Key 并完整复制到手
三样都齐了再往下走，中途就不会卡在找资料上。
装完打开应用，先找到模型服务入口
双击安装、打开 Cherry Studio 后，点击左下角的齿轮图标进入设置，再在左侧导航里打开模型服务。
内置 Provider 列表里直接就有深度求索（DeepSeek），不需要手动添加供应商，这是最省事的一点。
三要素填对，DeepSeek 一次接上
DeepSeek 接入任何工具，核心配置都逃不出这三个值：
| 参数 | 应填值 | 填错的后果 |
|---|---|---|
| API 密钥 | DeepSeek 开放平台创建的完整 Key | 401 鉴权失败，无法建立连接 |
| API 地址 | 保持默认https://api.deepseek.com | 请求打到错误地址，连接直接失败 |
| 模型列表 | 点击获取模型列表后，添加deepseek-v4-pro与deepseek-v4-flash | 下拉框里没有模型可选，建不了智能体 |
按顺序操作四步：
- 把 API Key 粘贴到API 密钥字段，API 地址保持默认值不动。
- 点击获取模型列表，拉取当前可用的模型。
- 把
deepseek-v4-pro和deepseek-v4-flash添加进模型列表。 - 打开 DeepSeek 服务页面右上角的开关，启用该 Provider。
建一个智能体，选对模型就能聊
进入顶部智能体页面，点击+ 智能体，填写名称，模型下拉框里选deepseek-v4-pro（想追求响应速度和更低成本就选deepseek-v4-flash），按需选择权限模式后点击添加。
打开新建的 Agent 即可开始对话。DeepSeek V4 默认开启深度思考，且原生支持最高 100 万 token 的上下文窗口，Cherry Studio 默认基于完整窗口运行，无需额外配置。
想要最强推理表现，点一下灯泡图标
写代码或处理复杂任务时，点击输入框工具栏里的灯泡图标，在思维链长度菜单中选中穷究。Cherry Studio 会自动把它映射为 DeepSeek API 的reasoning_effort: "max"，让模型给出最充分的思考。
连不上、没模型时，对照这四个高频坑
- 🔑 报 401 或连接失败 → API Key 复制不完整、夹带空格 → 回开放平台重新完整复制，再粘贴一次
- 🔗 Key 没问题却连不上 → API 地址被手改、多拼了路径 → 把 API 地址改回默认
https://api.deepseek.com - ⚠️ 智能体的模型下拉框是空的 → 没点过获取模型列表→ 回到模型服务页重新拉取，再添加两个模型
- 🤔 模型拿不准用哪个 → 先用
deepseek-v4-pro兜底 → 嫌慢或嫌贵时，在智能体设置里换成deepseek-v4-flash
更多工具和完整指南在哪看
- Cherry Studio 完整接入指南（含英文版）：docs/cherry_studio.zh-CN.md / docs/cherry_studio.md
- 全部 23 款工具的目录与简介：README.zh-CN.md
- 各工具配置界面截图目录：docs/assets/
- 想给仓库补充新工具指南：CONTRIBUTING.md
- 想把全部指南存到本地，克隆仓库即可：
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），仅供参考
