SpyBara
Go Premium

plugins/mods/overview.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 56 additions and 56 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Tue 6 23:59 Thu 8 22:58 Wed 14 22:58 Thu 15 23:58 Mon 19 23:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59

Aperçu des mods

Ajoutez des volets, des commandes et des règles d'appel d'outils à Claude Code avec un mod. Découvrez ce qu'un mod peut faire, comment en créer ou en installer un, et où les mods s'exécutent.

Un mod est un plugin qui change l'apparence et le comportement de Claude Code. Il est composé de gestionnaires d'événements JavaScript ou TypeScript : Claude Code en appelle un quand un événement se produit, comme un appel d'outil, une invite soumise, ou une partie de l'interface en cours de dessin, et le gestionnaire peut observer l'événement, le modifier, ou le reprendre. Utilisez un mod pour ajouter votre propre fonctionnalité à Claude Code, comme un volet qui affiche le graphique de la saturation de votre contexte après chaque requête. Pour les fichiers d'un mod et un exemple complet, voir Comment fonctionne un mod.

[!NOTE]

Les hooks existants de Claude Code s'exécutent également sur des événements, en tant que commande shell, requête HTTP ou invite que vous configurez dans un fichier de paramètres. Les gestionnaires d'un mod sont des fonctions qui s'exécutent à l'intérieur de Claude Code à la place. Claude Code appelle les deux types de hooks : sur ces pages, « hook » signifie le gestionnaire d'un mod, et le type de fichier de paramètres est un « settings hook ».

Ce qu'un mod peut faire

Les settings hooks, les skills, les lignes d'état et les serveurs MCP fonctionnent en dehors de Claude Code : chacun exécute un script, ou donne à Claude du texte ou des outils. Un mod s'exécute à l'intérieur de Claude Code, il peut donc faire des choses qu'ils ne peuvent pas :

  • Dessiner une interface que vous pouvez utiliser : un volet à côté de la transcription ou une bande au-dessus de l'invite, avec des onglets, des boutons et des champs de texte. Voir Dessiner dans l'interface.
  • Redessiner la propre interface de Claude Code : remplacer ou remodeler les parties que Claude Code dessine lui-même, comme la ligne d'un appel d'outil, le spinner, ou la boîte de dialogue dans laquelle Claude pose des questions. Voir Modifier ce que Claude Code dessine déjà.
  • Intervenir dans un appel d'outil ou une requête : par exemple, maintenir un appel d'outil pendant que vous posez une question à l'utilisateur, y répondre sans exécuter l'outil, ou envoyer une requête à un modèle différent. Voir Garder ou modifier un appel d'outil et Suivre un tour.
  • Exécuter votre propre code sur une commande : une /command qui exécute votre fonction immédiatement, sans tour Claude, même pendant que Claude travaille. Voir Ajouter une commande ou un outil.
  • Partager des données entre les hooks : les hooks d'un mod partagent les variables de son fichier, donc ce qu'un hook enregistre, un autre peut l'afficher. Par exemple, un hook peut compter les appels d'outils tandis qu'un autre affiche le compte à côté du spinner, ou l'un peut lire l'utilisation des tokens de chaque requête tandis qu'un autre la représente graphiquement dans un volet. Voir Réagir aux événements.

Les mods fonctionnent dans le CLI Claude Code, dans l'onglet Code de l'application Claude Desktop et dans l'extension VS Code. Voir Où les mods s'exécutent pour comprendre comment ils se comportent ailleurs, comme dans claude -p et les sessions cloud. Si un hook de paramètres, un skill ou un serveur MCP fait déjà ce dont vous avez besoin, comparez-les avant d'écrire un mod. Pour gérer les mods d'une organisation, voir Gérer les mods de votre organisation.

Obtenir un mod

Pour commencer avec un mod :

Installer ou mettre à jour un mod

[!WARNING]

Un mod est du code qui s'exécute avec vos permissions. Il peut lire et écrire vos fichiers, démarrer des processus et faire des requêtes réseau. Installez les mods uniquement à partir d'auteurs et de marketplaces en qui vous avez confiance. Voir Décider si vous faites confiance à un mod.

Un mod s'installe en tant que plugin, à partir d'une marketplace. Donnez le nom du plugin, un @, et le nom de la marketplace. Ces exemples installent un plugin nommé token-chart à partir d'une marketplace nommée your-org :

  • Dans une session Claude Code, exécutez /plugin install token-chart@your-org.
  • Dans votre shell, exécutez claude plugin install token-chart@your-org.

Installer les plugins couvre les marketplaces, les portées, l'extension VS Code et l'application Desktop, et garder les plugins à jour, qui s'appliquent tous à un plugin contenant un mod sans modifications.

Si vous installez ou mettez à jour un mod à partir de votre shell pendant qu'une session est ouverte, exécutez /reload-plugins dans cette session pour le charger. Sinon, il se charge la prochaine fois que vous démarrez Claude Code.

Essayer un mod d'exemple

Anthropic partage des mods d'exemple dans le répertoire claude-code/mods du dépôt claude-code-playground. Chacun est un plugin complet, et son README explique comment il a été construit. Le dépôt les partage tels quels, sans support.

  • token-weather : dessine une prévision de votre fenêtre de contexte au-dessus du prompt
  • blast-radius : retient une commande shell risquée, comme rm -rf ou un force push, et montre ce qu'elle modifierait, avec des boutons pour continuer ou annuler
  • replay-theater : ajoute une commande /replay qui parcourt pas à pas les modifications de fichiers effectuées par Claude lors du dernier tour

Un mod d'exemple s'exécute avec vos permissions. Pour voir ce qu'il fait avant de le charger, listez ses hooks et ses appels.

Pour en essayer un, clonez le dépôt et chargez le répertoire du mod pour une session avec --plugin-dir. Pour confirmer que le mod a été chargé, vérifiez quels mods la session a chargés.

Pour en conserver un, ajoutez le répertoire claude-code/mods du clone en tant que marketplace, puis installez le mod à partir de claude-code-playground-mods. La marketplace pointe vers votre clone, donc le mod cesse de se charger si vous le déplacez ou le supprimez.

Décider si vous faites confiance à un mod

Un mod est du code qui s'exécute avec vos permissions, à l'intérieur de Claude Code. Installez les mods uniquement à partir d'auteurs et de marketplaces en qui vous avez confiance.

Ce qu'un mod peut atteindre

Un mod s'exécute avec vos permissions, donc avant d'en installer un, sachez ce à quoi il a accès. Une fois qu'il se charge, un mod peut :

  • Agir sur votre machine en tant que vous : lire et écrire des fichiers n'importe où où votre compte utilisateur peut, démarrer des programmes et faire des requêtes réseau
  • Lire vos secrets : les variables d'environnement et les fichiers de paramètres, y compris une clé API que vous gardez dans l'un ou l'autre
  • Voir votre session : chaque prompt que vous envoyez et chaque appel d'outil que Claude fait
  • Modifier votre session : réécrire un prompt ou un appel d'outil, soumettre un prompt comme si vous l'aviez tapé, ou envoyer un message à une autre de vos sessions
  • Agir sans vous demander : approuver un appel d'outil avant que la question ne vous soit posée
  • Dépenser votre utilisation : appeler un modèle sur votre plan ou clé API

Les mods ne sont pas isolés dans un sandbox. Si vous activez le sandboxing, le sandbox isole les commandes Bash que Claude exécute, et un processus qu'un mod démarre s'exécute en dehors de celui-ci.

Avec des paramètres gérés ou un /login Team ou Enterprise comme identifiants de la session, par défaut, l'approbation d'un mod ne permet pas à un appel de contourner vos règles ask ni vos hooks PreToolUse. Sans l'un ni l'autre, un mod peut approuver un appel pour lequel une règle ask vous demanderait confirmation, ou que votre hook PreToolUse a bloqué. Pour vérifier quand un mod peut également approuver un appel qu'une règle deny refuse, consultez Étendre les permissions avec les hooks.

Un mod peut remodeler une grande partie de l'interface de Claude Code, mais pas la demande de permission. Il ne peut pas modifier ce qu'une demande vous montre.

Énumérer ce qu'un mod fait avant de l'installer

Avant d'installer un mod, vous pouvez énumérer les événements qu'il gère et ce qu'il demande à Claude Code de faire, comme lire un fichier ou faire une requête réseau, sans l'exécuter. Obtenez d'abord les fichiers du plugin, par exemple en clonant son dépôt. Ensuite, dans votre shell, exécutez claude plugin validate sur le répertoire du plugin :

claude plugin validate ./some-mod

Les lignes hooks: et calls: dans la sortie énumèrent les événements que le mod gère et ce qu'il demande à Claude Code de faire. Examiner ce qu'un mod peut faire montre la sortie et les appels à rechercher.

Activer ou désactiver les mods

Les mods sont activés par défaut. Dans le terminal, utilisez Claude Code v2.1.287 ou version ultérieure. L'application Desktop inclut sa propre copie de Claude Code, et les mods y fonctionnent à partir de la v2.1.286. Vérifiez la version à l'endroit où vous utilisez les mods :

  • Terminal : dans votre shell, exécutez claude --version. Si la vôtre est plus ancienne, mettez à jour Claude Code.
  • Application Desktop : dans une session locale de l'onglet Code, saisissez /status et lisez la ligne Claude Code, qui affiche une version telle que 2.1.286. Si la vôtre est plus ancienne, mettez à jour l'application Desktop.

Pour désactiver les mods, choisissez combien en arrêter et pour combien de temps. Pour les réactiver, annulez le même changement :

  • Un mod : désactivez ou désinstallez son plugin à partir de l'onglet Installé dans /plugin
  • Chaque mod installé, pour une session : démarrez Claude Code avec --safe-mode, qui désactive également vos autres personnalisations
  • Chaque mod que vous avez installé, dans chaque session : définissez "disableAllHooks": true dans ~/.claude/settings.json. Vos settings hooks et votre barre de statut personnalisée s'arrêtent aussi. Ce que votre organisation gère continue de fonctionner.

Si vous utilisez Claude Code via une organisation, un administrateur peut également limiter les mods qui se chargent. Les administrateurs commencent à Empêcher les mods installés par l'utilisateur de se charger.

disableAllHooks et allowManagedModsOnly de votre organisation arrêtent un mod et laissent le reste de son plugin en place : le plugin reste installé, et ses skills, commandes, agents et serveurs MCP se chargent. D'autres paramètres et flags vont plus loin. disableAllHooks et Ce qui s'exécute sous allowManagedHooksOnly indiquent l'effet de chacun sur un plugin et ses settings hooks.

Pour savoir si les mods peuvent se charger pour vous, voir Vérifier si les mods peuvent se charger.

[!NOTE]

Si vous avez défini CLAUDE_CODE_ENABLE_FUNCTION_HOOKS lors de l'accès anticipé, supprimez-le. Claude Code v2.1.287 et versions ultérieures l'ignorent, donc le définir à 0 ne garde pas les mods désactivés.

Voir quels mods une session a chargés

Pour voir quels mods une session de terminal a chargés, exécutez /plugin à l'invite Claude Code. Une ligne atténuée sous les onglets donne le compte et les noms, comme 1 mod active · first-mod. Si un mod que vous avez installé n'est pas nommé là, voir Découvrir pourquoi un mod ne fait rien.

Comment fonctionne un mod

Un mod est un plugin dont le code enregistre les gestionnaires d'événements, appelés hooks. Claude Code exécute un hook quand son événement se produit, comme quand Claude appelle un outil ou quand le spinner est dessiné. Un petit mod a trois fichiers :

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

Ceci est un register.js complet. Il compte les appels d'outils que Claude fait et affiche le compte à côté du spinner pendant que Claude travaille, comme dans Thinking · tool calls: 3….

// The count, shared by the two hooks below
let calls = 0

// Claude Code calls this once when the mod loads
export function register(on) {
  // Runs each time Claude is about to use a tool
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Ask Claude Code to draw the interface again, so the new count shows
    $.ui.invalidate('ui.render')
    // Let the tool run as usual
    return next(e)
  })

  // Runs each time Claude Code draws the spinner
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Keep Claude Code's spinner, with the count added after its word
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

Le fichier enregistre deux hooks, et les deux utilisent la variable calls en haut :

  • Le hook tool.call s'exécute chaque fois que Claude est sur le point d'utiliser un outil. Il ajoute un à calls, demande à Claude Code de redessiner l'interface, et laisse l'outil s'exécuter comme d'habitude.
  • Le hook ui.render s'exécute chaque fois que Claude Code dessine le spinner. Il garde le propre spinner de Claude Code et ajoute le compte après le mot.

Cet enregistrement montre le mod en action. Regardez la ligne du spinner au-dessus de la zone de prompt : pendant que Claude énumère un répertoire et lit deux fichiers, il lit Thinking · tool calls: 1…, puis 2…, puis 3….