Guide
Les hooks de Claude Code, expliqués : ce que c’est et ce que vous pouvez en faire
Réponse courte : Les hooks permettent à Claude Code d’exécuter votre commande quand un outil démarre, qu’il demande une autorisation ou qu’un tour se termine. Leur fonctionnement, et comment Herdbell les utilise.
Un hook est une petite commande qu’un agent exécute à un moment précis. Claude Code, Codex et Cursor les prennent tous en charge sous une forme ou une autre, et c’est la façon propre pour un autre programme de suivre ce que fait un agent, sans se connecter à quoi que ce soit ni lire l’écran.
L’idée en un paragraphe
Vous dites à l’agent : quand ceci arrive, lance cette commande. L’agent la lance et lui transmet une courte description de l’événement. La commande peut simplement l’enregistrer (pour envoyer une notification, par exemple) ou, pour certains événements, renvoyer une réponse que l’agent utilise.
Moments où l’on peut se brancher
Les noms d’événements et les réglages exacts varient selon les agents et les versions : consultez la documentation de chaque agent avant d’écrire le vôtre.
- Une session démarre ou se termine, ou vous envoyez un prompt.
- Un outil est sur le point de s’exécuter, ou vient de s’exécuter.
- L’agent demande l’autorisation de faire quelque chose.
- L’agent termine son tour (un événement Stop).
Où ils vivent
Dans un fichier de réglages : ~/.claude/settings.json pour Claude Code, ~/.codex/hooks.json pour Codex et ~/.cursor/hooks.json pour Cursor. Modifier ces fichiers à la main est tout à fait possible, et c’est aussi ainsi qu’un outil comme Herdbell se connecte.
Comment Herdbell les utilise
- À la connexion, Herdbell sauvegarde le fichier, puis ajoute sa propre petite commande pour les événements dont il a besoin.
- Pour la plupart des événements, il se contente d’écouter, afin de pouvoir montrer ce que fait l’agent.
- Pour une demande d’autorisation, il attend votre réponse et la renvoie, de sorte que Allow et Deny prennent effet. Pour une fin de tour, il peut garder l’agent ouvert pour que votre réponse retourne dans le même chat.
- Si vous ne répondez pas à temps, il s’efface et l’agent revient à sa propre demande. La déconnexion ne retire que les hooks de Herdbell.
Questions fréquentes
Les hooks nécessitent-ils une clé d’API ou une connexion ?
Non. Un hook est une commande locale sur votre Mac. Herdbell les utilise pour ne jamais avoir à se connecter à un agent ni à appeler un modèle d’IA.
Un hook peut-il casser mon agent ?
Un hook mal écrit peut le ralentir ou le dérouter, c’est pourquoi Herdbell sauvegarde d’abord vos réglages, garde ses hooks minimaux et s’efface quand vous ne répondez pas. Vous pouvez le déconnecter à tout moment.