Fait partie du pilier réduire l'usage des tokens dans Claude Code. Cette paire parle d'un mode de défaillance qui ressemble exactement à un outil qui ne marche pas.
À lire aussi :
ccusage ou graphify : de quoi ai-je besoin ?
ccusage d'abord, parce que le principal risque de graphify n'est pas d'échouer — c'est de ne jamais tourner. graphify s'invoque par une commande/graphify. Contrairement à un serveur MCP, dont les outils sont dans la boîte de l'agent dès le premier message, une commande slash n'est consultée que si quelque chose dans la session y conduit.
Un index que personne n'interroge coûte la passe d'indexation et n'économise rien. De l'extérieur, c'est indiscernable d'un outil qui ne fonctionne pas, et le seul moyen de distinguer les deux est de regarder les chiffres.
Je maintiens un benchmark ouvert de sessions longues et je vends un outil concurrent. graphify n'y affiche aucune économie de coût de session mesurable, et cette question de consultation y est pour quelque chose.
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.
Pour les abonnés Claude Pro et Max, le point fort est la vue par bloc de facturation de 5 heures, calée sur la fenêtre glissante d'Anthropic.
Il est en lecture seule et ne réduit rien, et n'a aucun contrefactuel — dépense observée seulement. Le schéma JSONL qu'il lit est implicite plutôt que spécifié.
Que fait graphify exactement ?
Il cartographie tout le projet dans un graphe de connaissances interrogeable. Python, licence MIT, installable depuis PyPI, invoqué par/graphify sur Claude Code, Codex, opencode, Cursor, Copilot, Aider, OpenClaw et d'autres.
Son différenciateur, c'est ce qu'il ingère : documentation, PDF, images et vidéo à côté des sources. Rien d'autre dans la catégorie ne couvre les actifs non-code, et dans les projets où des documents de conception ou des passations enregistrées détiennent les réponses, c'est un vrai manque comblé.
Il produit un artefact persistant — graph.json, plus une vue HTML et un rapport Markdown — donc le graphe est interrogeable plus tard sans relire le dépôt, et un humain peut auditer le HTML au lieu de lui faire confiance à l'aveugle.
Ses coûts : l'indexation est une étape explicite à relancer à mesure que le projet bouge, un graphe périmé induit en erreur en silence plutôt que d'échouer bruyamment, il exige un runtime Python, et il ne touche pas aux sorties de commandes.
Comment savoir si le graphe fonctionne ?
Trois signaux, du plus facile au plus difficile à lire :- Les appels d'outils par session. Un index consulté réduit les lectures de navigation. Si votre nombre d'appels d'outils est inchangé après l'installation de graphify, le graphe n'est pas dans la boucle, aussi bon soit-il.
- La dépense totale, sur des semaines et non des tâches. ccusage vous la donne, ainsi que votre variance d'une semaine à l'autre, en général plus grande qu'on ne l'imagine. Une différence de 15 % face à un écart naturel de 20 % n'est pas un résultat.
- L'artefact lui-même. graphify écrit
graph.jsonet une vue HTML. Ouvrez-la. S'il est périmé, ou s'il lui manque les documents que vous supposiez couverts, vous avez trouvé le problème sans aucune donnée d'usage.
Ce que ça coûte quand il n'est pas consulté
La passe d'indexation, et rien d'autre — c'est la bonne nouvelle. graphify est opt-in : contrairement à un serveur MCP toujours connecté, il ne vous facture pas un manifeste à chaque tour. Un graphe non consulté est un effort gaspillé plutôt qu'une facture continue. C'est un mode de défaillance nettement meilleur que l'alternative, et il vaut la peine de le savoir avant de conclure que l'outil était une erreur. Le correctif tient en général en une ligne. Mettez l'invocation dans les instructions de votre projet pour que l'agent aille au graphe quand une question porte sur la structure du projet. Sans cela, vous avez installé l'outil sans l'adopter.Que le compteur ne peut-il pas dire ?
Le pourquoi. ccusage rapporte qu'une session a coûté plus ou moins que d'habitude. Il ne dira pas que l'agent a ignoré le graphe, que le graphe avait trois semaines de retard, ni que onze des vingt appels d'outils ont relu les quatre mêmes fichiers. Il ne peut pas non plus isoler une variable que vous n'avez pas isolée. Deux changements la même semaine produisent un résultat ininterprétable — et une réindexation compte comme un changement.Lequel choisir ?
Installez ccusage dans tous les cas. Gratuit, sans installation, en lecture seule, et ici c'est ce qui sépare « graphify n'a pas aidé » de « graphify n'a jamais tourné ». Installez graphify si la connaissance de votre projet n'est pas toute dans les sources — documents d'architecture, spécifications, PDF de prestataires, passations enregistrées. Puis écrivez l'invocation dans vos instructions d'agent plutôt que d'espérer. Sautez graphify si votre dépôt est du code pur avec un README maigre. Son différenciateur ne s'applique pas à vous, et un index limité aux sources sera plus simple à garder frais.Comment appliquer ça aujourd'hui
- Lancez
npx ccusage@latestet notez quatre semaines normales. C'est votre base de variance, et c'est ce qui manque à la plupart des comparaisons. - Ouvrez
graph.jsonou la vue HTML après votre première passe d'indexation. Vérifiez qu'il contient ce que vous supposiez. - Écrivez
/graphifydans les instructions de votre projet, rattaché au type de question qu'il doit traiter. - Jugez-le d'abord sur les appels d'outils, ensuite sur le coût.
Ce qui tourne mal (anti-patterns)
Installer un outil opt-in et ne jamais l'invoquer. La défaillance la plus courante ici, et elle ressemble en tout point à un outil inutile. Réindexer et changer autre chose la même semaine. Un résultat ininterprétable. Faire confiance à un graphe périmé. Une réponse fausse mais assurée coûte plus cher que pas de réponse, et graphify ne vous prévient pas comme le fait un index à watcher. Prendre ccusage pour un optimiseur. Il n'économise rien. Toute sa valeur est dans ce que vous faites du chiffre.À lire aussi :
- Réduire l'usage des tokens dans Claude Code — le pilier, indépendant de l'outil
- codegraph vs graphify — graphify face à un index MCP toujours actif
- rtk vs graphify — graphify face à un filtre de sorties shell
- Heures de reset des limites Claude — le bloc de cinq heures que rapporte ccusage
- Benchmark des optimiseurs de tokens — la mesure ouverte derrière le résultat de graphify
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.
