ccusage : le compteur qui te dit enfin ce que Claude Code te coûte (en une commande)

TL;DR — ccusage en une minute

• Ce que c’est : ccusage (ryoppippi, MIT, ~18 000 étoiles), un outil en ligne de commande (npx ccusage) qui analyse ta conso de tokens et ton coût Claude Code (et Codex, Copilot CLI…) à partir de tes logs locaux.
• Ce qu’il montre : rapports par jour / semaine / mois / session, breakdown par modèle, tokens de cache comptés à part, export JSON.
• Le hook : une seule commande, rien à installer durablement, 100% local (aucune donnée envoyée).
• Le catch : c’est une estimation (prix embarqués). En abonnement Max/Pro, il affiche le « coût équivalent API » — pas ta facture réelle.
• Notre verdict : Installer — le moyen le plus simple de savoir ce que Claude Code te coûte vraiment (ou vaut, si tu es en abo).

« Combien me coûte Claude Code ? » — la question que tout le monde se pose. On a écrit un article sur les prix (Pro/Max/API). ccusage répond à l’autre moitié : combien TU consommes réellement. Une commande, tes logs locaux, et tu as le chiffre.

Le problème : ta conso Claude Code est invisible

Tu utilises Claude Code tous les jours, mais tu n’as aucune idée de ce que ça représente en tokens et en euros. En API, tu le découvres sur la facture (trop tard). En abonnement (Pro/Max), tu paies un forfait, mais tu ne sais pas si tu le « rentabilises » — ou si tu frôles les limites. Dans les deux cas, tu pilotes sans compteur.

Ce que fait ccusage

ccusage lit tes logs locaux (les fichiers JSONL que Claude Code écrit sur ta machine) et en sort un tableau de bord dans le terminal :

• Rapports par jour, semaine, mois et par session.
• Breakdown par modèle (Opus vs Sonnet vs Haiku…) — tu vois où part le budget.
• Les tokens de cache comptés à part (crucial pour comprendre le vrai coût).
• Filtres de dates, export JSON, mode compact pour les captures.

Et ça marche aussi pour Codex, Copilot CLI et 10+ autres agents.

Le hook : une commande, zéro installation, 100% local

Pas de compte, pas de setup : npx ccusage@latest, et c’est parti. Surtout : tout tourne en local sur ta machine — aucune donnée envoyée à un serveur. Pour un outil qui lit ton activité de dev, c’est le bon niveau de confidentialité.

Le catch honnête

• C’est une estimation. Les prix viennent d’une base embarquée (LiteLLM), pas de ton compte de facturation. Le chiffre est très proche, mais ce n’est pas ta facture officielle au centime.
• Abonnement ≠ facture. Si tu es en Claude Pro ou Max, tu paies un forfait fixe. ccusage t’affiche alors le « coût équivalent API » — ce que tu aurais payé à l’usage. Très utile pour savoir si ton abo est rentable (si l’équivalent dépasse ton forfait, tu es gagnant), mais ce n’est pas de l’argent réellement dépensé.

Bien compris, ces deux nuances rendent l’outil encore plus utile : c’est un radar de valeur, pas un relevé bancaire.

Pour qui c’est vraiment utile

• Tu es en API et tu veux surveiller/maîtriser ta facture Claude Code : indispensable.
• Tu es en abonnement Max/Pro et tu veux savoir si tu le rentabilises : le « coût équivalent » te le dit.
• Tu veux comprendre où part ton budget (quel modèle, quelle session coûte cher) : le breakdown est parfait pour ça.

Notre verdict : Installer

ccusage, c’est le compteur qui manquait à Claude Code. Gratuit, open source, local, et lançable en une commande : il n’y a aucune raison de coder à l’aveugle sur tes coûts. Que tu sois en API (surveiller la facture) ou en abonnement (vérifier la rentabilité), il te donne enfin le chiffre.

La seule chose à garder en tête, c’est que ce chiffre est une estimation basée sur des prix embarqués, et qu’en abonnement il s’agit d’un « coût équivalent », pas d’un débit réel. Vu comme le tableau de bord de ta conso Claude Code, ccusage est un incontournable. (Pour comprendre les prix eux-mêmes — Pro, Max, API — voir notre article dédié au coût de Claude Code.)

Points de vigilance

• Estimation : prix embarqués (LiteLLM), pas ta facture officielle au centime.
• Abonnement : affiche le « coût équivalent API », pas de l’argent réellement dépensé.
• Local : lit tes logs sur ta machine, rien n’est envoyé — bon point confidentialité.
• Multi-agents : marche aussi pour Codex, Copilot CLI et d’autres.