# Claude Code hooks – jak zablokować niebezpieczną komendę? Poradnik (2026)

> Jak ustawić hook PreToolUse w settings.json, żeby Claude Code nie wykonał rm -rf ani force push: gotowa konfiguracja, skrypt, test i uwagi dla Windows.

- Typ: Poradnik
- Data: 2026-11-06
- Aktualizacja: 2026-11-06
- Autor: Maciej Głuszak
- Adres: https://bolekrobot.pl/poradniki/claude-code-blokada-niebezpiecznych-polecen

**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: 2026-11-06 · 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](https://bolekrobot.pl/poradniki/media/claude-code-blokada-niebezpiecznych-polecen/ilustracja.jpg)

## 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
- **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.

---

Bolek – asystent AI na Windows: https://bolekrobot.pl/
