Bolek › Poradniki › 6 listopada 2026
Claude Code hooks – jak zablokować niebezpieczną komendę? Poradnik (2026)
Poradnik · · Maciej Głuszak · wersja .md
W skrócie: Hook PreToolUse to Twój skrypt, który Claude Code uruchamia tuż przed każdą komendą i który może ją zablokować. Blokujesz, kończąc skrypt kodem 2 albo zwracając decyzję deny.
Wklej do Claude Code:
Dodaj w tym projekcie hook PreToolUse dla narzędzia Bash, który blokuje komendy zawierające rm -rf oraz git push z opcją --force i zwraca powód odmowy. Zapisz konfigurację w .claude/settings.json, skrypt w .claude/hooks, a potem przetestuj go na obu komendach.
Aktualizacja: · sprawdzone na: Claude Code 2.1, Windows 11
Plik z zasadami (CLAUDE.md) to prośba, którą asystent zwykle spełnia. Hook to wymuszenie: skrypt uruchamiany automatycznie przy zdarzeniu, którego asystent nie może pominąć. Do rzeczy groźnych – kasowanie, wypychanie zmian, dotykanie sekretów – używamy hooków, nie próśb.

Jak to działa
Zdarzenie PreToolUse odpala się przed użyciem narzędzia, na przykład powłoki (Bash). Claude Code przekazuje skryptowi na standardowe wejście dane w formacie JSON, a w nich komendę. Skrypt decyduje: przepuścić czy zablokować.
Konfiguracja
Wpis trafia do pliku `settings.json` – w katalogu `.claude` projektu (do wspólnego repozytorium), w `settings.local.json` (tylko Ty) albo w pliku w katalogu domowym (wszystkie projekty):
``` { "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/blokada.sh" } ] } ] } } ```
Skrypt blokujący
Skrypt czyta komendę z JSON-a (potrzebny program jq) i odmawia, gdy pasuje do wzorca:
``` #!/bin/bash KOMENDA=$(jq -r '.tool_input.command') if echo "$KOMENDA" | grep -qE 'rm -rf|git push.*--force'; then jq -n '{hookSpecificOutput: {hookEventName: "PreToolUse", permissionDecision: "deny", permissionDecisionReason: "Zablokowane: komenda destrukcyjna"}}' else exit 0 fi ```
Drugi sposób to wyjście z kodem 2 i komunikatem na stderr – Claude Code zablokuje wtedy akcję i pokaże komunikat asystentowi. Nie mieszaj obu sposobów w jednym skrypcie.
Test
- Wpisz `/hooks` – zobaczysz skonfigurowane hooki i miejsce, w którym je zdefiniowano.
- Poproś asystenta o wykonanie niegroźnej komendy z `rm -rf` na pustym folderze testowym. Powinien dostać odmowę z Twoim komunikatem.
- Gdy nic się nie dzieje, uruchom Claude Code z opcją `--debug`.
Windows
Jeśli masz Git dla Windows, skrypty powłoki Bash działają jak wyżej. Bez niego hooki uruchamiają się w PowerShellu: ustaw w konfiguracji pole `shell` na `powershell` albo wywołaj `powershell.exe` z plikiem skryptu. Wtedy kod wyjścia inny niż 0 lub 2 traktowany jest jako błąd.
Pułapki
- Wzorzec za wąski. `rm -rf` ominie zapis `rm -fr`. Dodaj warianty albo blokuj szerzej i przepuszczaj wyjątki.
- Hook nie widzi załączników. Plik dołączony do wiadomości przez @ nie przechodzi przez PreToolUse – do blokowania odczytu użyj reguły odmowy dla narzędzia Read.
- Zbyt wiele hooków. Każdy dodaje opóźnienie przy każdej komendzie. Zaczynaj od dwóch trzech reguł.
Co dalej
Zdarzeń jest ponad trzydzieści – na przykład start sesji, wysłanie wiadomości czy zakończenie pracy. Zacznij od PreToolUse i rozszerzaj, gdy trafisz na kolejny powód.
Te lekcje pochodzą z codziennej pracy z Bolkiem, asystentem AI na Windows. Własny Bolek – wdrożenie u Ciebie albo zostaw kontakt – odezwiemy się w ciągu 1 dnia roboczego.