Qu’est-ce que ccusage ?
ccusage lit les journaux d'usage que Claude Code et d'autres CLI d'agents gardent sur votre machine et rapporte les tokens et le coût estimé par jour, semaine, mois ou session. Pour Claude Code, il montre aussi les blocs de facturation de 5 heures avec une vue en direct et offre une statusline compacte (en beta) pour la barre d'état de Claude Code.
Il tourne avec `npx ccusage@latest` (ou bunx, pnpm dlx, Nix) et n'a besoin ni de compte ni de clé d'API. Le README liste 18 sources, dont Claude Code, Codex, OpenCode, Amp, Goose, Kilo, Gemini CLI et GitHub Copilot CLI. Les prix viennent de LiteLLM, models.dev et de barèmes historiques intégrés, mis en cache localement, avec un mode `--offline`.
ccusage vaut-il le coup ?
ccusage est devenu le compteur local par défaut pour l'usage des agents de code. Il a environ 19 100 étoiles GitHub, npm a compté environ 871 000 téléchargements sur les 30 jours jusqu'au 18 octobre 2026, et il sort presque chaque jour : v20.0.34 le 15 octobre à v20.0.41 le 22 octobre. Démarré par ryoppippi, il est désormais sous une organisation ccusage, et la base de code est en Rust, encore distribuée via npm.
La colonne de coût doit être lue avec soin. Dans le mode auto par défaut, il utilise le costUSD que Claude Code stocke là où il est présent et sinon multiplie les tokens par les prix publiés par token. La documentation dit clairement que les coûts « peuvent ne pas refléter la facturation réelle » et que les appels d'outils comme la recherche web ne sont pas inclus. Sur un abonnement Pro ou Max, le chiffre n'est pas votre facture ; c'est ce que le même travail aurait coûté aux tarifs de paiement à l'usage.
La limite moins évidente est l'historique. Claude Code garde les transcriptions locales pendant 30 jours par défaut (le réglage cleanupPeriodDays), et ccusage ne peut compter que ce qui est encore sur disque. Quiconque veut une tendance sur un trimestre doit d'abord relever ce réglage, ou exporter des instantanés `--json` selon un calendrier.
Les données d'usage ne quittent jamais la machine, selon la documentation, mais par défaut ccusage rafraîchit bien son cache de prix par le réseau ; `--offline` l'arrête. Les rapports séparent les tokens d'entrée, de sortie, de création de cache et de lecture de cache par modèle, ce qui est la ventilation dont vous avez besoin pour dire si un changement de cache de prompt ou un plugin d'économie de tokens a vraiment aidé.
Sa portée est une seule machine. Il n'y a pas de vue serveur ou d'équipe documentée, si bien qu'un manager qui compare dix développeurs collecte et additionne dix fichiers JSON à la main, et chacun d'eux n'est aussi complet que la rétention de logs de ce portable.
Là où il fait la différence
Un développeur qui teste un plugin d'économie de tokens comme RTK
Prouver s'il réduit vraiment l'usage
Lancez `ccusage daily --json` pendant une semaine avant et une semaine après l'avoir install é et comparez les tokens d'entrée et de lecture de cache par modèle. Prend quelques minutes et ne coûte rien ; la comparaison n'est aussi juste que les charges de travail des deux semaines.
Un responsable d'ingénierie qui paie des sièges Claude Max
Décider si passer l'équipe à la facturation API serait moins cher
Chaque développeur lance `ccusage monthly --json` et partage le fichier ; les totaux montrent ce que le même usage coûterait aux tarifs API. Comme il n'y a pas de vue partagée, collecter et additionner les fichiers est manuel.
Un développeur indépendant qui facture plusieurs clients
Attribuer la dépense d'agent à chaque projet client
`ccusage claude daily --instances --project <nom>` groupe l'usage de Claude Code par projet ; le chiffre équivalent API est un poste défendable si le contrat facture l'outillage au coût.
Avant de vous engager
- Mise en route
- `npx ccusage@latest` imprime un rapport quotidien en quelques secondes ; bunx met le paquet en cache pour que les exécutions répétées soient plus rapides. Ajoutez `ccusage statusline` au hook de ligne d'état de Claude Code pour un chiffre en direct.
- Intégrations
- Lit les journaux locaux de 18 CLI d'agents, dont Claude Code (~/.claude et ~/.config/claude/projects), Codex, OpenCode, Gemini CLI et Copilot CLI ; sort des tableaux ou du JSON ; les surcharges de prix vont dans ccusage.json.
- Données et confidentialité
- L'analyse est locale et les données d'usage ne sont pas téléversées, selon la documentation ; les données de prix sont récupérées et mises en cache sauf si vous passez --offline. Licence MIT, si bien que l'usage commercial est sans restriction.
- Coût à grande échelle
- Gratuit, sans édition payante ; il est financé par le parrainage. Le seul coût est l'habitude de le faire tourner sur chaque machine que vous voulez compter.
- Limites
- Les chiffres en dollars sont des estimations qui excluent la recherche web ; Claude Code supprime les transcriptions après 30 jours sauf si cleanupPeriodDays est relevé ; pas d'agrégation d'équipe. Seulement 4 issues ouvertes à la dernière vérification.
Les points forts
- Rapports entièrement locaux sans compte
- 18 CLI d'agents dans un seul rapport
- Sépare les tokens de création de cache et de lecture de cache par modèle
- Vue par bloc de 5 heures, statusline et sortie --json
Les points faibles
- Les coûts sont des estimations équivalentes à l'API et excluent la recherche web
- Historique limité à ce que l'agent garde sur disque (30 jours pour Claude Code par défaut)
- Pas de mode équipe ou serveur
Idéal pour
Quiconque veut suivre ou comparer l'usage de tokens entre les sessions d'agent.
Alternatives à ccusage
ccusage : questions fréquentes
- ccusage vaut-il le coup ?
- ccusage est le compteur que tout gros utilisateur d'agents devrait faire tourner, à condition de lire sa colonne en dollars comme ce que le travail aurait coûté sur l'API, pas ce qu'il a payé. Nous lui donnons 4.4 sur 5.
- Combien coûte ccusage ?
- Gratuit et open source (MIT).
- Quels sont les inconvénients de ccusage ?
- Les coûts sont des estimations équivalentes à l'API et excluent la recherche web; historique limité à ce que l'agent garde sur disque (30 jours pour Claude Code par défaut); pas de mode équipe ou serveur.
- À qui s’adresse ccusage ?
- Quiconque veut suivre ou comparer l'usage de tokens entre les sessions d'agent.
- Combien coûte ccusage pour une équipe ou en production ?
- Gratuit, sans édition payante ; il est financé par le parrainage. Le seul coût est l'habitude de le faire tourner sur chaque machine que vous voulez compter.
- ccusage est-il sûr pour les données de l’entreprise ?
- L'analyse est locale et les données d'usage ne sont pas téléversées, selon la documentation ; les données de prix sont récupérées et mises en cache sauf si vous passez --offline. Licence MIT, si bien que l'usage commercial est sans restriction.
- Quelles sont les meilleures alternatives à ccusage ?
- Les alternatives les plus proches que nous avons testées sont rtk (Rust Token Killer), Claude Code Router et mindwalk.
Réponses vérifiées le 23 oct. 2026.