乐于分享
好东西不私藏

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

普通人也能跑的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自带了,不用管。
安装脚本会自动干这些事:
  1. 检测你的操作系统
  2. 创建`~\.hermes`目录(放配置文件的地方)
  3. 下载最新的Hermes程序
  4. 配置好Python虚拟环境
  5. 在你PATH里加上hermes命令
装完之后,关掉终端重新打开,输入:
```bash
hermes --version
```
如果弹出版本号(比如`hermes 2.x.x`),安装成功。
如果提示"找不到命令":
  • Windows:重启电脑(对,就这个方法最快)
  • Mac/Linux:执行source ~/.bashrcsource ~/.zshrc

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

Hermes装好了,但它需要调用大模型才能工作。大模型是别人家的服务器,你得有个"钥匙"才能用。
这个钥匙叫API Key。
最省事的方案:用OpenRouter
OpenRouter是一个模型聚合平台,你注册一个账号、充5美元,就能调用上面几乎所有的大模型——Claude、GPT、DeepSeek、Gemini全都有。
步骤:
  1. 打开 https://openrouter.ai 注册(支持Google/GitHub一键登录)
  2. 充值最低5美元(支持支付宝)
  3. 点右上角头像 → 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