Hooks

Hooks är användardefinierade skal-kommandon, HTTP-slutpunkter eller LLM-prompter som körs automatiskt vid specifika punkter i Claude Codes livscykel. Den avgörande skillnaden är att medan CLAUDE.md-instruktioner är kontextuella och kan ignoreras, är hooks kod som körs oavsett Claudes beslut. Om en åtgärd måste ske vid en fast punkt – före varje commit, efter varje filändring – bör den implementeras som en hook.

Verifierade händelsenamn inkluderar: SessionStart, SessionEnd, Setup, UserPromptSubmit, UserPromptExpansion, Stop, StopFailure, PreToolUse, PostToolUse, PostToolUseFailure, PostToolBatch, PermissionRequest, PermissionDenied, PreCompact, PostCompact, Notification, SubagentStart, SubagentStop, InstructionsLoaded, och FileChanged.

Konfigurationen följer en tre-nivåers struktur: välj en hook-händelse, lägg till en matcher-grupp för att filtrera när den utlöses (t.ex. 'Bash'), och definiera handlers. Handlers kan vara av typen command, http, mcp_tool, prompt, eller agent. Verifierade konfigurationsplatser inkluderar ~/.claude/settings.json (globalt), .claude/settings.json (projektspecifikt), .claude/settings.local.json (projektspecifikt och git-ignorerat), en plugins hooks/hooks.json, och skill- eller agent-frontmatter (skopat till komponentens aktiva varaktighet).

Exit-kod semantik är kritisk: en exit-kod på 0 indikerar framgång, vilket tillåter Claude Code att tolka JSON-utdata för efterföljande beslut. En exit-kod på 2 indikerar ett blockande fel, vilket förhindrar verktygsanropet och visar stderr för Claude. Andra icke-noll exit-koder behandlas som icke-blockande fel.

Viktigt är att en PreToolUse-hook kan returnera ett permissionDecision av deny för att förhindra att ett verktygsanrop exekveras. Detta ger en kraftfull mekanism för att upprätthålla begränsningar eller validera villkor innan åtgärder vidtas. För hantering av hooks kan Hooks Management-skill översätta naturligt språk till validerade konfigurationer, och Debug Hooks-skill erbjuder en arbetsflöde för felsökning av problem.