Guide · IA & agents

5 outils de suivi des tokens pour Claude Code et Codex

Suivez facilement tokens, contexte, quotas d’abonnement et coûts API dans Claude Code et Codex, sans confondre estimation locale et facture réelle.

Cinq jauges de consommation de hauteurs différentes.

La consommation de tokens de Claude Code ou de Codex ne donne pas, à elle seule, votre quota restant ni votre facture. Une session locale, un abonnement et une clé API ont des compteurs différents. Les cinq outils ci-dessous servent chacun à lire un de ces compteurs sans inventer de conversion entre tokens, crédits et messages.

En bref. Commencez par la vue native liée à votre mode de connexion : /usage dans Claude Code ou /status dans Codex. Ajoutez une ligne d’état si vous voulez surveiller le contexte pendant le travail. Utilisez ccusage pour analyser les journaux locaux sur plusieurs jours. Le tableau de bord Codex reste la référence pour les limites du compte ChatGPT. Ces vues sont incluses ou gratuites, hors abonnement et consommation du modèle.

Tableau des 5 outils

Informations vérifiées le 4 novembre 2026. L’ordre aide à passer du compteur le plus proche de la session au relevé du compte ; ce n’est pas un classement.

Outil ou vueCe qu’il mesureGratuit ou payantOpen sourcePlateforme
Claude Code /usageTokens et estimation de coût de la session, limites du forfaitInclus dans Claude Code ; modèle ou abonnement facturé séparémentNon, interface propriétaireTerminal Claude Code
Claude Code /statuslineContexte, estimation de coût et fenêtres de limite visibles en continuInclus dans Claude CodeNon pour la fonction native ; licence du script selon son auteurTerminal Claude Code
ccusageAgrégats locaux par jour, semaine, mois ou sessionGratuitOui, MITTerminal, journaux locaux Claude Code et Codex
Codex CLI /status, /usage et /statuslineContexte de la session et usage du compte depuis le terminalInclus dans Codex ; forfait ou API séparéOui, Apache-2.0 pour le CLITerminal Codex
Tableau de bord Codex UsageLimites du forfait, échéances de remise à zéro et crédits selon le compteInclus dans le compte CodexNon, service propriétaireWeb et application Codex

Une mention « gratuit » dans ce tableau concerne seulement le compteur. Elle ne rend ni le modèle, ni l’abonnement, ni les appels API gratuits.

Avant de lire un chiffre, identifiez son périmètre

Quatre notions reviennent dans les interfaces. Les mélanger produit des conclusions fausses, même lorsque chaque chiffre est exact.

  • Le coût API dépend des tokens facturables, du modèle et de la grille applicable au compte. Une estimation calculée par le client n’est pas la facture.
  • La limite d’abonnement est une allocation incluse dans un forfait Claude ou ChatGPT. Elle peut être partagée avec d’autres surfaces du même éditeur.
  • Le quota de session correspond à une fenêtre de temps ou à la capacité restante d’une conversation. Il ne se convertit pas en nombre garanti de prompts.
  • L’estimation locale est reconstruite depuis la session courante ou des journaux présents sur la machine. Elle peut ignorer un autre ordinateur, le web ou une tâche cloud.

Anthropic distingue aussi la limite d’utilisation de la limite de longueur. La première porte sur ce que le compte peut consommer pendant une période. La seconde porte sur la fenêtre de contexte d’une conversation.[3] Pour replacer ces compteurs dans un budget complet, le guide Mesurer le coût d’un agent sépare déjà tokens, outils, machine et stockage.

1. Claude Code /usage pour la session et le forfait

Dans une session Claude Code, tapez :

/usage

La commande réunit deux lectures. Le bloc Session affiche les tokens de la session, leur répartition par modèle et une estimation monétaire calculée localement. Pour un compte API, cette vue aide à repérer une session coûteuse. Anthropic précise toutefois que la valeur est une estimation fondée sur les tarifs catalogue, sauf si l’organisation a configuré sa propre table de prix. La page Usage de Claude Console reste la source de facturation.[1]

Pour un abonnement Claude, le montant estimé de la session n’indique pas ce que vous devez payer en plus. L’usage est inclus dans le forfait jusqu’à ses limites. La même commande affiche alors les barres du plan, des statistiques d’activité et une ventilation récente. Elle peut attribuer une part de l’usage aux skills, sous-agents, plugins ou serveurs MCP. Ces parts décrivent l’usage observé ; elles ne promettent pas une économie équivalente si vous retirez un élément.[1]

La vue locale sur les dernières 24 heures ou les sept derniers jours ne couvre que l’historique présent sur cette machine. Un passage dans claude.ai, Claude Desktop ou un autre ordinateur peut consommer le même forfait sans apparaître dans cette ventilation locale. Les limites de session et les limites hebdomadaires du compte sont, elles, communes aux surfaces Claude concernées.[3]

/usage est donc le bon premier contrôle quand Claude Code annonce une limite atteinte. Regardez la fenêtre concernée et son heure de remise à zéro. Ne divisez pas le pourcentage restant par votre nombre de prompts précédents : la taille du contexte, les outils, le modèle et le niveau d’effort font varier la consommation.

Licence et disponibilité : /usage fait partie du client Claude Code documenté par Anthropic. Ce n’est pas un projet tiers sous licence open source. La commande a été vérifiée dans la documentation officielle de gestion des coûts, pas exécutée sur un compte pour cet article.

2. Claude Code /statusline pour surveiller le contexte

Une ligne d’état évite d’ouvrir /usage après chaque tour. Claude Code peut générer sa configuration avec une instruction telle que :

/statusline show model name, context percentage and rate limits

La ligne reçoit un objet JSON de la session et lance un script local qui choisit les champs à afficher. La documentation expose notamment le pourcentage de contexte utilisé, les tokens d’entrée et de sortie, l’estimation du coût de session et, pour les abonnements compatibles, les pourcentages consommés dans les fenêtres de limite. Le script tourne localement et son exécution ne consomme pas de tokens API.[2]

Cette vue répond à une question précise : combien de place reste-t-il dans le contexte actif ? Elle ne répond pas automatiquement à « combien me reste-t-il sur ma facture ? ». Le champ de coût est encore une estimation côté client. Les données de contexte proviennent de la dernière réponse API, tandis que /context peut ajouter une estimation des messages arrivés depuis cette réponse. Deux pourcentages légèrement différents peuvent donc décrire des instants différents.[2]

La ligne d’état exécute une commande shell. Relisez le script généré avant de l’autoriser, surtout dans un dépôt récupéré ailleurs. Un affichage simple du pourcentage de contexte demande peu de code et limite les surprises. Si la valeur reste vide au démarrage, attendez la première réponse du modèle : plusieurs champs sont absents avant celle-ci.

Licence et disponibilité : la fonction est native et propriétaire. La documentation ne donne pas de licence open source au script généré. La référence officielle de la status line décrit les champs et les règles de confiance. Aucun script n’a été généré ni exécuté pour cette page.

3. ccusage pour agréger les journaux locaux

ccusage lit les données locales de plusieurs agents de code, dont Claude Code et Codex. Son dépôt documente des rapports quotidiens, hebdomadaires, mensuels et par session. La commande de démarrage publiée est :

Page du dépôt GitHub ccusage/ccusage : description du projet, fichiers et README.
GitHub, github.com, capture du 12 novembre 2026
npx ccusage@latest

Pour isoler une source, le projet fournit notamment :

npx ccusage@latest claude daily
npx ccusage@latest codex daily

L’intérêt de ccusage apparaît après plusieurs sessions. La vue native répond bien à « où en suis-je maintenant ? ». ccusage aide plutôt à repérer les jours chargés, les modèles utilisés et la part des lectures ou écritures de cache dans les fichiers disponibles sur la machine. Il sait aussi produire du JSON pour votre propre analyse.[4]

Ses colonnes de coût restent des estimations. Le projet applique des données tarifaires et permet des surcharges de prix ; il ne lit pas votre contrat, vos taxes ou une remise négociée. Un journal absent, nettoyé ou créé sur une autre machine ne peut pas entrer dans le total. Le rapport n’est donc ni le quota officiel d’un abonnement, ni le relevé de facturation d’une API.

L’outil tiers lit des historiques de sessions. Avant de l’installer, examinez les fichiers auxquels il accède et évitez de partager une sortie qui contient un nom de projet sensible. L’option JSON facilite l’automatisation, mais elle facilite aussi la copie de données vers un autre système. Gardez le traitement local si vous n’avez pas besoin d’export.

Le dépôt n’était pas archivé lors de la vérification, et sa version v20.0.48 avait été publiée le 2 novembre 2026. Le code de l’application est distribué sous licence MIT.[4][5] Les commandes ci-dessus viennent du README officiel ; elles n’ont pas été lancées pour cet article.

4. Les vues natives de Codex CLI

Codex sépare l’état de la conversation de l’activité du compte. Dans le terminal, /status affiche la configuration de la session et l’usage du contexte. La documentation le recommande pour contrôler le modèle actif, la politique d’approbation, les racines accessibles et la capacité de contexte restante.[6]

/status

Les versions documentées proposent aussi /usage pour ouvrir les actions d’usage du compte, avec des vues quotidiennes, hebdomadaires ou cumulées lorsque la session dispose de l’authentification Codex requise :

/usage weekly

Enfin, /statusline permet de choisir les éléments permanents du pied du terminal, dont le contexte, les limites, les compteurs de tokens et l’identifiant de session. Cette famille de commandes forme une seule vue native : état ponctuel avec /status, activité du compte avec /usage, puis affichage continu avec /statusline.[6]

Une session connectée avec ChatGPT et une session lancée avec une clé API ne suivent pas le même budget. OpenAI précise que les prix API sont séparés de l’usage inclus dans l’abonnement. N’utilisez donc pas un tarif API pour convertir le pourcentage restant du forfait en nombre de tâches.[7] Avec une clé API, consultez le tableau d’usage de la plateforme API pour la dépense autoritative de l’organisation.

Page tarifaire officielle de OpenAI, avec ses offres et leurs prix au jour de la capture.
OpenAI, learn.chatgpt.com, capture du 12 novembre 2026

Le terminal donne un diagnostic rapide, pas une garantie sur le prochain travail. Une tâche locale longue, une tâche cloud et un petit correctif peuvent consommer des parts différentes. la grille des outils IA pour développeurs aide à comparer les autres différences sans fabriquer d’équivalence de quotas.

Licence et disponibilité : le dépôt officiel openai/codex publie le CLI sous Apache-2.0.[8] Les services distants et le compte ChatGPT restent soumis aux conditions du service. Les commandes ont été lues dans la documentation, sans connexion à un compte Codex pour cette page.

Page du dépôt GitHub openai/codex : description du projet, fichiers et README.
GitHub, github.com, capture du 12 novembre 2026

5. Le tableau de bord Codex Usage pour les limites du compte

Le tableau de bord Codex Usage est la vue à ouvrir quand la question porte sur l’allocation du forfait, la date de remise à zéro ou le solde de crédits disponible. OpenAI y renvoie depuis sa page officielle de tarification Codex et depuis l’aide sur les limites.[7]

Cette page complète le CLI dans trois situations : vous travaillez sur plusieurs machines, vous alternez tâches locales et cloud, ou plusieurs fonctions agentiques partagent la même allocation. Le tableau de bord du compte peut alors voir ce qu’un journal local ne voit pas. Selon le plan et le rôle dans l’espace de travail, il peut aussi afficher les crédits restants ou les options de gestion associées.

Ne lisez pas un crédit comme un token. OpenAI distingue les tokens traités, les crédits de facturation et l’usage inclus dans un abonnement. Les taux applicables dépendent du modèle, du type de token et du contrat. La documentation prévient aussi que les estimations de messages ne sont pas des limites fixes. Pour connaître la marge actuelle, utilisez la valeur et l’échéance affichées par le compte au moment de la consultation.[7]

Le tableau de bord Codex ne remplace pas le tableau d’usage de l’API OpenAI. Si Codex fonctionne avec une clé API, la dépense appartient à l’organisation API concernée. Si Codex fonctionne avec la connexion ChatGPT, la limite appartient au forfait ou à l’espace ChatGPT. Vérifiez le mode d’authentification avant de rapprocher deux relevés.

Licence et disponibilité : Codex Usage est un service web propriétaire d’OpenAI, sans licence open source. Son accès dépend du compte et du plan. La documentation publique a été consultée, mais le tableau authentifié n’a pas été ouvert pour cet article.

Une routine de suivi sans double comptage

  1. Au début d’une session, vérifiez le mode de connexion : abonnement Claude, compte ChatGPT ou clé API.
  2. Lisez /usage dans Claude Code ou /status dans Codex pour le contexte actif.
  3. Gardez la status line seulement si le suivi continu vous aide à décider quand changer de tâche ou repartir sur une session propre.
  4. Une fois par semaine, comparez ccusage aux journaux locaux, sans attendre qu’il reproduise le total du compte.
  5. Pour une décision de budget, revenez au tableau fournisseur correspondant à l’authentification. La facture ou le relevé d’organisation prime sur l’estimation locale.

Cette routine évite d’additionner deux fois la même session. La status line, la commande native et ccusage peuvent tous relire des données issues du même travail. Ils offrent des angles différents ; leurs totaux ne sont pas trois dépenses distinctes. Pour observer le déroulement technique d’un run plutôt que son coût, consultez Observer un run d’agent.

Comment réduire la consommation sans promesse chiffrée

Commencez une nouvelle session quand vous passez à une tâche sans rapport avec la précédente. Un long historique est renvoyé ou relu au fil des appels, même si votre nouvelle question tient sur une ligne. Gardez les instructions de projet courtes et placez les règles spécialisées près du code concerné.

Désactivez les serveurs MCP et outils inutiles pour la tâche. Leurs définitions prennent de la place dans le contexte, et leurs résultats peuvent l’alourdir davantage. Limitez aussi les sous-agents : chacun lance ses propres requêtes. Ces changements réduisent des sources de consommation documentées, mais aucun pourcentage d’économie ne peut être promis avant mesure sur votre dépôt.[1][7]

Une limite atteinte ne prouve pas qu’un prompt précis était mauvais. Regardez d’abord la durée de la session, le contexte, le modèle, les outils et les tâches parallèles. Le guide Claude Code : prix, offres et limites explique pourquoi un forfait ne correspond pas à un nombre fixe de demandes.

Questions fréquentes

/usage affiche-t-il la facture réelle de Claude Code ?

Non. Pour une session API, Claude Code calcule une estimation locale à partir des tokens et des prix disponibles. Anthropic renvoie vers la page Usage de Claude Console pour la facturation autoritative.[1]

Pourquoi /context et la status line diffèrent-ils ?

La status line part des compteurs de la dernière réponse API. /context peut ajouter une estimation des messages ajoutés depuis cette réponse, ce qui crée un écart temporaire.[2]

ccusage connaît-il mon quota Claude ou ChatGPT ?

Non. Il agrège les données locales qu’il sait lire. Il ne remplace pas les limites affichées par le compte Claude ou le tableau Codex Usage.[4]

Peut-on convertir les tokens Codex en crédits ?

Seulement avec la grille officielle qui s’applique réellement au plan, au modèle et au type de token concernés. Il n’existe pas d’équivalence universelle à recopier pour tous les comptes.[7]

Que vérifier après un message « limite atteinte » ?

Identifiez d’abord la fenêtre concernée et son heure de remise à zéro dans la vue native ou le tableau du compte. Vérifiez ensuite si des crédits supplémentaires sont activés avant de relancer une tâche, afin d’éviter de passer involontairement d’une allocation incluse à une consommation payante.

Sources

[1] https://code.claude.com/docs/en/costs : Anthropic, gestion des coûts de Claude Code, consulté le 4 novembre 2026. [2] https://code.claude.com/docs/en/statusline : Anthropic, personnaliser la ligne d’état, consulté le 4 novembre 2026. [3] https://support.claude.com/fr/articles/11647753-comment-fonctionnent-les-limites-d-utilisation-et-de-longueur : Anthropic, limites d’utilisation et de longueur, consulté le 4 novembre 2026. [4] https://github.com/ccusage/ccusage : ccusage, dépôt officiel, consulté le 4 novembre 2026. [5] https://github.com/ccusage/ccusage/blob/main/apps/ccusage/LICENSE : ccusage, licence MIT, consulté le 4 novembre 2026. [6] https://developers.openai.com/codex/developer-commands : OpenAI, commandes développeur de Codex, consulté le 4 novembre 2026. [7] https://learn.chatgpt.com/docs/pricing : OpenAI, tarifs et limites d’usage de Codex, consulté le 4 novembre 2026. [8] https://github.com/openai/codex/blob/main/LICENSE : OpenAI Codex, licence Apache-2.0, consulté le 4 novembre 2026.