Claude Code Hooks

Les Claude Code Hooks, Visualisés.

Les Claude Code hooks vous permettent d'exécuter des commandes shell déterministes à chaque événement clé du cycle de vie de Claude Code : avant l'utilisation d'un outil, après l'utilisation d'un outil, lorsqu'un prompt est soumis, lorsqu'un agent s'arrête ou lorsqu'une notification est envoyée. AgentsRoom est le centre de commande visuel qui vous permet de voir chaque hook se déclencher en temps réel, sur des dizaines d'agents Claude Code, dans des dizaines de projets.

Les hooks sont la méthode officielle d'Anthropic pour ajouter de l'automatisation déterministe, des garde-fous, des pistes d'audit et des effets de bord personnalisés à Claude Code. AgentsRoom ne remplace pas vos hooks. Il exécute le vrai CLI Claude Code, donc chaque hook que vous configurez dans .claude/settings.json continue de fonctionner exactement comme prévu. Ce qu'AgentsRoom ajoute, c'est la visibilité : un tableau de bord en direct où vous pouvez voir chaque déclenchement de hook, par agent, par projet, par exécution.

Qu'est-ce que les Claude Code hooks ?

Les Claude Code hooks sont des commandes shell définies par l'utilisateur que Claude Code exécute automatiquement à des points précis d'une session d'agent. Ils sont configurés dans .claude/settings.json (partagé, versionné dans git) ou .claude/settings.local.json (personnel, ignoré par git), et ils vous donnent un contrôle déterministe sur le comportement de vos agents Claude Code. Là où un prompt est probabiliste, un hook est déterministe à 100 % : il s'exécute à chaque fois que l'événement correspondant se produit, sans exception.

Les hooks sont la réponse d'Anthropic au besoin de garde-fous, d'automatisation, de télémétrie, de journalisation d'audit et d'intégrations personnalisées. Vous pouvez utiliser les Claude Code hooks pour formater automatiquement le code après chaque édition, bloquer les commandes dangereuses avant leur exécution, enregistrer chaque appel d'outil dans un fichier, envoyer une notification bureau lorsque l'agent attend une entrée, déclencher un job CI à la fin d'une session, ou streamer chaque prompt vers un backend d'observabilité. Toute commande shell que vous pouvez écrire, vous pouvez la brancher à un Claude Code hook.

Parce que les hooks vivent dans le projet lui-même (.claude/settings.json est versionné dans git), ils voyagent avec votre code. Chaque développeur de l'équipe, et chaque agent IA généré depuis ce projet, hérite du même filet de sécurité. AgentsRoom respecte ce modèle de bout en bout : l'application desktop ne réécrit pas vos hooks, elle exécute le vrai CLI Claude Code en tant que processus enfant, qui récupère automatiquement votre configuration de hooks, exactement comme si vous lanciez claude code depuis un terminal.

Les 6 Événements de Claude Code Hooks

Chaque session d'agent Claude Code déclenche des événements de hook à des points bien définis. Voici ce que chaque événement signifie et ce que vous pouvez en faire.

PreToolUse

Le hook PreToolUse se déclenche avant que Claude Code n'exécute un outil (Bash, Edit, Write, Read, Grep, etc.). C'est l'endroit idéal pour des garde-fous : bloquer les commandes dangereuses, exiger une confirmation pour les opérations destructrices, appliquer des règles spécifiques au projet, ou réécrire les arguments d'outil avant exécution. Retournez un code de sortie non nul depuis le hook pour bloquer entièrement l'appel d'outil. PreToolUse est le Claude Code hook numéro 1 pour les équipes soucieuses de la sécurité.

PostToolUse

Le hook PostToolUse se déclenche immédiatement après la fin de tout outil Claude Code. C'est ici que vous branchez le post-traitement automatique : exécuter un formateur (Prettier, Black, rustfmt) après chaque Edit, déclencher un linter après chaque Write, mettre à jour un changelog lorsqu'un fichier est modifié, ou pousser des événements de télémétrie. PostToolUse est le hook incontournable pour transformer Claude Code en un membre d'équipe discipliné qui laisse le code plus propre qu'il ne l'a trouvé.

UserPromptSubmit

Le hook UserPromptSubmit se déclenche à chaque fois qu'un nouveau prompt est envoyé à un agent Claude Code. Utilisez-le pour enregistrer chaque prompt à des fins d'audit et de conformité, réécrire les prompts à la volée (injecter du contexte, masquer des secrets), router les requêtes vers différents modèles, ou imposer des conventions de nommage. Combiné avec le tableau de bord multi-agents d'AgentsRoom, UserPromptSubmit vous donne une piste d'audit complète de chaque instruction envoyée à chaque agent Claude Code.

Stop

Le hook Stop se déclenche lorsqu'une session d'agent Claude Code se termine, soit parce que le travail est fait, soit parce qu'elle a été annulée. C'est le bon endroit pour exécuter des jobs de nettoyage, pousser un résumé final vers un système de suivi, committer des artefacts, ou notifier un humain que la session est terminée. AgentsRoom complète le hook Stop avec son propre système de notifications, vous êtes ainsi notifié à la fois par votre hook personnalisé et par les notifications push desktop + mobile d'AgentsRoom.

Notification

Le hook Notification se déclenche lorsque Claude Code envoie une notification système — généralement lorsque l'agent attend une entrée utilisateur ou a terminé une tâche longue. Utilisez-le pour router les notifications vers Slack, Discord, Telegram, un email, ou n'importe quel webhook de votre choix. AgentsRoom fait déjà remonter nativement les notifications Claude Code dans son tableau de bord multi-agents et sous forme de notifications push sur votre téléphone, le hook Notification est donc l'endroit parfait pour ajouter des intégrations personnalisées par-dessus.

SubagentStop

Le hook SubagentStop se déclenche lorsqu'un subagent Claude Code termine son travail et rend la main au parent. Si vous utilisez des Claude Code subagents définis dans .claude/agents/*.md pour déléguer des tâches spécialisées, SubagentStop vous permet de journaliser ce que chaque subagent a fait, d'agréger leurs sorties, ou de déclencher une étape de suivi. Dans AgentsRoom, les événements SubagentStop apparaissent dans la timeline en direct des agents pour que vous voyiez exactement quels subagents se sont exécutés dans chaque session Claude Code.

Pourquoi les Claude Code Hooks Sont Importants

Les hooks transforment Claude Code d'une IA impressionnante en un agent de code de qualité production sur lequel toute votre équipe peut compter.

Garde-fous de Sécurité Déterministes

Les prompts sont probabilistes et peuvent être contournés. Les Claude Code hooks sont des commandes shell déterministes qui s'exécutent toujours. Un hook PreToolUse peut bloquer n'importe quel rm -rf, n'importe quel push --force, n'importe quelle migration destructrice — peu importe comment l'agent formule son raisonnement. C'est le standard de référence pour les déploiements Claude Code critiques en matière de sécurité.

Automatisation Sans Effort

Branchez les Claude Code hooks à vos formateurs, linters, exécuteurs de tests, vérificateurs de types et scripts de build. Chaque édition que fait l'agent déclenche les mêmes vérifications que votre pipeline CI — localement, instantanément, automatiquement. Vos agents Claude Code deviennent des contributeurs auto-disciplinés qui n'oublient jamais de lancer le formateur.

Piste d'Audit Complète

Chaque prompt, chaque appel d'outil, chaque démarrage et arrêt de session peut être journalisé par les Claude Code hooks. Combinez cela avec la timeline visuelle d'AgentsRoom et vous obtenez une piste d'audit complète de chaque action d'agent IA de code — essentiel pour les équipes soumises à de fortes exigences de conformité, les entreprises soucieuses de la sécurité, et quiconque prend au sérieux le développement IA observable.

Conventions à l'Échelle de l'Équipe

Parce que .claude/settings.json est versionné dans git, un unique ensemble de Claude Code hooks impose les mêmes conventions à chaque développeur de l'équipe et à chaque agent IA généré depuis le projet. Les nouveaux membres de l'équipe héritent des garde-fous dès qu'ils clonent le dépôt. Mettez à niveau le comportement de toute votre équipe de code IA avec une seule pull request.

Observabilité des Hooks en Direct

Les Claude Code hooks produisent des événements. AgentsRoom transforme ces événements en un flux visuel : chaque déclenchement de hook, chaque appel d'outil, chaque changement de statut, streamé en direct par agent et par projet. Vous n'avez plus à surveiller les logs — vous regardez votre flotte Claude Code travailler en temps réel.

Passer de la Surveillance à la Supervision

Sans hooks, faire tourner Claude Code signifie surveiller chaque appel d'outil. Avec les hooks, vous déléguez la surveillance à du code déterministe et vous supervisez au niveau des exceptions. AgentsRoom amplifie cela : vous voyez tous vos agents Claude Code protégés par des hooks en même temps, et vous n'intervenez que lorsque quelque chose requiert votre attention.

Claude Code Hooks + AgentsRoom

AgentsRoom est le centre de commande visuel pour Claude Code et les autres CLI de code IA. Il ne forke pas Claude Code, il ne réimplémente pas les hooks, il n'intercepte pas les appels d'outil. Il exécute le vrai CLI Claude Code comme un processus enfant à l'intérieur d'un terminal xterm.js complet, ce qui signifie que chaque hook que vous avez défini dans .claude/settings.json ou .claude/settings.local.json s'exécute exactement comme Anthropic l'a conçu — pas de compromis, pas de surprise, aucun middleware invisible.

Ce qu'AgentsRoom ajoute, c'est l'échelle et la visibilité. Vous pouvez exécuter des dizaines d'agents Claude Code en parallèle, sur des dizaines de projets, chacun avec sa propre configuration de hooks, et voir chaque déclenchement de hook sur un seul tableau de bord. Combinés aux notifications par agent, à l'application compagnon mobile et au suivi de statut en temps réel d'AgentsRoom, les Claude Code hooks deviennent une couche d'observabilité de premier ordre pour l'ensemble de votre opération de code IA.

Exécute le Vrai CLI Claude Code

AgentsRoom lance de vrais processus claude CLI à l'intérieur de terminaux xterm.js complets. Tout hook configuré dans .claude/settings.json, .claude/settings.local.json ou dans les paramètres utilisateur se déclenche automatiquement, exactement comme si vous lanciez Claude Code depuis votre terminal. Aucun patching, aucune réécriture, aucune perte de fidélité.

Événements de Hook sur une Flotte Multi-Agents

Exécutez 10, 20, 50 agents Claude Code en parallèle avec les hooks activés. Le tableau de bord multi-agents d'AgentsRoom fait remonter simultanément les notifications déclenchées par hook et les changements de statut pour chaque agent. Vos garde-fous PreToolUse, vos formateurs PostToolUse et vos handlers Stop fonctionnent tous à l'échelle de la flotte.

Visibilité des Hooks Inter-Projets

Chaque projet dans AgentsRoom a son propre .claude/settings.json et donc sa propre configuration de Claude Code hooks. La barre latérale agrège le statut en direct à travers les projets pour que vous puissiez repérer quels hooks se déclenchent où, quels agents sont bloqués en attente d'une entrée utilisateur, et quels hooks Stop viennent de terminer une exécution.

Notifications Desktop + Mobile

AgentsRoom est livré avec des notifications macOS natives et des notifications push mobiles chiffrées de bout en bout. Les hooks Notification, Stop et SubagentStop de Claude Code produisent tous des signaux qu'AgentsRoom fait remonter directement sur votre bureau et votre téléphone. Vous pouvez vous éloigner de l'ordinateur et toujours savoir quand un hook vous demande de revenir.

FAQ Claude Code Hooks

Qu'est-ce que les Claude Code hooks, en une phrase ?+
Les Claude Code hooks sont des commandes shell définies par l'utilisateur que Claude Code exécute automatiquement sur des événements de cycle de vie spécifiques (PreToolUse, PostToolUse, UserPromptSubmit, Stop, Notification, SubagentStop), vous donnant un contrôle déterministe sur le comportement de vos agents IA de code.
Où sont configurés les Claude Code hooks ?+
Les Claude Code hooks vivent dans .claude/settings.json (versionné dans git, partagé avec l'équipe) ou .claude/settings.local.json (ignoré par git, personnel). Les deux fichiers sont automatiquement pris en compte par le CLI Claude Code. AgentsRoom exécute le vrai CLI Claude Code, il respecte donc les deux fichiers sans configuration supplémentaire.
AgentsRoom remplace-t-il les Claude Code hooks ?+
Non. AgentsRoom ne remplace pas, ne réécrit pas et n'intercepte pas les Claude Code hooks. Il exécute le vrai CLI Claude Code comme un processus enfant, ce qui signifie que vos hooks continuent de s'exécuter exactement comme Anthropic les a conçus. Le rôle d'AgentsRoom est de vous donner un centre de commande visuel et un tableau de bord multi-agents au-dessus des sessions Claude Code propulsées par des hooks.
Puis-je surveiller les événements de Claude Code hooks dans AgentsRoom ?+
Oui. AgentsRoom streame en direct la sortie de chaque session Claude Code, y compris les événements déclenchés par hook (sortie de formateur, rejets de garde-fous, messages de notification, arrêts de subagents). Le tableau de bord multi-agents agrège le statut de chaque agent en cours, pour que vous puissiez repérer d'un coup d'œil quels hooks se sont déclenchés où.
Quel est le Claude Code hook le plus utile pour commencer ?+
Pour la plupart des équipes, PostToolUse est le hook à plus forte valeur en premier : branchez-le à votre formateur et votre linter pour que chaque Edit soit instantanément nettoyée. Pour les projets critiques en sécurité, PreToolUse est indispensable : bloquez les commandes Bash destructrices avant que l'agent ne les exécute. Une fois ceux-ci en place, ajoutez UserPromptSubmit pour la journalisation d'audit et Stop pour la télémétrie de fin.
AgentsRoom est-il gratuit à utiliser avec les Claude Code hooks ?+
Oui. AgentsRoom est gratuit à télécharger et à utiliser avec jusqu'à 3 projets. Apportez votre propre abonnement Anthropic ou clé API. Chaque hook, chaque garde-fou PreToolUse, chaque formateur PostToolUse que vous avez configuré dans .claude/settings.json fonctionnera immédiatement — aucune configuration supplémentaire, aucun frais supplémentaire.

Voyez Vos Claude Code Hooks se Déclencher en Direct

Téléchargez AgentsRoom, ouvrez un projet avec des hooks .claude/settings.json, lancez un agent Claude Code, et regardez chaque événement de hook arriver dans le tableau de bord en temps réel.

GratuitTélécharger AgentsRoom

App companion : suivez vos agents en déplacement

Compatible avec Claude, Codex, OpenCode, Gemini CLI et Aider

Multi-projets
Multi-provider
Multi-agents
Statut en direct
Diff & commit
App mobile
Aperçu live