Hooks

Hooks zijn door de gebruiker gedefinieerde shell-commando's, HTTP-eindpunten of LLM-prompts die automatisch worden uitgevoerd op specifieke punten in de levenscyclus van Claude Code. Het belangrijkste onderscheid is dat hoewel CLAUDE.md instructies contextueel zijn en genegeerd kunnen worden, hooks code zijn die draait ongeacht de beslissingen van Claude. Als een actie op een vast punt moet plaatsvinden – vóór elke commit, na elke bestandsbewerking – dan moet deze als een hook worden geïmplementeerd.

Geverifieerde eventnamen zijn onder andere: SessionStart, SessionEnd, Setup, UserPromptSubmit, UserPromptExpansion, Stop, StopFailure, PreToolUse, PostToolUse, PostToolUseFailure, PostToolBatch, PermissionRequest, PermissionDenied, PreCompact, PostCompact, Notification, SubagentStart, SubagentStop, InstructionsLoaded, en FileChanged.

Configuratie volgt een drielaagse structuur: selecteer een hook-event, voeg een matcher groep toe om te filteren wanneer deze wordt geactiveerd (bijv. 'Bash'), en definieer handlers. Handlers kunnen van het type command, http, mcp_tool, prompt, of agent zijn. Geverifieerde configuratielocaties zijn onder andere ~/.claude/settings.json (globaal), .claude/settings.json (projectspecifiek), .claude/settings.local.json (projectspecifiek en genegeerd door git), de hooks/hooks.json van een plugin, en skill- of agent-frontmatter (beperkt tot de actieve duur van het component).

De semantiek van exitcodes is cruciaal: een exitcode van 0 betekent succes, waardoor Claude Code JSON-uitvoer kan parsen voor daaropvolgende beslissingen. Een exitcode van 2 duidt op een blokkerende fout, die de tool-aanroep voorkomt en stderr aan Claude toont. Andere niet-nul exitcodes worden behandeld als niet-blokkerende fouten.

Cruciaal is dat een PreToolUse hook een permissionDecision van deny kan retourneren om te voorkomen dat een tool-aanroep wordt uitgevoerd. Dit biedt een krachtig mechanisme voor het afdwingen van beperkingen of het valideren van voorwaarden voordat acties worden ondernomen. Voor het beheren van hooks kan de Hooks Management skill natuurlijke taal vertalen naar gevalideerde configuraties, en de Debug Hooks skill biedt een workflow voor het oplossen van problemen.