Usare ChatGPT in Hermes senza chiave API: guida completa alla configurazione

Come usare ChatGPT con Hermes senza chiave API

Puoi far girare i modelli GPT dentro Hermes Agent usando semplicemente il tuo abbonamento ChatGPT già attivo. Hermes si autentica tramite OAuth con device-code di ChatGPT, salva le credenziali in ~/.hermes/auth.json e può importare quelle già esistenti di Codex CLI. Questo significa niente chiave API per sviluppatori, nessuna dashboard di fatturazione a token e nessuna rotazione di chiavi da gestire. C'è però un limite fisso da tenere a mente: questo sistema richiede un piano a pagamento, e il costo di ChatGPT Plus è rimasto fermo a 20$ dal lancio.

Questa guida spiega il meccanismo, ti accompagna nell'installazione e mostra passo per passo il flusso di login OAuth. Copre anche il modo più intelligente per pagare gli abbonamenti AI come ChatGPT, Claude e Gemini senza perdere soldi in commissioni sulle transazioni estere. Ti servono circa 10 minuti di lettura, e alla fine avrai GPT che funziona in un agente da terminale con il tuo abbonamento a fare il lavoro pesante.

Paghi ChatGPT, Claude o Gemini in dollari ogni mese? Bleap applica 0% di commissioni sul cambio valuta sui tuoi abbonamenti in USD e ti dà un cashback fisso del 20% su Claude, ChatGPT e Gemini, con una Mastercard self-custodial e nessun abbonamento proprio da pagare. (Il cashback del 20% si applica solo a Claude, ChatGPT e Gemini.) Ottieni la carta Bleap →

1. Come funziona davvero l'integrazione OAuth di OpenAI con Hermes

Il meccanismo dietro l'accesso basato su abbonamento

Hermes utilizza il flusso OAuth device code di OpenAI, lo stesso schema di autenticazione usato da strumenti come Slack e GitHub CLI. Invece di generare una chiave API nella dashboard sviluppatori di OpenAI, è il tuo abbonamento ChatGPT esistente a fungere da credenziale. Il codice sorgente di Hermes Agent utilizza un flusso OAuth device di OpenAI Codex per l'autenticazione OpenAI, non una semplice variabile d'ambiente OPENAIAPIKEY, e questo flusso è pensato per chi ha un abbonamento Codex e vuole autenticarsi tramite il sito OpenAI invece di gestire una chiave API grezza.

In questo modo le richieste passano attraverso l'infrastruttura degli abbonamenti consumer di ChatGPT, e non attraverso il livello API a pagamento per token.

Perché è diverso dall'autenticazione con chiave API

Una chiave API significa un account sviluppatore più una fatturazione per token. Il login OAuth significa invece che il tuo abbonamento mensile a tariffa fissa copre l'utilizzo. Il vantaggio pratico è concreto: nessuna bolletta API a sorpresa, nessun budget di token da monitorare e nessuna chiave da ruotare. Un avvertimento da fare subito: quali piani ChatGPT siano effettivamente ammessi, e come l'utilizzo di Hermes venga conteggiato rispetto ai limiti Codex del tuo piano, non è al momento documentato. Considera l'accesso ai modelli come una fotografia del momento, non come una garanzia fissa nel tempo.

2. Prerequisiti: cosa ti serve prima di iniziare

Account e abbonamenti richiesti

• Un piano ChatGPT a pagamento attivo. I prezzi di ChatGPT vanno da 0 a 200 dollari al mese, suddivisi in cinque fasce: Free a 0$, Go a 8$, Plus a 20$ e due piani Pro a 100$ e 200$. Il piano gratuito non è supportato per questo flusso.
• Un account OpenAI con indirizzo email verificato.
• Un abbonamento a pagamento è il requisito minimo perché il flusso OAuth device si autentica in base al tuo abbonamento, e gli account gratuiti non hanno l'accesso ai modelli che questo metodo richiede.

Software richiesto e compatibilità del sistema

• Hermes Agent installato (lo vediamo nella prossima sezione).
• Un sistema operativo supportato: macOS, Linux o Windows.
• Un emulatore di terminale moderno come bash, zsh o PowerShell.
• Una connessione internet per il reindirizzamento del browser OAuth.

Chi usa Windows dovrebbe eseguire l'installazione da una sessione PowerShell con privilegi elevati. Su Linux, verifica che il tuo profilo shell includa il percorso del binario di Hermes.

3. Installazione di Hermes Agent: due metodi

Metodo 1: Installer desktop (consigliato ai principianti)

Vai alla pagina ufficiale di download dell'installer desktop di Hermes e scarica la versione per il tuo sistema.

1. Scarica l'installer giusto per il tuo OS: .dmg per macOS, .exe per Windows, oppure un .AppImage o package per Linux.
2. Avvia l'installer e segui le indicazioni a schermo.
3. Al termine dell'installazione, verifica che Hermes sia disponibile nel PATH del sistema.

Controlla che tutto funzioni con un rapido check della versione:

hermes --version

Metodo 2: Installazione da terminale (consigliato agli sviluppatori)

Se preferisci restare nella shell, puoi usare un package manager oppure lo script di installazione.

• macOS e Linux: esegui lo script di installazione basato su curl, oppure usa brew install hermes-agent.
• Windows: winget install hermes-agent o il package equivalente.

Su macOS e Linux potresti dover concedere i permessi di esecuzione allo script scaricato e aggiungere la cartella del binario al PATH. Poi verifica tutto con lo stesso comando:

hermes --version

Configurazione post-installazione

Al primo avvio, Hermes crea un file di configurazione in ~/.hermes/config.toml (o l'equivalente per il tuo sistema). Non c'è nessun campo per la chiave API da compilare nel flusso in abbonamento. Non esiste una chiave API statica: Hermes genera e rinnova automaticamente il token per te, ricreandolo anche in caso di errore 401 a metà sessione. L'OAuth si occupa di tutto il resto.

4. Eseguire il comando di autenticazione OAuth

Il comando esatto da inserire nel terminale per avviare il login

Avvia il login con device-code di ChatGPT con:

hermes auth add openai-codex

Puoi anche accedervi in modalità interattiva. Esegui hermes auth add openai-codex (oppure hermes model → ChatGPT o Codex Subscription) per avviare un nuovo login con device-code; la quarantena si azzera al successivo scambio riuscito. Il selettore interattivo è utile se non sei sicuro di quale provider scegliere, perché ti guida passo passo nella scelta.

Cosa succede subito dopo aver eseguito il comando

Hermes genera un codice univoco per il dispositivo e lo mostra nel terminale insieme a un URL di verifica. Il terminale entra quindi in una fase di polling, in attesa che tu completi l'approvazione dal browser. Durante questa fase, l'output del terminale in genere mostra il codice, l'URL e una riga "waiting for authorisation" che si aggiorna mentre il sistema effettua il polling. La finestra per l'approvazione resta aperta per diversi minuti, quindi non c'è bisogno di correre a passare al browser immediatamente.

Vuoi che la tua spesa mensile in AI ti ripaghi davvero? Su ChatGPT, Claude e Gemini, Bleap ti dà un cashback fisso del 20% in USDC più 0% di commissioni sul cambio valuta sull'importo in USD, senza costi mensili sulla carta. Scopri la carta Bleap →

5. Approvare la richiesta OAuth e completare il login

Conferma passo dopo passo dal browser (Device Code Flow)

1. Apri l'URL stampato in un browser qualsiasi. Non devi necessariamente usare lo stesso dispositivo su cui hai eseguito il comando.
2. Accedi con le tue credenziali OpenAI, se non hai già effettuato il login.
3. Quando richiesto, inserisci il codice del dispositivo mostrato nel terminale.
4. Controlla i permessi richiesti da Hermes, che riguardano l'accesso in lettura alla tua sessione ChatGPT.
5. Clicca su Confirm o Allow per completare l'autorizzazione.

Come capire se il login è andato a buon fine

Il terminale mostra un messaggio di successo che confirma l'account autenticato, e il token viene salvato localmente nella cartella di configurazione di Hermes. Da quel momento in poi, l'aggiornamento automatico in background ti mantiene collegato. Questo funziona esattamente come lo stesso modello OAuth per gli altri provider di Hermes: non serve nessuna API key, fai il login una volta sola e Hermes si occupa di rinnovare la sessione in automatico. Non dovrai rifare il login finché il token salvato non viene revocato o non scade del tutto.

Risoluzione dei problemi di login più comuni

• Codice scaduto: i codici del dispositivo durano poco, quindi rilancia il comando di login per generare un nuovo codice e un nuovo URL.
• Account non idoneo: un account ChatGPT gratuito non può completare questa procedura, ed è un comportamento previsto.
• Problemi di redirect del browser: disattiva i blocchi popup per il dominio di autenticazione, e se un token sembra non funzionare più, è più affidabile rifare il login da capo piuttosto che tentare di nuovo. Tieni presente anche il consiglio più generale: i provider basati su OAuth come Nous Portal o OpenAI Codex potrebbero richiedere un nuovo login completo invece di una semplice API key.

6. Selezionare e passare a un modello GPT in Hermes

Configurazione del modello dopo l'autenticazione

Una volta autenticato, Hermes utilizza un modello di base, ma puoi impostare esplicitamente il modello GPT che preferisci:

hermes config set model <model-name>

I modelli a tua disposizione dipendono dal tuo piano di abbonamento, e visto che l'offerta di OpenAI cambia rapidamente, conviene controllare quali modelli il tuo account può effettivamente usare prima di scegliere.

Modelli GPT disponibili con l'abbonamento ChatGPT

Nel 2026, la famiglia di punta di OpenAI è GPT-5.6. Hermes Agent può funzionare con la famiglia GPT di OpenAI, GPT-5.6 Sol, Terra, Luna e altri, e GPT-5.6 Sol è attualmente il modello di punta.

La disponibilità dei modelli cambia man mano che OpenAI aggiorna i suoi piani. Infatti, GPT-5.6 sta comparendo negli abbonamenti a pagamento di ChatGPT, inclusi gli account Plus e Pro, ma il rilascio può variare in base ad account, regione e piano. Per vedere tutto ciò che il tuo account può usare:

hermes models list

Cambiare modello a metà sessione

Puoi cambiare modello al volo durante una sessione attiva. Un approccio comune è passare a un modello più leggero e veloce per le richieste semplici, per poi tornare al modello di punta quando serve ragionamento pesante o attività di coding più lunghe. Così le risposte restano rapide senza sacrificare la qualità dove conta davvero.

7. Verificare che la configurazione funzioni correttamente

Eseguire un prompt di prova

Verifica che tutto funzioni con un semplice prompt:

hermes run "Explain OAuth device code flow in one paragraph"

Se l'esecuzione va a buon fine, viene visualizzato il nome del modello attivo, viene restituita una risposta generata e non compaiono errori relativi alla chiave API. La prima risposta dopo l'autenticazione potrebbe richiedere qualche istante in più rispetto alle successive, mentre la sessione si "scalda".

Verificare i dettagli della sessione e dell'abbonamento

Controlla lo stato attuale dell'autenticazione con:

hermes auth status

L'output conferma l'email con cui hai effettuato l'accesso, il modello attivo e la validità del token. Come indicato nella documentazione relativa alla vista dei provider, la sezione Auth Providers mostrerà lo stato attuale di ogni provider.

Cosa fare se il test fallisce

• Riesegui hermes auth add openai-codex se la sessione risulta scaduta.
• Controlla la connessione a internet e le regole del firewall.
• Consulta i log più recenti con hermes logs --tail 50 per individuare il punto in cui si verifica il problema.

8. Perché usare GPT tramite Hermes invece di un modello locale

Qualità e capacità di ragionamento

I modelli GPT di punta superano costantemente la maggior parte dei modelli open-weight eseguibili localmente su ragionamento, coding e compiti linguistici. I modelli GPT sono noti per il coding solido, una conoscenza generale ampia e un tool-calling affidabile, qualità che li rendono efficaci per carichi di lavoro agentici. Ottieni output di alta qualità senza dover ricorrere a trucchi di prompt engineering.

Finestra di contesto e memoria

I modelli GPT ospitati sul cloud gestiscono finestre di contesto molto più ampie di quanto possa fare la maggior parte dell'hardware consumer in locale. Questo significa codebase più grandi, documenti più lunghi e conversazioni multi-turno senza un calo evidente di qualità a metà sessione.

Requisiti hardware (o la loro assenza)

I modelli locali come Llama e Mistral richiedono una VRAM notevole, spesso almeno 8 GB per i modelli piccoli e 24 GB o più per quelli più grandi. Con Hermes più l'OAuth di ChatGPT, il calcolo viene invece eseguito sull'infrastruttura di OpenAI. Questo rende la configurazione ideale per grafiche integrate, laptop più vecchi o macchine di lavoro con driver GPU bloccati.

Affidabilità e uptime

Non ci sono tempi di caricamento del modello, nessun compromesso legato alla quantizzazione e nessun throttling termico. Ottieni una disponibilità costante invece di dover monitorare un server di inferenza locale.

Quando un modello locale resta la scelta migliore

I modelli locali restano la scelta migliore in tre casi: dati sensibili che non devono mai lasciare il dispositivo, un vero utilizzo offline e volumi d'uso molto elevati, dove i conti sul costo per richiesta fanno pendere la bilancia verso l'auto-hosting. Il bello è che Hermes supporta entrambi gli approcci, quindi non resti bloccato su una sola strada.

Il tuo stack di AI ti costa soldi veri ogni mese. Fai in modo che te ne restituisca un po'. ChatGPT, Claude e Gemini fatturano in dollari, e una carta tradizionale ti aggiunge un 2-3% a ogni rinnovo. Bleap non applica commissioni di cambio e ti restituisce un cashback fisso del 20% su tutti e tre. Scopri la carta Bleap →

FAQ: usare ChatGPT con Hermes senza chiave API

Mi serve un abbonamento ChatGPT Plus per usare Hermes con i modelli GPT?

Sì, è necessario un abbonamento a pagamento, ChatGPT Plus o Pro. Il flusso OAuth device code si autentica in base al tuo abbonamento, e gli account gratuiti non possono completare questa procedura. Il costo di ChatGPT Plus è rimasto fisso a 20$ dal lancio, e su base annua arriva a 240$, con fatturazione solo mensile.

Qual è il comando da terminale di Hermes per avviare il login OAuth di ChatGPT?

Esegui hermes auth add openai-codex, oppure usa hermes model e seleziona l'opzione ChatGPT o Codex Subscription. Questo avvia il flusso device code, che mostra un URL e un codice unico da confermare nel browser per completare l'autenticazione.

A quali modelli GPT posso accedere tramite il mio abbonamento ChatGPT in Hermes?

Dipende dal tuo piano e dal rollout attuale. Nel 2026 la famiglia di punta è GPT-5.6 Sol, Terra e Luna. Esegui hermes models list dopo l'autenticazione per vedere esattamente a cosa può accedere il tuo account, dato che il rollout può ancora variare in base ad account, area geografica e piano.

In cosa differisce questo dall'usare una chiave API OpenAI con Hermes?

Con una chiave API paghi in base ai token tramite la piattaforma developer di OpenAI. Il login OAuth tramite il tuo abbonamento ChatGPT usa invece il tuo piano mensile fisso. L'API ha una struttura di costi separata dagli abbonamenti ChatGPT: paghi per milione di token elaborati, non per messaggio o al mese, e l'accesso API non include un abbonamento ChatGPT, e viceversa.

Cosa devo fare se il device code scade prima che lo confermi?

I device code hanno una durata breve. Basta rieseguire hermes auth add openai-codex per generare un nuovo codice e un nuovo URL, e poi completare tempestivamente la conferma nel browser.

Posso usare Hermes con un modello locale e passare a GPT quando serve?

Sì. Hermes non dipende da un provider specifico e supporta sia backend locali che modelli GPT cloud. Hermes Agent è agnostico rispetto al provider; Nous Portal è una delle strade supportate, ma puoi usare anche OpenRouter, Ollama, provider diretti, GitHub Copilot, Hugging Face ed endpoint compatibili con OpenAI. Usa hermes config set model <model-name> per cambiare modello quando vuoi.

Conclusione: sfrutta al massimo il tuo abbonamento ChatGPT con Hermes

Se paghi già ChatGPT Plus o Pro, usarlo dentro un agente da terminale come Hermes ti fa sbloccare un valore che altrimenti resterebbe inutilizzato. Il processo è in quattro passaggi: installa Hermes, esegui il comando di autenticazione, confermi dal browser e scegli il tuo modello GPT. Il vantaggio? Niente gestione di chiavi API, niente sorprese di fatturazione a consumo, niente hardware locale pesante da gestire. L'unico compromesso onesto è che un abbonamento a pagamento è indispensabile per questo flusso di lavoro. Da lì in poi, puoi sperimentare passando da un modello all'altro: uno più leggero per la velocità, il modello di punta per i compiti più impegnativi.

Un ultimo consiglio pratico sulla bolletta vera e propria. I tuoi abbonamenti AI si rinnovano in USD, e la maggior parte delle carte aggiunge silenziosamente il 2-3% su ogni pagamento in valuta estera. Con Bleap paghi al tasso reale con 0% di commissioni di cambio, e su Claude, ChatGPT e Gemini guadagni un cashback fisso del 20% in USDC su ogni rinnovo, senza alcun abbonamento mensile per la carta. È una Mastercard self-custodial utilizzabile ovunque sia accettata Mastercard, così i soldi che risparmi con il tuo setup vanno ancora più lontano.