Comment voir la consommation de tokens de Claude Code : 4 méthodes

Si vous utilisez Claude Code plus de quelques minutes par jour, les tokens sont votre vraie monnaie. Ils décident quand vous atteignez une limite de débit, à quelle vitesse vous épuisez un abonnement, et si un long run d'agent en valait la peine. Le souci : Claude Code ne vous met pas le chiffre sous les yeux. Il faut aller le chercher.

Voici quatre façons de vérifier la consommation de tokens de Claude Code, de la commande intégrée la plus rapide à un compteur en direct qui affiche chaque agent en temps réel. Choisissez celle qui correspond au niveau de détail dont vous avez besoin.

1. Le plus rapide : la commande /cost

Dans n'importe quelle session Claude Code, tapez :

/cost

Claude Code affiche le coût total et le nombre de tokens de la session en cours, ainsi que sa durée. C'est la réponse la plus rapide à la question "combien cette session a dépensé jusqu'ici", et ça ne demande rien à installer.

Le bémol : /cost se limite à la session dans laquelle vous êtes. Elle ne dit pas ce que vous avez dépensé hier, ce qu'un autre projet a coûté, ni comment un agent se compare à un autre. Pour une vérification ponctuelle, c'est parfait. Pour de l'historique, lisez la suite.

2. La source : les transcripts de session

Claude Code écrit chaque session sur disque sous forme de transcript JSONL. Sur macOS et Linux, vous les trouverez ici :

~/.claude/projects/<chemin-projet-encodé>/<session-id>.jsonl

Chaque ligne est un message, et les messages de l'assistant portent un objet usage avec les comptes exacts : input_tokens, output_tokens, et les champs de cache (cache_creation_input_tokens, cache_read_input_tokens). Les lectures de cache sont la partie intéressante : elles coûtent bien moins cher que de l'input neuf, donc une session avec un bon taux de cache coûte bien moins que ne le laisse croire le nombre brut de tokens.

C'est la vérité terrain. Tous les autres outils, y compris les deux ci-dessous, lisent ces mêmes fichiers. Si vous voulez scripter votre propre rapport, un jq sur le JSONL vous y mènera.

3. Un CLI dédié : ccusage

Si vous préférez ne pas écrire votre propre parseur, l'outil communautaire ccusage lit ces transcripts et les agrège en totaux par jour, par mois et par session :

npx ccusage@latest

Bon compromis : plus d'historique que /cost, moins de travail qu'un jq fait main. Il reste dans le terminal, cela dit, donc il répond à "combien j'ai dépensé" mais pas à "quel agent, là, maintenant, est en train de dépenser".

4. Un compteur en direct : l'usage par session dans AgentsRoom

Les trois méthodes ci-dessus partagent un angle mort : elles sont a posteriori et mono-flux. Dès que vous lancez plusieurs agents en parallèle, vous voulez voir l'usage par agent, en direct, sans taper une commande dans chaque terminal.

C'est le rôle du compteur de tokens Claude Code dans AgentsRoom. Il lit les mêmes transcripts JSONL, par session, et fait remonter :

• les tokens d'input, d'output et de cache par agent, mis à jour pendant que la session tourne
• le taux de cache, pour voir quand le contexte est réutilisé plutôt que renvoyé
• une alerte avant qu'une session ne dérive vers une limite de débit

Comme il attribue l'usage par session, il reste correct même quand vous faites tourner plusieurs comptes Claude Code côte à côte : chaque compte garde ses propres totaux, ce qui rend la refacturation par client simple.

Laquelle choisir

• Besoin du chiffre de cette session ? /cost.
• Envie de scripter un rapport sur mesure ? Lisez directement les transcripts JSONL.
• Besoin de totaux quotidiens et mensuels dans le terminal ? ccusage.
• Plusieurs agents à surveiller en direct, par agent et par compte ? Le compteur dans AgentsRoom.

Vérifier l'usage est la première étape. Si les chiffres vous font grimacer, l'étape suivante est de les faire baisser : voyez comment réduire les coûts en tokens de Claude Code pour les leviers qui comptent vraiment, à commencer par la réutilisation du cache.