Kroker

Kroker er brukerdefinerte skallkommandoer, HTTP-endepunkter eller LLM-prompter som utføres automatisk på spesifikke punkter i Claude Codes livssyklus. Nøkkel skillet er at mens CLAUDE.md-instruksjoner er kontekstuelle og kan ignoreres, er kroker kode som kjører uavhengig av Claudes beslutninger. Hvis en handling må skje på et fast punkt – før hver commit, etter hver filredigering – bør den implementeres som en krok.

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

Konfigurasjonen følger en tre-nivå struktur: velg en krokhendelse, legg til en matcher-gruppe for å filtrere når den utløses (f.eks. 'Bash'), og definer handlers. Handlers kan være av typen command, http, mcp_tool, prompt eller agent. Verifiserte konfigurasjonslokasjoner inkluderer ~/.claude/settings.json (global), .claude/settings.json (prosjektspesifikk), .claude/settings.local.json (prosjektspesifikk og gitignored), en plugins hooks/hooks.json, og ferdighets- eller agent-frontmatter (avgrenset til komponentens aktive varighet).

Semantikken for utgangskoder er kritisk: en utgangskode på 0 betyr suksess, noe som lar Claude Code parse JSON-utdata for påfølgende beslutninger. En utgangskode på 2 indikerer en blokkerende feil, forhindrer verktøykall og viser stderr til Claude. Andre ikke-null utgangskoder behandles som ikke-blokkerende feil.

Viktigst, en PreToolUse-krok kan returnere en permissionDecision av deny for å forhindre at et verktøykall utføres. Dette gir en kraftig mekanisme for å håndheve begrensninger eller validere betingelser før handlinger utføres. For å administrere kroker kan Hooks Management-ferdigheten oversette naturlig språk til validerte konfigurasjoner, og Debug Hooks-ferdigheten tilbyr en arbeidsflyt for feilsøking av problemer.