Utiliser ChatGPT dans Hermes sans clé API : guide de configuration complet

Comment faire tourner ChatGPT avec Hermes sans clé API

Vous pouvez faire tourner des modèles GPT dans Hermes Agent en utilisant simplement votre abonnement ChatGPT existant. Hermes s'authentifie via l'OAuth par code d'appareil de ChatGPT, stocke les identifiants dans ~/.hermes/auth.json, et peut importer des identifiants Codex CLI déjà existants. Concrètement, pas besoin de clé API développeur, pas de tableau de facturation au jeton, et aucune rotation de clé à gérer. Attention tout de même à une limite incontournable : ce système nécessite un abonnement payant, et le prix de ChatGPT Plus est resté à 20 $ depuis son lancement.

Ce guide explique le mécanisme, détaille l'installation étape par étape, et montre le flux de connexion OAuth exact. Il aborde aussi la manière la plus intelligente de payer vos abonnements IA comme ChatGPT, Claude et Gemini sans perdre d'argent dans les frais de change à l'étranger. Comptez environ 10 minutes de lecture, et à la fin vous aurez GPT qui tourne dans un agent en ligne de commande, votre abonnement faisant tout le travail.

Vous payez ChatGPT, Claude ou Gemini en dollars chaque mois ? Bleap ne prend aucun frais de change sur vos abonnements en USD et vous offre 20% de cashback fixe sur Claude, ChatGPT et Gemini, avec une Mastercard auto-hébergée et sans abonnement à payer en plus. (Le cashback de 20% s'applique uniquement à Claude, ChatGPT et Gemini.) Obtenir la carte Bleap →

1. Comment fonctionne réellement l'intégration OAuth d'OpenAI avec Hermes

Le mécanisme derrière l'accès basé sur l'abonnement

Hermes utilise le flux OAuth par code d'appareil d'OpenAI, le même schéma d'authentification que celui utilisé par des outils comme Slack ou le CLI GitHub. Plutôt que de générer une clé API dans le tableau de bord développeur d'OpenAI, c'est votre abonnement ChatGPT existant qui sert d'identifiant. Le code source de Hermes Agent utilise un flux OAuth de type device flow via OpenAI Codex pour l'authentification OpenAI, et non une simple variable d'environnement OPENAIAPIKEY. Ce flux est pensé pour les utilisateurs disposant d'un abonnement Codex qui préfèrent s'authentifier via le site d'OpenAI plutôt que de gérer une clé API brute.

Cela fait passer les requêtes par l'infrastructure d'abonnement grand public de ChatGPT, plutôt que par le niveau API facturé au token.

En quoi c'est différent de l'authentification par clé API

Une clé API implique un compte développeur et une facturation au token. La connexion OAuth, elle, permet à votre abonnement mensuel forfaitaire de couvrir l'usage à la place. L'avantage pratique est bien réel : pas de facture API surprise, pas de budget de tokens à surveiller, et aucune clé à faire tourner. Une précision importante à garder en tête : on ne sait pas encore précisément quels niveaux d'abonnement ChatGPT sont éligibles, ni comment l'usage de Hermes est comptabilisé par rapport aux limites Codex de votre forfait. Considérez donc l'accès aux modèles comme une situation susceptible d'évoluer, et non comme une garantie figée.

2. Prérequis : ce dont vous avez besoin avant de commencer

Comptes et abonnements nécessaires

• Un forfait ChatGPT payant actif. Les tarifs de ChatGPT vont de 0 à 200 $ par mois, répartis sur cinq formules : Gratuit à 0 $, Go à 8 $, Plus à 20 $, et deux formules Pro à 100 $ et 200 $. La formule gratuite n'est pas prise en charge pour ce processus.
• Un compte OpenAI avec une adresse e-mail vérifiée.
• Un abonnement payant est le minimum requis, car le flux d'authentification OAuth par appareil s'appuie sur votre abonnement, et les comptes gratuits n'ont pas accès au modèle exposé par cette méthode.

Logiciels requis et compatibilité système

• Hermes Agent installé (on en parle dans la section suivante).
• Un système d'exploitation compatible : macOS, Linux ou Windows.
• Un émulateur de terminal moderne comme bash, zsh ou PowerShell.
• Une connexion internet pour la redirection du navigateur OAuth.

Les utilisateurs de Windows doivent lancer l'installation depuis une session PowerShell en mode administrateur. Sous Linux, vérifiez que votre profil shell référence bien le chemin du binaire Hermes.

3. Installer Hermes Agent : deux méthodes

Méthode 1 : l'installeur de bureau (recommandé pour les débutants)

Rendez-vous sur la page officielle de téléchargement de l'installeur de bureau Hermes et récupérez la version adaptée à votre système.

1. Téléchargez l'installeur correspondant à votre OS : .dmg pour macOS, .exe pour Windows, ou un .AppImage ou paquet équivalent pour Linux.
2. Lancez l'installeur et suivez les instructions de l'interface graphique.
3. Une fois l'installation terminée, vérifiez qu'Hermes est bien accessible dans le PATH de votre système.

Vérifiez l'installation avec un petit contrôle de version :

hermes --version

Méthode 2 : installation en ligne de commande (recommandé pour les développeurs)

Si vous préférez rester dans le terminal, utilisez un gestionnaire de paquets ou le script d'installation.

• macOS et Linux : lancez le script d'installation via curl, ou utilisez brew install hermes-agent.
• Windows : winget install hermes-agent ou le paquet équivalent.

Sur macOS et Linux, il se peut que vous deviez accorder les droits d'exécution au script téléchargé et ajouter le répertoire du binaire à votre PATH. Vérifiez ensuite avec la même commande :

hermes --version

Configuration post-installation

Au premier lancement, Hermes crée un fichier de configuration dans ~/.hermes/config.toml (ou l'équivalent selon votre plateforme). Aucun champ de clé API à remplir pour le parcours d'abonnement. Il n'y a pas de clé API statique : Hermes génère et rafraîchit automatiquement le token à votre place, y compris en le régénérant en cas d'erreur 401 en cours de session. L'OAuth s'occupe du reste.

4. Lancer la commande d'authentification OAuth

La commande exacte du terminal pour démarrer la connexion

Lancez la connexion ChatGPT par device-code avec :

hermes auth add openai-codex

Vous pouvez aussi y accéder en mode interactif. Exécutez hermes auth add openai-codex (ou hermes model → ChatGPT ou Codex Subscription) pour démarrer une nouvelle connexion par device-code ; la mise en quarantaine se lève dès le prochain échange réussi. Le sélecteur interactif est pratique si vous ne savez pas trop quel fournisseur choisir, puisqu'il vous guide dans le choix.

Ce qui se passe juste après avoir lancé la commande

Hermes génère un code d'appareil unique et l'affiche dans le terminal, accompagné d'une URL de vérification. Le terminal passe alors en mode d'attente, le temps que vous validiez l'autorisation dans le navigateur. Pendant cette phase, le terminal affiche généralement le code, l'URL, et une ligne "en attente d'autorisation" qui se rafraîchit pendant l'attente. La fenêtre d'autorisation reste ouverte plusieurs minutes, donc pas besoin de se précipiter pour basculer vers le navigateur.

Vous voulez que vos dépenses mensuelles en IA vous rapportent enfin quelque chose ? Sur ChatGPT, Claude et Gemini, Bleap vous offre 20% de cashback fixe en USDC, plus 0% de frais de change sur les paiements en USD, sans frais de carte mensuels. Obtenir la carte Bleap →

5. Valider la demande OAuth et finaliser la connexion

Confirmation dans le navigateur, étape par étape (Device Code Flow)

1. Ouvrez l'URL affichée dans n'importe quel navigateur. Vous n'avez pas besoin d'être sur l'appareil qui a exécuté la commande.
2. Connectez-vous avec vos identifiants OpenAI si ce n'est pas déjà fait.
3. Saisissez le code appareil affiché dans votre terminal lorsque cela vous est demandé.
4. Vérifiez les permissions demandées par Hermes, qui couvrent l'accès en lecture à votre session ChatGPT.
5. Cliquez sur Confirmer ou Autoriser pour terminer l'autorisation.

À quoi ressemble une connexion réussie

Le terminal affiche un message de succès confirmant le compte authentifié, et le token est enregistré localement dans le dossier de configuration de Hermes. À partir de ce moment, le rafraîchissement en arrière-plan vous maintient connecté. Cela fonctionne comme le même modèle OAuth utilisé pour les autres fournisseurs Hermes : pas besoin de clé API, vous vous connectez une seule fois, et Hermes rafraîchit automatiquement votre session en arrière-plan. Vous n'aurez pas à refaire cette connexion tant que le token stocké n'est pas révoqué ou totalement expiré.

Résoudre les erreurs de connexion courantes

• Code expiré : les codes appareil ont une durée de vie courte, il suffit de relancer la commande de connexion pour générer un nouveau code et une nouvelle URL.
• Compte non éligible : un compte ChatGPT gratuit ne peut pas suivre ce parcours, c'est normal.
• Problèmes de redirection dans le navigateur : désactivez les bloqueurs de pop-up pour le domaine d'authentification, et si un token semble périmé, mieux vaut refaire une connexion complète plutôt qu'un simple nouvel essai. Gardez en tête ce conseil plus général : les fournisseurs basés sur OAuth comme Nous Portal ou OpenAI Codex ont parfois besoin d'une nouvelle procédure de connexion plutôt que d'une simple clé API.

6. Sélectionner et changer de modèle GPT dans Hermes

Configuration du modèle après authentification

Une fois authentifié, Hermes utilise un modèle par défaut, mais vous pouvez définir explicitement le modèle GPT de votre choix :

hermes config set model <model-name>

Les modèles auxquels vous avez accès dépendent de votre formule d'abonnement, et la gamme d'OpenAI évolue vite. Mieux vaut donc vérifier ce que votre compte peut réellement utiliser avant de vous lancer.

Modèles GPT disponibles via l'abonnement ChatGPT

En 2026, la famille phare d'OpenAI est GPT-5.6. Hermes Agent peut fonctionner avec la famille GPT d'OpenAI, GPT-5.6 Sol, Terra, Luna et d'autres, GPT-5.6 Sol étant le modèle phare actuel.

La disponibilité des modèles évolue à mesure qu'OpenAI met à jour ses formules. D'ailleurs, GPT-5.6 apparaît désormais dans les abonnements ChatGPT payants, y compris les comptes Plus et Pro, mais le déploiement peut varier selon le compte, la région et la formule. Listez tout ce que votre compte peut utiliser avec :

hermes models list

Changer de modèle en cours de session

Vous pouvez changer de modèle directement pendant une session active. Une pratique courante consiste à basculer vers un modèle plus léger et plus rapide pour les requêtes simples, puis à revenir au modèle phare pour le raisonnement complexe ou les longues tâches de codage. Cela permet de garder des réponses rapides sans sacrifier la qualité là où elle compte vraiment.

7. Vérifier que la configuration fonctionne correctement

Lancer un prompt de test

Vérifiez que tout fonctionne avec un simple prompt :

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

Une exécution réussie affiche le nom du modèle actif, renvoie une réponse générée et ne montre aucune erreur liée à la clé API. La première réponse après l'authentification peut prendre un peu plus de temps que les suivantes, le temps que la session se mette en route.

Vérifier les détails de session et d'abonnement

Vérifiez votre état d'authentification actuel avec :

hermes auth status

Le résultat confirme votre adresse e-mail connectée, le modèle actif et la validité du token. Comme le précise la documentation pour la vue des fournisseurs, la section Auth Providers affiche l'état actuel de chaque fournisseur.

Que faire si le test échoue

• Relancez hermes auth add openai-codex si la session semble avoir expiré.
• Vérifiez la connexion internet et les règles du pare-feu.
• Consultez les logs récents avec hermes logs --tail 50 pour identifier précisément la couche en cause.

8. Pourquoi utiliser GPT via Hermes plutôt qu'un modèle local

Qualité et capacité de raisonnement

Les modèles phares de GPT surpassent systématiquement la plupart des modèles à poids ouverts exécutables localement, que ce soit en raisonnement, en code ou en langage. Les modèles GPT sont réputés pour leur excellent niveau en code, leur vaste culture générale et leur fiabilité dans l'appel d'outils, autant de qualités qui les rendent efficaces pour les workflows agentiques. Vous obtenez des résultats de haute qualité sans avoir à bricoler vos prompts.

Fenêtre de contexte et mémoire

Les modèles GPT hébergés dans le cloud gèrent des fenêtres de contexte bien plus larges que ce que la plupart du matériel grand public peut supporter en local. Concrètement, cela veut dire des bases de code plus volumineuses, des documents plus longs et des conversations à plusieurs échanges sans dégradation perceptible en cours de session.

Exigences matérielles (ou plutôt, leur absence)

Les modèles locaux comme Llama et Mistral demandent beaucoup de VRAM, souvent 8 Go minimum pour les petits modèles et 24 Go ou plus pour les plus gros. Avec Hermes associé à l'authentification OAuth de ChatGPT, le calcul s'effectue sur l'infrastructure d'OpenAI. Cette configuration est donc idéale pour les cartes graphiques intégrées, les vieux ordinateurs portables ou les machines de travail dont les pilotes GPU sont verrouillés.

Fiabilité et disponibilité

Pas de temps de chargement du modèle, pas de compromis liés à la quantisation, pas de limitation thermique. Vous bénéficiez d'une disponibilité constante au lieu de devoir surveiller un serveur d'inférence local.

Quand un modèle local reste le meilleur choix

Les modèles locaux gardent l'avantage dans trois cas précis : les données sensibles qui ne doivent jamais quitter l'appareil, une véritable utilisation hors ligne, et les volumes d'usage très élevés où l'économie par requête penche en faveur de l'auto-hébergement. Bon point, Hermes prend en charge les deux approches, donc vous n'êtes enfermé dans aucune direction.

Votre stack IA vous coûte de l'argent tous les mois. Autant qu'elle vous en rapporte un peu. ChatGPT, Claude et Gemini facturent en dollars, et une carte classique ajoute 2 à 3% de frais à chaque renouvellement. Bleap ne prend aucun frais de change et reverse 20% de cashback fixe sur les trois. Obtenir la carte Bleap →

FAQ : utiliser ChatGPT avec Hermes sans clé API

Ai-je besoin d'un abonnement ChatGPT Plus pour utiliser Hermes avec les modèles GPT ?

Oui, un abonnement payant ChatGPT Plus ou Pro est nécessaire. Le flux OAuth par code d'appareil s'authentifie via votre abonnement, et les comptes gratuits ne peuvent pas suivre cette procédure. Le tarif de ChatGPT Plus est resté à 20$ depuis son lancement, ce qui représente 240$ par an, en facturation mensuelle uniquement.

Quelle commande terminal Hermes permet de lancer la connexion OAuth à ChatGPT ?

Lancez hermes auth add openai-codex, ou utilisez hermes model et sélectionnez l'option ChatGPT ou Codex Subscription. Cela déclenche le flux par code d'appareil : une URL et un code unique s'affichent, que vous validez dans votre navigateur pour finaliser l'authentification.

À quels modèles GPT puis-je accéder via mon abonnement ChatGPT dans Hermes ?

Cela dépend de votre formule et du déploiement en cours. En 2026, la famille phare regroupe GPT-5.6 Sol, Terra et Luna. Lancez hermes models list après authentification pour voir précisément ce à quoi votre compte a accès, car le déploiement peut encore varier selon le compte, la région et la formule.

En quoi cela diffère-t-il de l'utilisation d'une clé API OpenAI avec Hermes ?

Une clé API vous facture à la consommation, par jeton, via la plateforme développeur OpenAI. La connexion OAuth via votre abonnement ChatGPT s'appuie au contraire sur votre forfait mensuel fixe. L'API repose sur une structure de coûts distincte des abonnements ChatGPT : vous payez au million de jetons traités, pas au message ni au mois, et l'accès à l'API n'inclut pas d'abonnement ChatGPT, et inversement.

Que faire si le code d'appareil expire avant que je l'aie validé ?

Les codes d'appareil ont une durée de vie courte. Relancez simplement hermes auth add openai-codex pour générer un nouveau code et une nouvelle URL, puis validez rapidement dans votre navigateur.

Puis-je utiliser Hermes avec un modèle local et basculer vers GPT quand j'en ai besoin ?

Oui. Hermes est agnostique côté fournisseur et prend en charge aussi bien les backends locaux que les modèles GPT cloud. Hermes Agent est agnostique côté fournisseur ; Nous Portal est une route prise en charge parmi d'autres, et OpenRouter, Ollama, les fournisseurs directs, GitHub Copilot, Hugging Face et les endpoints compatibles OpenAI sont également supportés. Utilisez hermes config set model <model-name> pour changer de modèle à tout moment.

Conclusion : tirez le meilleur parti de votre abonnement ChatGPT avec Hermes

Si vous payez déjà pour ChatGPT Plus ou Pro, l'utiliser dans un agent terminal comme Hermes vous permet de débloquer une valeur que vous laissez sinon de côté. Le processus tient en quatre étapes : installer Hermes, lancer la commande d'authentification, confirmer dans votre navigateur, puis sélectionner votre modèle GPT. À la clé : plus de gestion de clé API, plus de mauvaises surprises liées à la facturation au token, et pas besoin de matériel local puissant. Le seul vrai compromis, c'est qu'un abonnement payant est incontournable pour ce workflow. Ensuite, à vous d'expérimenter le changement de modèle : un modèle plus léger pour la rapidité, et le modèle phare pour les tâches lourdes.

Un dernier conseil pratique, côté facture cette fois. Vos abonnements IA se renouvellent en USD, et la plupart des cartes ajoutent discrètement 2 à 3 % sur chaque paiement à l'étranger. Avec Bleap, vous payez au taux réel, sans frais de change, et sur Claude, ChatGPT et Gemini, vous touchez un cashback fixe de 20 % en USDC à chaque renouvellement, sans abonnement mensuel de carte. C'est une carte Mastercard auto-custodiale, utilisable partout où Mastercard est accepté, pour que l'argent économisé par votre setup aille encore plus loin.