Voyez ce que Claude Code vous coûte vraiment avec ccusage — puis décidez comment payer

« Ça a l'air cher » n'est pas une donnée ; les journaux locaux, si

Chaque session Claude Code est consignée dans des fichiers JSONL sous ~/.claude : quelles requêtes, quels modèles, combien de tokens en entrée et en sortie, combien de cache touché. Le journal commence le jour de l'installation — sauf accident, vos dernières semaines d'usage y sont en entier.

ccusage fait quelque chose de désarmant de simple : il lit ce journal, multiplie par une grille de prix et dispose le résultat par jour, semaine et session. Il n'uploade rien, ne demande aucune clé d'API, ne change aucune configuration — il n'en a pas besoin : le registre et l'arithmétique restent sur votre machine.

Une commande pour commencer, trois vues à connaître

Rien à installer — npx ccusage daily tourne tel quel. Trois vues à connaître au quotidien, chacune répond à une question :

• daily : ce qu'a coûté chaque jour — répond à « quel jour a brûlé » ;
• blocks : découpé en blocs de facturation de 5 heures — la vue alignée sur les fenêtres de limite de l'abonnement ; montre où tombe votre gros travail ;
• monthly : le mois récapitulé — à regarder avant de demander « faut-il changer de façon de payer ».

Il chiffre au tarif public — l'étape que tout le monde saute

ccusage multiplie par la grille officielle des tarifs publics. D'où une distinction cruciale : si vous êtes abonné, le nombre n'est pas ce que vous avez payé (vous payez un forfait mensuel) — c'est « ce que cet usage aurait coûté au tarif API public », une règle pour mesurer l'usage, pas une facture. Si vous êtes utilisateur API, c'est une approximation de votre facture — une approximation, car la tarification des lectures/écritures de cache peut différer du relevé exact de votre fournisseur ; le relevé par requête reste la source de vérité.

La distinction n'est pas de la pédanterie ; c'est l'entrée de l'étape suivante : lisez la sortie de ccusage comme une forme d'usage, pas comme une facture, et les nombres commencent à décider pour vous.

Une semaine d'exécution, et vous obtenez plus qu'un total

Un total dit si c'est cher ; une forme dit pourquoi, et si un autre modèle de facturation serait moins cher. Lancez une semaine et relevez quatre paramètres : les heures concentrées par jour (l'étendue de vos blocs), l'intensité des tâches (modèle phare ou équilibré en tête), le taux de hit cache (même contexte, hit contre froid, un ordre de grandeur d'écart) et le profil de pointe (régulier chaque jour, ou deux jours d'explosion). Ces quatre nombres servent bien plus que le total mensuel, parce que les différences de tous les modèles de facturation se déploient le long de ces quatre axes.

De la forme à la décision : l'allure de l'arithmétique

Avec une forme en main, abonnement contre à l'usage cesse d'être un argument de camp pour devenir une multiplication affectable : heures par jour × intensité dans un calculateur de coûts, le mensuel à l'usage en sort, posez-le à côté du prix de l'abonnement. En dessous, l'usage économise ; au-dessus, vous payez le prix de l'usage pour un flux non plafonné — ce qui peut se défendre, mais c'est désormais un choix éclairé.

La partie intéressée, dite franchement : notre calculateur et notre relevé par requête font exactement cela — tarifs lus en direct depuis l'endpoint de prix public, coût de chaque requête consultable et exportable après coup. Mais vous n'avez pas besoin de nous : tout fournisseur offrant une grille lisible par machine et un relevé par requête fait la même arithmétique ; celui qui refuse les deux, aussi basse que paraisse sa grille, devrait voir « invérifiable » compté comme un coût.