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.md qui 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.
Comparatif des briques de personnalisation de Claude Code
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 :

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 :

Les mods intégrés à Claude Code
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.

Comportement des mods selon l'endroit où tourne Claude Code
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 :

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 (lignes calls:), 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": true dans ~/.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.

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 :

Structure du mod de veille IT-Connect
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 :

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 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 /status affiche 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 /diff tournent 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.