> ## Documentation Index > Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 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](/docs/fr/plugins/overview) 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](#how-a-mod-works). Les [hooks](/docs/fr/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](/docs/fr/plugins/mods/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à](/docs/fr/plugins/mods/interface#change-what-claude-code-already-draws). * **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](/docs/fr/plugins/mods/events#guard-or-change-a-tool-call) et [Suivre un tour](/docs/fr/plugins/mods/events#follow-a-turn). * **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](/docs/fr/plugins/mods/api#add-a-command-or-a-tool). * **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](/docs/fr/plugins/mods/events). Les mods fonctionnent dans le CLI Claude Code et dans l'onglet Code de l'application Claude Desktop. Voir [Où les mods s'exécutent](#where-mods-run) pour comprendre comment ils se comportent ailleurs, comme dans l'extension VS Code, `claude -p`, et les sessions cloud. Si un settings hook, une skill, ou un serveur MCP fait déjà ce dont vous avez besoin, [comparez-les](#compare-mods-settings-hooks-skills-and-mcp-servers) avant d'écrire un mod. Pour gérer les mods d'une organisation, voir [Gérer les mods de votre organisation](/docs/fr/plugins/mods/admin).

Obtenir un mod

Vous pouvez commencer avec un mod de trois façons : * **Utiliser un que vous avez déjà** : certaines des propres fonctionnalités de Claude Code sont des mods, comme `/diff`. Voir [Mods intégrés à Claude Code](#mods-built-into-claude-code). * **En créer un** : décrivez ce que vous voulez dans une session Claude Code, et Claude écrit le mod. Voir [Demander un mod à Claude](/docs/fr/plugins/mods/create#ask-claude-for-a-mod). Pour apprendre comment fonctionne le code d'un mod, [écrivez-en un vous-même](/docs/fr/plugins/mods/create#write-a-mod-yourself). * **En installer un** : voir [Installer ou mettre à jour un mod](#install-or-update-a-mod)

Installer ou mettre à jour un mod

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](#decide-whether-to-trust-a-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](/docs/fr/plugins/install) couvre les marketplaces, les scopes, l'extension VS Code et l'application Desktop, et [garder les plugins à jour](/docs/fr/plugins/install#keep-plugins-updated), 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.

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](/docs/fr/plugins/security).

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 invite que vous envoyez et chaque appel d'outil que Claude fait * **Modifier votre session** : réécrire une invite ou un appel d'outil, soumettre une invite comme si vous l'aviez tapée, ou envoyer un message à une autre de vos sessions * **Agir sans vous demander** : approuver un appel d'outil avant que vous ne soyez invité * **Dépenser votre utilisation** : appeler un modèle sur votre plan ou clé API Un mod qui approuve les appels d'outils peut approuver un appel qu'une règle `ask` demanderait, ou qu'un de vos propres hooks `PreToolUse` a bloqué. [Étendre les permissions avec les hooks](/docs/fr/permissions#extend-permissions-with-hooks) énumère ce qu'un tel mod peut approuver, y compris quand il peut approuver un appel qu'une règle `deny` refuse. Un mod peut remodeler une grande partie de l'interface de Claude Code, mais pas l'invite de permission. Il ne peut pas modifier ce qu'une invite 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 sur lesquels il se branche 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 référentiel. Ensuite, dans votre shell, exécutez `claude plugin validate` sur le répertoire du plugin : ```bash theme={null} 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](/docs/fr/plugins/mods/admin#review-what-a-mod-can-do) montre la sortie et les appels à rechercher.

Activer ou désactiver les mods

Les mods nécessitent Claude Code v2.1.287 ou version ultérieure, et ils sont activés par défaut. Dans votre shell, exécutez `claude --version` pour vérifier, et mettez à jour Claude Code si le vôtre est plus ancien. 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`](/docs/fr/plugins/install#manage-installed-plugins) * **Chaque mod installé, pour une session** : démarrez Claude Code avec [`--safe-mode`](/docs/fr/cli-reference#cli-flags), qui laisse également de côté vos autres personnalisations * **Chaque mod que vous avez installé, dans chaque session** : définissez [`"disableAllHooks": true`](/docs/fr/settings-reference#disableallhooks) dans `~/.claude/settings.json`. Vos settings hooks et votre ligne d'état 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](/docs/fr/plugins/mods/admin#stop-user-installed-mods-from-loading). Pour savoir si les mods peuvent se charger pour vous, voir [Vérifier si les mods peuvent se charger](/docs/fr/plugins/mods/troubleshoot#check-whether-mods-can-load). 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](/docs/fr/plugins/mods/troubleshoot#find-out-why-a-mod-does-nothing).

Comment fonctionne un mod

Un mod est un [plugin](/docs/fr/plugins/overview) 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 : ```text theme={null} first-mod/ ├── .claude-plugin/ │ └── plugin.json └── hooks/ ├── hooks.json └── register.js ``` * **`plugin.json`** : le [manifeste](/docs/fr/plugins/manifest-reference) du plugin * **`hooks.json`** : [pointe vers votre fichier de code](/docs/fr/plugins/mods/reference#files) * **`register.js`** : [votre code](/docs/fr/plugins/mods/create#write-a-mod-yourself), appelé le module hooks. Il dit à Claude Code sur quels événements exécuter vos fonctions. 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…`. ```javascript hooks/register.js theme={null} // Le compte, partagé par les deux hooks ci-dessous let calls = 0 // Claude Code appelle ceci une fois quand le mod se charge export function register(on) { // S'exécute chaque fois que Claude est sur le point d'utiliser un outil on('tool.call', async ($, e, next) => { calls += 1 // Demandez à Claude Code de redessiner l'interface, pour que le nouveau compte s'affiche $.ui.invalidate('ui.render') // Laissez l'outil s'exécuter comme d'habitude return next(e) }) // S'exécute chaque fois que Claude Code dessine le spinner on('ui.render', { component: 'Spinner' }, async ($, e, next) => { // Gardez le spinner de Claude Code, avec le compte ajouté après son mot 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`](/docs/fr/plugins/mods/reference#tools)** 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`](/docs/fr/plugins/mods/reference#interface)** 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 boîte d'invite : pendant que Claude énumère un répertoire et lit deux fichiers, il lit `Thinking · tool calls: 1…`, puis `2…`, puis `3…`.