OpenAI Codex

Introduction

Le provider OpenAI Codex permet a Hermes Agent d'utiliser les modeles Codex d'OpenAI via votre compte ChatGPT. L'authentification se fait par OAuth device code flow: vous ouvrez une URL, entrez un code, et Hermes Agent gere les tokens automatiquement.

Aucune installation de Codex CLI n'est necessaire. Hermes Agent integre le provider nativement.

Connecter OpenAI Codex a Hermes Agent

Premiere connexion

hermes model

Dans le menu, selectionnez "OpenAI Codex". Un code a usage unique s'affiche dans le terminal. Ouvrez l'URL indiquee dans votre navigateur, connectez-vous a votre compte ChatGPT, et entrez le code.

Les credentials sont stockes dans ~/.hermes/auth.json et geres automatiquement.

Importer des credentials Codex CLI existants

Si vous utilisez deja Codex CLI, Hermes Agent peut importer ses instructions, permissions, serveurs MCP, skills et memoires :

hermes import-agent codex --dry-run

La commande affiche d'abord un apercu. Elle n'importe jamais les cles API, tokens ou autres credentials : configurez ensuite l'authentification Hermes avec hermes setup ou hermes model.

Re-authentification

Si vos tokens expirent ou sont revoques:

hermes auth add openai-codex

Ou simplement hermes model et selectionnez a nouveau OpenAI Codex.

Gestion des tokens

Quarantaine des tokens invalides

Si un refresh token echoue avec une erreur terminale (HTTP 4xx, invalid_grant, token revoque), Hermes Agent marque le token comme mort et arrete de le rejouer. Vous ne verrez pas un flot d'erreurs d'authentification identiques. Le message suivant vous invite a vous re-authentifier.

La quarantaine est levee automatiquement apres une authentification reussie.

Stockage

Les tokens OAuth sont stockes dans ~/.hermes/auth.json. Ce fichier est gere automatiquement: ne l'editez pas manuellement.

Changer de modele

En cours de session, utilisez /model pour basculer entre les modeles Codex disponibles. Pour changer de provider, quittez la session et utilisez hermes model.

Verifier la connexion

hermes status
hermes auth status
hermes chat -q "Bonjour, quel modele es-tu ?"

Depannage

Code expire

Les codes device code flow expirent rapidement (quelques minutes). Si le code expire, relancez hermes model pour obtenir un nouveau code.

Token revoque

hermes auth add openai-codex    # relance l'authentification

Erreur d'authentification persistante

Verifiez que votre compte ChatGPT a acces aux modeles Codex. Les comptes ChatGPT Plus, Team, et Enterprise sont generalement eligibles.

Conflit avec Codex CLI

Hermes Agent et Codex CLI peuvent coexister sans probleme. Les credentials sont stockes separement (~/.hermes/auth.json vs ~/.codex/auth.json). L'import est une copie, pas un deplacement.

Sources

• Documentation officielle Hermes Agent (https://hermes-agent.nousresearch.com/docs/)
• AI Providers (https://hermes-agent.nousresearch.com/docs/integrations/providers)
• CLI commands reference (https://hermes-agent.nousresearch.com/docs/reference/cli-commands)
• Depot NousResearch/hermes-agent, commit b4f8c491

Liens internes proposes

• Modeles et providers
• Configurer Hermes Agent
• Nous Portal
• Anthropic
• Depannage