Hermes Agent 一个隐藏功能:把 $20 订阅变成无限 API,喂饱所有编码工具


读完这篇,你能做到一件事。
把 Claude Pro / ChatGPT Pro / SuperGrok 的月度订阅,变成本地 OpenAI 兼容 API。让 Codex CLI、Aider、Cline、Continue 直接连上去用。
不需要额外 API 费用。不需要管理 API key。
一个 YouTube 博主说得直白:
❝
「如果你在用 AI 编码工具并且为只能通过一个界面使用的订阅付费,proxy 功能本身就永久改变了你的工作流。」
先看完成后的样子

一个入口,多个消费者。你的 $20/月订阅,通过一个本地代理,变成整个工具链的动力源。
前提条件
-
一个 Claude Pro / ChatGPT Pro / SuperGrok 订阅(任选一个,$20/月起)
-
Python 3.10+(v0.14.0 最低要求)
-
终端(macOS / Linux / Windows WSL2 / Windows 原生 beta)
关于 provider 认证: Hermes 支持三种认证路径——API key 在 .env、OAuth 通过 hermes model、或自定义 endpoint 在 config.yaml。proxy 功能走的是 OAuth 路径。
阶段一:安装 Hermes v0.14.0
第一步:一行安装
macOS / Linux:
curl -fsSL https://hermes.nousresearch.com/install.sh | bashWindows(PowerShell):
irm https://hermes.nousresearch.com/install.ps1 | iex或者用 pip 直接装(v0.14.0 新增的 PyPI 分发):
pip install hermes-agentv0.14.0 的安装比之前简单了一个数量级。重量级依赖(Docker、SSH 后端等)不再默认安装——第一次用时才自动拉取。冷启动比 v0.13.0 快 19 秒。
第二步:验证安装
hermes --version应该显示 v0.14.0 或 v2026.5.16。
如果有问题,跑诊断:
hermes doctor它会检查 Python 版本、依赖状态、provider 配置等。
验证:hermes --version 显示正确版本号。
阶段二:配置 Provider
第三步:选择并认证 Provider
hermes model这会进入交互式 provider 选择。你会看到类似:
? Select provider:
❯ Anthropic (Claude Pro/Max — OAuth)
OpenAI (ChatGPT Pro — OAuth)
xAI (SuperGrok — OAuth)
OpenRouter (API key)
Nous Portal (OAuth)
Custom endpoint
...选你有订阅的那个。以 Claude Pro 为例:
-
选择
Anthropic -
系统会打开浏览器进行 OAuth 认证
-
登录你的 Claude 账号,授权 Hermes
-
回到终端,认证完成
SuperGrok 用户注意: v0.14.0 新增了 xAI OAuth。选择后同样走浏览器认证。还附带了 Grok 4.3 的 1M token context window 和 x_search 工具。
SSH 远程机器用户: 如果你在没有浏览器的服务器上,v0.14.0 有 tunnel 文档教你怎么完成 OAuth。
第四步:测试 Provider 连通性
hermes进入交互模式后测试:
> 你好,告诉我今天的日期能正常回复就说明 provider 配置成功。输入 /exit 退出。
验证: agent 正常回复消息,没有认证错误。
阶段三:启动本地代理
第五步:启动 hermes proxy
hermes proxy start你会看到类似输出:
✓ Local proxy started
Endpoint: http://localhost:8080/v1
Provider: anthropic (Claude Pro via OAuth)
Compatible with: OpenAI Chat Completions API这个代理做的事:
-
在本地监听 OpenAI 格式的 API 请求
-
通过你的 OAuth session 转发给对应模型
-
返回 OpenAI 格式的响应
不按 token 计费。走的是你的月度订阅额度。
第六步:验证代理
另开终端:
curl http://localhost:8080/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{
"model": "default",
"messages": [{"role": "user", "content": "Hello, respond in one word."}]
}'应该收到正常的 JSON 响应。
也可以查看可用模型:
curl http://localhost:8080/v1/models验证: curl 返回有效的 chat completion JSON。
阶段四:连接编码工具
第七步:配置 Aider
export OPENAI_API_BASE=http://localhost:8080/v1
export OPENAI_API_KEY=hermes-proxy
aiderproxy 不验证 key 内容,但 Aider 需要一个非空值。用任意字符串即可。
Aider 现在通过你的本地代理发送请求。所有 token 消耗走订阅额度。
第八步:配置 Cline(VS Code)
在 VS Code 的 Cline 设置中:
{
"cline.apiProvider": "openai-compatible",
"cline.apiBaseUrl": "http://localhost:8080/v1",
"cline.apiKey": "hermes-proxy"
}第九步:配置 Continue(VS Code)
编辑 ~/.continue/config.json:
{
"models": [{
"title": "Hermes Proxy (Claude Pro)",
"provider": "openai",
"model": "default",
"apiBase": "http://localhost:8080/v1",
"apiKey": "hermes-proxy"
}]
}第十步:配置 Codex CLI
export OPENAI_BASE_URL=http://localhost:8080/v1
export OPENAI_API_KEY=hermes-proxy
codex验证: 在任一工具中发送消息,确认收到回复。
阶段五:后台常驻
第十一步:让代理开机自启
Linux(systemd):
hermes proxy install-servicemacOS(launchd):
hermes proxy install-service --launchd或者简单用 tmux:
tmux new -d -s hermes-proxy 'hermes proxy start'Windows 用 Task Scheduler 或 PowerShell 后台:
Start-Process -NoNewWindow hermes proxy start验证: 关闭当前终端,重新打开,curl http://localhost:8080/v1/models 仍正常返回。
完整流程一览

第一次做的建议
-
先用一个工具测试。 比如 Aider。确认代理正常后再配其他工具
-
注意订阅的速率限制。 Claude Pro 有每分钟/每小时请求上限。多工具同时用可能触发限流。遇到 429 就减少并发
-
SuperGrok 是性价比最高的选择。 因为它同时给你 Grok 4.3(1M context)+ X Search + 图片生成 + 视频生成。一个订阅喂饱 Hermes 本体 + proxy 给其他工具
-
如果你已经有 Claude Pro 订阅。 注意:如果系统里设了
ANTHROPIC_API_KEY环境变量,Claude Code 会优先用 API key 而不是订阅。确保 proxy 走的是 OAuth 路径
容易踩的坑
坑 1:Windows 上所有工具报 TypeError
v0.14.0 已知 P1 bug(#28920)。creationflags 参数重复传递。
怎么避开:等 hotfix。或手动编辑 tools/environments/local.py 第 523-537 行,删掉重复的 creationflags。或者用 WSL2 绕过。
坑 2:代理启动了但工具连不上
确认代理监听的是 127.0.0.1:8080。如果工具在 Docker 容器里运行,用 host.docker.internal:8080。
如果用了 VPN 或防火墙,确认 localhost 流量没被拦截。
坑 3:OAuth token 过期
订阅的 OAuth token 有有效期。如果代理突然返回 401,重新跑 hermes model 刷新认证。
v0.14.0 加了 entitlement error 处理,会给出更清晰的错误信息。
坑 4:多工具同时请求限流(429)
订阅有 RPM(requests per minute)限制。Claude Pro 大约 40-60 RPM。
解决方案:
-
不要同时在 3 个以上工具触发请求
-
或者用 Hermes 的
credential_pool配置多个订阅做负载均衡 -
或者给不同工具设置请求间隔
坑 5:context window 不匹配
一个社区用户的教训:Hermes 不会自动检查模型的实际 context window。如果你通过 proxy 用的模型只有 128K context,但工具发了超长请求,会静默失败。
在 ~/.hermes/config.yaml 里手动设置正确的 context length。
进阶玩法
玩法一:SuperGrok + X Search
如果你用 SuperGrok 订阅,v0.14.0 解锁了额外能力:
hermes
> /tools enable x_search
> 搜索 X 上关于 Hermes Agent v0.14.0 的讨论之前搜索 X 需要昂贵的 API 调用。现在走 OAuth 订阅,免费。
玩法二:Hermes 编排 + Codex/Claude Code 执行
一个 LinkedIn 用户的真实工作流:
从 Telegram 发消息给 Hermes
→ Hermes /goal 分配任务
→ Codex 通过 proxy 构建代码
→ Claude Code 通过 proxy 审查代码
→ 结果显示在 Kanban 看板Hermes 不只是 proxy。它是编排层。
玩法三:Claude 跨会话 prompt cache
v0.14.0 新增了 1 小时的 Claude 跨会话 prompt cache(支持 Anthropic、OpenRouter、Nous Portal)。
如果你的工作流涉及重复的 prompt 前缀(比如同一个代码库的 context),resume 和重复工作会更快更便宜。
收尾
v0.14.0 的本地代理,本质上是把 Hermes 从「AI agent」变成了「AI 基础设施层」。
它不跟 Codex、Aider、Cline 竞争。
它让自己成为它们的后端。
一个 $20/月的订阅,通过 hermes proxy,变成整个工具链的动力源。
这可能是 v0.14.0 里最被低估的功能。
也是 Hermes 从「极客玩具」变成「开发者基础设施」的关键一步。
参考资料
-
Hermes Agent v0.14.0 Release Notes — GitHub[1]
-
Hermes Agent v0.14 Is a Platform Now — YouTube (Panda Making Money)[2]
-
Hermes V0.14 is INSANE! — YouTube (Julian Goldie)[3]
-
Hermes Agent: The Ultimate Beginner's Guide — YouTube (Metics Media, 41K views)[4]
-
Hermes Agent Full Tutorial for Beginners — YouTube (Tech With Tim, 30K views)[5]
-
Hermes Agent w/ ChatGPT 5.5 is literally magic — YouTube (Alex Finn, 59K views)[6]
-
AI Providers — Hermes Agent Documentation[7]
-
Hermes v0.13 Reference — Blake Crosley[8]
-
Codex and Claude Code Integrate with Hermes Agent — LinkedIn[9]
-
Use Claude Code with your Pro or Max plan — Claude Help Center[10]
-
Hermes v0.14.0 Foundation Release — Reddit r/hermesagent[11]
-
FAQ & Troubleshooting — Hermes Agent Documentation[12]
-
Windows P1 bug — GitHub Issue #28920[13]
-
NousResearch/hermes-agent — GitHub[14]
Reference
[1]
Hermes Agent v0.14.0 Release Notes — GitHub: https://github.com/NousResearch/hermes-agent/blob/main/RELEASE_v0.14.0.md
[2]
Hermes Agent v0.14 Is a Platform Now — YouTube (Panda Making Money): https://www.youtube.com/watch?v=CmL_Qh1PjsI
[3]
Hermes V0.14 is INSANE! — YouTube (Julian Goldie): https://www.youtube.com/watch?v=-nRtEBBHRL4
[4]
Hermes Agent: The Ultimate Beginner's Guide — YouTube (Metics Media, 41K views): https://www.youtube.com/watch?v=CwPUOVUdApE
[5]
Hermes Agent Full Tutorial for Beginners — YouTube (Tech With Tim, 30K views): https://www.youtube.com/watch?v=1ve4Atbqmoo
[6]
Hermes Agent w/ ChatGPT 5.5 is literally magic — YouTube (Alex Finn, 59K views): https://www.youtube.com/watch?v=B2wHaRDf3Qo
[7]
AI Providers — Hermes Agent Documentation: https://hermes-agent.nousresearch.com/docs/ko/integrations/providers
[8]
Hermes v0.13 Reference — Blake Crosley: https://blakecrosley.com/guides/hermes
[9]
Codex and Claude Code Integrate with Hermes Agent — LinkedIn: https://www.linkedin.com/posts/shubhamsaboo_this-is-wild-codex-builds-claude-code-reviews-activity-7460153734082338816-gNBx
[10]
Use Claude Code with your Pro or Max plan — Claude Help Center: https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan
[11]
Hermes v0.14.0 Foundation Release — Reddit r/hermesagent: https://www.reddit.com/r/hermesagent/comments/1teu9u4/hermes_v0140_v2026516_foundation_release_hermes/
[12]
FAQ & Troubleshooting — Hermes Agent Documentation: https://hermes-agent.nousresearch.com/docs/ko/reference/faq
[13]
Windows P1 bug — GitHub Issue #28920: https://github.com/NousResearch/hermes-agent/issues/28920
[14]
NousResearch/hermes-agent — GitHub: https://github.com/nousresearch/hermes-agent