ccusage vs token-optimizer : deux tableaux de bord

token-optimizer embarque un tableau de bord plus riche que ccusage. Il rend aussi compte de son propre travail, et c'est exactement pourquoi il vous faut un second chiffre.

Profile photo of Paul Irolla

Par Paul Irolla

Founder · AI & developer tools · Tokenade

Docteur en IA · conçoit des outils d'optimisation de tokens pour agents de code

Voir la page de l'auteur
6 min de lecture
Résumer avec l'IA
Citer cette page
Fait partie du pilier réduire l'usage des tokens dans Claude Code. C'est la seule paire d'ici où les deux outils rapportent des chiffres, et la différence tient à qui ils rendent des comptes.

ccusage ou token-optimizer : de quoi ai-je besoin ?

Des deux, pour une raison qui n'est pas une question de fonctionnalités : l'un des deux mesure son propre effet. Le tableau de bord de token-optimizer est réellement plus riche — coûts par tour, mix de modèles, analyse du cache, répartition par sous-agent, adoption des skills, détection de dérive. ccusage donne des totaux quotidiens et hebdomadaires, une répartition par modèle, les tokens de cache et une vue par bloc de 5 heures, et rien d'autre. Mais token-optimizer modifie aussi vos sessions. Un outil qui optimise et rapporte à la fois est le cas où une seconde lecture indépendante vaut les deux minutes qu'elle coûte. Ce n'est pas une suspicion sur ce projet en particulier ; c'est la façon dont on traite tout instrument attaché à ce qu'il mesure. Je maintiens un benchmark ouvert de sessions longues et je vends un outil concurrent. token-optimizer n'y a pas été mesuré : son tableau de bord est donc à ce jour le seul compte rendu public de son propre effet.

Que fait ccusage exactement ?

Il lit les transcriptions JSONL locales de votre agent et rapporte ce que vous avez dépensé. Environ 15k étoiles, 15 sources d'agents supportées, zéro installation — bunx ccusage ou npx ccusage@latest. Rapports quotidiens, hebdomadaires, mensuels et par session, répartition par modèle, suivi des tokens de cache, sortie JSON composable avec d'autres tableaux de bord. Ses deux propriétés structurelles comptent ici plus que ses fonctionnalités. Il est en lecture seule, donc il ne peut pas influencer ce qu'il rapporte. Et il est indépendant de l'agent sur 15 sources, donc il donne un chiffre unique sur une installation mixte plutôt qu'un chiffre par outil. Ses limites sont annoncées : il ne réduit rien, il n'a aucun contrefactuel, et le schéma JSONL qu'il lit est implicite plutôt que spécifié.

Que fait token-optimizer exactement ?

Quatre couches, plus le tableau de bord :
  • Les cartes de structure AST — un fichier de 180K tokens devient environ 250 tokens de structure, 95–99 % de compression sur la charge qui fait le plus mal.
  • La compaction intelligente à checkpoints progressifs, qui condense l'état de session à mesure qu'il grossit.
  • Un score de qualité à 7 signaux, qui guette la dégradation du contexte en cours de session. Rien d'autre dans la catégorie ne modélise cela.
  • Le tableau de bord HTML, avec coûts par tour, analyse du cache, mix de modèles, répartition par sous-agent et dérive.
Il tourne sur Claude Code, OpenCode, OpenClaw et Codex. Sa licence est PolyForm Noncommercial : gratuit pour un usage personnel ou en petite équipe, licence payante pour l'usage commercial. L'installation est plus lourde hors de Claude Code et il porte une forte dépendance Python locale.

Que voit chaque tableau de bord ?

token-optimizer voit à l'intérieur de la session ; ccusage voit à travers votre outillage. Le score de qualité est l'exemple le plus net du premier. Tous les autres outils de la catégorie optimisent le coût et vous laissent découvrir vous-même le coût en qualité, en général après une mauvaise réponse. Un signal de dégradation à côté d'un signal de coût est une vraie contribution, et aucun compteur indépendant ne peut le produire, puisqu'il faut être dans la boucle. L'avantage de ccusage est l'inverse. Il couvre 15 sources d'agents : si vous utilisez Claude Code sur un projet et Codex sur un autre, il donne un total unique. Il donne aussi ce qu'aucun tableau de bord d'éditeur ne donnera : votre propre variance de référence, issue de semaines où vous n'avez rien changé. Savoir que votre dépense oscille de 20 % toute seule vous dit à partir de quelle taille un effet compte comme résultat — et c'est ce chiffre qui rend toute autre comparaison signifiante.

Faut-il encore ccusage si l'on a le tableau de bord ?

Oui, pour trois raisons précises, et aucune n'est la méfiance.
  • Le périmètre. token-optimizer rapporte sur les plateformes où il tourne. Si votre travail déborde sur des agents qu'il ne supporte pas, son tableau est une vue partielle de votre facture.
  • La base de référence. Il vous faut des données de dépense d'avant l'installation, et de semaines où rien n'a changé. Seul un compteur indépendant déjà en place vous les donne.
  • L'indépendance à la licence. Si vous cessez un jour d'utiliser token-optimizer — pour raison de licence ou autre — vous perdez le reporting avec lui. ccusage continue.
Installez ccusage d'abord, collectez quelques semaines, puis installez token-optimizer. Cet ordre ne coûte rien et c'est la différence entre une mesure et une impression.

Que ne peuvent-ils dire ni l'un ni l'autre ?

Si une économie sur un canal a atteint votre facture. Les deux rapportent ; aucun ne fait tourner le contrefactuel. « Combien cette semaine aurait-elle coûté sans les cartes de structure » n'est une question à laquelle aucun des deux ne répond, et le seul moyen honnête d'y accéder est de changer une chose à la fois et de comparer des semaines à votre variance connue.

Lequel choisir ?

Installez ccusage dans tous les cas. Gratuit, sans installation, en lecture seule, indépendant de l'agent. Il n'existe aucun scénario où le chiffre indépendant vous dessert. Installez token-optimizer si vous êtes un individu ou une petite équipe sous Claude Code et que les gros fichiers dominent vos lectures — et après avoir réglé la question de licence, la seule décision irréversible de cette page. Ne prenez pas le tableau de bord pour un substitut du compteur. Périmètres différents, indépendance différente, deux minutes pour avoir les deux.

Comment appliquer ça aujourd'hui

  1. Lancez npx ccusage@latest avant d'installer quoi que ce soit d'autre. Quatre semaines normales donnent une base de variance qu'aucun outil ne peut fournir rétroactivement.
  2. Réglez la question de licence s'il s'agit de travail commercial.
  3. Puis installez token-optimizer sans rien changer d'autre cette semaine-là.
  4. Lisez le score de qualité à côté du coût. C'est le chiffre que le compteur indépendant ne peut pas donner, et celui qui a le plus de chances de vous faire changer d'avis.

Ce qui tourne mal (anti-patterns)

Déployer en entreprise un outil sous licence non commerciale. Rien à voir avec les tokens, et l'erreur la plus coûteuse disponible ici. Installer l'optimiseur avant le compteur. Vous n'avez alors aucun « avant », et aucun moyen d'en reconstruire un. Lire un tableau de bord d'éditeur comme un résultat indépendant. C'est un compte rendu de bonne foi, depuis l'intérieur de la boucle. Prendre ccusage pour un optimiseur. Il n'économise rien. Toute sa valeur est dans ce que vous faites du chiffre.
À lire aussi :

Classé n°1 au Token-Harness Optimizer Leaderboard.

Tokenade est classé n°1 au Token-Harness Optimizer Leaderboard — un benchmark de bout en bout des optimiseurs de tokens, mesuré sur de vraies sessions de code. Installez-le une fois, il agit sur chaque prompt. Compatible avec Claude Code, Cursor, Codex, Copilot et plus.