Hooki w Claude Code. Polecenie, które uruchomi się zawsze, a nie wtedy, gdy Claude pamięta
Co to jest hook w Claude Code, na jakie zdarzenia można go podpiąć i gdzie go zapisać. Dwa gotowe przykłady, formatowanie po edycji i blokada zmian w pliku .env.
Część przewodnikaClaude Code. Kompletny przewodnik od instalacji po własne skille i pluginy
W tym tekście
W skrócie
Hook w Claude Code to polecenie, które Claude Code sam uruchamia przy wybranym zdarzeniu, na przykład po każdej edycji pliku albo przed wykonaniem komendy. Zapisuje się go w pliku settings.json, a polecenie /hooks pokazuje wszystkie skonfigurowane hooki. Poniżej są dwa gotowe przykłady, formatowanie kodu po edycji i blokada zmian w pliku .env.
W CLAUDE.md stoi zdanie, żeby po każdej zmianie uruchamiać Prettier. Claude zwykle to robi. Czasem w długiej sesji zapomina i do repozytorium trafia plik z innym formatowaniem. Takie rzeczy przenosi się z CLAUDE.md do hooka.
Hook w Claude Code to polecenie, które Claude Code uruchamia sam w określonym momencie pracy. Nie decyduje o tym model, więc polecenie wykona się za każdym razem. Dokumentacja Anthropic nazywa to deterministyczną kontrolą. Ta strona należy do przewodnika po Claude Code, stan na 10 listopada 2026.
Co to jest hook w Claude Code
Najczęściej hook to zwykłe polecenie powłoki, typ command. Claude Code przekazuje mu na wejściu JSON z opisem zdarzenia, na przykład ścieżkę edytowanego pliku. Hook odpowiada kodem wyjścia. Kod 0 znaczy, że nie ma zastrzeżeń. Kod 2 blokuje akcję, a tekst wypisany na stderr wraca do Claude jako wyjaśnienie.
Są jeszcze cztery inne typy. http wysyła dane zdarzenia pod adres URL, mcp_tool wywołuje narzędzie z serwera MCP, prompt prosi model Claude o jedną decyzję, a agent uruchamia sprawdzanie z dostępem do narzędzi. Typ agent Anthropic opisuje jako eksperymentalny.
Różnica między hookiem a CLAUDE.md jest prosta. CLAUDE.md to prośba, którą model czyta i której zwykle się trzyma. Hook to mechanizm, który działa bez względu na to, co model uzna.
Zdarzenia, na które można podpiąć hook
W dokumentacji jest dziś 33 zdarzenia. Na co dzień przydaje się kilka z nich.
| Zdarzenie | Kiedy się uruchamia |
|---|---|
SessionStart | Na początku sesji i przy jej wznowieniu |
UserPromptSubmit | Po wysłaniu polecenia, zanim Claude je przeczyta |
PreToolUse | Przed użyciem narzędzia, może je zablokować |
PermissionRequest | Gdy narzędzie potrzebuje zgody |
PostToolUse | Po udanym użyciu narzędzia |
Notification | Gdy Claude Code wysyła powiadomienie |
Stop | Gdy Claude kończy odpowiedź |
PreCompact | Przed streszczeniem rozmowy |
FileChanged | Gdy obserwowany plik zmieni się na dysku |
SessionEnd | Na końcu sesji |
Pole matcher zawęża hook do wybranych narzędzi. Edit|Write znaczy, że hook zadziała tylko przy edycji i zapisie plików. Wielkość liter ma znaczenie.
Gdzie zapisać hook
Hooki stoją w bloku hooks w pliku ustawień. Od wyboru pliku zależy, kogo dotyczą.
| Plik | Zasięg | Trafia do repozytorium |
|---|---|---|
~/.claude/settings.json | Wszystkie Wasze projekty | Nie |
.claude/settings.json | Jeden projekt | Tak |
.claude/settings.local.json | Jeden projekt, tylko Wy | Nie |
| Ustawienia zarządzane | Cała organizacja | Ustawia administrator |
Hooki mogą też przyjść z wtyczką, ze skillem albo z subagentem. Kiedy edytujecie plik ustawień w trakcie sesji, Claude Code zwykle sam zauważa zmianę.
Przykład 1. Formatowanie po każdej edycji
Ten hook uruchamia Prettier na każdym pliku, który Claude zmienił. Zdarzenie PostToolUse z matcherem Edit|Write działa po edycji i zapisie. Polecenie wyciąga ścieżkę pliku narzędziem jq, więc jq musi być zainstalowany.
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
}
]
}
]
}
}Gdy hook zadziała poprawnie, w rozmowie nic się nie pojawia. Żeby sprawdzić, poproście Claude o dopisanie linijki z apostrofami do pliku JavaScript. Przy domyślnych ustawieniach Prettier zamieni je na cudzysłowy.
Przykład 2. Blokada zmian w pliku .env
Ten hook nie pozwala Claude zmieniać pliku .env, package-lock.json ani niczego w .git/. Skrypt sprawdza ścieżkę i kończy się kodem 2, gdy pasuje do listy. Zapiszcie go w .claude/hooks/protect-files.sh.
INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/")
for pattern in "${PROTECTED_PATTERNS[@]}"
do
if [[ "$FILE_PATH" == *"$pattern"* ]]
then
echo "Zablokowane, $FILE_PATH pasuje do wzorca $pattern" >&2
exit 2
fi
done
exit 0Potem rejestrujecie go jako PreToolUse dla edycji i zapisu. Skrypt uruchamiamy przez bash, więc nie musi mieć prawa do wykonania.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "bash \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
}
]
}
]
}
}Poproście Claude o dopisanie komentarza do .env. Edycja zostanie odrzucona, zanim się wykona, a Claude dostanie komunikat ze skryptu i poszuka innej drogi. Według dokumentacji odmowa z hooka PreToolUse działa w każdym trybie uprawnień, także w bypassPermissions. Kod 0 niczego nie zatwierdza, wtedy decydują zwykłe reguły uprawnień.
Polecenie /hooks i bezpieczeństwo
Wpiszcie /hooks w Claude Code. Otworzy się lista hooków pogrupowana według zdarzeń, z informacją, z którego pliku pochodzi każdy z nich. Lista służy tylko do podglądu. Hook zmienia się albo usuwa w pliku ustawień. Wszystkie naraz wyłącza "disableAllHooks": true.
Hook można też zamówić słowami. Wystarczy napisać Claude, co ma robić, na przykład zablokować edycję folderu migrations, a potem sprawdzić wynik w /hooks.
Dwie rzeczy z rozdziału o bezpieczeństwie trzeba znać. Hook typu command działa z pełnymi uprawnieniami Waszego konta, więc może czytać i kasować wszystko, do czego macie dostęp. W zwykłej sesji Claude Code nie uruchamia hooków, dopóki nie zaakceptujecie zaufania do folderu. W trybie claude -p tego pytania nie ma i hooki z cudzego repozytorium wykonają się od razu. Więcej o tym trybie w tekście o Claude Code w skryptach i CI.
Dobrze zacząć od jednego hooka, który blokuje pliki z danymi dostępowymi, a formatowanie dołożyć później. Jeśli zastanawiacie się, gdzie w Waszej firmie AI może przejąć powtarzalną pracę, zamówcie bezpłatny audyt AI.
Co chcecie zmienić w swojej firmie?
Zostawcie numer. Porozmawiamy o Waszym procesie i sprawdzimy, czy możemy pomóc. Pierwsza rozmowa jest bezpłatna.
Usługa, o której jest ten tekst
Automatyzacja i AI / OCRAutomatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.