Qu’est-ce que TokenEconomizer ?
TokenEconomizer est un plugin qui rend les agents de code moins chers dans les dépôts où vous revenez, sans modifier l’agent ni le modèle. Après chaque session terminée, il met à jour trois choses : des micro-skills (des faits sur le dépôt que les sessions redécouvrent sans cesse, par exemple lancer python -m pytest parce que pytest manque), une liste d’outils que le dépôt n’utilise jamais, qu’il retire via les réglages de l’agent lui-même, et un loop guard qui demande à un modèle juge si un tour qui échoue à répétition est bloqué et, si c’est le cas, envoie une seule redirection.
Il prend en charge Claude Code, Codex, GitHub Copilot CLI et Pi, avec une prise en charge expérimentale de Cursor, opencode et Hermes. L’élagage des outils et le loop guard sont activés par défaut ; les micro-skills sont désactivées. Le plugin n’a pas besoin de sa propre clé d’API : ses appels de modèle passent par la CLI de votre agent avec votre abonnement existant, et ce qu’il apprend est conservé dans ~/.tokeneconomizer.
Il accompagne l’article TokenEconomizer: Experience-Driven Black-Box Cost Control for Coding Agents (arXiv 2610.22732), signé par des chercheurs de Microsoft Research, Microsoft Security et UC Berkeley. Il est écrit en Python avec la seule bibliothèque standard, demande Python 3.10 ou plus récent et est sous licence Apache-2.0. La version 0.1.0 est sortie le 26 octobre 2026.
TokenEconomizer vaut-il le coup ?
TokenEconomizer est un module de réduction des coûts pour agents de code appuyé sur une étude contrôlée, et cette étude soutient une affirmation modeste et crédible : dans un dépôt où vous revenez sans cesse, l’agent peut cesser de payer pour les mêmes erreurs et pour des outils qu’il n’appelle jamais. L’article a exécuté dans l’ordre 277 tâches SWE-Bench issues de 6 dépôts, avec trois graines chacune, sur cinq combinaisons d’agent et de modèle. Il fait état d’un coût moyen, cache compris, inférieur de 18,4 à 30,9 % à celui de l’agent non modifié, plus bas dans les 30 cellules dépôt et combinaison (de 5,2 à 40,1 %), les appels de modèle du plugin étant imputés à la tâche qui les a déclenchés. Dans le même montage, RTK seul a fait monter le coût dans 12 de ces cellules et RepoMap d’Aider dans 15.
Les réserves figurent dans l’article lui-même. Le Pass@1 a progressé dans 4 combinaisons sur 5 et a reculé de 1,0 point sur Claude Code avec Opus 4.8 ; l’article donne des écarts types sur trois graines mais aucun test de significativité, et la plupart des écarts sont d’un ou deux points. Ses hyperparamètres ont été fixés lors d’exécutions de développement sur les six mêmes dépôts, les séries de tâches sont des corrections indépendantes et non de vraies sessions d’utilisateurs, et les auteurs indiquent que l’usage interactif n’a pas été testé. Les économies prennent aussi du temps : chaque dépôt sauf xarray a d’abord coûté plus cher, et tous étaient moins chers à partir de la sixième tâche.
Les réglages livrés ne sont pas la configuration derrière le chiffre phare. Les 18,4 à 30,9 % reposent sur les trois mécanismes, mais le plugin désactive les micro-skills par défaut. Sur Claude Code, l’ablation de l’article attribue à l’élagage des outils seul 13,2 % (Sonnet 5) et 17,7 % (Opus 4.8), aux micro-skills seules 11,8 et 14,3 %, et au loop guard seul 7,1 et 5,4 %. Le seul test indépendant que nous avons trouvé, publié par yoDEV sur DEV Community avant l’étiquette v0.1.0, va dans ce sens : sur 8 corrections de bugs dans un petit dépôt Python, exécutées deux fois de chaque côté, l’élagage a retiré 284 outils et réduit le contexte par requête de 31 %, le coût par session a baissé de 15 % ($0.72 à $0.61) sur seulement 4 sessions, les micro-skills ne se sont jamais activées et le loop guard n’est jamais intervenu.
Le traitement des données est plus propre que chez la plupart. Pas de clé d’API supplémentaire ; les appels du juge, de la redirection et du proposeur de faits passent par la CLI de votre propre agent (claude -p, codex exec, copilot -p), avec Haiku par défaut sur Claude Code, et la documentation indique qu’aucun appel ne reçoit le contenu des fichiers ni vos prompts. Le juge voit les 24 dernières actions, commandes tronquées à 90 caractères, soit au plus environ 1 500 tokens. L’état appris reste dans ~/.tokeneconomizer et la documentation ne mentionne aucune télémétrie. L’élagage écrit en revanche des listes d’interdiction dans des fichiers du projet comme .claude/settings.local.json, masqués à git via .git/info/exclude.
C’est une version de recherche précoce. Le dépôt a été créé le 13 octobre 2026 et compte environ 4 800 étoiles et 16 issues et pull requests ouvertes, dont une fuite de mémoire sous Windows dans le lanceur de hooks (#144) et une situation de concurrence dans le loop guard quand des outils tournent en parallèle (#142). Il est testé sur des plages de versions étroites des agents, comme Claude Code 2.1.300 à 2.1.310, et les versions plus récentes ne sont pas testées. Là où RTK compresse la sortie des commandes, TokenEconomizer change ce que l’agent charge et répète, si bien que les deux se cumulent : le meilleur résultat de l’article avec Opus 4.8, un coût inférieur de 33,2 %, les combinait.
Là où il fait la différence
Une développeuse backend avec un abonnement API qui utilise Claude Code chaque jour dans un monorepo Django
Ne plus payer pour des outils MCP et des connecteurs que le dépôt n’utilise jamais
Installez le plugin et gardez les réglages par défaut ; après plusieurs sessions, l’élagage écrit une liste d’interdiction dans .claude/settings.local.json, après environ une heure d’inactivité pour ne pas casser un cache de prompts encore chaud. Dans le petit test de yoDEV, cela a retiré 284 outils et réduit le contexte par requête de 31 % ; toolprune restore les rétablit.
Un responsable d’ingénierie qui surveille les dépenses d’agents d’une équipe de dix personnes sur Codex
Vérifier si le coût des agents baisse vraiment dans les principaux dépôts de l’équipe
Chaque développeur l’installe ; status et le ledger.jsonl de chaque dépôt indiquent le coût des sessions, appels du plugin compris. Attendez-vous à ce que les premières sessions coûtent plus cher et jugez le résultat après une semaine de travail normal, pas d’après les 18,4 à 30,9 % de l’article.
Un développeur dont l’agent relance sans cesse la même commande de test en échec
Casser les longues boucles d’échec sans arrêter l’agent à la main
Après 5 tours réussis dans le dépôt, le loop guard envoie un tour qui semble bloqué à un juge sur votre abonnement (Haiku par défaut sur Claude Code) et redirige une fois si le juge est sûr à au moins 0,7. Il n’arrête jamais un tour lui-même ; en mode headless, un tour signalé continue jusqu’aux limites propres de l’agent.
Avant de vous engager
- Mise en route
- Demande Python 3.10 ou plus récent. Clonez le dépôt et laissez le clone en place, ajoutez-le comme marketplace de plugins puis installez tokeneconomizer@tokeneconomizer (commandes plugin de claude, codex ou copilot) ; Pi l’installe directement depuis git. Sur Claude Code et Copilot CLI, lancez toolprune refresh-catalog une fois par machine et après chaque mise à jour de l’agent.
- Intégrations
- Testé avec Claude Code 2.1.300 à 2.1.310, Codex 0.153.1 à 0.164.0, Copilot CLI 1.0.83 à 1.0.102 et Pi 1.2.0 à 1.3.0 ; Cursor, opencode et Hermes sont expérimentaux. L’élagage retire des outils isolés sur Claude Code, des paquets de capacités sur Codex et des serveurs MCP entiers sur Copilot CLI, et rien sur les autres.
- Données et confidentialité
- Faits, indices d’usage des outils, historique des boucles, un registre des coûts et un journal d’erreurs restent dans ~/.tokeneconomizer ; supprimer ce dossier efface ce qu’il a appris. Les appels de modèle passent par la CLI de votre agent et, selon la documentation, n’incluent jamais le contenu des fichiers ni vos prompts. Aucune télémétrie documentée. Apache-2.0.
- Coût à grande échelle
- Le plugin est gratuit ; les appels du juge et du proposeur sont facturés sur votre abonnement, et avec les réglages par défaut il n’appelle un modèle que lorsqu’un tour semble bloqué. Aucune édition hébergée ou payante n’est publiée.
- Limites
- Les économies demandent des sessions répétées dans un même dépôt et commencent dans le négatif. Avec Copilot BYOK, les appels de modèle du plugin sont suspendus. Lancer une commande du plugin dans l’agent coûte un tour de modèle. 16 issues et pull requests ouvertes, dont une fuite de mémoire sous Windows et une situation de concurrence avec outils en parallèle dans le loop guard.
Les points forts
- Économies mesurées dans un article avec trois graines, appels propres inclus
- Pas de clé d’API supplémentaire ; les appels passent par la CLI de votre agent
- L’état appris reste en local dans ~/.tokeneconomizer
- Chaque action est réversible, et un plugin en échec laisse la session continuer
Les points faibles
- Les micro-skills, part du résultat phare, sont désactivées par défaut
- Coûte plus cher sur les premières tâches d’un nouveau dépôt
- Hyperparamètres réglés sur les dépôts mêmes où il a été testé
- v0.1.0 avec des bugs Windows et de concurrence ouverts et peu de versions d’agents testées
Idéal pour
Développeurs et équipes qui paient au token Claude Code, Codex ou Copilot CLI et font tourner l’agent jour après jour dans les mêmes quelques dépôts.
Alternatives à TokenEconomizer
TokenEconomizer : questions fréquentes
- TokenEconomizer vaut-il le coup ?
- Un réducteur de coûts appuyé sur une vraie étude, qui vaut la peine dans les dépôts où vous travaillez chaque jour, à condition d’attendre des réglages par défaut moins que le chiffre phare de l’article. Nous lui donnons 3.8 sur 5.
- Combien coûte TokenEconomizer ?
- Gratuit sous licence Apache-2.0 ; ses propres appels de modèle sont facturés sur votre abonnement ou votre clé d’agent existants.
- Quels sont les inconvénients de TokenEconomizer ?
- Les micro-skills, part du résultat phare, sont désactivées par défaut; coûte plus cher sur les premières tâches d’un nouveau dépôt; hyperparamètres réglés sur les dépôts mêmes où il a été testé; v0.1.0 avec des bugs Windows et de concurrence ouverts et peu de versions d’agents testées.
- À qui s’adresse TokenEconomizer ?
- Développeurs et équipes qui paient au token Claude Code, Codex ou Copilot CLI et font tourner l’agent jour après jour dans les mêmes quelques dépôts.
- Combien coûte TokenEconomizer pour une équipe ou en production ?
- Le plugin est gratuit ; les appels du juge et du proposeur sont facturés sur votre abonnement, et avec les réglages par défaut il n’appelle un modèle que lorsqu’un tour semble bloqué. Aucune édition hébergée ou payante n’est publiée.
- TokenEconomizer est-il sûr pour les données de l’entreprise ?
- Faits, indices d’usage des outils, historique des boucles, un registre des coûts et un journal d’erreurs restent dans ~/.tokeneconomizer ; supprimer ce dossier efface ce qu’il a appris. Les appels de modèle passent par la CLI de votre agent et, selon la documentation, n’incluent jamais le contenu des fichiers ni vos prompts. Aucune télémétrie documentée. Apache-2.0.
- Quelles sont les meilleures alternatives à TokenEconomizer ?
- Les alternatives les plus proches que nous avons testées sont rtk (Rust Token Killer), context-mode et ccusage.
Réponses vérifiées le 5 nov. 2026.