剪藏#AI赋能说#剪藏

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

2026 年 8 月 18 日1 分钟
分享Twitter / XTelegram微博
Hermes Agent 一个隐藏功能:把 $20 订阅变成无限 API,喂饱所有编码工具 封面

Notion image

读完这篇,你能做到一件事。

把 Claude Pro / ChatGPT Pro / SuperGrok 的月度订阅,变成本地 OpenAI 兼容 API。让 Codex CLI、Aider、Cline、Continue 直接连上去用。

不需要额外 API 费用。不需要管理 API key。

一个 YouTube 博主说得直白:

「如果你在用 AI 编码工具并且为只能通过一个界面使用的订阅付费,proxy 功能本身就永久改变了你的工作流。」

先看完成后的样子

Notion image

一个入口,多个消费者。你的 $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:

JAVASCRIPT
curl -fsSL https://hermes.nousresearch.com/install.sh | bash

Windows(PowerShell):

JAVASCRIPT
irm https://hermes.nousresearch.com/install.ps1 | iex

或者用 pip 直接装(v0.14.0 新增的 PyPI 分发):

JAVASCRIPT
pip install hermes-agent

v0.14.0 的安装比之前简单了一个数量级。重量级依赖(Docker、SSH 后端等)不再默认安装——第一次用时才自动拉取。冷启动比 v0.13.0 快 19 秒。

第二步:验证安装

JAVASCRIPT
hermes --version

应该显示 v0.14.0v2026.5.16

如果有问题,跑诊断:

JAVASCRIPT
hermes doctor

它会检查 Python 版本、依赖状态、provider 配置等。

验证:hermes --version 显示正确版本号。

阶段二:配置 Provider

第三步:选择并认证 Provider

JAVASCRIPT
hermes model

这会进入交互式 provider 选择。你会看到类似:

JAVASCRIPT
? Select provider:
  ❯ Anthropic (Claude Pro/Max — OAuth)
    OpenAI (ChatGPT Pro — OAuth)
    xAI (SuperGrok — OAuth)
    OpenRouter (API key)
    Nous Portal (OAuth)
    Custom endpoint
    ...

选你有订阅的那个。以 Claude Pro 为例:

  1. 选择 Anthropic

  2. 系统会打开浏览器进行 OAuth 认证

  3. 登录你的 Claude 账号,授权 Hermes

  4. 回到终端,认证完成

SuperGrok 用户注意: v0.14.0 新增了 xAI OAuth。选择后同样走浏览器认证。还附带了 Grok 4.3 的 1M token context window 和 x_search 工具。

SSH 远程机器用户: 如果你在没有浏览器的服务器上,v0.14.0 有 tunnel 文档教你怎么完成 OAuth。

第四步:测试 Provider 连通性

JAVASCRIPT
hermes

进入交互模式后测试:

JAVASCRIPT
> 你好,告诉我今天的日期

能正常回复就说明 provider 配置成功。输入 /exit 退出。

验证: agent 正常回复消息,没有认证错误。

阶段三:启动本地代理

第五步:启动 hermes proxy

JAVASCRIPT
hermes proxy start

你会看到类似输出:

JAVASCRIPT
✓ Local proxy started
  Endpoint: http://localhost:8080/v1
  Provider: anthropic (Claude Pro via OAuth)
  Compatible with: OpenAI Chat Completions API

这个代理做的事:

  1. 在本地监听 OpenAI 格式的 API 请求

  2. 通过你的 OAuth session 转发给对应模型

  3. 返回 OpenAI 格式的响应

不按 token 计费。走的是你的月度订阅额度。

第六步:验证代理

另开终端:

JAVASCRIPT
curl http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -'{
    "model": "default",
    "messages": [{"role": "user", "content": "Hello, respond in one word."}]
  }'

应该收到正常的 JSON 响应。

也可以查看可用模型:

JAVASCRIPT
curl http://localhost:8080/v1/models

验证: curl 返回有效的 chat completion JSON。

阶段四:连接编码工具

第七步:配置 Aider

JAVASCRIPT
export OPENAI_API_BASE=http://localhost:8080/v1
export OPENAI_API_KEY=hermes-proxy
aider

proxy 不验证 key 内容,但 Aider 需要一个非空值。用任意字符串即可。

Aider 现在通过你的本地代理发送请求。所有 token 消耗走订阅额度。

第八步:配置 Cline(VS Code)

在 VS Code 的 Cline 设置中:

JAVASCRIPT
{
  "cline.apiProvider""openai-compatible",
  "cline.apiBaseUrl""http://localhost:8080/v1",
  "cline.apiKey""hermes-proxy"
}

第九步:配置 Continue(VS Code)

编辑 ~/.continue/config.json

JAVASCRIPT
{
  "models": [{
    "title""Hermes Proxy (Claude Pro)",
    "provider""openai",
    "model""default",
    "apiBase""http://localhost:8080/v1",
    "apiKey""hermes-proxy"
  }]
}

第十步:配置 Codex CLI

JAVASCRIPT
export OPENAI_BASE_URL=http://localhost:8080/v1
export OPENAI_API_KEY=hermes-proxy
codex

验证: 在任一工具中发送消息,确认收到回复。

阶段五:后台常驻

第十一步:让代理开机自启

Linux(systemd):

JAVASCRIPT
hermes proxy install-service

macOS(launchd):

JAVASCRIPT
hermes proxy install-service --launchd

或者简单用 tmux:

JAVASCRIPT
tmux new -d -s hermes-proxy 'hermes proxy start'

Windows 用 Task Scheduler 或 PowerShell 后台:

JAVASCRIPT
Start-Process -NoNewWindow hermes proxy start

验证: 关闭当前终端,重新打开,curl http://localhost:8080/v1/models 仍正常返回。

完整流程一览

Notion image

第一次做的建议

  • 先用一个工具测试。 比如 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 订阅,v0.14.0 解锁了额外能力:

JAVASCRIPT
hermes
> /tools enable x_search
> 搜索 X 上关于 Hermes Agent v0.14.0 的讨论

之前搜索 X 需要昂贵的 API 调用。现在走 OAuth 订阅,免费。

玩法二:Hermes 编排 + Codex/Claude Code 执行

一个 LinkedIn 用户的真实工作流:

JAVASCRIPT
从 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 从「极客玩具」变成「开发者基础设施」的关键一步。

参考资料

  1. Hermes Agent v0.14.0 Release Notes — GitHub[1]

  2. Hermes Agent v0.14 Is a Platform Now — YouTube (Panda Making Money)[2]

  3. Hermes V0.14 is INSANE! — YouTube (Julian Goldie)[3]

  4. Hermes Agent: The Ultimate Beginner's Guide — YouTube (Metics Media, 41K views)[4]

  5. Hermes Agent Full Tutorial for Beginners — YouTube (Tech With Tim, 30K views)[5]

  6. Hermes Agent w/ ChatGPT 5.5 is literally magic — YouTube (Alex Finn, 59K views)[6]

  7. AI Providers — Hermes Agent Documentation[7]

  8. Hermes v0.13 Reference — Blake Crosley[8]

  9. Codex and Claude Code Integrate with Hermes Agent — LinkedIn[9]

  10. Use Claude Code with your Pro or Max plan — Claude Help Center[10]

  11. Hermes v0.14.0 Foundation Release — Reddit r/hermesagent[11]

  12. FAQ & Troubleshooting — Hermes Agent Documentation[12]

  13. Windows P1 bug — GitHub Issue #28920[13]

  14. 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

原文地址: https://mp.weixin.qq.com/s?__biz=MzI3NjE4OTAyMg==&mid=2247489028&idx=1&sn=44211246f6ac13448764fd4acae44a01&chksm=ea87826054746d07f07aeab830df8822bc84b1f8bcb596e3f8b32ae8a1f9b434480a48cda51a&mpshare=1&scene=1&srcid=0521rvbQJJAHVhI0RAZathTt&sharer_shareinfo=be8c36e9932db012d1d96083efaa87c8&sharer_shareinfo_first=be8c36e9932db012d1d96083efaa87c8#rd

相关文章