CodeLedger : Le plugin open-source Claude Code suit l'utilisation des jetons et les agents en arrière-plan.

Ce que fait CodeLedger

CodeLedger est un plugin open-source pour Claude Code (serveur MCP) qui suit automatiquement l'utilisation des tokens, les coûts par projet et l'activité des agents en arrière-plan. Il a été créé après l'analyse de 77 sessions Claude Code sur 8 projets avec le plan Max 20x, révélant une consommation significative de tokens par les agents en arrière-plan.

Le problème qu'il résout

La commande intégrée /cost dans Claude Code ne montre que les données de la session en cours. Il n'existe aucun moyen natif de voir :

• L'historique par projet
• La ventilation par agent
• Ce que consomment les agents en arrière-plan
• Quel modèle est utilisé pour quelle tâche

Lorsque vous fermez le terminal, ce contexte disparaît à jamais.

Principales découvertes de l'analyse

• Coût API équivalent de 2 061 $ sur 77 sessions, 8 projets
• Projet le plus coûteux : 955 $ en tokens pour un projet secondaire
• 233 agents en arrière-plan ont consommé 23 % des dépenses en tokens des agents
• 57 % du calcul était Opus, y compris pour des tâches comme la recherche de fichiers que Sonnet gère bien
• Une session a généré plus de 100 agents en arrière-plan, consommant plus de 80 $ en valeur de tokens

Modèles d'agents en arrière-plan découverts

• Les agents acompact-* s'exécutent automatiquement pour compresser le contexte lorsque les conversations deviennent longues, utilisant le modèle de votre session (y compris Opus)
• Les agents aprompt_suggestion-* génèrent des suggestions de prompts et apparaissent fréquemment dans les longues sessions
• Il n'existe aucun moyen natif de distinguer les "agents que j'ai demandés" des "agents système en arrière-plan" sans analyser les préfixes agentId du JSONL

Fonctionnalités de CodeLedger

• Suivi des coûts par projet sur toutes les sessions
• Ventilation par agent montrant quels agents ont consommé le plus de tokens
• Détection de la surcharge séparant vos agents de codage des agents en arrière-plan acompact-* et aprompt_suggestion-*
• Recommandations d'optimisation des modèles
• Requêtes conversationnelles — demandez "qu'ai-je dépensé cette semaine sur le projet X ?"

Comment ça fonctionne

• Se connecte aux événements SessionEnd et analyse les fichiers JSONL locaux
• Un scanner en arrière-plan capture les sessions où les hooks n'étaient pas actifs
• Stocke tout dans une base de données SQLite locale (~/.codeledger/codeledger.db) — zéro cloud, zéro télémétrie
• Expose des outils MCP : usage_summary, project_usage, agent_usage, model_stats, cost_optimize

Installation

npm install -g codeledger

L'outil attend toujours l'approbation du Marketplace Anthropic, mais l'installation via npm fonctionne directement.