Zabezpieczanie Claude Code przed wyciekiem danych.

02 / Warstwa 1 · Deny rules

settings.json — twarde blokady odczytu i zapisu.

Blokada jest aplikowana przed wywołaniem narzędzia, więc agent nie widzi zawartości. W hierarchii deny zawsze wygrywa nad allow i ask. Lokalizacje pliku:

Reguły uniwersalne

{
  "permissions": {
    "deny": [
      "Read(./.env)", "Read(./.env.*)",
      "Read(./secrets/**)", "Read(./config/credentials.*)",
      "Read(**/*.pem)", "Read(**/*.key)",
      "Bash(ping *)", "Bash(nslookup *)"
    ]
  },
  "cleanupPeriodDays": 7
}

Reguły specyficzne dla systemu

Na Windows narzędzie nadal nazywa się Bash, ale pod spodem uruchamia PowerShell — blokuj komendy właściwe dla platformy:

// Linux / macOS
"Read(~/.ssh/**)", "Read(~/.aws/**)", "Read(~/.kube/**)",
"Bash(curl *)", "Bash(wget *)", "Bash(nc *)"

// Windows (PowerShell pod Bash)
"Bash(curl *)", "Bash(Invoke-WebRequest *)",
"Bash(Invoke-RestMethod *)", "Bash(iwr *)", "Bash(nc *)"

W ścieżkach Windows w JSON ukośniki wsteczne muszą być podwojone.

04 / Warstwa 2 · PreToolUse hook

Skrypt przed każdą operacją — wykrywa sekrety zanim trafią do pliku.

Hook to skrypt powłoki uruchamiany przed wybranymi narzędziami. Kod wyjścia decyduje, co się stanie:

• exit 0 — operacja przechodzi normalnie.
• exit 1 — błąd hooka (operacja może przejść).
• exit 2 — twarda blokada: operacja anulowana, agent widzi komunikat.

Rejestracja hooka skanującego Write i Edit

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [
          { "type": "command", "command": ".claude/hooks/detect-secrets.sh" }
        ]
      }
    ]
  }
}

Skrypt skanuje generowaną treść pod kątem wzorców sekretów (klucze AWS, tokeny GitHub, klucze Stripe, hasła, connection stringi). Instalacja:

mkdir -p .claude/hooks
# skopiuj detect-secrets.sh do .claude/hooks/
chmod +x .claude/hooks/detect-secrets.sh

PostToolUse — audit log komend Bash

// Linux — dopisuje kazda komende do logu
"PostToolUse": [{
  "matcher": "Bash",
  "hooks": [{ "type": "command",
    "command": "jq -r '.tool_input.command' >> ~/.claude/command-audit-log.txt" }]
}]

06 / Wdrożenie · Audit i checklista

Self-audit prompt i checklista nowego projektu.

Wklej ten prompt, gdy chcesz sprawdzić projekt pod kątem bezpieczeństwa:

Zrob audyt bezpieczenstwa tego projektu. Znajdz i zgłos:
1. Zahardkodowane hasla, klucze API, tokeny w kodzie
2. Sekrety w komentarzach
3. Slabe hasla (mniej niz 12 znakow, slowa ze slownika)
4. Pliki .env przypadkiem zacommitowane (sprawdz historie git)
5. Connection stringi z osadzonymi danymi logowania
6. Klucze prywatne i certyfikaty w repozytorium
7. Dane wrazliwe w logach

Dla kazdego znaleziska: plik, numer linii, waga, rekomendacja.
NIE wypisuj prawdziwych wartosci sekretow — tylko wskaz ich obecnosc.

Checklista — nowy projekt z Claude Code

• .claude/settings.json z deny rules — dodaj ping i nslookup (CVE-2025-55284).
• Sandbox z allowUnsandboxedCommands: false (Linux/WSL2); na natywnym Windows: deny rules + hooki.
• Hook detect-secrets zainstalowany i wykonywalny.
• .env w .gitignore, a w repo tylko .env.example z placeholderami.
• Sprawdź historię: git log --all --full-history -- .env
• Nigdy nie uruchamiaj agenta jako root, sudo ani Administrator.
• cleanupPeriodDays: 7 w settings.json.

Test, czy blokady działają

# Zapytaj agenta: "pokaz zawartosc pliku .env"
# Oczekiwane: odmowa z powodu uprawnien

# Zapytaj: "zapisz do app.py: password = 'test123abc'"
# Oczekiwane: operacja zablokowana przez hook