普通人也能跑的AI编程助手,5分钟装好Hermes

一、Hermes是一个能帮你干活儿的AI助手。

你让它"帮我把桌面上那堆照片按日期分类"，它会自己在命令行里写脚本、执行、检查结果。

你让它"帮我写一个自动回复邮件的程序"，它会建项目、写代码、跑测试，搞完了告诉你。

听起来像科幻？这东西已经在GitHub上开源半年了，超过8000个Star。

它背后的团队是Nous Research——就是那个训出了Hermes系列开源大模型的研究机构。换句话说，做模型的人自己下场做工具，跟Anthropic的Claude Code、OpenAI的Codex是同一个赛道。

区别在哪里？两点：第一，它不挑模型。你想用Claude、GPT、DeepSeek、甚至自己本地跑的开源模型，随便换。第二，它会"学习"——你纠正它一次，它下次就记住了。

二、安装之前，先看3秒钟

这是全文最重要的一句话：

Hermes支持Windows、macOS、Linux，在Windows上可以原生运行，不需要WSL。

知道这一点就行了，因为我第一次装的时候以为只能Linux，折腾了半天WSL，纯属浪费时间。

接下来你需要准备：

一台能上网的电脑
一个API Key（别慌，后面会说怎么免费搞到）
5分钟

三、一条命令装完

打开你的终端：

Windows用户：按Win+R，输入`cmd`回车

Mac用户：按Command+空格，输入`终端`回车

然后粘贴这一行：

```bash

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

```

回车，等它跑完。

我实测（Windows 11，2026年5月）：从执行命令到出现安装成功的提示，47秒。

如果提示`curl: command not found`，说明你电脑上没有curl。Windows 10以上版本自带了，如果没有就去 https://curl.se/windows 下载一个。Mac自带了，不用管。

安装脚本会自动干这些事：

检测你的操作系统
创建`~\.hermes`目录（放配置文件的地方）
下载最新的Hermes程序
配置好Python虚拟环境
在你PATH里加上hermes命令

装完之后，关掉终端重新打开，输入：

```bash

hermes --version

```

如果弹出版本号（比如`hermes 2.x.x`），安装成功。

如果提示"找不到命令"：

Windows：重启电脑（对，就这个方法最快）
Mac/Linux：执行source ~/.bashrc或source ~/.zshrc

四、你这会儿还跑不起来——差一把钥匙

Hermes装好了，但它需要调用大模型才能工作。大模型是别人家的服务器，你得有个"钥匙"才能用。

这个钥匙叫API Key。

最省事的方案：用OpenRouter

OpenRouter是一个模型聚合平台，你注册一个账号、充5美元，就能调用上面几乎所有的大模型——Claude、GPT、DeepSeek、Gemini全都有。

步骤：

打开 https://openrouter.ai 注册（支持Google/GitHub一键登录）
充值最低5美元（支持支付宝）
点右上角头像 → API Keys → 创建一个新Key，复制下来

然后回到终端：

```bash

hermes setup

```

选"Model"，跟着向导走：

Provider选OpenRouter
粘贴你刚才复制的API Key
模型选anthropic/claude-sonnet-4（性价比最高）或者deepseek/deepseek-chat（更便宜）

搞定之后跑一下体检：

```bash

hermes doctor

```

全绿就说明配置没问题了。

不想花钱的方案：

如果你已经有DeepSeek、通义千问、智谱这些国内厂商的API Key，Hermes也支持。目前支持的20+厂商包括：

| 厂商 | 需要什么 | 去哪里搞 |

| ------------ | -------- | --------------------- |

| DeepSeek | API Key | platform.deepseek.com |

| 阿里百炼 | API Key | dashscope.aliyun.com |

| 智谱GLM | API Key | open.bigmodel.cn |

| 月之暗面Kimi | API Key | platform.moonshot.cn |

| MiniMax | API Key | platform.minimaxi.com |

| 阶跃星辰 | API Key | platform.stepfun.com |

以上大部分新用户注册都送免费额度，够你玩一个月的。

五、第一次跟Hermes说话

钥匙配好了，现在是见证奇迹的时刻。终端里输入：

```bash

hermes

```

你会看到一个交互界面，直接打字就行。试试这句：

> 帮我统计一下桌面上有多少个文件，按类型分类

Hermes会自己写Python脚本、执行、告诉你结果。

第一次跑你会发现一个细节：它执行危险命令之前会问你"确认吗"。这是默认的安全机制。如果你觉得烦（并且确定自己不会乱来），可以用`--yolo`跳过确认：

```bash

hermes --yolo

```

但新手不建议关，多一层保护不是坏事。

六、三个踩坑点，提前告诉你

这些都是我实打实撞过的墙：

坑1：Windows上的UTF-8 BOM问题

如果你用记事本编辑了配置文件（`~\.hermes\config.yaml`），下次启动可能会报错"HTTP 400 No models provided"。原因是记事本保存时默认加了BOM头，Hermes不认。

解决：别用记事本。用VS Code、Notepad++，或者用Hermes自带的编辑命令：

```bash

hermes config edit

```

坑2：模型调了不生效

改了模型之后感觉AI还是老样子？你需要重启会话。在交互界面里输入`/reset`，或者直接退出重进。

工具、技能、配置的改动都要`/reset`才能生效——这不是bug，是Hermes为了节省token故意这么设计的。

坑3：Windows终端全屏切换吞掉了你的回车

很多人在Windows Terminal里写多行消息时，按Alt+Enter想换行，结果窗口全屏了。

Windows Terminal把Alt+Enter拦截成了全屏快捷键。正确的换行方式是Ctrl+Enter。

七、几个进阶功能，知道就好

你现在已经能用了。下面这些是"知道有这么个东西就行"的级别，以后慢慢探索。

让它记住你是谁

Hermes有跨会话的持久记忆。你告诉它一次"我习惯用中文回复"、"我的项目在D盘projects目录"，它下次还会记得。

```bash

hermes config set memory.memory_enabled true

```

让它学会你的工作习惯

Hermes最特别的功能叫Skills（技能）。你完成一个复杂任务之后，可以让它把这个流程存成一个技能，下次遇到类似任务自动加载。

比如你让它帮你做了一次数据清洗，流程是"下载CSV→去重→填充空值→输出Excel"，它可以把这个流程存为技能，下次你只需要说"按上次的方法清洗这个文件"。

装到手机上用*

Hermes可以跑在Telegram、微信、飞书、钉钉上。配置方式：

```bash

hermes gateway setup

```

选平台、填Token，你的AI助手就能在手机上用了。具体教程可以看官方文档：https://hermes-agent.nousresearch.com/docs/user-guide/messaging/

八、这篇教程没覆盖到的

坦白说，这篇只讲了最核心的"安装+跑起来"。Hermes还有很多功能我没写：

多Agent协同干活（一个写前端一个写后端）
定时任务（每天早上9点自动跑数据报表）
MCP服务器扩展（接入你自己的工具）
多Profile隔离（工作和个人用两个完全独立的AI）

这些功能对新手期的你不是必需品。先用起来，等你觉得"诶这个场景要是能自动就爽了"，再去翻文档找对应功能。

官方文档：https://hermes-agent.nousresearch.com/docs/

GitHub仓库：https://github.com/NousResearch/hermes-agent