Les utilisateurs de Claude Code peuvent désormais modifier l’interface et le comportement de l’assistant au moyen de fonctions JavaScript ou TypeScript regroupées sous forme de plug-ins. Anthropic a lancé les mods le 1er octobre, avec prise en charge dans le CLI et l’onglet Code de Claude Desktop. Les développeurs peuvent ajouter à la conversation un affichage de l’utilisation du contexte.

Anthropic indique que les mods utilisent les autorisations de la machine de l’utilisateur et ne sont pas isolés dans un bac à sable. Un mod peut également lire les données de session ou effectuer des appels au modèle. Examinez son code et son éditeur avant de l’installer.

Ce guide s’adresse aux développeurs qui utilisent déjà Claude Code et souhaitent y ajouter une personnalisation visible et limitée. Il s’agit de créer un affichage de l’utilisation de la fenêtre de contexte, d’examiner le plug-in obtenu et de décider s’il faut le conserver. Ces instructions sont fondées sur la documentation, vérifiée le 2 octobre pour Claude Code v2.1.287 et les versions ultérieures. BIG CHANGE n’a pas exécuté cette procédure ni testé le code généré de manière indépendante.

Le grand changement

  • Ce qui change : les mods Claude Code ajoutent des fonctions capables de modifier des événements et de s’afficher dans l’interface de l’assistant, le tout intégré à son système de plug-ins existant.
  • Pourquoi c’est important : les développeurs peuvent intégrer un affichage ou un contrôle de flux de travail à leur session, tout en donnant à ce code accès à leur machine et à leur conversation.
  • À surveiller : la correspondance entre les appels et le comportement réels du mod et son objectif, les contrôles organisationnels applicables et les changements d’API entre les versions de Claude Code.

Vérifier la version, le compte et l’espace de travail

Exécutez claude --version dans un shell. La documentation actuelle sur les mods exige la version v2.1.287 ou ultérieure et indique que les mods sont activés par défaut. Les anciens paramètres de variables d’environnement réservés à l’accès anticipé ne contrôlent pas cette version.

Vous devez avoir accès à Claude Code et utiliser un espace de travail que vous avez marqué comme fiable. La documentation de configuration d’Anthropic répertorie les comptes Pro, Max, Team, Enterprise et Console, ainsi que les fournisseurs d’API tiers pris en charge. L’offre gratuite de Claude Chat n’inclut pas Claude Code. Les paramètres d’une organisation peuvent empêcher le chargement des mods créés par les utilisateurs.

Utilisez une session de terminal interactive. Le CLI et les sessions prises en charge dans Desktop affichent les interfaces des mods. Les hooks s’exécutent également dans le panneau de chat de VS Code et dans les sessions sans interface, où les dessins ne sont pas visibles. Les sessions WSL de Desktop ne prennent pas en charge les plug-ins.

Créer et examiner l’affichage

Le tutoriel du 1er octobre d’Anthropic décrit Token Weather, un affichage qui lit l’utilisation du contexte après les tours. Son pourcentage est calculé à partir du contexte utilisé pour la dernière réponse et de la fenêtre de contexte du modèle. Il s’agit d’un indicateur d’utilisation, sans mesure documentée de la qualité des réponses.

  1. Démarrez claude dans l’espace de travail fiable. Demandez-lui de créer un mod qui affiche, au-dessus de la zone de saisie, le pourcentage de contexte, le nombre de jetons utilisés et la taille de la fenêtre de contexte, avec mise à jour après chaque tour terminé de l’agent principal. Demandez l’API documentée d’utilisation de session et une implémentation limitée à l’affichage, sans accès aux fichiers, exécution de processus, requêtes réseau ni appels au modèle. Il s’agit de notre spécification plus restrictive pour la procédure de création documentée ; la demande elle-même ne fait pas respecter ces restrictions.
  2. Examinez les fichiers créés par Claude. Le manuel de création place le plug-in dans le répertoire de la session, sous ~/.claude/dev-mods/. Examinez son manifeste, sa configuration des hooks et son code. Claude Code demande si vous souhaitez activer le rechargement à chaud ; l’accepter exécute les mods de cette session et leurs révisions ultérieures.
  3. Avant de l’activer, exécutez claude plugin validate suivi du répertoire réel du plug-in dans votre shell. Lisez les hooks d’événements et les appels d’API signalés. Le comportement attendu requiert la lecture des données d’utilisation, la gestion de l’état et l’affichage du résultat. Examinez tout accès aux fichiers, aux variables d’environnement, aux processus, au réseau ou aux modèles, ainsi que les réécritures d’événements dans le code source. Une validation réussie indique la compatibilité avec le chargeur, pas une garantie de sécurité.
  4. Après avoir approuvé une implémentation examinée, exécutez /plugin et vérifiez l’onglet Installed pour le mod. Faites une requête ordinaire et vérifiez que la jauge se met à jour après le tour. Le critère de réussite est un plug-in chargé dont les valeurs d’utilisation sont visibles et se mettent à jour ; la seule génération d’un fichier ne prouve pas qu’il fonctionne.

Ces étapes ne garantissent pas que Claude générera la bonne implémentation dès le premier essai. L’implémentation complète de Token Weather et son exemple de test servent de référence pour comparer ce qu’il écrit. Le tutoriel indique qu’une lecture ordinaire de l’utilisation de session est gratuite ; demander une ventilation peut envoyer une requête de comptage des jetons. Demander à Claude d’écrire ou de réviser le mod consomme tout de même l’utilisation normale de Claude Code.

Surveiller le code et ses autorisations

Un mod créé dans une session est temporaire. Le manuel de création indique qu’il faut le conserver en copiant son répertoire vers un emplacement personnel, puis démarrer les sessions avec claude --plugin-dir suivi de cet emplacement. Chaque chargement écrit des déclarations propres à la version sous .claude-plugin/types/ ; vérifiez-les lors des mises à jour, car l’API peut changer.

Le manuel d’administration d’Anthropic explique une limite que les règles d’autorisation des outils peuvent masquer. Le garde-fou de sécurité intégré se charge pour les utilisateurs Team ou Enterprise, ou sur les machines dotées de paramètres gérés. Avec sa configuration par défaut, les règles de refus priment sur les mods utilisateur qui autorisent les appels d’outils de Claude. Ces règles ne limitent pas les appels propres du mod aux API de fichiers ou de processus. Les administrateurs peuvent bloquer les mods installés par les utilisateurs ou appliquer un mod de politique à leurs appels.

Le rapport d’enquête de Pluto Security du 22 septembre a signalé un accès aux identifiants, une tromperie de l’interface et la modification du code à distance dans des tests de la version préliminaire. Pluto vend des logiciels de sécurité pour ces extensions, et son rapport précède explicitement la disponibilité générale. Il constitue un élément utile pour examiner le code source d’un plug-in et ses dépendances téléchargées ; ses conclusions précises ne décrivent pas le comportement de la version v2.1.287. La documentation actuelle d’Anthropic précise les autorisations de cette version.

Désactivez un mod à l’aide des commandes de son plug-in. --safe-mode exclut les mods installés et les autres personnalisations d’une session.

Utilisation et coût

Les guides de lancement et des mods d’Anthropic ne mentionnent aucuns frais distincts pour les mods. La documentation des coûts de Claude Code indique que l’utilisation par abonnement est déduite des allocations du forfait, tandis que l’utilisation de Console et des fournisseurs cloud est facturée au jeton. Un mod qui appelle un modèle peut consommer cette utilisation. Vérifiez /usage et l’interface de facturation correspondant à votre mode de connexion ; un pourcentage de contexte n’est ni une facture ni un plafond de dépenses.

Notez la version de Claude Code à côté du plug-in examiné. L’ajout d’approbations de commandes ou d’outils auxiliaires téléchargés nécessite un nouvel examen, car il modifie les capacités du code.

Sources et ressources complémentaires

  • Anthropic, Personnaliser Claude Code avec des mods, 1er octobre 2026 : annonce de sortie, intégration aux plug-ins et avertissement explicite sur l’accès à la machine. Anthropic développe et vend Claude Code.
  • Présentation des mods, consultée le 2 octobre : version, interfaces de session, autorisations de l’hôte, validation et commandes de désactivation.
  • Créer un mod, consultée le 2 octobre : création, approbation, rechargement à chaud, conservation et déclarations de types propres aux versions. Ce document décrit le comportement attendu, pas un test de BIG CHANGE.
  • Premiers pas avec les mods Claude Code, Addy Osmani, 1er octobre : la mesure, le code et l’exemple de test de Token Weather. La démonstration est celle d’Anthropic.
  • Gérer les mods de votre organisation, consultée le 2 octobre : disponibilité du garde-fou, portée des règles de refus et options des administrateurs. Elle ne rend pas les mods utilisateur généralement isolés de la machine.
  • Configuration avancée et Gérer efficacement les coûts, consultées le 2 octobre : prérequis du compte, facturation selon l’authentification et suivi de l’utilisation. Aucune source de lancement examinée ne précise de prix distinct pour les mods.
  • Pluto Security, « Inside Claude Code Function Hooks », 22 septembre : tests menés par des chercheurs sur une version préliminaire et limites de ces tests. Pluto commercialise des produits de sécurité pour extensions ; nous n’avons pas reproduit ces tests.