DeepSeek Hermes是什么？Hermes Agent安装教程、接入DeepSeek API与和Harness区别

Q: 必须用 deepseek-v4-pro 吗？

接入文档示例选 deepseek-v4-pro。Flash 更便宜，能否在 Hermes 里选，取决于提供商列表和你的账号权限，以 hermes model 与 DeepSeek 定价页为准。

Q: Key 写了但不生效？

确认文件在 ~/.hermes/.env，保存后重启 Hermes；首次接入用 hermes setup 或 hermes model，不要只靠会话里的 /model。

依据 DeepSeek API Docs「接入 Hermes」与 Hermes Agent 官方安装文档整理，核查 2026-10-14（新加坡时间）。

主题标签：DeepSeek Hermes、Hermes Agent安装、DeepSeek接入Hermes、Nous Hermes、deepseek-v4-pro

没有叫「DeepSeek Hermes」的官方产品或模型。搜索结果里这个词，多半是把两件事拼在一起：一边是DeepSeek的大模型 API，一边是 Nous Research 开源的 Hermes Agent。DeepSeek 官方文档专门有一页「接入 Hermes」：先把 Hermes 装好，再在配置里把模型提供商选成 DeepSeek，填 API Key 和 Base URL，示例模型写的是 deepseek-v4-pro。下面按官方材料说明它是什么、怎么装、怎么接到 DeepSeek，以及为什么容易和 Harness 搞混。

DeepSeek Hermes 到底指什么

Hermes Agent 是 Nous Research 做的开源 AI Agent，可以在本机跑命令、配工具网关、接多种模型提供商。DeepSeek 不是 Hermes 的开发方，而是 Hermes 支持的模型后端之一。所以更干净的说法是「用 Hermes 调用 DeepSeek」，而不是「去官网下一个叫 DeepSeek Hermes 的独立 App」。

名字	是什么	谁做的	常见入口
Hermes Agent	开源本地 Agent（CLI / 桌面包）	Nous Research	hermes-agent.nousresearch.com
DeepSeek API	大模型推理接口	DeepSeek	api.deepseek.com
DeepSeek Harness（dsh）	DeepSeek 自己的开源 Agent 框架	DeepSeek	deepseek.com/download、GitHub deepseek-ai/deepseek-harness

想看 DeepSeek 自家桌面端，读DeepSeek Harness 桌面版；模型档位读DeepSeek V4 Flash 和 V4 Pro 区别。站内工具入口还可从终端编程智能体、AI开发与智能体、国产AI助手找起。

安装 Hermes：官方脚本怎么跑

DeepSeek 文档与 Hermes 安装页给出的命令一致。前置条件：Linux / macOS / WSL2 需要 Git；其余由安装脚本处理。Windows 可用原生 PowerShell 脚本，不一定非上 WSL。

Linux / macOS / WSL2：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
或官方域名一键：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows 原生（PowerShell）：iex (irm https://hermes-agent.nousresearch.com/install.ps1)
装完后重新打开终端（或执行 source ~/.bashrc / source ~/.zshrc），确认 hermes 在 PATH 里。
也可以从 Hermes 官网下载 macOS / Windows 桌面安装包；纯 CLI 装好后还能再跑 hermes desktop。
出问题先跑 hermes doctor，它会指出缺什么依赖、配置漂到哪了。

POSIX 源码安装后，代码多在 ~/.hermes/hermes-agent/，启动器常见于 ~/.local/bin/hermes，用户数据默认在 ~/.hermes/。若提示 hermes: command not found，九成是没刷新 PATH，而不是装失败。

接到 DeepSeek：setup 与 model

按 DeepSeek「接入 Hermes」页的推荐路径：

执行 hermes setup，选 Quick Setup。
模型提供商选 DeepSeek。
填入 DeepSeek API Key；Base URL 填 https://api.deepseek.com。
模型选 deepseek-v4-pro（文档示例；你账号里若开放 Flash，也可在 hermes model 里改，以实际列表为准）。
完成其余选项后输入 hermes 开始对话。

以后改提供商或 Key，优先用 hermes model；会话内的 /model 只切换已经配好的项，不适合第一次接入。也可以把 Key 写进 ~/.hermes/.env（例如 DEEPSEEK_API_KEY=...），切记不要把真实密钥提交到 Git 仓库。若走兼容中转，在 hermes model 选 Custom endpoint，填对方给的 Base URL、Key、模型 ID，不要死抄过期教程里的旧模型名。

API Key 在 DeepSeek 开放平台申请，站内可从DeepSeek进入。也有人经OpenRouter聚合路由，但对 Hermes 来说内置 DeepSeek 提供商步骤最少。若你更习惯编辑器内 Agent，可对照Cursor、Claude Code、Continue的配置习惯，思路类似：模型后端和「壳」是分开的。

和 DeepSeek Harness 别混、别装错包

拼写只差几个字母，产品完全不同。Harness 命令行常写作 dsh，仓库是 deepseek-ai/deepseek-harness，下载页在 deepseek.com/download。Hermes 来自 Nous。搜「DeepSeek Hermes 桌面版」时，结果里经常夹杂 Harness 教程，装错包是新手最常见的坑。本地客户端若只想聊天，也可以先看Cherry Studio这类多模型壳，再决定要不要上全功能 Agent。

使用时注意的几件事

Agent 能执行本机命令，等于拥有你当前用户的权限；不要在装了生产密钥的目录里随便开「全自动」。
第一次建议用小任务验证：列目录、读一个无关紧要的文件、再问模型一个简单问题，确认走的是 DeepSeek 而不是别的默认提供商。
费用在 DeepSeek 侧按 token 计，和 Hermes 本身是否开源无关；档位差价见Flash 与 Pro 区别。
更新后若配置项搬家，按官方提示跑 hermes config check / hermes config migrate，不要凭旧截图硬改 YAML。

常见问题

DeepSeek Hermes 是官方模型吗？

不是。没有官方模型名叫 DeepSeek Hermes。它通常指 Hermes Agent + DeepSeek API 这一组合。

必须用 deepseek-v4-pro 吗？

接入文档示例选 deepseek-v4-pro。Flash 更便宜，能否在 Hermes 里选，取决于提供商列表和你的账号权限，以 hermes model 与 DeepSeek 定价页为准。

Windows 一定要 WSL 吗？

不必。官方提供原生 Windows 安装脚本；也可以在 WSL2 里走 Linux 安装路径。

Key 写了但不生效？

确认文件在 ~/.hermes/.env，保存后重启 Hermes；首次接入用 hermes setup 或 hermes model，不要只靠会话里的 /model。

和 ChatGPT / Claude 客户端冲突吗？

一般不冲突，它们是不同进程。只要端口、全局代理规则别互相抢即可。对比产品可看ChatGPT、Claude。

延伸阅读：DeepSeek V4.1-Flash是什么、智能体与本地模型工作流、AI编程怎么选。分类：国产大模型API、AI编程与建站、本地大模型。

来源与核查日期

核查日期：2026-10-14（新加坡时间）。安装命令与模型名以官方文档最新页为准；本文不提供任何破解或绕过计费的方法。

DeepSeek Hermes是什么？安装教程与接入DeepSeek API