Hooks

Hooks jsou uživatelsky definované příkazy shellu, HTTP koncové body nebo LLM prompty, které se automaticky spouštějí ve specifických bodech životního cyklu Claude Code. Klíčový rozdíl je v tom, že zatímco instrukce CLAUDE.md jsou kontextové a mohou být ignorovány, hooks jsou kód, který běží bez ohledu na rozhodnutí Claude. Pokud musí akce proběhnout ve stanoveném bodě – před každým commitem, po každé úpravě souboru – měla by být implementována jako hook.

Ověřené názvy událostí zahrnují: SessionStart, SessionEnd, Setup, UserPromptSubmit, UserPromptExpansion, Stop, StopFailure, PreToolUse, PostToolUse, PostToolUseFailure, PostToolBatch, PermissionRequest, PermissionDenied, PreCompact, PostCompact, Notification, SubagentStart, SubagentStop, InstructionsLoaded a FileChanged.

Konfigurace sleduje tříúrovňovou strukturu: vyberte hook událost, přidejte skupinu matcher pro filtrování, kdy se spustí (např. 'Bash'), a definujte handlers. Handlers mohou být typu command, http, mcp_tool, prompt nebo agent. Ověřená umístění konfigurace zahrnují ~/.claude/settings.json (globální), .claude/settings.json (specifické pro projekt), .claude/settings.local.json (specifické pro projekt a ignorované v gitu), hooks/hooks.json pluginu a hlavičku skillu nebo agenta (v rozsahu platnosti komponenty).

Sémantika návratového kódu je kritická: návratový kód 0 značí úspěch, což Claude Code umožňuje analyzovat JSON výstup pro následná rozhodnutí. Návratový kód 2 označuje blokující chybu, která zabrání volání nástroje a zobrazí stderr Claude. Ostatní nenulové návratové kódy jsou považovány za neblokující chyby.

Zásadní je, že hook PreToolUse může vrátit permissionDecision s hodnotou deny, aby se zabránilo spuštění volání nástroje. To poskytuje silný mechanismus pro vynucování omezení nebo ověřování podmínek před provedením akcí. Pro správu hooků může skill Hooks Management převést přirozený jazyk na ověřené konfigurace a skill Debug Hooks nabízí pracovní postup pro řešení problémů.