Tutorial For Power Users

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

Hermes Agent

Hermes Agent

@hermesagents

May 18, 2026

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,或者就開個終端機分頁,都行。

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、新整合。不寄垃圾信,隨時可以退訂。