Claude Code Mods : suivre le contexte et rejouer les modifications sans confondre signal et preuve

Une longue session Claude Code soulève souvent deux questions différentes : combien de contexte le dernier tour a-t-il ajouté, et quelles opérations de modification de fichiers Claude a-t-il appelées ? Le playground d’Anthropic propose un exemple prêt à l’emploi pour chaque besoin. Token Weather affiche l’occupation du contexte de la session principale ; Replay Theater permet de parcourir les appels de modification du dernier tour concerné.

La limite essentielle est simple : ces deux outils apportent de l’observabilité, pas une recette d’acceptation. Un pourcentage de contexte ne représente ni un solde, ni un coût, ni la fin d’une tâche. Une modification visible dans le replay ne prouve pas qu’elle a été autorisée, exécutée avec succès ou conservée dans le fichier final.

Choisissez le Mod qui répond à votre question immédiate

Question	Mod à charger	Ce qu’il indique	Ce qu’il ne prouve pas
Quelle part de la fenêtre principale est occupée et la croissance s’est-elle accélérée ?	Token Weather	Context tokens, taille de fenêtre, pourcentage et tendance sur 12 tours	Solde d’abonnement, coût, nombre de requêtes restantes ou tâche terminée
Quels appels Edit, Write ou MultiEdit ont eu lieu au dernier tour d’édition ?	Replay Theater	Fichier, outil, extraits locaux avant/après et court diff	Autorisation, succès de l’outil, état final du disque ou tests réussis

Pour diagnostiquer, chargez un seul Mod à la fois. Les deux exemples peuvent dessiner dans AbovePrompt. Leurs README précisent que cette bande est partagée : si un autre Mod l’utilise, un seul affichage peut rester visible.

Vérifiez la version et la confiance avant d’exécuter le code

Les README actuels exigent Claude Code 2.1.287 ou version ultérieure et ciblent le terminal. Commencez par vérifier le client :

claude --version

Ces Mods appartiennent au playground Anthropic DevRel. Le dépôt les présente comme des exemples fournis tels quels, sans support ni garantie qu’ils continueront à fonctionner après des changements de Claude Code, de l’API ou des modèles. Avant de lancer un exemple, lisez au minimum README.md, .claude-plugin/plugin.json, hooks/hooks.json et le module hooks du dossier choisi.

Un Mod s’exécute avec les droits de votre utilisateur ; « il ne fait qu’afficher une interface » n’est pas une frontière de sécurité. Pour un premier essai, préférez --plugin-dir pendant une seule session. La fermeture du processus Claude Code met fin à l’essai et évite de transformer un diagnostic en installation persistante.

Clonez les exemples officiels et validez votre choix

git clone https://github.com/anthropics/claude-code-playground.git
cd claude-code-playground/claude-code/mods

Le téléchargement du dépôt ne garantit pas que la structure du Mod est valide. Validez le dossier exact avant de démarrer une session.

Pour Token Weather :

claude plugin validate ./token-weather
claude --plugin-dir ./token-weather

Pour Replay Theater :

claude plugin validate ./replay-theater
claude --plugin-dir ./replay-theater

Si validate signale une erreur, arrêtez-vous et restaurez le manifest, la configuration des hooks ou le module indiqué. Ne supposez pas que Claude Code ignorera sans risque un paquet mal formé. Dans la nouvelle session, /plugin aide à confirmer ce qui a été chargé. Le véritable signal fonctionnel vient ensuite : Token Weather doit se mettre à jour après la fin d’un tour principal ; Replay Theater nécessite un tour terminé ayant réellement appelé des modifications de fichiers.

Lisez Token Weather comme une télémétrie de contexte, pas comme une facture

Après chaque tour principal, Token Weather appelle $.session.usage() et lit tokens, window et percent dans context. Il dessine une ligne au-dessus du prompt, conserve les 12 dernières mesures et indique l’ajout du dernier tour.

Les champs signifient :

• tokens : le contexte d’entrée sur lequel la dernière réponse a été produite, en combinant les input tokens non mis en cache, écrits en cache et lus depuis le cache ;
• window : la fenêtre de contexte du modèle de la session ;
• percent : le rapport tokens / window.

Une valeur de 0 % avant la première réponse est normale : aucune réponse n’a encore renvoyé d’éléments usage. L’affichage se met à jour une fois après le tour, pas en continu pendant son exécution. Les tours des sous-agents ne créent pas de mesure séparée pour la boucle principale.

Pourquoi le pourcentage peut différer de l’avertissement de compaction

Token Weather utilise la fenêtre de contexte complète comme dénominateur. L’avertissement auto-compact de Claude Code repose sur un seuil de compaction inférieur ; les deux pourcentages peuvent donc diverger. Dans une capture officielle de l’exemple, Token Weather indiquait 81 % et le client 90 %. C’est l’illustration de deux échelles dans les conditions de l’exemple, pas deux valeurs à faire coïncider dans votre session.

Les barres d’historique sont relatives à la mesure la plus élevée affichée. Des écarts visuels importants peuvent donc apparaître malgré un faible pourcentage absolu. Pour une lecture absolue, utilisez le pourcentage et le nombre de tokens. L’historique est réinitialisé au démarrage de la session ou au reload du plugin.

La conclusion correcte à tirer

Vous pouvez conclure : « Le contexte d’entrée de la session principale a fortement augmenté sur les derniers tours. » Vous ne pouvez pas conclure : « Il reste 19 % sur mon compte », « ce tour a coûté telle somme » ou « la tâche est terminée ». Le cache modifie la facturation, mais les entrées en cache occupent toujours le contexte. Consultez le fournisseur pour le solde, le coût et le statut de la requête.

Utilisez Replay Theater pour inspecter les tentatives de modification

Après le chargement, demandez à Claude une tâche qui modifie réellement des fichiers et attendez la fin du tour. Lorsque l’indication apparaît, ouvrez le replay :

/replay

Vous pouvez également sélectionner la bande avec ctrl+x, Tab, puis appuyer sur r. Dans le panneau :

Touche	Action
n	Étape suivante
p	Étape précédente
c ou Escape	Fermer

Chaque étape affiche le fichier, l’outil, le nombre de lignes ajoutées ou supprimées et un court diff. L’exemple limite chaque étape à 12 lignes. Pour Edit, il compare old_string à new_string, pas le fichier entier, et n’affiche pas les numéros de ligne. Pour Write, il lit l’ancien contenu du disque juste avant l’appel ; au-delà de 400 lignes, il n’effectue pas de correspondance complète.

Pourquoi une modification rejouée peut être absente du fichier final

Replay Theater enregistre l’appel avant de le transmettre. Une modification que vous refusez ou un appel qui échoue peut donc apparaître. Un appel ultérieur peut aussi écraser ou annuler une étape précédente.

Le replay reste en mémoire pendant la session en cours. Un redémarrage de Claude Code ou un reload du plugin le supprime. Un tour suivant sans modification conserve le replay précédent. Utilisez-le pour comprendre « ce que Claude a tenté », pas comme image de l’état final du dépôt.

Validez le travail sur les fichiers réels

Terminez dans le dépôt, quel que soit le contenu du replay :

git status --short
git diff --stat
git diff -- path/to/file
git diff --check

git status --short révèle les ajouts, modifications et suppressions réels. git diff --stat permet de détecter une portée anormalement large. Lisez le diff complet des fichiers importants au lieu de vous limiter aux 12 lignes du replay. Exécutez git diff --check pour les erreurs d’espacement, puis le plus petit test, type check ou build directement lié aux fichiers modifiés.

Formulez des critères observables : « la fonction cible a été renommée, toutes les références sont mises à jour, le test concerné passe et aucun fichier étranger n’a changé ». « Le replay montre cinq étapes vertes » n’est pas un critère d’acceptation.

Vérifiez l’usage réel dans le journal du fournisseur

Token Weather montre le remplissage du contexte ; il ne calcule pas une facture API. Chez n’importe quel fournisseur, retrouvez la requête par heure et par modèle, puis vérifiez status, input/output tokens, cache tokens applicables et coût enregistré.

Lorsque BetterToken sert de route API à Claude Code, sa page actuelle indique que model, time, token counts, cache usage, final cost et status restent regroupés dans un même enregistrement. Utilisez cette entrée pour confirmer l’usage réel. Cela ne signifie pas que BetterToken fournit les Mods, conserve le prompt et la réponse complets ou accepte automatiquement les changements. La connexion est décrite dans le guide BetterToken pour Claude Code.

Dépannez dans l’ordre le plus court

Échec de claude plugin validate

Lisez le fichier et le champ exacts indiqués par le validateur. Vérifiez que vous êtes dans claude-code-playground/claude-code/mods, que l’outil de téléchargement n’a pas renommé les fichiers cachés et que le checkout est intact. Revalidez avant de lancer.

Token Weather est absent ou reste à 0 %

Utilisez le terminal plutôt que le seul panneau de chat VS Code, confirmez la version 2.1.287 ou ultérieure et le chargement du bon Mod. Envoyez une requête normale et attendez la fin du tour principal. Zéro avant la première réponse est normal.

Replay Theater n’affiche aucune indication

Vérifiez que le tour a appelé Edit, Write ou MultiEdit et qu’il est terminé. Lire des fichiers, répondre à une question ou exécuter uniquement des commandes Bash ne crée aucune étape d’édition à enregistrer.

Le replay ne correspond pas à git diff

Fiez-vous aux fichiers. La modification a pu être refusée ou échouer, une étape ultérieure l’a peut-être remplacée, le panneau ne montre qu’un extrait local, ou un restart/reload a modifié l’état en mémoire. Relisez le diff complet et les tests ciblés.

Deux Mods ne s’affichent pas ensemble

Désactivez-en un et ouvrez une nouvelle session avec l’autre. Ils partagent AbovePrompt ; l’absence d’une deuxième bande ne prouve pas que le paquet est cassé.

La boucle minimale fiable

Choisissez Token Weather pour suivre la croissance du contexte et Replay Theater pour savoir quels appels d’édition ont eu lieu. Le chargement réussi n’est que la première étape ; un indicateur ou un replay visible est la deuxième. La troisième consiste toujours à inspecter les vrais fichiers, exécuter le contrôle pertinent le plus petit et, si l’usage compte, vérifier l’enregistrement du fournisseur. C’est ainsi que la visibilité du processus devient un résultat confirmé.