Le 1er octobre 2026, une semaine après la sortie des sessions cloud de leur phase d'aperçu, Anthropic a ajouté à Claude Code une fonction que beaucoup de développeurs attendaient : les mods. Il s'agit de petits programmes en TypeScript (ou en JavaScript) qui s'exécutent à l'intérieur de Claude Code et peuvent changer son comportement, son interface ou lui ajouter des commandes. Ils sont arrivés avec la version 2.1.287 et sont activés par défaut, sans réglage à faire.
J'utilise des assistants IA tous les jours pour mon travail, et je vois bien que chacun a sa façon de travailler. Il n'y a aucune raison pour que tout le monde ait exactement le même Claude Code. Que vous codiez seul le soir sur un projet perso ou dans une équipe qui a des règles de sécurité strictes, pouvoir adapter l'outil change pas mal de choses. Je vous explique ici ce que sont les mods, en quoi ils diffèrent des skills et des plugins, ce qu'ils peuvent faire sur votre machine (et c'est là qu'il faut être prudent), puis comment en installer un.
Projets, skills, plugins et mods : qui fait quoi ?
Avec toutes les fonctions qui se sont ajoutées autour de Claude ces derniers mois, on s'y perd facilement. Voici comment je les range.
- Projets
- Des espaces de travail dans claude.ai et l'application Claude. Un projet rassemble des documents de référence, des instructions personnalisées et les conversations qui vont avec. C'est là que vous rangez le contexte d'un sujet. À ne pas confondre avec le fichier
CLAUDE.md, qui sert à donner des instructions à Claude Code dans un dépôt de code. - Skills (compétences)
- Des fichiers
SKILL.mdqui expliquent à Claude comment mener une tâche précise, étape par étape. Claude les lit quand la tâche s'y prête. Claude Code en embarque d'ailleurs une,plugin-authoring, qui lui apprend à écrire des mods. - Plugins
- Le format de distribution. Un plugin peut contenir des skills, des commandes, des agents, des serveurs MCP, des hooks et des mods. Il s'installe depuis une marketplace avec la commande
/plugin. - Mods
- Du code exécutable, rangé dans un plugin. Claude Code appelle ses fonctions quand un événement se produit (un prompt envoyé, un appel d'outil, un élément d'interface à dessiner) et le mod peut observer, modifier ou remplacer ce qui se passe.
| Composant | Ce que c'est | Peut dessiner dans l'interface | Exemple en solo | Exemple en équipe |
|---|---|---|---|---|
| Projet (claude.ai) | Contexte, documents et instructions | Non | Garder les notes d'un site perso | Partager le cahier des charges d'une application |
| Skill | Instructions en Markdown lues par Claude | Non | Formater un rapport de bug toujours de la même façon | Faire respecter une convention de nommage |
| Hook de configuration | Script, requête HTTP ou prompt déclaré dans settings.json |
Non | Lancer un formateur après chaque modification | Journaliser les commandes exécutées |
| Plugin | Paquet qui regroupe les autres briques | Seulement via un mod | Installer un ensemble d'outils de la communauté | Distribuer un environnement commun via une marketplace interne |
| Mod | Fonctions JS/TS exécutées dans Claude Code | Oui | Ajouter un panneau ou une commande sur mesure | Bloquer les commandes Git destructrices |
| Si une skill, un hook de configuration ou un serveur MCP fait déjà ce dont vous avez besoin, inutile d'écrire un mod. | ||||
Comment fonctionne un mod ?
Pour comprendre les mods, il faut regarder la boucle de Claude Code. À chaque fois que vous envoyez un message, que Claude appelle un outil ou qu'une partie de l'écran est dessinée, un événement est émis. Un mod s'accroche à ces événements. Claude Code exécute sa fonction avant d'agir, et c'est elle qui décide de la suite. Elle peut :
- observer l'événement et le laisser passer tel quel ;
- le réécrire avant qu'il continue (modifier un prompt, ajouter du texte au spinner) ;
- y répondre elle-même, et l'action normale n'a alors pas lieu (refuser une commande, par exemple).
La différence avec les hooks classiques est importante. Un hook de configuration lance un script externe à un moment donné. Un mod tourne dans le processus de Claude Code. Il peut garder des données en mémoire d'un événement à l'autre, dessiner un panneau à côté de la conversation ou un bandeau au-dessus du prompt, mettre un appel d'outil en attente pour vous poser une question, ou ajouter une commande /quelquechose qui s'exécute tout de suite, même pendant que Claude travaille.
Un exemple de code tout simple
Un petit mod tient en trois fichiers : le manifeste .claude-plugin/plugin.json, le fichier hooks/hooks.json qui indique où se trouve le code, et le code lui-même, hooks/register.js. Voici l'exemple de la documentation officielle, que j'ai commenté en français. Il compte les appels d'outils de Claude et affiche ce nombre à côté du spinner.
// Le compteur, partagé par les deux hooks
let calls = 0
// Claude Code appelle cette fonction au chargement du mod
export function register(on) {
// Avant chaque utilisation d'un outil par Claude
on('tool.call', async ($, e, next) => {
calls += 1
// Demande à Claude Code de redessiner l'interface
$.ui.invalidate('ui.render')
// L'outil s'exécute normalement
return next(e)
})
// À chaque fois que le spinner est dessiné
on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
// On garde le spinner d'origine et on ajoute le compteur
return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
})
}
Pendant que Claude travaille, le spinner affiche alors « Thinking · tool calls: 1… », puis 2, puis 3. Rien de spectaculaire, mais on voit bien le principe : un hook modifie une variable, un autre l'affiche.
Pas à l'aise avec TypeScript ? Ce n'est pas un problème. Décrivez ce que vous voulez dans une session Claude Code : grâce à sa skill plugin-authoring, Claude écrit le mod, l'installe et le recharge dans la session en cours.
Anthropic utilise déjà les mods pour ses propres fonctions
Le meilleur signe que les mods ne sont pas un gadget, c'est qu'Anthropic s'en sert pour Claude Code lui-même. La commande /diff et son panneau sont devenus un mod. L'idée est de réduire le cœur de l'outil et de laisser chacun ajouter ce dont il a besoin. Dans /plugin, onglet Installed, les mods intégrés apparaissent sous Built-in :
| Nom dans /plugin | Rôle |
|---|---|
cc-plugin-diff |
Prend en charge /diff et dessine son panneau |
cc-plugin-agents-md |
Charge le fichier AGENTS.md comme instructions de projet |
cc-plugin-plugin-authoring |
Fournit la skill qui apprend à Claude à écrire des mods (pas de code de mod à l'intérieur) |
cc-plugin-sec-default |
Protège ce que gère votre organisation contre les mods installés par l'utilisateur |
cc-plugin-telemetry |
Envoie les données d'analyse de Claude Code et de ses mods intégrés |
cc-plugin-you-should-know |
Un agent secondaire qui affiche une note au-dessus du prompt quand il repère quelque chose que vous auriez pu manquer (désactivé par défaut) |
Le code source de diff, agents-md, sec-default et telemetry est public, dans le dossier mods du dépôt GitHub de Claude Code. C'est une bonne base pour apprendre.
Où les mods fonctionnent-ils ?
Au lancement, on parlait du terminal et de l'application de bureau. Depuis, l'extension VS Code s'est ajoutée. Il faut quand même distinguer deux choses : l'exécution des hooks d'un mod et l'affichage de ce qu'il dessine.
| Environnement | Les hooks s'exécutent | L'interface du mod s'affiche |
|---|---|---|
claude dans un terminal (y compris le terminal d'un éditeur et le plugin JetBrains) |
Oui | Oui |
| Onglet Code de Claude Desktop (version 2.1.286 ou plus) | Oui | Oui, sauf les éléments réservés au terminal |
| Session WSL dans Claude Desktop | Non | Non |
| Extension VS Code | Oui | Oui, à partir de la version 2.1.299 de l'extension |
claude -p et Agent SDK |
Oui | Non |
| Session cloud | Oui, si le plugin est présent dans la session | Non |
Dans le terminal, la commande claude --version vous indique si vous avez au moins la version 2.1.287. |
||
Sécurité et permissions : ce qu'il faut savoir
Toute cette liberté a un prix, et je préfère être clair : un mod s'exécute avec vos droits d'utilisateur, sans bac à sable.
Le sandboxing de Claude Code, si vous l'avez activé, n'isole que les commandes Bash lancées par Claude. Un processus démarré par un mod tourne en dehors. Concrètement, une fois chargé, un mod peut :
- lire et écrire des fichiers partout où votre compte a accès, lancer des programmes et faire des requêtes réseau ;
- lire vos variables d'environnement et vos fichiers de configuration, y compris une clé API ;
- voir chacun de vos prompts et chaque appel d'outil, et les réécrire ;
- approuver un appel d'outil avant même que la question vous soit posée ;
- appeler un modèle sur votre forfait ou votre clé API, donc consommer votre quota.
Les mods interviennent aussi dans les règles de permission. Un mod qui approuve des appels d'outils peut valider une action qu'une règle ask vous aurait demandé de confirmer. Pour les règles deny, tout dépend de la présence du garde-fou sec-default. Il est chargé avant les mods de l'utilisateur sur les comptes Team et Enterprise ainsi que sur les machines aux paramètres gérés par une organisation. Sur une installation personnelle Pro ou Max, il n'est pas là par défaut. Seule limite rassurante : un mod peut changer l'apparence d'une grande partie de l'interface, mais pas celle de la fenêtre de demande de permission.
N'installez jamais un mod d'origine inconnue sans avoir lu son code. Sur une machine personnelle, interdire à Claude Code de lire votre fichier .env n'empêchera pas un mod malveillant de le lire par ses propres moyens.
Anthropic fournit heureusement quelques outils pour garder la main :
- claude plugin validate
- Lancée sur le dossier d'un plugin, cette commande liste les événements que le mod intercepte (lignes
hooks:) et ce qu'il demande à Claude Code de faire, comme lire un fichier ou accéder au réseau (lignescalls:), sans exécuter une seule ligne de son code. C'est possible parce qu'un mod doit passer par l'API des mods pour toute action extérieure. - allowManagedModsOnly
- Ce paramètre géré permet à un administrateur de n'autoriser que les mods validés par l'organisation. Le reste du plugin (skills, commandes, serveurs MCP) continue de se charger.
- --safe-mode
- Lancez Claude Code avec cette option pour désactiver tous les mods installés le temps d'une session. Attention, elle désactive aussi vos autres personnalisations.
- disableAllHooks
- Avec
"disableAllHooks": truedans~/.claude/settings.json, vos mods sont coupés dans toutes les sessions, ainsi que vos hooks de configuration et votre barre d'état personnalisée. Ce que gère votre organisation continue de tourner.
Aucun de ces interrupteurs (ni --safe-mode, ni disableAllHooks) ne coupe les mods intégrés. Ceux-là se désactivent un par un dans /plugin. Et si vous aviez défini la variable CLAUDE_CODE_ENABLE_FUNCTION_HOOKS pendant la phase de test, supprimez-la : elle est ignorée depuis la version 2.1.287, la mettre à 0 ne bloque donc rien.
Des exemples concrets
Les mods d'exemple d'Anthropic
Anthropic partage plusieurs mods complets dans le dossier claude-code/mods du dépôt claude-code-playground. Ils sont fournis tels quels, sans support, mais chacun a un README qui explique comment il a été construit.
- Blast Radius : quand Claude veut lancer une commande à risque, comme un
rm -rfou ungit push --force, le mod la met en attente. Il affiche ce que la commande changerait, avec des boutons pour continuer ou annuler. Le genre de filet qu'on aimerait avoir avant chaque fausse manipulation. - token-weather : une « météo » de votre fenêtre de contexte, affichée au-dessus du prompt.
- replay-theater : ajoute une commande
/replaypour revoir, une par une, les modifications de fichiers faites par Claude au dernier tour.
Le mod de veille d'IT-Connect
Un autre exemple m'a plu par son côté pratique. Florian Burnel, cofondateur d'IT-Connect, a demandé à Claude Code d'écrire un mod qui affiche les derniers articles du site sans quitter le terminal. Voici les fichiers générés :
| Fichier | Rôle |
|---|---|
.claude-plugin/plugin.json |
Le manifeste : nom, version, description du plugin |
hooks/hooks.json |
Indique le fichier de code à charger |
hooks/register.tsx |
Le cœur du mod : la commande /itconnect, l'horloge et l'interface |
hooks/feed.ts |
Lecture du flux RSS et extraction des articles |
types/index.d.ts |
La description des données gardées pendant la session (articles, filtre actif…) |
tests/it-connect-news.test.tsx |
Les tests automatisés, lancés avec claude plugin test |
README.md |
La documentation : fonctions, installation, accès utilisés |
La commande /itconnect ouvre un panneau avec les derniers titres, et les articles parus depuis la dernière consultation sont signalés. Le mod vérifie aussi le flux de lui-même à intervalles réguliers. Selon la largeur de la fenêtre, le panneau s'affiche à côté de la conversation ou au-dessus du prompt. Ce que je retiens surtout, c'est le passage par claude plugin validate avant activation : on y voit une seule requête réseau vers le flux, un espace de stockage pour les articles déjà vus, l'interface et l'horloge. Rien d'autre. C'est exactement le réflexe à prendre. Et rien ne vous empêche de faire la même chose avec le flux RSS de vos sites préférés.
Installer et tester un mod
Un mod s'installe comme n'importe quel plugin, depuis une marketplace. On donne le nom du plugin, un @ et le nom de la marketplace :
- dans une session Claude Code :
/plugin install nom-du-mod@marketplace; - depuis le terminal :
claude plugin install nom-du-mod@marketplace.
Si vous installez un mod depuis le terminal alors qu'une session est déjà ouverte, tapez /reload-plugins dans cette session pour le charger. Sinon, il sera chargé au prochain lancement.
Pour un mod que vous avez sur votre disque (un clone de dépôt, ou un mod écrit par Claude), deux méthodes :
- Pour une seule session : depuis le terminal, et pas depuis une session déjà ouverte, lancez
claude --plugin-dir ~/claude-mods/mon-mod. - Pour toutes les sessions : ajoutez le chemin dans
~/.claude/settings.json:{ "env": { "CLAUDE_CODE_PLUGIN_DIRS": "~/claude-mods/mon-mod" } }.
Pour vérifier qu'un mod est bien chargé, tapez /plugin : une ligne discrète sous les onglets indique le nombre de mods actifs et leurs noms, par exemple « 1 mod active · mon-mod ». Les mods intégrés n'y figurent pas.
Ma routine avant d'activer un mod que je n'ai pas écrit : je récupère ses fichiers, je lance claude plugin validate dessus, je lis les lignes calls:, et je le teste d'abord pour une seule session avec --plugin-dir.
Questions fréquentes
- Faut-il savoir programmer pour utiliser les mods ?
- Non. Vous pouvez installer des mods existants, ou décrire ce que vous voulez à Claude Code, qui écrira le mod pour vous. Savoir lire un peu de code reste utile pour contrôler ce qu'il fait.
- Quelle version de Claude Code faut-il ?
- La version 2.1.287 au minimum dans le terminal, et la 2.1.286 pour l'onglet Code de Claude Desktop. Dans l'application, la commande
/statusaffiche la version utilisée. - Les mods sont-ils actifs sans rien faire ?
- Le mécanisme est activé par défaut, et les mods intégrés comme
/difftournent déjà. Un mod tiers, lui, ne se charge que si vous l'avez installé. - Un mod peut-il lire mes clés API ?
- Oui. Il a accès à vos variables d'environnement et à vos fichiers de configuration. C'est pour ça qu'il faut n'installer que des mods de sources de confiance, et les auditer avec
claude plugin validate. - Comment désactiver un mod qui pose problème ?
- Désactivez ou désinstallez son plugin dans l'onglet Installed de
/plugin. Pour tout couper le temps d'une session, relancez Claude Code avec--safe-mode.
Conclusion
Avec les mods, Claude Code devient un outil qu'on peut vraiment modeler. On peut intercepter ses événements, changer son interface, ajouter ses propres commandes, et Anthropic montre l'exemple en transformant ses propres fonctions en mods. Que vous vouliez sécuriser vos commandes shell, suivre votre consommation de contexte ou brancher votre veille, les possibilités sont larges.
Mais un mod, c'est du code qui tourne avec vos droits. Commencez par les exemples d'Anthropic, prenez l'habitude de passer chaque mod par claude plugin validate, et gardez --safe-mode en tête en cas de souci. Une fois ces réflexes pris, laissez Claude vous aider à construire l'environnement qui vous convient.
Comment cet article a-t-il été réalisé ? Le texte a été rédigé par mes soins, puis relu avec l'aide d'une intelligence artificielle afin de corriger d'éventuelles erreurs d'orthographe ou de grammaire. L'illustration de présentation a également été créée à l'aide de l'IA.