Moje konto

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.

Robot przy bramce zatrzymuje czerwony blok z ostrzeżeniem i przepuszcza zielony z ptaszkiem

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

  1. Wpisz `/hooks` – zobaczysz skonfigurowane hooki i miejsce, w którym je zdefiniowano.
  2. Poproś asystenta o wykonanie niegroźnej komendy z `rm -rf` na pustym folderze testowym. Powinien dostać odmowę z Twoim komunikatem.
  3. 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

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.