Suivre les coûts de Claude Code et Codex sans confondre estimation et facture

Pour suivre l’usage de Claude Code et de Codex CLI, partez des journaux locaux et calculez une estimation à partir des tokens, puis rapprochez-la du compte du fournisseur : un total calculé aux tarifs API ne correspond pas automatiquement aux frais d’un abonnement.

Avant de calculer : choisissez la bonne base

Un registre local lit des fichiers de session et applique une table de tarifs pour estimer un coût. Cette estimation, dite équivalente aux tarifs API, chiffre les tokens comme s’ils étaient facturés aux prix de l’API. Elle ne donne pas automatiquement le montant dû pour un abonnement.

La base de facturation dépend aussi du mode d’accès : l’usage de l’API Claude Console est facturé séparément d’un abonnement, tandis que Codex peut être utilisé avec un compte ChatGPT ou une clé API. Choisissez donc la mesure avant d’interpréter un montant.

Mettre en place un suivi local

Un tutoriel publié par Shattered.io décrit un registre Python qui lit des journaux JSONL de Claude Code et de Codex CLI, puis regroupe l’usage par jour, modèle, projet ou outil. JSONL est un format texte qui stocke un objet JSON par ligne. Le tutoriel présente ses rapports chiffrés d’exemple comme des données synthétiques.

1. Choisissez ce que vous voulez suivre. Séparez l’usage d’un abonnement de la facturation par clé API. Sans ce choix, un total calculé au tarif API risque de donner une fausse idée du coût de l’abonnement.
2. Repérez les journaux locaux. Le tutoriel situe les transcriptions Claude Code sous ~/.claude/projects, ou dans un répertoire Claude configuré. Le code source d’OpenAI décrit les sessions Codex dans ~/.codex/sessions. Ces fichiers sont la matière du registre local.
3. Vérifiez les compteurs que votre parseur lit. Dans un fixture de test public d’OpenAI, total_token_usage représente le cumul de la session et last_token_usage l’usage de la requête précédente. Le tutoriel calcule plutôt des écarts entre instantanés cumulés. Les deux champs du fixture donnent donc des périmètres distincts à contrôler lors de l’analyse.
4. Complétez le relevé des catégories de tokens. Le fixture d’OpenAI comprend aussi cached_input_tokens, cache_write_input_tokens et reasoning_output_tokens. Le parseur Codex décrit dans le tutoriel ne conserve pas cache_write_input_tokens. Sa présence dans le fixture ne suffit pas à déduire comment cette catégorie doit être tarifée.
5. Rapprochez les estimations du compte fournisseur. Utilisez les journaux pour analyser l’activité locale et les données d’usage ou de facturation du fournisseur pour vérifier les frais associés au compte. Une estimation locale ne remplace pas cette vérification.

Un garde-budget doit rejeter l’usage sans tarif

Dans le code Python publié par Shattered.io, l’agrégateur compte les tokens sans tarif, mais le garde-budget vérifie uniquement le total en dollars. Si un modèle ou un tarif manque, l’usage concerné peut donc ne pas entrer dans le montant contrôlé. Pour qu’un plafond soit exploitable, le contrôle doit refuser de continuer tant qu’il reste des tokens non tarifés.

Le contrôle Codex décrit dans le tutoriel est une fonction shell qui vérifie le budget avant de lancer codex. Un lancement direct de Codex, hors de cette fonction, contourne cette vérification.

Pour Claude Code, Anthropic indique que le hook UserPromptSubmit intervient avant le traitement d’une invite et que le code de sortie 2 bloque un événement compatible. Ce point de contrôle peut empêcher l’envoi d’une nouvelle invite ; il ne constitue pas un mécanisme d’arrêt d’une tâche déjà en cours.

Mesurer aussi le travail accepté

Le montant des tokens ne résume pas le temps nécessaire pour obtenir un résultat utilisable. Une personne contribuant sur Reddit décrit le suivi du coût équivalent aux tarifs API par brouillon accepté, séparément du temps de révision. Pour un aperçu, elle rapporte 2,40 dollars de tokens et trois heures de révision. C’est un exemple individuel, pas une mesure générale.

Un tableau de bord peut faciliter le suivi par projet ou par fournisseur. Lors d’une présentation de CodeBurn, AI Coding Daily montre des estimations quotidiennes, des ventilations par projet et par modèle, ainsi que l’activité des outils et des serveurs MCP. La personne qui présente le logiciel précise que ses montants reposent sur les tarifs API, et non sur les frais d’un abonnement.