ChatGPT in Hermes zonder API-sleutel: complete installatiegids

Zo draai je ChatGPT met Hermes zonder API-key

Je kunt GPT-modellen draaien binnen Hermes Agent met alleen je bestaande ChatGPT-abonnement. Hermes authenticeert via ChatGPT device-code OAuth, slaat je inloggegevens op in ~/.hermes/auth.json en kan bestaande Codex CLI-gegevens importeren. Dat betekent: geen developer API-key, geen dashboard voor betalingen per token, en geen keys die je moet blijven vernieuwen. Let wel op één harde beperking: deze werkwijze vereist een betaald abonnement, en de prijs van ChatGPT Plus staat sinds de lancering vast op $20.

In deze gids leggen we uit hoe het precies werkt, lopen we de installatie stap voor stap door en laten we de exacte OAuth-inlogflow zien. Ook bespreken we de slimste manier om te betalen voor AI-abonnementen zoals ChatGPT, Claude en Gemini, zonder geld te verliezen aan buitenlandse transactiekosten. Reken op ongeveer 10 minuten leestijd, en aan het einde draai je GPT in een terminal-agent terwijl je abonnement al het zware werk doet.

Betaal je elke maand in USD voor ChatGPT, Claude of Gemini? Bleap rekent 0% wisselkosten op je USD-abonnementen en geeft een vaste 20% cashback op Claude, ChatGPT en Gemini, met een self-custodial Mastercard en zonder eigen abonnement. (De 20% cashback geldt alleen voor Claude, ChatGPT en Gemini.) Vraag de Bleap-kaart aan →

1. Hoe OpenAI's OAuth-integratie met Hermes eigenlijk werkt

Het mechanisme achter toegang op basis van je abonnement

Hermes gebruikt OpenAI's OAuth device code flow, hetzelfde authenticatiepatroon dat je ook terugvindt bij tools als Slack en de GitHub CLI. In plaats van een API-key aan te maken in het OpenAI developer dashboard, dient je bestaande ChatGPT-abonnement als inlogmiddel. De onderliggende broncode van Hermes Agent gebruikt een OpenAI Codex OAuth device flow voor de authenticatie bij OpenAI, en geen simpele OPENAIAPIKEY-omgevingsvariabele. Deze device flow is bedoeld voor gebruikers met een Codex-abonnement die willen inloggen via de OpenAI-website in plaats van zelf een API-key te beheren.

Hierdoor lopen verzoeken via de infrastructuur van het consumenten-abonnement van ChatGPT, in plaats van via de API-laag waarbij je per token betaalt.

Waarom dit anders is dan authenticatie met een API-key

Een API-key betekent een developer-account plus betalen per token. Inloggen via OAuth betekent dat je vaste maandabonnement het gebruik dekt. Het praktische voordeel is reëel: geen onverwachte API-facturen, geen tokenbudget om in de gaten te houden, en geen keys om te vervangen. Eén punt van aandacht vooraf: het is momenteel niet gedocumenteerd welke ChatGPT-abonnementsvormen hiervoor in aanmerking komen, en hoe het gebruik van Hermes precies meetelt binnen de Codex-limieten van je abonnement. Zie modeltoegang dus als een momentopname, niet als een vaste garantie.

2. Vereisten: wat je nodig hebt voordat je begint

Vereiste accounts en abonnementen

• Een actief betaald ChatGPT-abonnement. De prijzen van ChatGPT lopen uiteen van $0 tot $200 per maand, verdeeld over vijf niveaus: Free voor $0, Go voor $8, Plus voor $20, en twee Pro-abonnementen voor $100 en $200. Het gratis niveau wordt niet ondersteund voor deze werkwijze.
• Een OpenAI-account met een geverifieerd e-mailadres.
• Een betaald abonnement is de minimale vereiste, omdat de OAuth device flow authenticeert op basis van je abonnement, en gratis accounts geen toegang hebben tot de modellen die deze methode gebruikt.

Vereiste software en systeemcompatibiliteit

• Hermes Agent geïnstalleerd (dit komt in de volgende sectie aan bod).
• Een ondersteund besturingssysteem: macOS, Linux of Windows.
• Een moderne terminalemulator zoals bash, zsh of PowerShell.
• Een internetverbinding voor de OAuth-browserredirect.

Windows-gebruikers kunnen de installatie het beste uitvoeren vanuit een PowerShell-sessie met verhoogde rechten (als beheerder). Controleer op Linux of je shellprofiel het pad naar de Hermes-binary correct aanroept.

3. Hermes Agent installeren: twee methoden

Methode 1: Desktop-installer (aanbevolen voor beginners)

Ga naar de officiële downloadpagina van de Hermes desktop-installer en haal de build voor jouw platform op.

1. Download de juiste installer voor je besturingssysteem: .dmg voor macOS, .exe voor Windows, of een .AppImage of pakket voor Linux.
2. Start de installer en volg de stappen in het scherm.
3. Controleer of Hermes in je systeem-PATH staat zodra de installatie is afgerond.

Controleer de installatie met een snelle versiecheck:

hermes --version

Methode 2: Installatie via de terminal (aanbevolen voor developers)

Werk je liever vanuit de shell? Gebruik dan een package manager of het installatiescript.

• macOS en Linux: draai het curl-gebaseerde installatiescript, of gebruik brew install hermes-agent.
• Windows: winget install hermes-agent of het bijbehorende pakket.

Op macOS en Linux moet je mogelijk uitvoerrechten geven aan het gedownloade script en de map met de binary toevoegen aan je PATH. Controleer daarna opnieuw met dezelfde check:

hermes --version

Configuratie na installatie

Bij de eerste keer opstarten maakt Hermes een configuratiebestand aan in ~/.hermes/config.toml (of het equivalent voor jouw platform). Voor de abonnementsflow hoef je geen API-sleutels in te vullen. Er is geen statische API-key nodig; Hermes genereert en vernieuwt het token automatisch voor je, ook als dit halverwege een sessie opnieuw moet gebeuren na een 401-foutmelding. OAuth regelt de rest.

4. De OAuth-authenticatiecommando uitvoeren

Het exacte terminalcommando om in te loggen

Start het inloggen bij ChatGPT via device-code met:

hermes auth add openai-codex

Je kunt het ook interactief doen. Voer hermes auth add openai-codex uit (of hermes model → ChatGPT of Codex Subscription) om een nieuwe device-code login te starten; de quarantaine wordt opgeheven bij de volgende succesvolle uitwisseling. Het interactieve keuzemenu is handig als je niet zeker weet welk provider-label je moet selecteren, want het leidt je stap voor stap door de keuze heen.

Wat er direct na het uitvoeren van het commando gebeurt

Hermes genereert een unieke device-code en toont deze in de terminal samen met een verificatie-URL. De terminal komt vervolgens in een pollingstatus terecht en wacht tot jij de goedkeuring in de browser afrondt. Tijdens deze fase laat de terminaluitvoer meestal de code, de URL en een regel "wachten op autorisatie" zien, die vernieuwt terwijl er gepolld wordt. Reken erop dat het goedkeuringsvenster meerdere minuten open blijft, dus je hoeft niet meteen naar de browser over te schakelen.

Wil je dat je maandelijkse AI-uitgaven ook echt iets opleveren? Bij ChatGPT, Claude en Gemini geeft Bleap je een vaste 20% cashback in USDC plus 0% wisselkosten op de USD-afschrijving, zonder maandelijkse kaartkosten. Vraag de Bleap-kaart aan →

5. De OAuth-aanvraag goedkeuren en inloggen afronden

Stap voor stap: bevestiging in de browser (Device Code Flow)

1. Open de weergegeven URL in een willekeurige browser. Je hoeft niet op hetzelfde apparaat te zitten waarop je het commando hebt uitgevoerd.
2. Log in met je OpenAI-accountgegevens als je nog niet bent ingelogd.
3. Voer de apparaatcode in die in je terminal wordt getoond zodra daarom wordt gevraagd.
4. Bekijk de rechten die Hermes aanvraagt; deze omvatten leestoegang tot je ChatGPT-sessie.
5. Klik op Bevestigen of Toestaan om de autorisatie af te ronden.

Zo ziet een geslaagde login eruit

De terminal geeft een succesmelding met een bevestiging van het geauthenticeerde account, en het token wordt lokaal opgeslagen in de Hermes-configuratiemap. Vanaf dat moment zorgt automatische vernieuwing op de achtergrond ervoor dat je ingelogd blijft. Dit werkt op dezelfde manier als bij andere Hermes-providers met hetzelfde OAuth-model: er is geen API-sleutel nodig, je logt één keer in en Hermes vernieuwt je sessie automatisch op de achtergrond. Je hoeft pas opnieuw in te loggen zodra het opgeslagen token wordt ingetrokken of volledig verloopt.

Veelvoorkomende inlogfouten oplossen

• Code verlopen: apparaatcodes zijn maar kort geldig, dus voer het inlogcommando opnieuw uit om een nieuwe code en URL te genereren.
• Account niet geschikt: een gratis ChatGPT-account kan deze flow niet doorlopen, dat is normaal gedrag.
• Problemen met browserdoorverwijzing: schakel pop-upblokkers voor het auth-domein uit, en als een token verouderd lijkt, is opnieuw inloggen betrouwbaarder dan het nog een keer proberen. Houd er rekening mee dat OAuth-gebaseerde providers zoals Nous Portal of OpenAI Codex soms een nieuwe login-flow nodig hebben in plaats van gewoon een nieuwe API-sleutel.

6. Een GPT-model selecteren en wisselen in Hermes

Modelconfiguratie na authenticatie

Zodra je bent geauthenticeerd, gebruikt Hermes een standaardmodel, maar je kunt zelf aangeven welk GPT-model je wilt gebruiken:

hermes config set model <model-name>

Welke modellen voor jou beschikbaar zijn, hangt af van je abonnement. En omdat OpenAI's aanbod snel verandert, is het slim om eerst te checken welke modellen je account daadwerkelijk kan gebruiken voordat je een keuze maakt.

Beschikbare GPT-modellen via je ChatGPT-abonnement

Vanaf 2026 is GPT-5.6 het topmodel van OpenAI. Hermes Agent werkt met OpenAI's GPT-familie, waaronder GPT-5.6 Sol, Terra, Luna en meer, en GPT-5.6 Sol is momenteel het vlaggenschipmodel.

Welke modellen beschikbaar zijn, verandert steeds als OpenAI zijn abonnementen bijwerkt. Zo verschijnt GPT-5.6 inmiddels in betaalde ChatGPT-abonnementen, waaronder Plus- en Pro-accounts, al kan de uitrol verschillen per account, regio en abonnement. Bekijk met dit commando welke modellen jouw account kan gebruiken:

hermes models list

Tussentijds wisselen van model

Je kunt tijdens een actieve sessie gewoon tussendoor van model wisselen. Een handige aanpak is om voor simpele vragen over te schakelen naar een sneller, lichter model, en vervolgens weer terug te gaan naar het topmodel voor zware redeneertaken of langere codeerklussen. Zo blijven je reacties vlot, zonder in te leveren op kwaliteit waar het echt telt.

7. Controleren of de installatie goed werkt

Een testprompt uitvoeren

Check met één simpele prompt of alles werkt:

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

Als het gelukt is, zie je de naam van het actieve model, krijg je een gegenereerd antwoord en verschijnen er geen foutmeldingen over de API-key. De eerste reactie na het inloggen kan iets langer duren dan de rest, omdat de sessie nog moet opstarten.

Sessie- en abonnementsgegevens controleren

Bekijk je huidige authenticatiestatus met:

hermes auth status

De uitvoer laat zien met welk e-mailadres je bent ingelogd, welk model actief is en of je token nog geldig is. Zoals ook in de documentatie over het providerscherm staat: in de sectie Auth Providers zie je de actuele status van elke provider.

Wat te doen als de test mislukt

• Voer hermes auth add openai-codex opnieuw uit als de sessie verlopen lijkt te zijn.
• Controleer je internetverbinding en firewallinstellingen.
• Bekijk de recente logs met hermes logs --tail 50 om te achterhalen waar het misgaat.

8. Waarom GPT via Hermes gebruiken in plaats van een lokaal model

Kwaliteit en redeneervermogen

Toonaangevende GPT-modellen presteren consistent beter dan de meeste lokaal draaiende open-weight modellen op het gebied van redeneren, programmeren en taalvaardigheden. GPT-modellen staan bekend om hun sterke codeerkwaliteiten, brede algemene kennis en betrouwbare tool-calling: eigenschappen die ze bijzonder geschikt maken voor agentische workloads. Zo bereik je hoogwaardige output zonder omslachtige prompt-engineering trucjes.

Contextvenster en geheugen

Cloud-gehoste GPT-modellen kunnen veel grotere contextvensters aan dan wat de meeste consumentenhardware lokaal aankan. Dat betekent grotere codebases, langere documenten en gesprekken met meerdere beurten, zonder dat je halverwege een sessie kwaliteitsverlies merkt.

Hardware-eisen (of het ontbreken daarvan)

Lokale modellen zoals Llama en Mistral hebben serieus veel VRAM nodig, vaak minimaal 8 GB voor kleine modellen en 24 GB of meer voor grotere. Met Hermes plus ChatGPT OAuth draait de rekenkracht juist op de infrastructuur van OpenAI. Dat maakt deze opzet ideaal voor geïntegreerde grafische kaarten, oudere laptops of werklaptops met dichtgetimmerde GPU-drivers.

Betrouwbaarheid en uptime

Er zijn geen laadtijden voor modellen, geen compromissen door quantisatie en geen thermische throttling. Je krijgt constante beschikbaarheid in plaats van dat je zelf een lokale inference-server moet beheren.

Wanneer een lokaal model toch de betere keuze is

Lokale modellen winnen nog steeds in drie gevallen: privacygevoelige data die het apparaat nooit mag verlaten, echt offline gebruik, en extreem hoge gebruiksvolumes waarbij de kosten per verzoek in het voordeel van self-hosting uitvallen. Handig genoeg ondersteunt Hermes beide routes, dus je zit niet vast aan één richting.

Je AI-stack kost elke maand echt geld. Laat het ook wat terugverdienen. ChatGPT, Claude en Gemini factureren in USD, en een gemiddelde kaart rekent bij elke verlenging 2-3% extra. Bleap berekent 0% wisselkosten en geeft een vaste 20% cashback op alle drie. Vraag de Bleap-kaart aan →

FAQ: ChatGPT met Hermes draaien zonder API-key

Heb ik een ChatGPT Plus-abonnement nodig om Hermes met GPT-modellen te gebruiken?

Ja, je hebt een betaald ChatGPT Plus- of Pro-abonnement nodig. De OAuth device code flow verifieert je abonnement, en met een gratis account kun je dit proces niet afronden. De prijs van ChatGPT Plus staat sinds de lancering vast op $20 per maand, wat neerkomt op $240 per jaar. Je kunt alleen maandelijks betalen.

Welk terminalcommando gebruik ik in Hermes om de ChatGPT OAuth-login te starten?

Voer hermes auth add openai-codex uit, of gebruik hermes model en kies de optie ChatGPT of Codex Subscription. Hierdoor start de device code flow: je krijgt een URL en een unieke code te zien, die je in je browser bevestigt om de authenticatie af te ronden.

Welke GPT-modellen kan ik via mijn ChatGPT-abonnement in Hermes gebruiken?

Dat hangt af van je abonnement en de huidige uitrol. In 2026 bestaat de topreeks uit GPT-5.6 Sol, Terra en Luna. Voer na het inloggen hermes models list uit om precies te zien welke modellen jouw account kan bereiken, want de uitrol kan nog verschillen per account, regio en abonnement.

Wat is het verschil met het gebruik van een OpenAI API-key in Hermes?

Met een API-key betaal je per token via het OpenAI developer platform. Bij inloggen via OAuth met je ChatGPT-abonnement gebruik je juist je vaste maandbedrag. De API heeft een aparte kostenstructuur ten opzichte van ChatGPT-abonnementen: je betaalt per miljoen verwerkte tokens, niet per bericht of per maand. Toegang tot de API is niet inbegrepen bij een ChatGPT-abonnement, en omgekeerd geldt dat ook.

Wat moet ik doen als de device code verloopt voordat ik hem heb bevestigd?

Device codes zijn maar kort geldig. Voer gewoon opnieuw hermes auth add openai-codex uit om een nieuwe code en URL te krijgen, en bevestig deze meteen in je browser.

Kan ik Hermes gebruiken met een lokaal model en indien nodig overschakelen naar GPT?

Ja. Hermes is providerneutraal en ondersteunt zowel lokale backends als cloud GPT-modellen. Hermes Agent is providerneutraal; Nous Portal is één ondersteunde route, en OpenRouter, Ollama, directe providers, GitHub Copilot, Hugging Face en OpenAI-compatibele endpoints worden ook ondersteund. Gebruik hermes config set model <model-name> om op elk moment te wisselen.

Conclusie: haal meer uit je ChatGPT-abonnement met Hermes

Als je al betaalt voor ChatGPT Plus of Pro, dan laat je waarde liggen als je het niet gebruikt via een terminal agent zoals Hermes. Het proces bestaat uit vier stappen: installeer Hermes, voer het auth-commando uit, bevestig in je browser en kies je GPT-model. Het voordeel? Geen API-key-gedoe, geen verrassingen door afrekenen per token, en geen zware lokale hardware nodig. Het enige eerlijke nadeel is dat een betaald abonnement voor deze werkwijze geen optie maar een vereiste is. Vanaf daar kun je experimenteren met het wisselen van modellen: een lichter model voor snelheid, en het topmodel voor zware taken.

Nog één praktische tip over de rekening zelf. Je AI-abonnementen worden verlengd in USD, en de meeste kaarten rekenen stiekem 2-3% extra bij elke buitenlandse transactie. Met Bleap betaal je tegen de echte koers zonder wisselkoerskosten, en op Claude, ChatGPT en Gemini krijg je bij elke verlenging vlak 20% cashback in USDC, zonder maandelijks kaartabonnement. Het is een self-custodial Mastercard die je overal kunt gebruiken waar Mastercard wordt geaccepteerd, waardoor het geld dat je opzet bespaart nog verder gaat.