Context Mode est un plugin tiers de Claude Code qui achemine certains résultats volumineux par ses propres outils et conserve un index local des événements de session. Un développeur peut ainsi examiner ce qui a atteint la conversation pendant une tâche de programmation. Ses statistiques décrivent le traitement des sorties par le plugin ; les fichiers modifiés et les critères d’acceptation déterminent toujours la qualité du travail. Ce guide suit les fichiers de la version 1.0.169 du mainteneur et les instructions actuelles de Claude Code pour les plugins, vérifiés le 20 octobre 2026. BIG CHANGE n’a ni installé le plugin ni exécuté de session de programmation pour cet article.

Le grand changement

  • Ce qui change : Un plugin de Claude Code peut intercepter certains appels d’outils, conserver les résultats volumineux hors de la conversation et indexer les événements pour les retrouver ensuite. Il faut vérifier la version installée depuis le catalogue et les hooks actifs dans sa propre session.
  • Pourquoi cela compte : Pendant une longue tâche, un développeur peut comparer les sorties acheminées consignées par le plugin aux fichiers et résultats de tests réels. Cela permet de juger si le filtrage a préservé les preuves nécessaires à une décision, sans prendre un chiffre de compression pour la preuve d’un travail utile.
  • À surveiller : Le contrôle décisif consiste à vérifier l’acheminement des appels prévus dans l’environnement installé et l’accès aux preuves originales après compactage ou reprise de session. Le rapport local du plugin ne prouve ni la facturation du fournisseur ni la justesse du code.

Avant l’installation

Utilisez une session de terminal Claude Code autorisée et un dépôt que vous pouvez modifier. Choisissez une tâche limitée avec un critère de fin connu : les fichiers concernés, une commande de test ou de compilation existante et le comportement à préserver. Pour un point de comparaison avec les contrôles de session intégrés à Claude Code, notre guide pour examiner le contexte et poursuivre une session présente /context et /compact sans ce plugin.

Dans le terminal, relevez les versions installées de Claude Code et de Node.js :

Terminal
claude --version
node --version

Le paquet du plugin à la révision fixée nécessite Node.js 22.5.0 ou ultérieur. Son manifeste Claude Code lance le serveur MCP avec node. Vérifiez que le processus du plugin peut accéder à Node, puis ouvrez une session interactive et confirmez que /plugin est disponible. Sinon, suivez les instructions de configuration de votre distribution Claude Code; l’ancienne version minimale du README du mainteneur ne constitue pas un test fiable de compatibilité avec les contrôles actuels.

Utilisez une plateforme capable d’exécuter le hook Bash du plugin : macOS, Linux, WSL ou Windows avec Git Bash configuré pour Claude Code. Claude Code peut fonctionner nativement sous Windows avec PowerShell, mais les règles de correspondance des hooks à la révision fixée nomment Bash, et non PowerShell. Ces fichiers n’établissent pas l’acheminement automatique par un outil exclusivement PowerShell.

Obtenez l’autorisation d’installer un plugin tiers dans l’espace de travail. Examinez sa Elastic License 2.0, ses commandes de hook et son manifeste de serveur au regard des règles de votre organisation. Claude Code indique que les hooks et serveurs MCP des plugins s’exécutent avec les privilèges de l’utilisateur hors du bac à sable des outils ; approuver un appel du modèle ne confine pas ces processus. Le plugin peut traiter le contenu du dépôt et hérite des fichiers et identifiants accessibles à l’utilisateur. Un index local ne signifie pas non plus que les prompts et résultats sélectionnés ne sont pas transmis au fournisseur du modèle. Consultez les conditions d’utilisation des données du compte avant d’employer des données sensibles.

1. Choisir délibérément la portée d’installation

Dans la session interactive Claude Code, saisissez ces commandes :

Text
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode

La deuxième commande ouvre le panneau des détails du plugin selon la procédure d’installation actuelle de Claude Code. Examinez les skills, hooks et serveur MCP répertoriés. Choisissez une portée locale pour un essai limité à vous dans ce dépôt, sauf autorisation plus large. La portée utilisateur active le plugin dans tous vos projets ; la portée projet l’active pour les collaborateurs qui l’installent. Lisez le récapitulatif et l’onglet Errors de /plugin . Suivez l’instruction de rechargement ou redémarrez Claude Code. Forcer /reload-plugins --force peut invalider le cache du prompt et entraîner une requête non mise en cache ; ne le faites que pour activer le plugin dans la session actuelle.

Confirmez la présence de Context Mode dans l’onglet Installed de /plugin, avec la portée prévue. Depuis un terminal séparé, relevez la version réellement installée et son état :

Terminal
claude plugin list

L’instantané étudié correspond à la version 1.0.169, au commit du dépôt b31c7ee853cb9ea76121e24d368599390972a997; la commande du catalogue ne fixe pas ce commit. Évaluez toute modification de commande ou de comportement selon la version réellement installée. La voie distincte npx du mainteneur ne fournit que des outils MCP, sans les hooks automatiques du plugin ; elle n’équivaut donc pas à cette installation.

2. Diagnostiquer le plugin installé

Dans la session Claude Code active, exécutez :

Text
/context-mode:ctx-doctor

Conservez le rapport complet. La skill de diagnostic à la révision fixée étiquette les résultats [OK], [FAIL] et [WARN]. Vérifiez les lignes concernant l’environnement d’exécution, l’enregistrement des hooks, la recherche SQLite FTS5, l’enregistrement du plugin et sa version. Corrigez chaque échec selon sa cause. Une skill ou un serveur absent exige l’examen de l’onglet Errors de /plugin et du guide de dépannage des plugins Claude Code. Un diagnostic réussi établit l’état de la configuration ; l’étape suivante vérifie l’acheminement réel pendant le travail.

3. Observer l’acheminement pendant une tâche réelle

Avant la tâche, enregistrez son objectif, son critère d’acceptation et l’état du dépôt. Ces commandes de terminal aident à repérer les modifications existantes sans les attribuer au plugin :

Terminal
git status --short
git diff --stat

Dans la session Claude Code, exécutez /context-mode:ctx-stats et conservez le rapport initial complet. Réalisez ensuite la tâche autorisée. Observez les noms des outils et les résultats : les lectures, recherches, commandes shell ou appels MCP concernés passent-ils par les outils Context Mode, et pouvez-vous retrouver les détails originaux omis par un résultat filtré ? Relancez la même commande de statistiques ensuite :

Text
/context-mode:ctx-stats

La skill de statistiques indique les sorties de la session actuelle et leur répartition par outil. Sans appels concernés, un rapport vide ne montre aucun effet observé du plugin. Conservez les deux rapports et comparez-les aux appels observés. Les chiffres de compression et de durée du mainteneur sont ses exemples, pas des mesures de votre tâche. Les estimations de tokens ou de contexte du plugin ne sont ni une facture du fournisseur ni la preuve de modifications correctes. L’utilisation de Claude Code et du modèle reste soumise aux conditions de votre compte ou fournisseur.

Si la conversation est compactée ou reprise, examinez l’état récupéré avant une autre modification. Vérifiez les fichiers, les différences et la commande d’acceptation originale ; récupérez tout résultat complet nécessaire pour juger un extrait filtré. L’index local de Context Mode peut retrouver une décision antérieure, mais son état rappelé ne vérifie pas le dépôt. Terminez en exécutant le véritable contrôle de la tâche et en examinant vous-même les différences. Notez la commande, le résultat de sortie, les fichiers concernés et les échecs non résolus. Un rapport peut rester utile si la tâche échoue ; il ne doit pas transformer cet échec en réussite.

4. Récupérer sans abandonner les preuves

Si l’acheminement bloque un outil nécessaire, conservez l’erreur exacte et le rapport de diagnostic, puis examinez l’onglet Errors de /plugin. Si le plugin est en cause, désactivez Context Mode depuis l’onglet Installed de /plugin, à la portée qui l’active. Les paramètres locaux, de projet et d’utilisateur ont des portées et priorités différentes. Ouvrez une nouvelle session Claude Code, confirmez que le plugin y est désactivé et vérifiez que les outils ordinaires et l’état réel de la tâche sont utilisables. Gardez les rapports et sorties sources nécessaires pour expliquer l’incident.

La désactivation ne supprime pas l’index local. La skill de purge du plugin décrit une opération délibérée et irréversible /context-mode:ctx-purge . La portée session exige son identifiant exact et supprime ses lignes et fragments de recherche tout en préservant les autres sessions et statistiques du projet. La portée projet supprime le contenu indexé du projet, tous ses événements de session, fichiers d’événements et statistiques. Décidez et confirmez la portée seulement après avoir conservé les preuves nécessaires ; aucune purge n’est un dépannage courant. /clear et /compact n’effacent pas les données stockées par Context Mode.

Sources et lectures complémentaires