Chapitre 6 · Chapitre 6 · Bloquer, protéger, enrichir
6.4 Aperçu des hooks prompt, agent et http
Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.
Suivre gratuitementLes hooks command appliquent des règles fixes. Pour des décisions qui demandent du jugement, la documentation propose d'autres types.
Le hook prompt
Claude Code envoie ton texte et les données de l'événement à un modèle Claude, qui doit répondre {"ok": true} ou {"ok": false, "reason": "..."}. Exemple de la doc, sur l'événement Stop :
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "prompt",
"prompt": "Check if all tasks are complete. If not, respond with {\"ok\": false, \"reason\": \"what remains to be done\"}."
}
]
}
]
}
}
Si la réponse est ok: false, Claude continue de travailler en suivant la raison donnée. Tu peux écrire le prompt en français : « Vérifie que toutes les tâches demandées sont terminées. Sinon, réponds avec ok à false et la liste de ce qui reste. »
Le hook agent
Il lance un sous-agent capable de lire des fichiers ou de lancer des commandes avant de décider, par exemple « vérifie que les tests passent ». La doc le signale comme expérimental et recommande les hooks command pour un usage en production.
Le hook http
Il envoie les données de l'événement à une adresse web, par exemple un service qui centralise les journaux d'une équipe. Attention : tout ce que contient l'événement part alors vers ce service, y compris des chemins et parfois le contenu de fichiers. N'envoie jamais ces données vers une adresse que tu ne contrôles pas.
Les délais par défaut
La doc indique des délais différents selon le type : 10 minutes pour command, http et mcp_tool, 30 secondes pour prompt, 60 secondes pour agent. Le champ timeout (en secondes) permet de les ajuster.
Quand choisir quoi
- Une règle vérifiable par un programme (extension, nom de fichier, résultat d'un outil) : command.
- Une appréciation simple sur ce que Claude vient de faire : prompt.
- Une vérification qui demande d'explorer le projet : agent, en gardant en tête qu'il est expérimental.
- Transmettre l'événement à un service de ton équipe : http.
Un point de vigilance
Un hook prompt ou agent consomme des appels au modèle. Sur un événement fréquent comme PostToolUse, la consommation grimpe vite. Réserve-les aux moments rares et importants. Et contrairement à un hook command, leur décision n'est pas déterministe : un modèle peut se tromper ou varier d'une fois à l'autre.
Si ça coince
- Le hook prompt bloque Claude en boucle. Ton critère est trop strict ou flou. Rends-le précis et vérifiable.
- Le hook agent est lent. Il explore avant de décider : garde-le pour des moments rares, et ajuste
timeoutsi besoin. - Tu hésites sur la syntaxe d'un type. Vérifie dans la page « Hooks reference » : chaque type a ses propres champs.
À retenir
prompt: un modèle répond ok ou non ;agent: un sous-agent vérifie (expérimental) ;http: l'événement part vers une adresse web.- Ces types coûtent des appels au modèle et ne sont pas déterministes.
- Pour les règles strictes, reste sur
command. - Un hook http envoie les données de l'événement : seulement vers un service que tu contrôles.