Claude Code : le plugin qui économise 90 % des tokens en lecture (et comment l'installer)
Depuis la fin du bonus de 50 % sur les limites hebdomadaires de Claude Code le 13 septembre, les quotas sont plus serrés. Un plugin développé par Dimitri Mazmanov, principal product manager chez Spotify, promet de réduire de 90 % la consommation de tokens en lecture, selon ses propres benchmarks. Voici ce que fait ce plugin, comment il fonctionne, et ce qu'il faut savoir avant de l'adopter.
Pourquoi les lectures de fichiers pèsent si lourd
Selon la source, les agents de code passent plus de temps à lire et éditer des fichiers qu'à raisonner. Chaque fois que Claude Code ouvre un fichier volumineux, l'intégralité du contenu entre dans la fenêtre de contexte et consomme des tokens d'entrée. Sur un projet réel, ces lectures répétées peuvent représenter une part importante de la facture et des quotas.
L'idée du plugin est simple : ne pas laisser Claude lire les gros fichiers lui-même, mais déléguer cette lecture à un modèle moins cher, puis ne renvoyer à Claude que le résultat utile.
Deux agents, deux rôles
Le plugin repose sur deux agents : bulk-reader pour la lecture et code-writer pour l'écriture. Le reader est confié à gemini-2.5-flash avec une température déterministe de 0,2. Selon la source, le million de tokens en entrée coûte 0,30 dollar chez gemini-2.5-flash contre 5 dollars chez Claude Opus 5, soit un écart de prix considérable qui explique l'essentiel de l'économie.
Comment les hooks bloquent les lectures
Le mécanisme repose sur deux hooks :
- check-file-size bloque la lecture au-delà d'un seuil configurable, fixé à 350 lignes par défaut.
- check-bash-read applique le même blocage aux commandes bash comme cat, head ou tail.
Les lectures ciblées restent autorisées : Claude peut toujours lire seulement une partie d'un fichier. C'est un point important, car cela évite de casser les workflows qui ont besoin d'un extrait précis.
Les résultats annoncés, et leurs limites
La réduction de 90 % en lecture a été mesurée sur un repo Java avec quatre scénarios différents. Il s'agit d'un benchmark réalisé par l'auteur du plugin, pas d'un test indépendant. Spotify ne communique aucun chiffre de réduction pour l'écriture.
Plusieurs limites sont documentées :
- Le reader ne peut pas retrouver de numéro de ligne précis lors de son analyse.
- Le modèle délégué reste moins performant que Claude, et les tâches critiques ne sont pas déléguées.
- Chaque délégation peut augmenter la latence de 10 à 30 secondes selon Spotify, sans protocole de mesure détaillé.
- Le plugin dépend de Spotify Portal pour l'accès aux agents, une dépendance lourde.
Le fork Siphon : supprimer la dépendance à Portal
Un fork du JDN, nommé Siphon, remplace les appels à Portal par un appel direct à l'API Gemini. Cela simplifie l'installation, mais ajoute une dépendance : les fichiers délégués sont envoyés vers l'API de Google. Les tests du fork Siphon sont rapportés par l'auteur de l'article, pas par un tiers.
Autre point de vigilance : sur Codex, aucun hook ne se déclenche. La délégation repose alors sur le bon vouloir de l'agent, ce qui rend le comportement moins prévisible.
Faut-il l'adopter ?
Le plugin est surtout pertinent si vous travaillez sur de gros fichiers et que vos quotas Claude Code sont un frein. Il ne remplace pas Claude pour les tâches critiques et introduit de la latence. À l'inverse, si vos lectures sont déjà ciblées ou si vos fichiers restent petits, le gain sera marginal.
Points clés à retenir
- Économie annoncée : 90 % de tokens en lecture, selon le benchmark de l'auteur.
- Seuil par défaut : 350 lignes.
- Coût d'entrée : 0,30 $/M tokens chez gemini-2.5-flash contre 5 $/M chez Claude Opus 5, selon la source.
- Latence ajoutée : 10 à 30 secondes par délégation, selon Spotify.
- Dépendance : Spotify Portal, ou l'API Gemini via le fork Siphon.
En résumé, c'est une piste crédible pour réduire la facture de lecture, à condition d'accepter les compromis sur la précision, la latence et la dépendance à un service externe. Les chiffres avancés demandent une validation sur votre propre codebase avant d'en tirer des conclusions définitives.
Source
Claude Code : ce plugin permet d'économiser 90% des tokens en lecture
