Mods de Claude Code : les installer, les utiliser, les désactiver sans risque
Les mods sont des plugins avec des function hooks in-process capables de redessiner l'interface, d'ajouter des commandes et d'intercepter les appels d'outils. Ce guide couvre votre premier mod, la liste intégrée et les interrupteurs d'arrêt — chaque fait vérifié contre la documentation officielle.
En bref
- Les mods sont des plugins Claude Code qui embarquent un module de hooks — du JavaScript qui tourne dans Claude Code même et peut observer, réécrire ou répondre aux événements.
- Sur v2.1.287 ou plus récent, les mods marchent out of the box : installez avec /plugin install name@marketplace et le mod est actif après un redémarrage de la session.
- Le mod intégré You Should Know est opt-in : activez-le une fois avec /plugin enable cc-plugin-you-should-know@builtin.
- Pour vous en passer : désactivez un mod précis dans /plugin, démarrez avec --safe-mode pour une session, ou mettez "disableAllHooks": true pour garder tous les mods installés éteints.
Claude Mods Make Claude Code 10x More Powerful
Chaîne : Firecrawl4:40
Claude Code v2.1.287 — Claude Mods and Agent Plugins
Chaîne : Claude Code Changelog2:13
Mods overview — official docs (function hooks)
Docs : code.claude.com/docs
Les captures d'écran proviennent des deux vidéos ci-dessus ; seuls des segments d'écran propres et des slides typographiques de changelog ont été utilisés — les passages avec présentateur ont été écartés. Les faits sont vérifiés contre la documentation officielle des mods, pas contre les vidéos.
Les horodatages renvoient en lien direct vers les vidéos sources, pour que les créateurs reçoivent la visite. Claude Code est une marque d'Anthropic ; ce guide est indépendant et sans affiliation.
Installer et utiliser votre premier mod Claude Code
Comprendre ce qu'est un mod
- 1
Savoir ce que change un mod
Claude Code 2.1.287 introduit les mods : des plugins qui modifient le comportement profond de l'agent lui-même. Un mod peut réagir aux événements de session, garder son propre état et dessiner directement dans l'interface — un petit programme qui étend votre terminal, pas une instruction de plus pour le modèle.
Les notes de version v2.1.287 présentent les mods comme des plugins modifiant le comportement profond au sein de Claude Code.Voir à 0:30 - 2
Situer les mods parmi les autres couches d'extension
Les skills orientent le comportement du modèle, les serveurs MCP exposent des outils externes, les shell hooks exécutent des commandes aux événements du cycle de vie. Les mods sont la quatrième couche : du code qui tourne dans le processus, peut changer l'interface et intercepter des événements avant ou après coup. L'aide-mémoire sous le walkthrough compare les cinq couches.
- 3
Vérifier votre version de Claude Code
Les mods exigent Claude Code v2.1.287 ou plus récent, où ils sont activés par défaut. Vérifiez avec claude --version ; si vous êtes en retard, suivez notre guide de mise à jour de Claude Code et revenez. Certains mods peuvent demander des versions encore plus récentes.
Les notes v2.1.287 couvrent : Claude Mods, le plugin You Should Know, le filtrage d'agent view et la gestion des tâches en arrière-plan.Voir à 0:09
En installer un et le voir tourner
- 4
Passer l'ancien flag d'activation
Les anciens walkthroughs disent de définir CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 — c'était la preview en accès anticipé. Depuis la 2.1.287, les mods sont actifs par défaut et la variable est ignorée : vous pouvez la retirer de vos réglages. Rien d'autre n'est nécessaire pour activer les mods.
- 5
Installer un mod depuis un marketplace
Dans une session : /plugin install mod-name@marketplace ; depuis votre shell : claude plugin install mod-name@marketplace, puis /reload-plugins si une session est déjà ouverte. Avant d'installer du code tiers, vous pouvez le passer au crible avec claude plugin validate ./some-mod.
- 6
Lire ce qu'est réellement un mod
Un mod est un module de hooks : une entrée register(on) qui abonne des fonctions handler aux événements du moteur. Chaque handler reçoit l'API des mods, l'événement et une continuation next() — la forme d'un middleware Express : on peut observer, réécrire ou répondre à l'événement, puis le passer.
Le register.tsx d'un vrai mod : un handler on('ui.render') qui redessine le composant AbovePrompt avec une ligne de texte en plus.Voir à 2:35 - 7
Lancer la session et vérifier
Démarrez Claude Code et cherchez les preuves : les commandes slash propres au mod apparaissent dans la liste d'aide, et /plugin affiche une ligne comme "1 mod active" sous les onglets. Si rien n'apparaît, relisez les instructions du mod — les mods graphiques ne fonctionnent que dans le terminal et l'onglet Code de l'app desktop.
La commande /hello dans la liste d'aide vient d'un mod installé — les mods peuvent enregistrer des commandes personnalisées exécutées immédiatement, sans tour de Claude.Voir à 2:32
Les mods intégrés
- 8
Rencontrer les mods intégrés
Ouvrez /plugin et regardez la section Built-in : cc-plugin-agents-md charge AGENTS.md, cc-plugin-diff alimente le panneau /diff, cc-plugin-plugin-authoring est la skill d'authoring de plugins, cc-plugin-sec-default veille sur la politique d'org, et cc-plugin-telemetry gère l'analytics. Leur source vit dans le dossier mods du dépôt Claude Code.
- 9
Activer le mod You Should Know
You Should Know est l'agent auxiliaire intégré de Claude Code : une fois activé, il surveille votre session et signale ce qui vous a peut-être échappé. Il est livré désactivé — activez-le une fois avec /plugin enable cc-plugin-you-should-know@builtin et il reste actif pour les sessions suivantes.
La carte officielle you-should-know : un agent auxiliaire qui surveille votre session, activé avec /plugin enable cc-plugin-you-should-know@builtin.Voir à 0:48 - 10
Connaître les trois interrupteurs d'arrêt
Désactivez un mod précis dans l'onglet Installed de /plugin. Lancez claude --safe-mode pour une unique session sans mod. Ou mettez "disableAllHooks": true dans ~/.claude/settings.json pour garder tous les mods installés éteints jusqu'à ce que vous changiez ça. Les mods intégrés continuent de tourner dans les trois cas — c'est voulu.
Garder le contrôle
- 11
Respecter le modèle de sécurité
Les mods tournent avec vos permissions et sans sandbox : ils peuvent lire les variables d'environnement et les secrets, réécrire des prompts, pré-approuver des appels d'outils et dépenser votre quota. N'installez que des mods que vous accepteriez de faire tourner comme code brut sur votre machine, et auditez avec /plugin ce qu'une session a réellement chargé.
- 12
Savoir où les mods peuvent dessiner
L'UI des mods — panneaux à côté de la transcription, bandes au-dessus du prompt, onglets personnalisés — se rend dans le terminal et l'onglet Code de l'app desktop. Elle ne dessine pas dans les sessions WSL, le panneau de chat VS Code, les runs claude -p, l'Agent SDK ni les sessions cloud, et un mod peut restyler l'UI de Claude Code mais jamais le prompt de permission.
Mods vs plugins vs skills vs MCP vs hooks
Claude Code compte maintenant cinq couches d'extension, et les noms se brouillent vite. La version courte — où tourne le code et ce qu'il peut toucher :
- 1Les skills sont des paquets d'instructions markdown qui orientent le comportement du modèle à l'appel — sans exécuter de code propre.
- 2Les serveurs MCP relient des outils et sources de données externes via le Model Context Protocol — hors du processus, exposés comme outils.
- 3Les shell hooks sont des commandes issues de vos fichiers de réglages qui tournent aux événements du cycle de vie, comme avant ou après un appel d'outil.
- 4Les plugins empaquetent tout cela — commandes, agents, serveurs MCP, hooks — en un paquet installable.
- 5Les mods sont des plugins dont le module de hooks tourne dans le processus : des fonctions TypeScript capables de redessiner l'UI, d'intercepter des événements en plein vol et de garder un état entre les événements.
Règle empirique : les instructions vont dans les skills, les intégrations dans MCP, l'automatisation dans les shell hooks, l'emballage dans les plugins — et quand vous voulez changer l'apparence même de Claude Code ou l'issue d'un événement, c'est un mod.