Tech • IA • Robotique • Jeu
Les mods dans Claude Code : changer le fonctionnement de Claude Code
5/10INTRO
Claude Code prend désormais en charge des mods capables de modifier son interface et son comportement en interceptant des événements internes, ce qui permet aux développeurs de changer le rendu, les prompts, les appels d’outils et d’ajouter des éléments d’interface personnalisés.
POINTS CLÉS
Ce que les mods peuvent modifier
Les mods fonctionnent comme des plugins exécutés dans Claude Code et peuvent modifier directement le comportement central. Ils peuvent changer ce que l’application affiche, altérer les données envoyées aux prompts, influencer les appels d’outils effectués, et ajouter des éléments d’interface, des compétences et des commandes personnalisés. Le système permet aux développeurs de remodeler à la fois le flux de travail et la présentation, au-delà d’une simple extension de fonctions externes.
Exemples de personnalisations
Les premiers exemples montrent l’ampleur de cette flexibilité. Un mod affiche une ventilation en direct du contexte au-dessus du prompt, donnant aux utilisateurs plus de visibilité sur ce que le système utilise. Un autre ajoute un panneau latéral listant tous les agents d’un projet, au lieu du seul agent actif, avec lancement en un clic. Un troisième masque les adresses e-mail à l’écran jusqu’au survol du curseur, afin de réduire les divulgations accidentelles pendant les enregistrements.
Structure du système de mods
Un mod utilise la même structure plugin.json et hook.json qu’un plugin standard, avec un ajout important: hook.json inclut une clé modules pointant vers un fichier TypeScript. Ce fichier contient la logique du mod. En pratique, ce changement transforme un package de plugin standard en package capable d’exécuter du code dans le propre système d’événements de Claude Code.
Gestion des événements de type middleware
Claude Code expose des dizaines d’événements internes, notamment les appels d’outils, les vérifications d’autorisation, l’exécution des messages, l’émission des prompts et le rendu. Un mod enregistre des fonctions sur ces événements, et chaque fonction s’exécute à chaque déclenchement, juste avant que Claude Code n’effectue son action normale. La conception ressemble étroitement à un middleware, permettant aux développeurs d’inspecter, de modifier ou de remplacer le comportement au moment où il se produit.
Modèle de fonction en trois parties
Chaque gestionnaire d’événement reçoit trois entrées. La première est un $ object, qui donne accès à Claude Code pour des actions comme afficher une interface, appeler le modèle et lire des fichiers. La deuxième est l’event data elle-même, contenant les informations propres à cet instant. La troisième est next, qui détermine ce que Claude Code fait ensuite en recevant la charge utile d’événement éventuellement modifiée.
Possibilité de remplacer le comportement par défaut
Les développeurs peuvent modifier les données d’événement avant de les transmettre à next, et ces changements deviennent l’action exécutée par Claude Code. Si un mod modifie une commande, c’est la commande modifiée qui s’exécute. L’appel à next est facultatif: un mod peut à la place renvoyer son propre résultat et gérer entièrement l’événement, remplaçant le comportement par défaut de Claude Code dans ce cas.
Fonctionnement du mod de masquage des e-mails
L’exemple de confidentialité des e-mails utilise l’événement render, qui se déclenche juste avant qu’une réponse apparaisse à l’écran. Le mod analyse le texte de la réponse à la recherche d’adresses e-mail et construit un bloc d’affichage de remplacement qui ne révèle l’adresse qu’au survol. Comme il renvoie sa propre version rendue au lieu d’appeler next, Claude Code affiche la sortie modifiée tout en conservant la réponse sous-jacente intacte.
Les changements d’affichage ne modifient pas le contexte du modèle
L’exemple du masquage des e-mails met en évidence une distinction essentielle entre la présentation et l’état du modèle. Une modification limitée au rendu change ce qui apparaît à l’écran, mais ne change pas ce que le modèle a utilisé en interne. Ainsi, une adresse e-mail masquée peut rester disponible pour des tâches ultérieures, comme rédiger un message, même si l’interface visible la dissimule.
Chargement, rechargement et distribution
Les mods peuvent être chargés en démarrant Claude Code avec un indicateur plugin dir pointant vers le dossier du plugin. Dans l’application de bureau, où les indicateurs ne sont pas disponibles, le même dossier peut être ajouté via le fichier global de paramètres. Le dossier est surveillé pour détecter les changements, ce qui permet à une session en cours de prendre en compte les mises à jour immédiatement après l’enregistrement d’un fichier. Comme un mod reste empaqueté comme un plugin, il peut aussi être partagé via un dépôt de marketplace pour installation par d’autres utilisateurs.
CONCLUSION
Le nouveau système de mods transforme Claude Code en plateforme pilotée par middleware, où les développeurs peuvent personnaliser le comportement interne autant que l’interface utilisateur. La combinaison de hooks d’événements, d’une exécution isolée et d’un packaging partageable ouvre la voie à une personnalisation plus poussée et à un meilleur contrôle des flux de travail.
Poser une question