Les mods de Claude Code : par où commencer

Les liens officiels, si tu veux aller direct à la source :

Un mod, c'est un plugin écrit en JavaScript ou en TypeScript qui tourne à l'intérieur de Claude Code. Il réagit à des événements : un appel d'outil, un prompt envoyé, une partie de l'interface qui se dessine. Il peut les observer, les modifier, ou les prendre en charge à la place de Claude Code.

1. Ce qu'un mod peut faire

Un skill dit à Claude comment travailler, avec des instructions en Markdown. Un mod change Claude Code lui-même, et c'est le seul à pouvoir dessiner dans l'interface.

Concrètement, un mod peut :

ajouter un volet à côté de la conversation, ou une bande au-dessus du prompt, avec des boutons et des champs de texte ;
redessiner le spinner, les lignes d'appel d'outil ou la boîte de questions de Claude ;
bloquer, réécrire ou relancer un appel d'outil ;
réécrire un prompt avant qu'il parte au modèle ;
masquer des secrets dans la sortie d'un outil avant que Claude la lise ;
ajouter une /commande qui s'exécute tout de suite, sans tour de Claude, même pendant qu'il travaille.

Une seule limite : un mod ne peut pas modifier la demande de permission.

Pour l'anecdote, /diff est lui-même devenu un mod intégré.

2. Ton premier mod, en demandant à Claude

Les mods sont sortis le 1er octobre 2026. Dans le terminal, il te faut Claude Code v2.1.287 ou plus. Vérifie ta version.

claude --version

Dans l'onglet Code de l'app Claude Desktop, tape /status et lis la ligne Claude Code : les mods y marchent à partir de la v2.1.286.

Ils sont activés par défaut. Dans le chat de l'extension VS Code, un mod tourne mais n'affiche rien : volets et bandes, c'est terminal et Desktop seulement.

Pas besoin d'écrire une ligne de code. Ouvre une session Claude Code et décris le mod que tu veux, en langage naturel. L'exemple de la doc :

make a mod that shows the current git branch above the prompt

Claude utilise son skill intégré plugin-authoring et écrit le mod dans ~/.claude/dev-mods/<id de session>/. ~/.claude est un dossier protégé, donc en mode de permission par défaut, Claude Code te demande d'approuver chaque fichier du mod. Valide-les au fur et à mesure.

Au premier fichier, Claude Code te demande si tu veux activer le rechargement à chaud pour la session. Réponds Enable for this session.

Le mod se charge à la fin de la réponse de Claude, puis se recharge à chaque fois qu'il le modifie. Tu demandes une retouche, tu vois le résultat.

Pour vérifier qu'il est actif, lance cette commande et appuie sur Tab jusqu'à l'onglet Installed.

/plugin

Un mod écrit par Claude ne se charge que dans sa session, et Claude Code finit par supprimer le dossier de cette session. Pour le garder, demande à Claude de le sortir de là et de l'installer comme plugin, avec la portée qui te va :

user : pour toi, dans tous tes projets ;
project : pour tout le monde sur ce repo ;
local : pour toi, dans ce repo seulement.

Pour juste le relancer dans une autre session sans l'installer, ça suffit :

claude --plugin-dir <dossier du mod>

Chez moi, j'ai un outil qui monte mes vidéos avec Claude Code. En un prompt, Claude m'a codé un mod qui affiche dans un volet chaque étape du montage, et quand c'est à moi de valider. Quelques prompts de plus ont suffi pour améliorer l'affichage.

3. Les mods d'exemple d'Anthropic

Anthropic a publié trois mods d'exemple dans son dépôt claude-code-playground. Chacun a un README qui explique comment il a été construit. Ils sont partagés tels quels, sans support.

Mod	Ce qu'il fait
`token-weather`	Affiche une prévision de ta fenêtre de contexte au-dessus du prompt.
`blast-radius`	Retient une commande risquée, comme `rm -rf` ou un force push, et te montre ce qu'elle changerait. Tu continues ou tu annules avec des boutons.
`replay-theater`	Ajoute une commande `/replay` qui rejoue les modifications de fichiers du dernier tour.

Pour en tester un, clone le dépôt et lance Claude Code avec le dossier du mod.

git clone https://github.com/anthropics/claude-code-playground.git
cd claude-code-playground/claude-code/mods
claude --plugin-dir ./token-weather

Remplace token-weather par le mod que tu veux essayer.

4. Sécurité : à lire avant d'installer un mod

Un mod n'est pas sandboxé. Il tourne avec tes permissions, donc il peut :

lire et écrire tes fichiers ;
lancer des programmes ;
faire des requêtes réseau ;
lire tes variables d'environnement et tes clés d'API ;
voir tes prompts, les réécrire, ou en envoyer un comme si tu l'avais tapé ;
approuver un appel d'outil à ta place ;
appeler un modèle sur ton forfait ou ta clé d'API.

Même si tu as activé le sandboxing de Claude Code, un programme lancé par un mod tourne en dehors.

N'installe que des mods d'auteurs en qui tu as confiance.

Pour voir ce qu'un mod fait sans l'exécuter, récupère ses fichiers et lance cette commande. Les lignes hooks: et calls: te listent les événements qu'il gère et ce qu'il demande à Claude Code de faire.

claude plugin validate ./le-mod

Pour couper tous les mods installés le temps d'une session, lance Claude Code en mode sans échec. Ça désactive aussi tes autres personnalisations.

claude --safe-mode

Rejoins la communauté

Si tu construis un SaaS ou si tu débutes dans le dev avec l'IA, viens faire un tour sur notre Discord. On partage nos projets, on parle outils et on s'entraide pour livrer plus vite.

Suis-moi sur Instagram pour les coulisses et le build in public.