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
hermes proxy
默认绑到 localhost 的一个空闲端口上。启动日志里会打出 URL,复制下来。要固定端口的话:
hermes proxy --port 11500
把它当一个长跑进程跑着——下游工具用着它的时候让它别死。systemd、launchd、tmux,或者就开个终端 tab,都行。
2. 让下游工具指过来
Aider
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 URL:
http://localhost:11500/v1 - •API Key:
hermes-proxy(任意非空值) - •Model ID:你 Hermes 配置里的模型名(比如
claude-sonnet-4-6、gpt-5.1)
存盘。Cline 的请求现在就走 Hermes 转一道;订阅认证这部分剩下的事它不用管。
Codex CLI
Codex CLI 一般认 OPENAI_API_BASE 和 OPENAI_API_KEY。跟 Aider 同一套:
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 改):
{
"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 测一下:
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 不要。整个卖点就这一句话。