Claude Code Hooks

Claude Code Hooks, zwizualizowane.

Claude Code hooks pozwalają uruchamiać deterministyczne polecenia shellowe przy każdym kluczowym zdarzeniu w cyklu życia Claude Code: przed użyciem narzędzia, po użyciu narzędzia, przy wysłaniu promptu, gdy agent zatrzymuje się lub gdy wysyłane jest powiadomienie. AgentsRoom to wizualne centrum dowodzenia, które pozwala obserwować każde wyzwolenie hooka w czasie rzeczywistym, w dziesiątkach agentów Claude Code, w dziesiątkach projektów.

Hooki to oficjalny sposób Anthropic na dodanie deterministycznej automatyzacji, zabezpieczeń, śladów audytu i niestandardowych efektów ubocznych do Claude Code. AgentsRoom nie zastępuje Twoich hooków. Uruchamia prawdziwe Claude Code CLI, więc każdy hook skonfigurowany w .claude/settings.json działa dokładnie tak, jak zamierzono. To, co dodaje AgentsRoom, to widoczność: dashboard na żywo, w którym widzisz każde wyzwolenie hooka — per agent, per projekt, per uruchomienie.

Czym są Claude Code hooks?

Claude Code hooks to zdefiniowane przez użytkownika polecenia shellowe, które Claude Code automatycznie wykonuje w określonych punktach podczas sesji agenta. Są skonfigurowane w .claude/settings.json (współdzielone, commitowane do gita) lub .claude/settings.local.json (osobiste, gitignored) i dają deterministyczną kontrolę nad zachowaniem Twoich agentów Claude Code. Podczas gdy prompt jest probabilistyczny, hook jest w 100% deterministyczny: uruchamia się za każdym razem, gdy wyzwoli się pasujące zdarzenie, bez wyjątków.

Hooki to odpowiedź Anthropic na potrzebę zabezpieczeń, automatyzacji, telemetrii, logowania audytu i niestandardowych integracji. Możesz używać Claude Code hooks, aby automatycznie formatować kod po każdej edycji, blokować niebezpieczne polecenia zanim zostaną uruchomione, logować każde wywołanie narzędzia do pliku, wysyłać powiadomienie desktopowe, gdy agent czeka na input, wyzwalać zadanie CI na zakończenie sesji lub streamować każdy prompt do backendu obserwowalności. Każde polecenie shellowe, które możesz napisać, możesz podłączyć do Claude Code hooka.

Ponieważ hooki żyją w samym projekcie (.claude/settings.json jest commitowany do gita), podróżują razem z Twoją bazą kodu. Każdy deweloper w zespole i każdy agent AI uruchomiony z tego projektu dziedziczy tę samą siatkę bezpieczeństwa. AgentsRoom respektuje ten model od początku do końca: aplikacja desktopowa nie przepisuje Twoich hooków, uruchamia prawdziwe Claude Code CLI jako proces potomny, który automatycznie podbiera Twoją konfigurację hooków — dokładnie tak, jak uruchomienie claude code z terminala.

6 zdarzeń Claude Code Hook

Każda sesja agenta Claude Code wyzwala zdarzenia hooków w dobrze zdefiniowanych punktach. Oto, co oznacza każde zdarzenie i co możesz z nim zrobić.

PreToolUse

Hook PreToolUse wyzwala się przed uruchomieniem przez Claude Code jakiegokolwiek narzędzia (Bash, Edit, Write, Read, Grep itp.). To idealne miejsce na zabezpieczenia: blokuj niebezpieczne polecenia, wymagaj potwierdzenia dla destrukcyjnych operacji, egzekwuj reguły specyficzne dla projektu lub przepisuj argumenty narzędzi przed wykonaniem. Zwróć z hooka niezerowy kod wyjścia, aby całkowicie zablokować wywołanie narzędzia. PreToolUse to hook nr 1 Claude Code dla zespołów świadomych bezpieczeństwa.

PostToolUse

Hook PostToolUse wyzwala się natychmiast po zakończeniu działania dowolnego narzędzia Claude Code. To tutaj podłączasz automatyczne post-processing: uruchamiaj formater (Prettier, Black, rustfmt) po każdym Edit, wyzwalaj linter po każdym Write, aktualizuj changelog gdy plik jest modyfikowany lub pushuj zdarzenia telemetryczne. PostToolUse to codzienny, najbardziej użyteczny hook, który zamienia Claude Code w zdyscyplinowanego członka zespołu, który zostawia bazę kodu czystszą, niż ją znalazł.

UserPromptSubmit

Hook UserPromptSubmit wyzwala się za każdym razem, gdy nowy prompt jest wysyłany do agenta Claude Code. Użyj go, aby logować każdy prompt na potrzeby audytu i compliance, przepisywać prompty w locie (wstrzykiwać kontekst, redagować sekrety), routować żądania do różnych modeli lub egzekwować konwencje nazewnicze. W połączeniu z dashboardem wieloagentowym AgentsRoom, UserPromptSubmit daje Ci pełny ślad audytu każdej instrukcji wysłanej do każdego agenta Claude Code.

Stop

Hook Stop wyzwala się, gdy sesja agenta Claude Code kończy się — albo dlatego, że praca jest zakończona, albo dlatego, że została anulowana. To właściwe miejsce na uruchamianie zadań porządkujących, wysyłanie finalnego podsumowania do systemu śledzenia, commitowanie artefaktów lub powiadamianie człowieka, że sesja się zakończyła. AgentsRoom uzupełnia hook Stop własnym systemem powiadomień, więc zostaniesz poinformowany zarówno przez swój niestandardowy hook, jak i przez powiadomienia desktopowe i push mobilne AgentsRoom.

Notification

Hook Notification wyzwala się, gdy Claude Code wysyła powiadomienie systemowe — zazwyczaj gdy agent czeka na input użytkownika lub zakończył długotrwałe zadanie. Użyj go, aby routować powiadomienia do Slack, Discord, Telegram, e-mail lub dowolnego webhooka. AgentsRoom natywnie pokazuje powiadomienia Claude Code w swoim dashboardzie wieloagentowym i jako powiadomienia push na Twoim telefonie, więc hook Notification to idealne miejsce, aby dodać na wierzchu niestandardowe integracje.

SubagentStop

Hook SubagentStop wyzwala się, gdy subagent Claude Code kończy swoją pracę i zwraca kontrolę do rodzica. Jeśli używasz subagentów Claude Code zdefiniowanych w .claude/agents/*.md do delegowania wyspecjalizowanych zadań, SubagentStop pozwala logować, co zrobił każdy subagent, agregować ich wyjścia lub wyzwalać kolejny krok. Wewnątrz AgentsRoom zdarzenia SubagentStop pojawiają się w timeline'ie agenta na żywo, dzięki czemu możesz dokładnie zobaczyć, które subagenty działały wewnątrz każdej sesji Claude Code.

Dlaczego Claude Code hooks mają znaczenie

Hooki zamieniają Claude Code z imponującej AI w produkcyjnej klasy agenta kodującego, na którym może polegać cały Twój zespół.

Deterministyczne zabezpieczenia bezpieczeństwa

Prompty są probabilistyczne i mogą zostać ominięte. Claude Code hooks to deterministyczne polecenia shellowe, które zawsze się uruchamiają. Hook PreToolUse może zablokować dowolne rm -rf, dowolny push --force, dowolną destrukcyjną migrację — niezależnie od tego, jak agent sformułuje swoje rozumowanie. To złoty standard dla wdrożeń Claude Code o krytycznym znaczeniu dla bezpieczeństwa.

Automatyzacja bez wysiłku

Podłącz Claude Code hooks do swoich formaterów, linterów, runnerów testów, type checkerów i skryptów buildu. Każda edycja, jaką robi agent, wyzwala te same sprawdzenia, które wykonuje Twój pipeline CI — lokalnie, natychmiastowo, automatycznie. Twoi agenci Claude Code stają się samodyscyplinowanymi kontrybutorami, którzy nigdy nie zapominają uruchomić formatera.

Pełny ślad audytu

Każdy prompt, każde wywołanie narzędzia, każde uruchomienie i zakończenie sesji może być zalogowane przez Claude Code hooks. Połącz to z wizualnym timeline'em AgentsRoom, a otrzymasz pełny ślad audytu każdej akcji agenta AI — niezbędny dla zespołów obciążonych compliance, firm świadomych bezpieczeństwa i każdego, kto traktuje poważnie obserwowalne tworzenie AI.

Konwencje obowiązujące w całym zespole

Ponieważ .claude/settings.json jest commitowany do gita, jeden zestaw Claude Code hooks wymusza te same konwencje dla każdego dewelopera w zespole i każdego agenta AI uruchomionego z projektu. Nowi członkowie zespołu dziedziczą zabezpieczenia w chwili sklonowania repo. Zaktualizuj zachowanie całego zespołu AI-kodującego jednym pull requestem.

Obserwowalność hooków na żywo

Claude Code hooks produkują zdarzenia. AgentsRoom zamienia te zdarzenia w wizualny feed: każde wyzwolenie hooka, każde wywołanie narzędzia, każda zmiana statusu — streamowane na żywo per agent i per projekt. Nie musisz już tailować logów — obserwujesz swoją flotę Claude Code przy pracy w czasie rzeczywistym.

Od obserwowania do nadzorowania

Bez hooków uruchamianie Claude Code oznacza obserwowanie każdego wywołania narzędzia. Z hookami delegujesz obserwację deterministycznemu kodowi i nadzorujesz na poziomie wyjątków. AgentsRoom to wzmacnia: widzisz wszystkie swoje chronione hookami agenty Claude Code naraz i wkraczasz tylko wtedy, gdy coś wymaga Twojej uwagi.

Claude Code Hooks + AgentsRoom

AgentsRoom to wizualne centrum dowodzenia dla Claude Code i innych CLI do kodowania AI. Nie forkuje Claude Code, nie reimplementuje hooków, nie przechwytuje wywołań narzędzi. Uruchamia prawdziwe Claude Code CLI jako proces potomny wewnątrz pełnoprawnego terminala xterm.js, co oznacza, że każdy hook zdefiniowany przez Ciebie w .claude/settings.json lub .claude/settings.local.json działa dokładnie tak, jak zaprojektował to Anthropic — bez kompromisów, bez niespodzianek, bez niewidocznego middleware.

To, co dodaje AgentsRoom, to skala i widoczność. Możesz uruchomić dziesiątki agentów Claude Code równolegle, w dziesiątkach projektów, każdy z własną konfiguracją hooków, i widzieć każde wyzwolenie hooka na jednym dashboardzie. W połączeniu z powiadomieniami per agent w AgentsRoom, towarzyszącą aplikacją mobilną i śledzeniem statusu w czasie rzeczywistym, Claude Code hooks stają się pierwszorzędną warstwą obserwowalności dla całej Twojej operacji kodowania AI.

Uruchamia prawdziwe Claude Code CLI

AgentsRoom spawnuje prawdziwe procesy claude CLI wewnątrz pełnoprawnych terminali xterm.js. Każdy hook skonfigurowany w .claude/settings.json, .claude/settings.local.json lub ustawieniach na poziomie użytkownika wyzwala się automatycznie, dokładnie tak, jakbyś uruchomił Claude Code z terminala. Bez patchowania, bez przepisywania, bez utraty wierności.

Zdarzenia hooków w flocie wieloagentowej

Uruchamiaj 10, 20, 50 agentów Claude Code równolegle z włączonymi hookami. Dashboard wieloagentowy AgentsRoom pokazuje powiadomienia wyzwolone hookami i zmiany statusu dla każdego agenta jednocześnie. Twoje zabezpieczenia PreToolUse, formatery PostToolUse i obsługa Stop działają wszystkie w skali floty.

Widoczność hooków między projektami

Każdy projekt w AgentsRoom ma własny .claude/settings.json, a tym samym własną konfigurację Claude Code hooks. Pasek boczny agreguje status na żywo między projektami, dzięki czemu można dostrzec, które hooki wyzwalają się gdzie, którzy agenci są zablokowani na inpucie użytkownika i które hooki Stop właśnie zakończyły uruchomienie.

Powiadomienia desktopowe i mobilne

AgentsRoom dostarczany jest z natywnymi powiadomieniami macOS i szyfrowanymi end-to-end mobilnymi powiadomieniami push. Hook Notification, hook Stop i hook SubagentStop Claude Code produkują sygnały, które AgentsRoom pokazuje bezpośrednio na Twoim desktopie i telefonie. Możesz odejść od komputera i nadal wiedzieć, kiedy hook każe Ci wrócić.

Claude Code Hooks FAQ

Czym są Claude Code hooks, w jednym zdaniu?+
Claude Code hooks to zdefiniowane przez użytkownika polecenia shellowe, które Claude Code uruchamia automatycznie w określonych zdarzeniach cyklu życia (PreToolUse, PostToolUse, UserPromptSubmit, Stop, Notification, SubagentStop), dając deterministyczną kontrolę nad zachowaniem Twoich agentów AI kodujących.
Gdzie konfiguruje się Claude Code hooks?+
Claude Code hooks żyją w .claude/settings.json (commitowany do gita, współdzielony z zespołem) lub .claude/settings.local.json (gitignored, osobisty). Oba pliki są automatycznie podbierane przez Claude Code CLI. AgentsRoom uruchamia prawdziwe Claude Code CLI, więc respektuje oba pliki bez żadnej dodatkowej konfiguracji.
Czy AgentsRoom zastępuje Claude Code hooks?+
Nie. AgentsRoom nie zastępuje, nie przepisuje ani nie przechwytuje Claude Code hooks. Uruchamia prawdziwe Claude Code CLI jako proces potomny, co oznacza, że Twoje hooki działają dokładnie tak, jak zaprojektował to Anthropic. Rolą AgentsRoom jest dostarczenie wizualnego centrum dowodzenia i dashboardu wieloagentowego na sesjach Claude Code napędzanych hookami.
Czy mogę monitorować zdarzenia Claude Code hooks w AgentsRoom?+
Tak. AgentsRoom streamuje wyjście każdej sesji Claude Code na żywo, w tym zdarzenia wyzwolone hookami (wyjście formatera, odrzucenia zabezpieczeń, komunikaty powiadomień, zatrzymania subagentów). Dashboard wieloagentowy agreguje status każdego działającego agenta, więc możesz jednym spojrzeniem zobaczyć, które hooki wyzwoliły się gdzie.
Jaki jest najbardziej użyteczny Claude Code hook na start?+
Dla większości zespołów PostToolUse to pierwszy hook o najwyższej wartości: podłącz go do swojego formatera i lintera, aby każda edycja była natychmiast uporządkowana. Dla projektów krytycznych pod względem bezpieczeństwa PreToolUse jest niezbędny: blokuj destrukcyjne polecenia Bash, zanim agent je uruchomi. Gdy już je masz, dodaj UserPromptSubmit do logowania audytu i Stop do telemetrii zakończenia.
Czy AgentsRoom jest darmowy do użytku z Claude Code hooks?+
Tak. AgentsRoom jest darmowy do pobrania i użytku z maksymalnie 3 projektami. Przynieś własną subskrypcję Anthropic lub klucz API. Każdy hook, każde zabezpieczenie PreToolUse, każdy formater PostToolUse skonfigurowany w .claude/settings.json zadziała natychmiast — bez dodatkowej konfiguracji, bez dodatkowych opłat.

Zobacz, jak Twoje Claude Code hooks wyzwalają się na żywo

Pobierz AgentsRoom, otwórz projekt z hookami w .claude/settings.json, uruchom agenta Claude Code i obserwuj, jak każde zdarzenie hooka wpływa do dashboardu w czasie rzeczywistym.

Za darmoPobierz AgentsRoom

Aplikacja towarzyszaca: monitoruj agentów w podrozy

Działa z Claude, Codex, OpenCode, Gemini CLI i Aider

Wiele projektów
Multi-provider
Wielu agentów
Status na żywo
Diff i commit
Aplikacja mobilna
Podgląd na żywo