Tutorial For Power Users

一份 Claude Pro 订阅,所有工具都能用:拿 `hermes proxy` 接 Aider、Cline、Codex CLI

Hermes Agent

Hermes Agent

@hermesagents

2026年5月18日

7 分钟阅读

v0.14.0 出了一条一行命令——hermes proxy——悄无声息地把一整类社区问了好几个月的接入问题给吞掉了。跑一遍 hermes proxy,你就有了一个本地 http://localhost:port 端点,这个端点讲 OpenAI 那套 API,背后接的是你登过的任意一个 OAuth provider——Claude Pro、ChatGPT Pro、SuperGrok。

落到实操层面就是这件事:那些只会讲 OpenAI API 的工具——Aider、Cline、Codex CLI、Continue,以及一长串的编辑器插件——现在可以通过你已经在订的那份订阅和 Claude Pro、ChatGPT Pro、SuperGrok 说话,整个过程你不用生成任何 API key。

这件事重要在哪:这些工具里多数都要求你跟每家 provider 各自开账单关系。Aider 接 Claude → 在 Anthropic console 开一个带支付方式的账户。Cline 接 GPT-5 → OpenAI 那边再开一个账单账户。Codex CLI → 同理。hermes proxy 把这一堆塌缩成一个 localhost 端点,认证走的是你已经有的那个 OAuth 会话。

下面把流程过一遍。

0. 前置条件

  • 装好并配置好 Hermes Agent v0.14.0 或者更新(hermes --version 验一下)
  • 通过 hermes model 至少绑好一个 OAuth 订阅——Claude Pro、ChatGPT Pro,或者 SuperGrok

如果你从来没登过任何一个 OAuth provider,第一次跑 hermes model 的时候它会带你走完每家的 OAuth 流程。挑一份你实际在付钱的订阅。

1. 起 proxy

bash
hermes proxy

默认绑到 localhost 的一个空闲端口上。启动日志里会打出 URL,复制下来。要固定端口的话:

bash
hermes proxy --port 11500

把它当一个长跑进程跑着——下游工具用着它的时候让它别死。systemdlaunchdtmux,或者就开个终端 tab,都行。

2. 让下游工具指过来

Aider

bash
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy  # 任意非空字符串都行
aider --model claude-sonnet-4-6

Aider 的 --model 这一行写的是 proxy 从你 Hermes provider 配置里解析出来的模型名字。如果你是 Claude Pro 登的,你默认的 Claude 模型就在那;ChatGPT Pro 和 SuperGrok 同理。

Cline(VS Code)

在 Cline 的设置里,provider 选 OpenAI Compatible。然后填:

  • Base URLhttp://localhost:11500/v1
  • API Keyhermes-proxy(任意非空值)
  • Model ID:你 Hermes 配置里的模型名(比如 claude-sonnet-4-6gpt-5.1

存盘。Cline 的请求现在就走 Hermes 转一道;订阅认证这部分剩下的事它不用管。

Codex CLI

Codex CLI 一般认 OPENAI_API_BASEOPENAI_API_KEY。跟 Aider 同一套:

bash
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy
codex --model gpt-5-codex

如果你通过 Hermes 登的是 ChatGPT Pro,gpt-5-codex 这个模型会从 proxy 透出来,Codex CLI 就能全功能用——你完全不用跟 OpenAI 那边建立任何账单关系。

Continue(JetBrains / VS Code)

编辑 Continue 的配置(~/.continue/config.json 或者从 UI 改):

json
{
  "models": [{
    "title": "Claude via Hermes",
    "provider": "openai",
    "model": "claude-sonnet-4-6",
    "apiBase": "http://localhost:11500/v1",
    "apiKey": "hermes-proxy"
  }]
}

同样的套路。"provider" 仍然写 openai,因为在 Continue 看来,它就是在打一个 OpenAI 端点。

3. 验它通不通

一行 curl 测一下:

bash
curl http://localhost:11500/v1/models -H "Authorization: Bearer hermes-proxy"

应该返回你 Hermes provider 配置里能透出来的那份模型列表。要是收到 401 或者一份空列表,说明 proxy 在跑但 Hermes 看不见活的 OAuth 会话——回头跑一下 hermes model,挑一个你确实有效订阅的 provider。

4. 排错

  • "Connection refused"——proxy 没在跑。把它起起来。
  • "401 unauthorized"——你请求的模型不在你绑的订阅覆盖范围里。跑 hermes model 看看哪些 provider 是活的。
  • "Model not found"——下游工具里的模型名跟你 Hermes provider 透出来的名字对不上。用 hermes model list 里出现的名字。
  • 被限流——你撞到订阅本身的速率上限了(Claude Pro 在 Sonnet 上大致 5 小时 50 条;ChatGPT Pro 有自己一份额度;SuperGrok 也是)。proxy 不加任何额外的限流;你的 provider 给你多少配额,它就转多少。

这件事为什么重要

OpenAI API 是这整个 AI 工具生态的通用语。几乎每一个编辑器插件、每一个代码助手,第一优先支持的是 OpenAI,第二才是"OpenAI 兼容端点"。问题在于,"兼容端点"基本上都意味着——"你得有一个 API key,那就得有一个账单账户,于是你每月 20 美元的订阅就变成了别人 dashboard 上一份按量付费的账户。"

hermes proxy 把这个问题塌缩了。你的 OAuth 订阅留在原地不动。proxy 在 localhost 上讲 OpenAI。Aider、Cline、Codex CLI、Continue——它们不知道自己在跟 Claude 或者 Grok 说话。它们看到的只是一个能用的 OpenAI 端点。

一份订阅,所有工具能用,API key 不要。整个卖点就这一句话。

延伸阅读

订阅更新

Hermes Agent 的版本更新、新 skill、新集成——社区第一手消息。不发垃圾邮件,随时可以退订。