Ce que coûte réellement Codex CLI
Connexion par abonnement vs clé API, cache automatique et le calcul de tokens des sessions agentiques — le panorama des coûts de l'agent de code d'OpenAI.
Les utilisateurs de Codex CLI se partagent en deux camps : ceux sur un plan ChatGPT qui n'ont jamais vu de compteur de tokens, et ceux sur clé API qui ne voient que des compteurs de tokens. Les deux devinent — le camp du plan ne voit pas le compteur, le camp de l'API ne voit pas le comportement du modèle. Voici le panorama des coûts de Codex CLI : quel mode facture quoi, où vont les tokens, et pourquoi les sessions agentiques ne ressemblent pas à des chats.
Transparence d'emblée : j'opère Teapot Router, une passerelle qui sert Codex CLI et Claude Code sur les protocoles OpenAI-compatible et Anthropic. La mécanique ci-dessous vaut pour tout endpoint OpenAI-compatible.
Deux modes, deux réalités de mesure
Codex CLI tourne en deux modes à la facturation fondamentalement différente. Connexion par abonnement : l'usage est inclus dans un abonnement ChatGPT jusqu'à des limites, et vous voyez un indicateur de quota, pas une facture — bon marché jusqu'au mur, puis bridé. Mode clé API : chaque token est mesuré et tarifé par modèle — c'est là que les questions de coût vivent vraiment. Les équipes qui doivent voir combien coûte le travail tournent en clé API ; celles qui veulent juste le travail tournent à l'abonnement jusqu'à ce que les limites mordent.
Où vont les tokens dans une session agentique
Une session Codex n'est pas un chat ; c'est une boucle d'appels d'outils, de lectures de fichiers et d'éditions, et chaque tour renvoie le contexte de travail. La facture est pilotée par les mêmes trois variables que tout agent de code :
- Tours par tâche — les agents itèrent ; un refactor, c'est des dizaines d'allers-retours facturés, pas un prompt.
- Croissance du contexte — chaque fichier lu et résultat d'outil voyage dans les tours suivants ; le message 20 repaie les messages 1 à 19.
- Comportement de cache — OpenAI remise automatiquement les préfixes répétés ; vous ne le configurez pas, mais la forme de votre session décide quelle part de la facture reçoit la remise.
Le marché que fait le cache automatique
Le cache de prompt d'OpenAI ne demande aucune configuration : les préfixes stables répétés sont remisés au hit. La contrepartie, c'est le contrôle — vous touchez la remise quand la forme de votre session se trouve être cache-friendly, et vous ne pouvez ni étiqueter ni piloter comme le permet le cache à la Anthropic. Conséquence pratique : la discipline de session (tâches bornées, sessions neuves, préfixes stables et ennuyeux) déplace votre taux effectif plus que le choix du modèle — et aucun bouton ne compense un contexte chaotique.
Faire tourner Codex derrière une passerelle
Le mode clé API est aussi le mode routable : changez un base_url et Codex parle à tout endpoint OpenAI-compatible. C'est là que les équipes placent une passerelle — un pool partagé au lieu de clés par développeur, la mesure par requête (modèle, tokens, hits de cache, coût exact) au lieu d'un mystère mensuel, et un consolidé par organisation. La mesure est le point : le mode abonnement cache combien coûte le travail ; une passerelle mesurée le montre, par tâche, par clé, par projet.
Choisissez le mode délibérément : abonnement pour inclus-et-opaque, clé API pour mesuré-et-auditable. Puis gérez les trois variables qui décident de la facture API — tours, croissance du contexte, forme de session cache-friendly — car en codage agentique elles dominent tout le reste.
FAQ
Codex CLI est-il gratuit avec un plan ChatGPT ?
L'usage est inclus jusqu'aux limites du plan — vous payez l'abonnement, pas au token, et au dépassement c'est un bridage, pas une facture. Les charges lourdes finissent généralement en mode clé API.
Le cache de prompt s'applique-t-il aux sessions Codex ?
Oui — les préfixes stables répétés sont remisés automatiquement sur les endpoints OpenAI. Rien à configurer ; la forme de la session (tâches bornées, contexte stable) détermine la part remisée.
Puis-je pointer Codex CLI vers mon endpoint ?
Oui — définissez la base URL vers tout endpoint OpenAI-compatible. Les passerelles ajoutent la mesure par requête et des pools d'équipe par-dessus ; le protocole est le même.