v0.14.0 leverde een oneliner op die in stilte een hele klasse aan integratievragen heeft opgeslokt — vragen die de community al maanden stelde. Run hermes proxy en je krijgt een lokaal http://localhost:port-endpoint dat de OpenAI-API spreekt, ondersteund door welke OAuth-provider je ook bij Hermes ingelogd hebt — Claude Pro, ChatGPT Pro of SuperGrok.
Het praktische gevolg: tools die alleen de OpenAI-API kennen — Aider, Cline, Codex CLI, Continue en de lange staart aan editor-plugins — kunnen nu met Claude Pro, ChatGPT Pro en SuperGrok praten via je bestaande abonnement, zonder dat je ooit een API-key hoeft te genereren.
En hier zit het belangrijkste stuk: de meeste van deze tools eisen aparte facturatie-relaties per provider. Aider met Claude → een Anthropic console-account met betaalmethode. Cline met GPT-5 → een OpenAI-billing-account. Codex CLI → idem. hermes proxy plet dat allemaal tot één localhost-endpoint dat zich authenticeert via de OAuth-sessie die je al hebt.
Hieronder de precieze workflow.
0. Wat je nodig hebt
- •Hermes Agent v0.14.0 of nieuwer geïnstalleerd en geconfigureerd (
hermes --versionom te checken) - •Minstens één OAuth-abonnement gekoppeld via
hermes model— Claude Pro, ChatGPT Pro of SuperGrok
Heb je nog nooit ergens ingelogd op een OAuth-provider, dan loodst hermes model je de eerste keer door de OAuth-flow per provider. Kies het abonnement waar je daadwerkelijk voor betaalt.
1. De proxy starten
hermes proxy
Default bindt hij aan een vrije poort op localhost. De startup-log laat de URL zien — kopieer hem. Wil je de poort vastpinnen:
hermes proxy --port 11500
Run het als een langlevend proces — houd het in leven zolang downstream-tools het gebruiken. systemd, launchd, tmux of gewoon een terminal-tab werken allemaal.
2. Een downstream-tool op de proxy laten wijzen
Aider
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy # elke niet-lege string werkt
aider --model claude-sonnet-4-6
De --model-flag van Aider verwijst naar de modelnaam zoals de proxy hem uit je Hermes-provider-config resolved. Ben je via Claude Pro ingelogd, dan is je default Claude-model beschikbaar; hetzelfde voor ChatGPT Pro en SuperGrok.
Cline (VS Code)
Kies in Cline's settings OpenAI Compatible als provider. Zet:
- •Base URL:
http://localhost:11500/v1 - •API Key:
hermes-proxy(elke niet-lege waarde) - •Model ID: de modelnaam uit je Hermes-config (bijv.
claude-sonnet-4-6,gpt-5.1)
Opslaan. Cline routeert zijn verzoeken nu via Hermes; je abonnements-auth handelt de rest af.
Codex CLI
Codex CLI verwacht meestal OPENAI_API_BASE en OPENAI_API_KEY. Zelfde vorm als Aider:
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy
codex --model gpt-5-codex
Ben je via Hermes op ChatGPT Pro ingelogd, dan komt het gpt-5-codex-model door de proxy heen en krijgt Codex CLI volledige toegang zonder dat je ooit een OpenAI-billing-relatie hebt opgezet.
Continue (JetBrains / VS Code)
Bewerk je Continue-config (~/.continue/config.json of via de UI):
{
"models": [{
"title": "Claude via Hermes",
"provider": "openai",
"model": "claude-sonnet-4-6",
"apiBase": "http://localhost:11500/v1",
"apiKey": "hermes-proxy"
}]
}
Zelfde patroon. De "provider" blijft openai, want voor Continue is het gewoon een OpenAI-endpoint dat hij aanspreekt.
3. Verifieer dat het werkt
Een snelle curl-test:
curl http://localhost:11500/v1/models -H "Authorization: Bearer hermes-proxy"
Je krijgt de lijst met modellen terug die je Hermes-provider-config beschikbaar stelt. Krijg je een 401 of een lege lijst, dan draait de proxy wel, maar ziet Hermes geen actieve OAuth-sessie — run hermes model opnieuw en kies een provider waarvan je een lopend abonnement hebt.
4. Troubleshooting
- •"Connection refused" — de proxy draait niet. Start hem.
- •"401 unauthorized" — het model dat je opvroeg valt niet onder je gekoppelde abonnement. Run
hermes modelen kijk welke providers actief zijn. - •"Model not found" — de modelnaam in je downstream-tool matcht niet met wat je Hermes-provider blootstelt. Gebruik de namen uit
hermes model list. - •Rate-limited — je loopt tegen de rate-limits van het abonnement aan (Claude Pro doet ~50 berichten per 5 u op Sonnet; ChatGPT Pro heeft een eigen quota; SuperGrok ook). De proxy bouwt er geen eigen rate-limiter overheen; hij geeft door wat je provider je geeft.
Waarom dit ertoe doet
De OpenAI-API is de lingua franca van het AI-tool-ecosysteem. Vrijwel elke editor-plugin en code-assistant ondersteunt eerst OpenAI en pas daarna "OpenAI-compatible endpoints". De adder is dat "compatible endpoint" bijna altijd betekent: "je hebt een API-key nodig, dus een billing-account, dus je abonnement van $20/maand wordt een pay-as-you-go-account op iemands dashboard."
hermes proxy plet dat probleem. Je OAuth-abonnement blijft waar het zit. De proxy spreekt OpenAI op localhost. Aider, Cline, Codex CLI, Continue — die weten niet dat ze met Claude of Grok praten. Ze zien gewoon een OpenAI-endpoint dat werkt.
Eén abonnement, alle tools, geen API-key. Dat is de hele pitch.