Hooks in Claude Code

Belangrijkste Concepten

Wat zijn Hooks?

• Deterministische uitvoering: Hooks worden altijd uitgevoerd, in tegenstelling tot prompt-instructies die mogelijk niet worden uitgevoerd
• Voer commando's uit op specifieke punten in Claude's levenscyclus

Hook-gebeurtenissen

• Gebruiker prompt indienen: Wordt uitgevoerd wanneer u een prompt indient (voordat Claude deze verwerkt)
• Pre-tool use: Wordt uitgevoerd voordat een tool-aanroep wordt uitgevoerd
• Post-tool use: Wordt uitgevoerd nadat een tool-aanroep is voltooid
• Melding: Wordt uitgevoerd wanneer Claude een melding verzendt
• Stop: Wordt uitgevoerd wanneer Claude klaar is met reageren

Veelvoorkomende gebruiksscenario's

• Bestanden automatisch opmaken na bewerkingen
• Uitgevoerde commando's registreren voor compliance
• Gevaarlijke bewerkingen blokkeren (bijv. productiebestanden wijzigen)
• Meldingen verzenden wanneer taken zijn voltooid

Configuratie

• Geconfigureerd in settings. json bestand
• Geef op: gebeurtenistype, optionele matcher (welke tools van toepassing zijn) en uit te voeren commando
• Hooks op projectniveau kunnen in uw repo worden ingecheckt voor consistentie in het hele team

Pre-Tool Use Hooks (Bewerkingen blokkeren)

• Ontvangen tool-naam en invoer als JSON op stdin
• Exit-code 0 = doorgaan
• Exit-code 2 = actie blokkeren
• Foutbericht verzonden naar Claude als feedback waarin wordt uitgelegd waarom het werd geblokkeerd

Best Practices

• Gebruik post-tool use voor automatisch opmaken en registratie
• Gebruik pre-tool use om strikte regels af te dwingen en gevaarlijke bewerkingen te blokkeren
• Gebruik CLAUDE_PROJECT_DIR omgevingsvariabele in commando's om naar projectscripts te verwijzen
• Als iets elke keer zonder mankeren moet gebeuren, gebruik dan een hook in plaats van een prompt

Belangrijkste inzichten

• Hooks garanderen uitvoering op specifieke punten in de levenscyclus, in tegenstelling tot prompt-instructies die kunnen worden overgeslagen—gebruik ze wanneer iets altijd moet gebeuren

• Pre-tool use hooks kunnen bewerkingen blokkeren door exit-code 2 terug te geven, waardoor ze ideaal zijn voor het afdwingen van veiligheidsregels (bijv. het voorkomen van wijzigingen aan productiebestanden)

• Post-tool use hooks zijn voor automatisering: automatisch opmaken, registratie en meldingen die na voltooiing van tool-uitvoering moeten worden uitgevoerd

• **Configureer hooks in settings. json** met gebeurtenistype, optionele tool-matcher en commando; hooks op projectniveau kunnen onder versiebeheer worden geplaatst voor consistentie in het team

• Gebruik exit-codes strategisch: exit 0 om door te gaan, exit 2 om te blokkeren, met foutberichten naar Claude waarin de afwijzing wordt uitgelegd