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,或者就開個終端機分頁,都行。
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 不要。整個賣點就這一句話。