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
  1. Co to jest hook w Claude Code
  2. Zdarzenia, na które można podpiąć hook
  3. Gdzie zapisać hook
  4. Przykład 1. Formatowanie po każdej edycji
  5. Przykład 2. Blokada zmian w pliku .env
  6. Polecenie /hooks i bezpieczeństwo

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.

ZdarzenieKiedy się uruchamia
SessionStartNa początku sesji i przy jej wznowieniu
UserPromptSubmitPo wysłaniu polecenia, zanim Claude je przeczyta
PreToolUsePrzed użyciem narzędzia, może je zablokować
PermissionRequestGdy narzędzie potrzebuje zgody
PostToolUsePo udanym użyciu narzędzia
NotificationGdy Claude Code wysyła powiadomienie
StopGdy Claude kończy odpowiedź
PreCompactPrzed streszczeniem rozmowy
FileChangedGdy obserwowany plik zmieni się na dysku
SessionEndNa 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ą.

PlikZasięgTrafia do repozytorium
~/.claude/settings.jsonWszystkie Wasze projektyNie
.claude/settings.jsonJeden projektTak
.claude/settings.local.jsonJeden projekt, tylko WyNie
Ustawienia zarządzaneCała organizacjaUstawia 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.

.claude/settings.json
{
  "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.

bash
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 0

Potem rejestrujecie go jako PreToolUse dla edycji i zapisu. Skrypt uruchamiamy przez bash, więc nie musi mieć prawa do wykonania.

.claude/settings.json
{
  "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.

Kiedy najlepiej zadzwonić?
Administrator: Oleksandr Bondarenko (BondSoft)Polityka prywatnościRegulamin
Szczegóły prawne

Administratorem danych jest Oleksandr Bondarenko, prowadzący działalność gospodarczą pod firmą Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Dane przetwarzamy wyłącznie w celu kontaktu w sprawie Twojego zapytania i przedstawienia oferty — na podstawie Twojej zgody (art. 6 ust. 1 lit. a RODO oraz art. 398 ustawy Prawo komunikacji elektronicznej) oraz naszego prawnie uzasadnionego interesu polegającego na obsłudze zapytania (art. 6 ust. 1 lit. f RODO).

Podanie danych jest dobrowolne, ale niezbędne do kontaktu zwrotnego. Zgodę możesz wycofać w każdej chwili, pisząc na office@bondsoft.pl — nie wpływa to na zgodność z prawem przetwarzania sprzed wycofania.

Masz prawo dostępu do danych, ich sprostowania, usunięcia, ograniczenia przetwarzania, przenoszenia oraz wniesienia skargi do Prezesa Urzędu Ochrony Danych Osobowych.

Pełna informacja: Polityka prywatności.

Napiszcie e-mail

Usługa, o której jest ten tekst

Automatyzacja i AI / OCR

Automatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.