v0.14.0 ha tirato fuori un comando di una sola riga — hermes proxy — che ha ingoiato in silenzio un'intera classe di domande di integrazione che la community si faceva da mesi. Avvii hermes proxy e ti ritrovi un endpoint locale http://localhost:port che parla l'API di OpenAI, appoggiato al provider OAuth con cui sei loggato tramite Hermes — Claude Pro, ChatGPT Pro o SuperGrok.
La conseguenza pratica: gli strumenti che sanno parlare solo l'API OpenAI — Aider, Cline, Codex CLI, Continue, e la coda lunga di plugin per editor — adesso possono parlare a Claude Pro, ChatGPT Pro e SuperGrok attraverso l'abbonamento che hai già, senza che tu generi mai un'API key.
Questa è la parte che conta: la maggior parte di questi strumenti pretende un rapporto di fatturazione per ciascun provider. Aider con Claude → un account Anthropic console con metodo di pagamento. Cline con GPT-5 → un account di fatturazione su OpenAI. Codex CLI → lo stesso. hermes proxy schiaccia tutta quella roba in un singolo endpoint localhost che si autentica con la sessione OAuth che hai già.
Qui sotto il workflow esatto.
0. Prerequisiti
- •Hermes Agent v0.14.0 o più recente installato e configurato (
hermes --versionper controllare) - •Almeno un abbonamento OAuth collegato tramite
hermes model— Claude Pro, ChatGPT Pro o SuperGrok
Se non sei mai entrato in un provider OAuth, la prima volta che lanci hermes model ti accompagna nel flow OAuth di ogni provider. Scegli l'abbonamento che paghi davvero.
1. Avviare il proxy
hermes proxy
Di default si lega a una porta libera su localhost. Il log di avvio mostra l'URL — copialo. Per fissare la porta:
hermes proxy --port 11500
Lo fai girare come processo lungo — lo tieni vivo finché i tool a valle lo usano. systemd, launchd, tmux o anche solo una tab di terminale vanno tutti bene.
2. Puntare un tool a valle sul proxy
Aider
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy # va bene qualsiasi stringa non vuota
aider --model claude-sonnet-4-6
Il flag --model di Aider fa riferimento al nome del modello così come il proxy lo risolve dalla tua config provider di Hermes. Se sei entrato via Claude Pro, il tuo modello Claude di default è disponibile ; stessa cosa per ChatGPT Pro e SuperGrok.
Cline (VS Code)
Nelle impostazioni di Cline, scegli OpenAI Compatible come provider. Imposti:
- •Base URL:
http://localhost:11500/v1 - •API Key:
hermes-proxy(un qualsiasi valore non vuoto) - •Model ID: il nome del modello nella tua config di Hermes (per esempio
claude-sonnet-4-6,gpt-5.1)
Salvi. Cline ora instrada le sue richieste attraverso Hermes ; al resto pensa l'auth dell'abbonamento.
Codex CLI
Codex CLI di solito si aspetta OPENAI_API_BASE e OPENAI_API_KEY. Stessa forma di Aider:
export OPENAI_API_BASE=http://localhost:11500/v1
export OPENAI_API_KEY=hermes-proxy
codex --model gpt-5-codex
Se sei loggato in ChatGPT Pro tramite Hermes, il modello gpt-5-codex esce dal proxy e Codex CLI ottiene pieno accesso senza che tu apra mai un rapporto di fatturazione con OpenAI.
Continue (JetBrains / VS Code)
Modifichi la tua config di Continue (~/.continue/config.json o dall'UI):
{
"models": [{
"title": "Claude via Hermes",
"provider": "openai",
"model": "claude-sonnet-4-6",
"apiBase": "http://localhost:11500/v1",
"apiKey": "hermes-proxy"
}]
}
Stesso schema. Il "provider" resta openai perché, dal punto di vista di Continue, sta picchiando su un endpoint OpenAI.
3. Verificare che funzioni
Un curl al volo:
curl http://localhost:11500/v1/models -H "Authorization: Bearer hermes-proxy"
Dovresti ricevere la lista dei modelli che la tua config provider di Hermes espone. Se torna un 401 o una lista vuota, il proxy gira ma Hermes non vede una sessione OAuth attiva — rilancia hermes model e scegli un provider per cui hai un abbonamento vivo.
4. Risoluzione problemi
- •"Connection refused" — il proxy non sta girando. Avvialo.
- •"401 unauthorized" — il modello che hai chiesto non è coperto dall'abbonamento collegato. Lancia
hermes modele guarda quali provider sono attivi. - •"Model not found" — il nome del modello nel tool a valle non combacia con quello che il tuo provider Hermes espone. Usa i nomi di
hermes model list. - •Rate-limit — stai sbattendo contro i limiti dell'abbonamento (Claude Pro fa intorno a 50 messaggi ogni 5 h su Sonnet ; ChatGPT Pro ha una sua quota ; SuperGrok la sua). Il proxy non aggiunge un suo rate limiter ; passa la quota che il provider ti dà.
Perché conta
L'API OpenAI è la lingua franca dell'ecosistema dei tool IA. Quasi ogni plugin per editor e ogni assistente di codice supporta prima OpenAI e poi gli "endpoint OpenAI-compatibili". Il trucco è che "endpoint compatibile" quasi sempre significa "ti serve un'API key, quindi un account di fatturazione, quindi il tuo abbonamento da 20 dollari al mese diventa un account a consumo sulla dashboard di qualcun altro".
hermes proxy schiaccia quel problema. Il tuo abbonamento OAuth resta dove vive. Il proxy parla OpenAI su localhost. Aider, Cline, Codex CLI, Continue — non sanno di stare parlando con Claude o Grok. Vedono solo un endpoint OpenAI che funziona.
Un abbonamento, tutti gli strumenti, niente API key. Il pitch è tutto qui.