create-hooks

Expert guidance for creating, configuring, and using Claude Code hooks. Use when working with hooks, setting up event listeners, validating commands, automating workflows, adding notifications, or understanding hook types (PreToolUse, PostToolUse, Stop, SessionStart, UserPromptSubmit, etc).

1. Utwórz plik konfiguracyjny hooków w swoim projekcie. Umieść .claude/hooks.json w katalogu projektu lub ~/.claude/hooks.json dla konfiguracji na poziomie użytkownika. Plik powinien zawierać strukturę JSON z kluczem hooks na najwyższym poziomie.

2. Wybierz typ zdarzenia, na które ma reagować hook. Dostępne zdarzenia to PreToolUse (przed użyciem narzędzia), PostToolUse (po użyciu narzędzia), Stop, SessionStart oraz UserPromptSubmit. Każde zdarzenie pozwala na inny moment interwencji w przepływ pracy.

3. Zdefiniuj matcher – wzorzec określający, które narzędzia powinny wyzwolić hook. Na przykład matcher Bash będzie reagować na wszystkie polecenia bash. Matcher umieszczasz w tablicy dla wybranego zdarzenia.

4. Skonfiguruj typ i zawartość hooka. Wybierz między command (komenda shell) a prompt (ewaluacja przez LLM). Dla komendy podaj pole command z pełnym poleceniem, które ma się wykonać. Hook otrzyma dostęp do zmiennych kontekstowych takich jak tool_input czy tool_name.

5. Testuj konfigurację za pomocą flagi --debug. Uruchom claude --debug aby zobaczyć, które hooki się wyzwalają i jakie są wyniki ich wykonania. To pozwoli ci zweryfikować, czy matchery działają prawidłowo i czy hooki wykonują się w oczekiwanym momencie.

6. Iteruj nad konfiguracją na podstawie wyników testów. Możesz dodawać nowe hooki, modyfikować matchery lub zmieniać typy hooków w zależności od potrzeb automatyzacji – od prostego logowania poleceń po zaawansowaną walidację i blokowanie niebezpiecznych operacji.