Vous passez vos journées dans Claude Code, et il vous manque toujours un petit quelque chose. Voir où en est votre contexte, par exemple. Ou être retenu avant une commande qui efface tout.
Les mods de Claude Code, qu'on cherche souvent sous le nom de "Claude Modse, sont des plugins qui changent son apparence et son comportement. Anthropic les a annoncés le 1er octobre 2026.
Découvrons donc ce qu'un mod sait faire, comment en obtenir un sans écrire une ligne de code, et ce qu'il peut faire sur votre ordinateur.
Ce qu'un mod change dans Claude Code
Jusque-là, on personnalisait Claude Code de l'extérieur : un script se lançait à côté, ou un fichier d'instructions lui était donné à lire. Aucun ne pouvait toucher à l'écran.
Un mod, lui, est un plugin (une extension qu'on installe dans Claude Code) dont le code s'exécute dans Claude Code lui-même.
D'après la présentation des mods dans la documentation, ça lui ouvre quatre possibilités :
- Dessiner sa propre interface. Un panneau à côté de la conversation ou un bandeau au-dessus de la zone de saisie, avec des onglets, des boutons et des champs ;
- Redessiner celle de Claude Code. La ligne qui apparaît quand Claude lit un fichier, le texte animé pendant qu'il travaille, la fenêtre où il vous pose une question ;
- S'interposer dans une action. Retenir une commande le temps de vous demander votre avis, ou y répondre sans la lancer ;
- Ajouter une commande. Un
/quelquechosequi lance votre code tout de suite, même pendant que Claude est occupé.
Pour se faire une idée, Anthropic publie trois mods d'exemple, fournis tels quels :
- token-weather dessine une « météo » de votre contexte (ce que Claude garde en tête de la conversation) au-dessus de la zone de saisie ;
- blast-radius retient une commande risquée, comme
rm -rf, et montre ce qu'elle modifierait avant de vous laisser décider ; - replay-theater ajoute une commande
/replayqui rejoue pas à pas les modifications de fichiers de la dernière réponse.
Vous utilisez sans doute déjà un mod sans le savoir. La commande /diff, qui ouvre un panneau avec les modifications en cours, en est un. Anthropic construit donc une partie de Claude Code avec le même outil que nous avons désormais (les mods).
Comment créer un mod Claude Code sans coder ?
Qu'est-ce qui vous manque, à vous ? Pour ma part, c'est la branche Git. Je ne compte plus les fois où j'ai laissé Claude travailler sur la mauvaise (et où je m'en suis aperçu trop tard...).
Il suffit de le demander avec vos mots, dans une session ouverte (une conversation en cours avec Claude Code).
Par exemple "fais un mod qui montre la branche Git au-dessus de la zone de saisie". Le guide de création d'un mod décrit la suite :
- Claude écrit le mod dans un dossier réservé à votre session, sous
~/.claude/dev-mods/; - Claude Code vous pose une question au premier fichier enregistré. (Par exemple "Voulez-vous activer le rechargement à chaud pour cette session ?") ;
- Vous acceptez, et le mod se charge quand Claude a fini de répondre ;
- Vous demandez une retouche. Le mod se recharge à la fin de chaque réponse qui le modifie, sans redémarrer (c'est ça, le rechargement à chaud).
Bref, comme avec les skills et les routines !
Rien ne se passe ? Vérifiez votre version avec claude --version. À leur lancement, les mods demandaient au moins Claude Code 2.1.287 dans le terminal, et la version 2.1.286 dans l'application de bureau.
Si vous débutez avec l'outil, notre formation Claude Code reprend les sessions, les commandes et les permissions depuis le début.
Un mod écrit par Claude ne se charge que dans la session qui l'a créé. Claude Code supprime ensuite ce dossier après un délai fixé dans vos réglages. Pour le garder, copiez son dossier ailleurs (ou demandez-lui tout simplement). 😉
Une fois le dossier copié, chargez-le au lancement avec une option --plugin-dir :
claude --plugin-dir ~/mods/git-branchInstaller un mod écrit par quelqu'un d'autre
Un mod s'installe comme n'importe quel plugin, depuis une marketplace (un catalogue de plugins) :
/plugin install token-chart@your-orgMais avant d'installer le mod d'un inconnu, mieux vaut savoir ce que vous lui confiez.
Ce qu'un mod peut lire et faire sur votre machine
Installer un mod, c'est un peu laisser ses clés à un artisan pendant qu'on est au travail. Il vient poser une étagère, mais il a accès à tout l'appartement.
Anthropic l'écrit sans détour : un mod s'exécute avec vos permissions, et il n'est pas isolé du reste de la machine.
Une fois chargé, il peut faire six choses :
- Agir à votre place. Lire et écrire tous les fichiers que votre compte peut ouvrir, lancer des programmes, envoyer des requêtes sur Internet ;
- Lire vos secrets. Vos fichiers de réglages, là où l'on range souvent ses clés d'API (les codes qui relient un programme à votre compte) ;
- Voir votre session. Chaque message que vous envoyez, chaque action de Claude ;
- Modifier votre session. Réécrire un message, ou en envoyer un comme si vous l'aviez tapé ;
- Décider sans vous. Approuver une action avant qu'on vous pose la question ;
- Consommer votre forfait. Appeler un modèle sur votre abonnement ou votre clé d'API.
Une seule chose lui échappe : un mod ne peut pas redessiner la fenêtre de demande de permission. Ce que cette fenêtre vous montre est donc toujours vrai.
Même si vous activez le bac à sable de Claude Code (un mode qui enferme ses commandes dans un espace isolé), il n'isole que les commandes lancées par Claude. Un programme démarré par un mod s'exécute en dehors.
Lire ce que fait un mod avant de l'installer
Vous n'avez pas à croire l'auteur sur parole (d'ailleurs on vous le déconseille).
Récupérez les fichiers du plugin, puis lancez cette commande sur son dossier. Elle lit le code sans l'exécuter.
claude plugin validate ./first-modLa ligne hooks liste les événements que le mod écoute. La ligne calls liste ce qu'il demande à Claude Code. La page destinée aux administrateurs indique les appels à repérer.
Appel dans la ligne calls | Ce que le mod peut faire |
|---|---|
$.fs.read, $.fs.write | Lire ou écrire vos fichiers |
$.process.run | Lancer un programme sous votre nom |
$.http.fetch | Envoyer des données sur Internet |
$.env.get, $.settings.read | Lire vos réglages, clés d'API comprises |
$.model.complete | Appeler un modèle sur votre forfait |
$.prompt.submit | Envoyer un message à votre place |
Un mod qui montre la branche Git n'a aucune raison d'appeler $.http.fetch. Si la ligne apparaît, vous savez qu'il faut lire le code, ou passer votre chemin. 😉
Couper un mod
Pour couper un seul mod, désactivez son plugin dans l'onglet Installed de la commande /plugin.
Si vous souhaitez les couper tous pour une session uniquement, lancez claude --safe-mode, qui coupe aussi vos autres personnalisations.
Si c'est une envie permanente, vous pouvez aussi les couper tous une bonne fois pour toutes avec "disableAllHooks": true dans ~/.claude/settings.json.
Mod, hook, skill ou serveur MCP, lequel choisir ?
Quatre mécanismes se ressemblent, et un mod n'est pas toujours le bon.
Si vous recopiez les mêmes consignes à chaque conversation, il vous faut une skill, qui range ces consignes dans un fichier.
| Mécanisme | Ce que c'est | Peut dessiner à l'écran | À choisir quand |
|---|---|---|---|
| Mod | Des fonctions JavaScript ou TypeScript appelées par Claude Code | Oui | Vous voulez un panneau, un bandeau, une commande, ou modifier une action |
| Hook de réglages | Un script lancé à un moment précis de la session | Non | Vous avez déjà un script pour bloquer, autoriser ou noter une action |
| Skill | Un fichier de consignes que Claude lit | Non | Vous répétez toujours les mêmes instructions |
| Serveur MCP | Un programme extérieur qui donne des outils à Claude | Non | Claude doit atteindre un service extérieur |
Retenez la troisième colonne. Seul un mod peut dessiner quelque chose dans Claude Code. Pour tout le reste, les trois autres font souvent l'affaire, et ils sont plus simples à relire.
Un plugin est une boîte. Il peut contenir à la fois un mod, une skill et un serveur MCP. Installer « un plugin » ne vous dit donc pas ce qu'il embarque.
Où les mods fonctionnent-ils ?
Le code d'un mod s'exécute presque partout où son plugin est chargé. Ce qu'il dessine, en revanche, n'apparaît que dans le terminal et dans l'application de bureau :
| Où vous lancez Claude Code | Le code du mod s'exécute | Ce qu'il dessine apparaît |
|---|---|---|
| Terminal, y compris celui d'un éditeur | Oui | Oui |
| Onglet Code de l'application de bureau | Oui | Oui, sauf quelques éléments réservés au terminal |
| Session WSL (Linux sous Windows) dans l'application de bureau | Non | Non |
| Panneau de discussion de l'extension VS Code | Oui | Non |
Claude Code lancé par un script (claude -p, Agent SDK) | Oui | Non |
| Session dans le cloud | Oui, si le plugin y est chargé | Non |
Si vous travaillez dans l'extension VS Code, un mod qui bloque une commande dangereuse fonctionne donc. Un mod qui ouvre un panneau, lui, ne montrera rien.
Dans une entreprise, un administrateur peut limiter les mods autorisés. Le réglage allowManagedModsOnly ne laisse se charger que ceux de l'organisation. Un mod écrit par Claude pendant une session est alors refusé lui aussi.
À quoi ressemble le code d'un mod ?
Vous n'avez pas besoin de lire cette partie pour utiliser un mod. Elle est là pour les curieux.
Un petit mod tient en trois fichiers :
plugin.jsonqui donne le nom et la version du plugin ;hooks.jsonqui indique où se trouve votre code ;register.jsqui contient ce code.
Voici un register.js complet, repris de l'exemple d'Anthropic. Il compte les actions de Claude et ajoute le total à la ligne d'attente.
// Le compteur, partagé par les deux fonctions
let calls = 0
// Claude Code appelle register une fois, au chargement du mod
export function register(on) {
// Avant chaque appel d'outil de Claude
on('tool.call', async ($, event, next) => {
calls += 1
// Demande à Claude Code de redessiner l'interface
$.ui.invalidate('ui.render')
// Laisse l'outil s'exécuter normalement
return next(event)
})
// À chaque fois que Claude Code dessine la ligne d'attente
on('ui.render', { component: 'Spinner' }, async ($, event, next) => {
// Garde la ligne d'origine et ajoute le compteur à la fin
return next({ ...event, props: { ...event.props, suffix: ' · tool calls: ' + calls + '…' } })
})
}La première fonction se déclenche avant chaque action de Claude, et ajoute un au compteur. La seconde se déclenche quand Claude Code dessine la ligne d'attente, et y colle le total.
Chaque fonction passée à on est un hook (une fonction que Claude Code appelle quand un événement se produit).
Elle reçoit trois choses :
$regroupe tout ce qu'un mod a le droit de demander à Claude Code ;eventdécrit l'événement, par exemple le nom de l'outil et ses arguments ;nextpasse l'événement aux autres mods, puis à Claude Code.
Oui, quelques notions en JavaScript sont nécessaires et même avec, cela reste délicat ! 👀
Rassurez-vous, vous n'aurez sans doute jamais à écrire ce code vous-même. Demandez-le à Claude, puis relisez ce qu'il a produit avec claude plugin validate.
Questions fréquentes sur les mods de Claude Code
Qu'est-ce qu'un mod dans Claude Code ?
Un mod est un plugin qui change l'apparence et le comportement de Claude Code. Il est fait de fonctions JavaScript ou TypeScript que Claude Code appelle quand un événement se produit.
Il peut dessiner un panneau ou un bandeau, ajouter une commande, ou modifier une action de Claude avant qu'elle s'exécute. Anthropic a annoncé les mods le 1er octobre 2026.
Faut-il savoir coder pour créer un mod ?
Non. Vous décrivez ce que vous voulez dans une session, et Claude écrit le mod à votre place, puis Claude Code vous demande d'activer le rechargement à chaud.
Ce mod ne se charge que dans la session qui l'a créé. Pour le garder, copiez son dossier et lancez claude --plugin-dir suivi de son chemin.
Un mod Claude Code est-il dangereux ?
Il peut l'être. Un mod s'exécute avec vos permissions et sans isolation. Il peut lire vos fichiers et vos clés d'API, voir chaque message et approuver une action sans vous.
Avant d'installer un mod, lancez claude plugin validate sur son dossier. La commande liste ce qu'il écoute et ce qu'il demande, sans exécuter son code.
Les mods fonctionnent-ils dans VS Code ?
En partie. Dans le panneau de discussion de l'extension VS Code, le code d'un mod s'exécute mais rien de ce qu'il dessine n'apparaît.
Les panneaux et les bandeaux n'apparaissent que dans le terminal et dans l'onglet Code de l'application de bureau. Le terminal intégré de VS Code compte comme un terminal.
Comment désactiver les mods ?
Pour un seul mod, désactivez son plugin dans l'onglet Installed de /plugin. Pour tous le temps d'une session, lancez claude --safe-mode.
Pour les couper à chaque session, ajoutez "disableAllHooks": true dans ~/.claude/settings.json. Vos hooks de réglages s'arrêtent aussi.