v0.14.0 wypuścił jednoliniową komendę, która po cichu pochłonęła całą klasę pytań o integrację, które społeczność zadawała od miesięcy. Odpalasz hermes proxy i masz lokalny endpoint http://localhost:port, który mówi w API OpenAI, podpięty pod jakikolwiek provider OAuth, do którego jesteś zalogowany przez Hermesa — Claude Pro, ChatGPT Pro albo SuperGrok.
Praktyczna konsekwencja: narzędzia, które potrafią tylko gadać w API OpenAI — Aider, Cline, Codex CLI, Continue i długi ogon edytorowych pluginów — mogą teraz rozmawiać z Claude Pro, ChatGPT Pro i SuperGrok przez twoją obecną subskrypcję, bez generowania ani jednego klucza API.
Tu jest sedno: większość tych narzędzi wymaga relacji billingowej z każdym providerem osobno. Aider z Claude'em → konto w Anthropic console z metodą płatności. Cline z GPT-5 → konto billingowe w OpenAI. Codex CLI → tak samo. hermes proxy ściska to wszystko do jednego endpointu na localhoście, który uwierzytelnia się sesją OAuth, którą i tak już masz.
Oto dokładny workflow.
0. Co musisz mieć
- •Zainstalowanego i skonfigurowanego Hermes Agent v0.14.0 albo nowszego (
hermes --version, żeby sprawdzić) - •Co najmniej jedną subskrypcję OAuth podpiętą przez
hermes model— Claude Pro, ChatGPT Pro albo SuperGrok
Jeśli nigdy nie logowałeś się u żadnego providera OAuth, przy pierwszym uruchomieniu hermes model przejdzie cię przez OAuth-owy flow per provider. Wybierz subskrypcję, za którą faktycznie płacisz.
1. Odpal proxy
hermes proxy
Domyślnie podpina się do wolnego portu na localhost. Log startowy pokazuje URL — skopiuj go. Żeby przypiąć port:
hermes proxy --port 11500
Trzymaj go jako długo żyjący proces — niech nie zdycha, dopóki downstreamowe narzędzia z niego korzystają. systemd, launchd, tmux albo po prostu zakładka w terminalu — wszystko działa.
2. Naprowadź downstreamowe narzędzie na proxy
Aider
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy # dowolny niepusty string łyknie
aider --model claude-sonnet-4-6
Flaga --model w Aiderze odnosi się do nazwy modelu w takiej formie, w jakiej proxy rozwiązuje ją z twojej konfiguracji providerów Hermesa. Jeśli jesteś zalogowany przez Claude Pro, twój domyślny model Claude jest dostępny; tak samo dla ChatGPT Pro i SuperGrok.
Cline (VS Code)
W ustawieniach Cline wybierz OpenAI Compatible jako provider. Ustaw:
- •Base URL:
http://localhost:11500/v1 - •API Key:
hermes-proxy(dowolna niepusta wartość) - •Model ID: nazwa modelu z twojej konfiguracji Hermesa (np.
claude-sonnet-4-6,gpt-5.1)
Zapisz. Cline routuje teraz swoje requesty przez Hermesa; resztą zajmuje się auth twojej subskrypcji.
Codex CLI
Codex CLI zazwyczaj spodziewa się OPENAI_API_BASE i OPENAI_API_KEY. Ten sam kształt co Aider:
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy
codex --model gpt-5-codex
Jeśli jesteś zalogowany przez Hermesa do ChatGPT Pro, model gpt-5-codex wyjdzie przez proxy, a Codex CLI dostaje pełen dostęp, a ty ani razu nie zakładałeś relacji billingowej z OpenAI.
Continue (JetBrains / VS Code)
Edytuj konfig Continue (~/.continue/config.json albo z poziomu UI):
{
"models": [{
"title": "Claude via Hermes",
"provider": "openai",
"model": "claude-sonnet-4-6",
"apiBase": "http://localhost:11500/v1",
"apiKey": "hermes-proxy"
}]
}
Ten sam schemat. "provider" zostaje openai, bo z punktu widzenia Continue to jest endpoint OpenAI.
3. Sprawdź, czy działa
Szybki curl:
curl http://localhost:11500/v1/models -H "Authorization: Bearer hermes-proxy"
Powinieneś dostać listę modeli, które twoja konfiguracja providerów Hermesa wystawia. Dostajesz 401 albo pustą listę — proxy chodzi, ale Hermes nie widzi żywej sesji OAuth — odpal hermes model jeszcze raz i wybierz providera, do którego masz aktywną subskrypcję.
4. Co robić, kiedy się sypie
- •„Connection refused" — proxy nie chodzi. Odpal.
- •„401 unauthorized" — model, którego prosiłeś, nie jest pokryty twoją podpiętą subskrypcją. Odpal
hermes modeli zobacz, którzy providerzy są aktywni. - •„Model not found" — nazwa modelu w downstreamowym narzędziu nie matchuje tego, co wystawia twój provider Hermesa. Użyj nazw z
hermes model list. - •Rate-limit — siedzisz na limitach samej subskrypcji (Claude Pro ma ~50 wiadomości na 5 h na Sonneccie; ChatGPT Pro ma swoją kwotę; SuperGrok też swoją). Proxy nie dodaje własnego rate-limitera; przepuszcza tyle, ile dostanie od providera.
Dlaczego to jest ważne
API OpenAI to lingua franca ekosystemu narzędzi AI. Praktycznie każdy plugin do edytora i każdy asystent kodowy wspiera najpierw OpenAI, dopiero potem „endpoint-y OpenAI-compatible". Haczyk jest taki, że „kompatybilny endpoint" prawie zawsze znaczy „potrzebujesz klucza API, co znaczy, że potrzebujesz konta billingowego, co znaczy, że twoja subskrypcja za 20 dolarów na miesiąc staje się kontem pay-as-you-go na czyimś dashboardzie".
hermes proxy zaorywuje ten problem. Twoja subskrypcja OAuth zostaje tam, gdzie żyje. Proxy mówi w OpenAI na localhoście. Aider, Cline, Codex CLI, Continue — one nie wiedzą, że gadają z Claude'em albo Grokiem. Widzą po prostu endpoint OpenAI, który działa.
Jedna subskrypcja, wszystkie narzędzia, bez klucza API. Cały pitch w jednym zdaniu.