文章目录（15 节）
适用系统：Windows 与 macOS
作者：伯伦
更新日期：2026 年 10 月 18 日
这篇教程带你装好 DeepSeek Harness，登录自己的账号，检查余额并试一次模型连接。想用已有的 API Key，也可以按后面的步骤单独配置。安装或鉴权报错时，先看文末的常见问题。
装过类似软件的，可以先看快速版；第一次用，就跟着详细步骤往下做。文中会给出下载入口和配置方法。遇到界面或价格变化，以官网和自己的账户页面为准。
安装前准备
先看电脑系统和芯片
Windows：打开“开始 → 设置 → 系统 → 关于”，看清系统版本和系统类型。
- 显示“基于 x64 的处理器”，选择 Windows x64、64 位或 AMD64 安装包。
- 显示“基于 ARM 的处理器”，选择 Windows ARM64 安装包，并确认软件支持该架构。
Mac：点击左上角苹果菜单 → 关于本机。
- Apple M 系列芯片，选择 Apple Silicon、ARM64 或 aarch64。
- Intel 处理器，选择 Intel 或 x64。
- 看到 Universal 通用包时，按下载页说明选择，通常可以同时支持两种芯片。
下载 DeepSeek Harness 前，先核对官网要求的系统和芯片，尤其留意 Mac 安装包的适用范围。
账号和工作目录
准备自己的 DeepSeek 账号，并检查开放平台可用余额。选择自定义 API 时，准备自己的有效密钥。账号与密钥由自己保管。
先建一个 AI-Workspace 文件夹。Windows 可以放在用户目录或数据盘，Mac 可以放在“文稿”中，再在里面建一个测试目录：
AI-Workspace/
deepseek-test/第一次验证用空文件夹，权限保留询问或手动确认。选了工作目录，仍要留意后续的权限提示。几款智能体一起处理同一个项目时，先分好各自负责的文件，避免同时改同一份内容。
下载或登录失败时
下载或登录卡住时，先看具体报错，再检查网络、系统时间和官方服务状态。也要确认软件支持你的系统和使用地区，账号符合要求。公司或学校的电脑，还要看管理员是否允许安装和连接。
页面提示地区、账号或付款方式不符合要求时，按官方说明处理。条件暂时不满足，就先用自己能正常访问的工具。
认准产品与费用
这里安装的是 DeepSeek 官方 Harness 桌面端。它和手机 App、网页聊天的入口不同，下载时看清名称。先打开 DeepSeek 官方下载页，找到 DeepSeek Harness。
当前 macOS 桌面下载入口标注 Apple 芯片、macOS 13 或更高版本。Intel Mac 不能直接安装这个 Apple 芯片包；Windows 按下载页提供的版本及架构说明选择。
使用官方模型前，先查同一个 DeepSeek 账号的开放平台余额。选择自定义模型时，费用按对应模型服务的规则计算。相关账户和费用说明见 Harness 用户协议。
快速版
- 从官方页面下载与设备兼容的 Harness 桌面安装包。
- 完成安装并启动。
- 登录自己的 DeepSeek 账号，检查开放平台可用余额。
- 使用账号提供的模型，或在设置中填写自己的 DeepSeek API Key。
- 需要选择目录时打开
deepseek-test，保留操作确认。 - 发送最小连接消息，检查回复及用量。
详细步骤
第一步 下载并安装
在 官方下载页 找到 Harness 的 Windows 或 macOS 入口。
Windows：双击安装程序，按提示完成安装。Mac：打开 .dmg，把 Harness 拖入“应用程序”，复制结束后从已安装应用启动。
首次安装用官网桌面包，按安装提示操作即可。
第二步 登录并检查余额
使用自己的 DeepSeek 账号登录。通过浏览器完成验证时，按提示返回 Harness。
再打开 DeepSeek 开放平台，检查同一个账号的余额和模型用量。是否有赠送额度，以账户实际显示为准。
第三步 按需要添加 API Key
使用账号里的官方模型，先按默认登录流程走。要填自己的 API Key，就打开“设置 → 模型 / Settings → Models”，找到 DeepSeek 提供方，填好后保存。已有有效密钥的可以复用；想分开管理，也可以为不同应用各建一枚。
内置 DeepSeek 提供方先保留默认接口设置。https://api.deepseek.com/anthropic 对应 Anthropic 兼容协议，不能不看协议就拿来覆盖这里的地址。参见 Harness 模型配置指南。
第四步 验证
新建会话，选择可用模型。需要目录时选择 deepseek-test，发送：
只回复“连接成功”。不要读取或修改文件，也不要运行命令。收到回复后，去开放平台看一下用量，再退出、重开 Harness，确认账号和模型配置还在。
常见问题
| 情况 | 处理方法 |
|---|---|
| Mac 无法安装 | 核对芯片与 macOS 版本；当前官网该桌面包面向 Apple 芯片 |
| 已登录但模型不可用 | 检查账号余额、服务状态和客户端更新 |
| 保存后看不到密钥全文 | 先检查保存状态，再做最小验证，不反复创建密钥 |
| 401 | 核对密钥及其所属账号，确认未被撤销 |
| 持续等待或连接失败 | 查看网络、服务状态和当前额度，再决定是否重试 |
更新使用应用内入口或 Harness 官方页面。
装好后检查这几项
- 安装的是 DeepSeek Harness 官方桌面端，能够正常启动。
- 账号或自定义 API 配置可用，模型有回复，相应账户的调用用量可以核对。
- 退出并重开后，仍能进入账号和选择模型；需要文件操作时，另行检查工作区与权限。
常用词
| 名称 | 意思 |
|---|---|
| 智能体或 Agent | 能按授权调用工具、执行任务的程序 |
| API | 软件向模型服务发起请求的接口 |
| API Key | 调用凭证，可能消耗对应账户的余额 |
| 模型提供方或供应商 | 提供模型接口、处理请求并按规则计费的服务方 |
| 客户端 | 你在电脑上打开和操作的软件 |
| 工作目录 | 本次任务准备读写的文件夹，需要结合权限设置使用 |
| Skill | 给智能体使用的一组操作说明与配套资源，适合反复执行同类任务 |
| 工作流 | 一项工作分几步完成、用什么工具，以及在哪里检查结果 |
常用快捷键
| 操作 | Windows | macOS |
|---|---|---|
| 复制 | Ctrl + C | Command + C |
| 粘贴 | Ctrl + V | Command + V |
| 保存 | Ctrl + S | Command + S |
| 打开文件管理器 | Win + E | 打开 Finder |
| 搜索应用 | 开始菜单后输入名称 | Command + 空格 |
| 退出当前应用 | 使用应用菜单或托盘中的退出 | Command + Q |
有问题想问？
文章内容、工具使用或者发现哪里写错了，都可以告诉我。
- 微信Bienberlain_1024
- 邮箱bienberlain@outlook.com
扫码添加时请说明来意
欢迎反馈文章中的错误，也欢迎交流学习心得和工具使用经验。 联系时请说明对应文章或问题，请勿发送账号密码、验证码等敏感信息。隐私说明