ccusage — le compteur de tokens de tes CLI d’IA

ccusage est un outil en ligne de commande open-source (licence MIT, plus de 17 000 étoiles sur GitHub) qui calcule ta consommation de tokens et le coût estimé de tes assistants de code en IA. Il ne se branche sur aucune API et ne crée aucun compte : il lit simplement les journaux d'usage que ces outils écrivent déjà en local sur ta machine, puis en tire des rapports par jour, par semaine, par mois ou par session. Il détecte automatiquement les sources présentes — Claude Code, Codex, OpenCode, Gemini CLI, GitHub Copilot CLI et d'autres — et affiche le tout dans des tableaux lisibles au terminal. Tu peux aussi sortir les données en JSON pour les exploiter ailleurs, et travailler en mode hors ligne grâce à des tarifs pré-enregistrés. Concrètement, ccusage répond à une question que la plupart des indépendants se posent trop tard : combien me coûte réellement mon usage de l'IA, et sur quel projet.

Quel problème ccusage résout-il ?

Quand tu utilises plusieurs assistants de code, ta dépense est éclatée entre plusieurs factures et plusieurs tableaux de bord — quand tableau de bord il y a. Tu ne sais ni quel projet consomme, ni quel jour a dérapé, ni quelle part vient du cache. ccusage rassemble tout ça au même endroit, à partir de données que tu possèdes déjà, sans rien envoyer sur un serveur.

Comment l'installer et le lancer ?

Il n'y a rien à installer : ccusage se lance directement avec npx. Au premier lancement, il détecte les CLI présentes sur ta machine et affiche le rapport global.

npx ccusage

Pour d'autres vues, tu peux demander un rapport quotidien, mensuel ou par session, ou encore une sortie JSON à traiter dans un script.

npx ccusage --help

Que peut-on en tirer concrètement ?

Trois usages reviennent souvent. Un : repérer les journées ou les sessions anormalement coûteuses, pour comprendre quel type de tâche fait exploser le budget. Deux : mesurer la part de tokens de cache, souvent bien plus élevée qu'on ne l'imagine. Trois : refacturer proprement à un client le coût IA réellement engagé sur sa mission, chiffres à l'appui.

FAQ

ccusage est-il gratuit ?

Oui. Le projet est open-source sous licence MIT et se lance sans installation via npx. Les coûts affichés sont ceux de tes propres abonnements ou API — ccusage ne fait que les calculer.

Mes données partent-elles sur un serveur ?

Non. ccusage lit les journaux d'usage stockés en local par tes outils et ne les téléverse pas. Un mode hors ligne permet même de calculer les coûts sans connexion, à partir de tarifs pré-enregistrés.

Quels assistants de code sont pris en charge ?

Le projet couvre un large éventail de CLI, dont Claude Code, Codex, OpenCode, Gemini CLI et GitHub Copilot CLI. La liste évolue régulièrement : le site officiel de la documentation la tient à jour.

Les coûts affichés sont-ils exacts ?

Ce sont des estimations calculées à partir du nombre de tokens et des tarifs des modèles. Elles sont très utiles pour comparer des périodes ou des projets, mais elles ne remplacent pas la facture officielle de ton fournisseur.