Hooks in Claude Code

Concepts clés

Qu'est-ce que les Hooks ?

• Exécution déterministe : Les hooks s'exécutent toujours, contrairement aux instructions de prompt qui peuvent ne pas s'exécuter
• Exécutent des commandes à des points spécifiques du cycle de vie de Claude

Événements Hook

• Soumission de prompt utilisateur : S'exécute quand vous soumettez un prompt (avant que Claude le traite)
• Pré-utilisation d'outil : S'exécute avant qu'un appel d'outil ne s'exécute
• Post-utilisation d'outil : S'exécute après qu'un appel d'outil se termine
• Notification : S'exécute quand Claude envoie une notification
• Stop : S'exécute quand Claude termine sa réponse

Cas d'usage courants

• Formatage automatique des fichiers après modifications
• Journalisation des commandes exécutées pour la conformité
• Blocage des opérations dangereuses (par ex. , modification de fichiers en production)
• Envoi de notifications quand les tâches se terminent

Configuration

• Configuré dans le fichier settings. json
• Spécifier : type d'événement, matcher optionnel (quels outils s'appliquent), et commande à exécuter
• Les hooks au niveau du projet peuvent être archivés dans votre repo pour la cohérence à l'échelle de l'équipe

Hooks Pré-utilisation d'outil (Blocage des opérations)

• Reçoivent le nom de l'outil et l'entrée en JSON sur stdin
• Code de sortie 0 = procéder
• Code de sortie 2 = bloquer l'action
• Message d'erreur envoyé à Claude comme retour expliquant pourquoi il a été bloqué

Bonnes pratiques

• Utilisez post-tool use pour le formatage automatique et la journalisation
• Utilisez pre-tool use pour appliquer des règles strictes et bloquer les opérations dangereuses
• Utilisez la variable d'environnement CLAUDE_PROJECT_DIR dans les commandes pour référencer les scripts du projet
• Si quelque chose doit se produire à chaque fois sans faute, utilisez un hook au lieu d'un prompt

Points clés

• Les hooks garantissent l'exécution à des points spécifiques du cycle de vie, contrairement aux instructions de prompt qui peuvent être ignorées—utilisez-les quand quelque chose doit toujours se produire

• Les hooks pré-utilisation d'outil peuvent bloquer les opérations en retournant le code de sortie 2, ce qui les rend idéaux pour appliquer des règles de sécurité (par ex. , prévenir les modifications de fichiers en production)

• Les hooks post-utilisation d'outil sont pour l'automatisation : formatage automatique, journalisation, et notifications qui doivent s'exécuter après la fin de l'exécution de l'outil

• **Configurez les hooks dans settings. json** avec le type d'événement, le matcher d'outil optionnel, et la commande ; les hooks au niveau du projet peuvent être versionnés pour la cohérence de l'équipe

• Utilisez les codes de sortie stratégiquement : sortie 0 pour procéder, sortie 2 pour bloquer, avec des messages d'erreur envoyés à Claude expliquant le rejet