Personnalisez Claude Code avec des mods

Aujourd'hui, nous introduisons les mods, de petites fonctions TypeScript qui modifient le fonctionnement de Claude Code. Un mod peut réécrire une requête, ajouter une nouvelle interface utilisateur, remplacer une fonctionnalité intégrée ou ajouter des fonctionnalités entièrement nouvelles. Vous pouvez écrire vous-même un mod ou demander à Claude Code d'en écrire un pour vous. Les mods sont intégrés aux plug-ins, vous pouvez donc les installer et les partager comme n'importe quel plug-in. Ils fonctionnent dans Claude Code CLI et dans l'application de bureau.

Les mods fonctionnent avec le même accès à votre machine que Claude Code lui-même. Ils ne sont pas protégés par les systèmes d'analyse en sandbox, et vous ne devez installer des mods qu'à partir de sources de confiance, de la même manière que vous installez n'importe quel code sur votre ordinateur.

Pour découvrir ce que les mods peuvent faire, lisez notre guide pour créer votre premier mod.

Pourquoi nous avons créé des mods

Les développeurs ont demandé un meilleur contrôle sur le fonctionnement de Claude Code, sans attendre que nous vous fournissions une fonctionnalité. Les hooks ont contribué à donner aux utilisateurs une partie de ce contrôle, mais les hooks ne peuvent pas réécrire des événements, dessiner de nouvelles interfaces utilisateur ni remplacer des fonctionnalités. Les mods le peuvent.

Nous voulons que Claude Code vous appartienne afin que vous puissiez l'adapter à votre façon de travailler. Nous avons partagé le design des mods sur GitHub avant le lancement pour obtenir les retours des développeurs. Merci à tous ceux qui ont donné leur avis.

Fonctionnement des mods

Chaque fois que Claude Code effectue une action, il émet un événement. Par exemple, appel d'outil, demande d'autorisation ou rendu d'une partie de l'écran. Un mod est une fonction attachée à l'un de ces événements. Un mod peut s'exécuter avant l'événement, après celui-ci ou à la place. Il peut également conclure l'événement, en exécutant du code avant et après. Avec une seule fonction, un mod peut :

• Réécrire une requête avant qu'elle n'aboutisse au modèle.
• Bloquer, réécrire ou réessayer un appel d'outil.
• Approuver ou refuser une demande d'autorisation.
• Cacher les informations sensibles de la sortie d'outils avant que Claude ne les lise.

Un mod peut également modifier ce que vous voyez. Il peut modifier ou remplacer une partie de l'interface dessinée par Claude Code, comme le résultat d'un outil ou une question de Claude. Il peut ajouter des boutons et des entrées, et d'autres mods peuvent réagir lorsque vous cliquez dessus. Aujourd'hui, un mod peut cibler le terminal, l'application de bureau, ou les deux.

Lorsque plusieurs mods s'associent au même événement, ils s'exécutent dans l'ordre de leur chargement. Le premier mod à charger voit l'événement en premier et le résultat en dernier. Cela vous permet d'empiler les mods de différents auteurs.

Vous pouvez également utiliser Claude Code pour modifier Claude Code. Demander à Claude de créer un mod, qui pourra écrire le TypeScript, l'installer et le recharger à chaud dans votre session.

Échanger les fonctionnalités intégrées contre les vôtres

Certaines fonctionnalités intégrées de Claude Code sont désormais disponibles sous forme de mods. Par exemple, la fonctionnalité intégrée /diff est désormais un mod, vous pouvez donc la désactiver (dans /plugin) ou la remplacer par votre propre version. Nous prévoyons de transférer progressivement davantage de fonctionnalités intégrées vers des mods, afin que vous puissiez réduire Claude Code à un noyau minimal et n’y réintégrer que les fonctionnalités de votre choix.

Mods pour les équipes et les entreprises

Les mods sont fournis dans les plug-ins, de sorte que les contrôles de vos plug-ins existants s'appliquent. Les administrateurs peuvent autoriser ou bloquer les marketplaces de plug-ins. Sur les plans Team et Enterprise, le propriétaire les définit dans la console d'administration. Sur Claude API et les plans d'API tiers, les administrateurs transmettent les paramètres gérés aux machines des utilisateurs.

Sur les plans Team et Enterprise, et sur toute machine disposant de paramètres gérés, un mod intégré appelé sec-default ( « sécurité par défaut » ) se charge en premier. Il empêche les mods que les utilisateurs installent de faire des choses risquées, comme contourner vos règles de refus d'autorisation. Vous pouvez consulter le code source pour voir ce qu'il restreint. Les administrateurs peuvent charger leurs propres mods en premier. Si vous le faites, ajoutez sec-default à votre liste pour conserver ses restrictions.

Les équipes peuvent également utiliser les mods pour créer leurs propres contrôles et fonctionnalités. Par exemple :

• Statut CI/CD : un mod peut afficher l'état de votre pipeline dans un volet à côté de la conversation et l'actualiser en fonction de la réussite ou de l'échec des builds.
• Garanties de production : une modification peut nécessiter une confirmation avant d'affecter une commande à la configuration de production.
• Journal d'audit : un mod qui se charge en premier peut enregistrer chaque appel effectué par chaque autre mod.

Premiers pas

Les mods sont disponibles dès aujourd'hui dans Claude Code CLI et dans l'application de bureau. Installez des plug-ins qui incluent des mods depuis le répertoire Claude ou en exécutant /plugin dans l'interface de commande. Pour partager un mod, regroupez-le dans un plug-in et soumettez-le au répertoire.

Pour créer vos propres mods, lisez notre guide de démarrage ou consultez la documentation.