Hooks

Hooks er brugerdefinerede shell-kommandoer, HTTP-endpoints eller LLM-prompts, der udføres automatisk på specifikke punkter i Claude Codes livscyklus. Den vigtigste forskel er, at mens CLAUDE.md instruktioner er kontekstuelle og kan ignoreres, er hooks kode, der kører uanset Claudes beslutninger. Hvis en handling skal ske på et fast tidspunkt—før hver commit, efter hver filredigering—bør den implementeres som en hook.

Verificerede hændelsesnavne inkluderer: SessionStart, SessionEnd, Setup, UserPromptSubmit, UserPromptExpansion, Stop, StopFailure, PreToolUse, PostToolUse, PostToolUseFailure, PostToolBatch, PermissionRequest, PermissionDenied, PreCompact, PostCompact, Notification, SubagentStart, SubagentStop, InstructionsLoaded, og FileChanged.

Konfiguration følger en tre-niveau struktur: vælg en hook-hændelse, tilføj en matcher gruppe for at filtrere, hvornår den udløses (f.eks. 'Bash'), og definer handlers. Handlers kan være af typen command, http, mcp_tool, prompt eller agent. Verificerede konfigurationsplaceringer inkluderer ~/.claude/settings.json (global), .claude/settings.json (projektspecifik), .claude/settings.local.json (projektspecifik og gitignored), en plugins hooks/hooks.json, og skill eller agent frontmatter (afgrænset til komponentens aktive varighed).

Exit-kode semantik er kritisk: en exit-kode på 0 betyder succes, hvilket giver Claude Code mulighed for at parse JSON-output til efterfølgende beslutninger. En exit-kode på 2 indikerer en blokerende fejl, der forhindrer værktøjsopkaldet og viser stderr til Claude. Andre ikke-nul exit-koder behandles som ikke-blokerende fejl.

Afgørende er, at en PreToolUse hook kan returnere en permissionDecision af deny for at forhindre et værktøjsopkald i at blive udført. Dette giver en kraftfuld mekanisme til at håndhæve begrænsninger eller validere betingelser, før handlinger udføres. Til administration af hooks kan Hooks Management skill oversætte naturligt sprog til validerede konfigurationer, og Debug Hooks skill tilbyder en arbejdsgang til fejlfinding af problemer.