Przewodnik po Claude Code CLI: instalacja, konfiguracja, polecenia i zmienne środowiskowe

W skrócie: Claude Code to agentowy CLI, który odczytuje bazę kodu, wykonuje polecenia i modyfikuje pliki za pośrednictwem warstwowego systemu uprawnień, hooks, integracji MCP i subagents. Opanowanie pięciu podstawowych systemów (konfiguracji, uprawnień, hooks, MCP i subagents) zapewnia zwielokrotnienie produktywności. Warto dobierać klasę modelu do każdego zadania — Opus do złożonego rozumowania, Sonnet do ogólnych prac, a Haiku do szybkiej eksploracji — albo ujednolicić pracę na Opus, jeśli liczy się wyłącznie jakość. Do wszystkiego, co musi być wykonywane zawsze, należy używać hooks (nie promptów). Od wersji v2.1.197 (30 czerwca 2026) Claude Sonnet 5 jest domyślnym modelem w Claude Code — natywny kontekst 1M i promocyjne ceny 2/10 USD obowiązujące do 31 sierpnia — natomiast Opus jest dostępny przez /model opus (od v2.1.219 ten alias wskazuje Claude Opus 5); v2.1.198 (1 lipca) sprawia, że subagents domyślnie działają w tle, wprowadza Claude w Chrome do powszechnej dostępności, pozwala agentom działającym w tle tworzyć commity, wykonywać push i otwierać szkic PR po ukończeniu pracy nad kodem w worktree oraz wywołuje hook Notification (agent_needs_input/agent_completed) dla sesji działających w tle; v2.1.199 (2 lipca) wczytuje do 5 skumulowanych wywołań slash-skills i automatycznie ponawia przejściowe błędy 429 u subskrybentów; v2.1.200 (3 lipca) zmienia nazwę trybu uprawnień default na „Manual” w całym CLI, --help, VS Code i JetBrains (wartość konfiguracyjna pozostaje bez zmian, a manual jest akceptowany jako alias) oraz domyślnie zapobiega automatycznemu kontynuowaniu po oknach dialogowych AskUserQuestion; v2.1.202 (6 lipca) dodaje w /config opcję „Dynamic workflow size” i przywraca /review <pr> jako szybki, jednoprzebiegowy przegląd, podczas gdy przebieg wieloagentowy zostaje przeniesiony do /code-review <level> <pr#>; v2.1.203–205 (7–9 lipca) wzmacniają auto mode — pliki transkrypcji są chronione przed manipulacją, rm -rf użyte z nierozpoznawalną zmienną wymaga wcześniejszego potwierdzenia, a powiadomienia o zadaniach w tle informują, że nie doszło do interakcji z człowiekiem (dzięki czemu nie można podjąć działania na podstawie sfabrykowanych zatwierdzeń w transkrypcji) — oraz przekształcają /doctor w pełne narzędzie diagnostyczno-naprawcze (alias /checkup).^181182183 Wersja v2.1.217 (21 lipca) wycofała się z zagnieżdżonych subagents — subagents przestały domyślnie uruchamiać własne subagents (ustawienie domyślne, które v2.1.219 odwróciła ponownie trzy dni później, przywracając głębokość 3; patrz niżej), domyślnie równocześnie działa najwyżej 20 subagents (CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS), a --max-budget-usd rzeczywiście zatrzymuje teraz subagents działające w tle po osiągnięciu limitu.¹⁹⁴ Wersja v2.1.218 (22 lipca) przenosi /code-review do subagent działającego w tle — praca związana z przeglądem nie zajmuje już konwersacji — domyślnie uruchamia skills z context: fork w tle (można zrezygnować osobno dla każdej skill za pomocą background: false), sprawia, że /deep-research rozpoczyna działanie wyłącznie po jawnym wywołaniu, przekazuje kontrolę niebezpiecznych poleceń rm, procesów uruchamianych w tle przez & oraz podejrzanych ścieżek Windows klasyfikatorowi auto mode zamiast oknom dialogowym uprawnień, a także uniemożliwia uruchamianie hooks z frontmatter agentów pochodzących z niezaufanych folderów.¹⁹⁵ Wersja v2.1.219 (24 lipca) ustanawia Claude Opus 5 (claude-opus-5) domyślnym modelem Opus — kontekst 1M, maksymalnie 128K tokenów wyjściowych, 5/25 USD za MTok (identycznie jak w Opus 4.8), domyślnie włączone myślenie, domyślna wartość effort równa high, granica wiedzy w maju 2026 — oraz koryguje dwie kwestie wprowadzone przez wcześniejsze wydania: fast mode obejmuje teraz Opus 5 i Opus 4.8 w cenie 10/50 USD za MTok (2× cena bazowa, przy czym Opus 4.7 został całkowicie usunięty z fast mode), a zagnieżdżone subagents są ponownie domyślnie włączone, do głębokości 3 (CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1 wyłącza zagnieżdżanie). To samo wydanie dodaje zdarzenie hook DirectoryAdded, ustawienie sandbox.network.strictAllowlist, klucz ustawień workflowSizeGuideline, przy czym dynamic workflows domyślnie stosują teraz wytyczną średniego rozmiaru (należy dążyć do mniej niż 15 agentów), oraz przekazywanie zagnieżdżonych subagents w stream-json. Wersja v2.1.220 (25 lipca) zawiera wyłącznie poprawki błędów i usprawnienia niezawodności.^196197198 Od wersji v2.1.174–176 (12 czerwca 2026) lista dozwolonych availableModels może ograniczać również model Default za pomocą nowego zarządzanego ustawienia enforceAvailableModels (ustawienia użytkownika ani projektu nie mogą rozszerzyć zarządzanej listy), tytuły sesji są generowane w języku konwersacji (można ustawić konkretny język za pomocą ustawienia language), a wydanie uzupełniają nowe ustawienia footerLinksRegexes i wheelScrollAccelerationEnabled, okno dialogowe atrybucji /usage w VSCode oraz poprawka, dzięki której warunki if hooks dopasowują wzorce ścieżek Read/Edit/Write.¹⁷² Od wersji v2.1.173 (11 czerwca 2026) nazwa modelu Fable 5 z przyrostkiem [1m] jest automatycznie normalizowana przez jego usunięcie — Fable 5 już domyślnie oferuje kontekst 1M, dlatego przyrostek jest zbędny (miał znaczenie wyłącznie dla Opus/Sonnet). Od wersji v2.1.172 (10 czerwca 2026) sub-agents mogły rekurencyjnie uruchamiać własne sub-agents, do głębokości 5 poziomów — ustawienie to obowiązywało do v2.1.216, po czym zostało wyłączone w v2.1.217 (patrz wyżej) — Bedrock odczytuje region z ~/.aws, gdy AWS_REGION nie jest ustawione (/status pokazuje źródło), /plugin dodaje pasek wyszukiwania marketplace, a metryka OTEL claude_code.lines_of_code.count zyskuje atrybut model. Od wersji v2.1.170 (9 czerwca 2026) Claude Fable 5 — nowa klasa modelu wyższa od Opus — jest dostępny do wyboru w Claude Code przez /model fable po wykonaniu claude update (obsługuje pełną skalę wysiłku od low do max, ale nie pozwala wyłączyć myślenia); Opus 4.8 pozostaje domyślnym modelem agentowym. Od wersji v2.1.169 (8 czerwca 2026) --safe-mode (oraz CLAUDE_CODE_SAFE_MODE) uruchamia na potrzeby rozwiązywania problemów czystą sesję z wyłączonymi wszystkimi dostosowaniami, /cd przenosi sesję do nowego katalogu roboczego bez naruszania pamięci podręcznej promptów, a disableBundledSkills ukrywa przed modelem wbudowane skills i polecenia ukośnikowe. Od wersji v2.1.166 (6 czerwca 2026) ustawienie fallbackModel tworzy łańcuch maksymalnie trzech modeli zapasowych na wypadek przeciążenia modelu podstawowego, glob "*" działa w regułach odmowy MCP, a MAX_THINKING_TOKENS=0 / --thinking disabled całkowicie wyłączają myślenie w modelach, które domyślnie mają je włączone. Od wersji v2.1.154 (28 maja 2026) Opus 4.8 jest nowym modelem domyślnym, domyślnie pracuje z wysokim wysiłkiem i oferuje poziom /effort xhigh, dynamic workflows koordynują w tle od dziesiątek do setek agentów za pomocą /workflows, Fast mode w Opus 4.8 kosztuje 2× więcej niż stawka standardowa i zapewnia 2,5× większą szybkość, odchudzony prompt systemowy jest teraz domyślny dla wszystkich modeli z wyjątkiem Haiku/Sonnet/Opus 4.7 i wcześniejszych, /simplify ponownie służy wyłącznie do przeglądu porządkowego (niezależnego od /code-review --fix), claude agents przyjmuje ! <command> w celu uruchamiania sesji powłoki w tle, plugins mogą deklarować defaultEnabled: false, strumieniowe wykonywanie narzędzi jest zawsze włączone, a serwery stdio MCP otrzymują w zmiennych środowiskowych CLAUDE_CODE_SESSION_ID oraz CLAUDECODE=1. Wersja v2.1.153 dodała skipLfs do marketplace plugins, sprawiła, że /model zapisuje wybrany model jako domyślny (klawisz s ogranicza wybór do bieżącej sesji), oraz umieściła COLUMNS/LINES w środowisku wiersza stanu. Wersja v2.1.152 wprowadziła /code-review --fix (stosuje ustalenia w drzewie roboczym), disallowed-tools we frontmatter skill, /reload-skills, nowe zdarzenie hook MessageDisplay, wartości wyjściowe reloadSkills/sessionTitle dla hook SessionStart, zarządzane ustawienie pluginSuggestionMarketplaces, przełączanie --fallback-model w trakcie sesji oraz usunęła konieczność wyrażenia zgody na auto mode.^{162 163 164 165 166 167 168 169 170 206 171}

Claude Code działa jako system agentowy, a nie interfejs czatu dysponujący wiedzą programistyczną. CLI odczytuje bazę kodu, wykonuje polecenia, modyfikuje pliki, zarządza przepływami pracy git, łączy się z usługami zewnętrznymi za pośrednictwem MCP i deleguje złożone zadania wyspecjalizowanym subagents. Wszystko odbywa się przez interfejs wiersza poleceń, który wpisuje się w rzeczywisty sposób pracy programistów. Według stanu na luty 2026 Claude Code jest autorem 4% publicznych commitów GitHub (około 135 000 dziennie) — oznacza to wzrost 42 896× w ciągu 13 miesięcy od wersji research preview — a 90% własnego kodu Anthropic zostało napisane przez AI.¹⁰³

Różnica między okazjonalnym a efektywnym korzystaniem z Claude Code sprowadza się do pięciu podstawowych systemów. Ich opanowanie sprawia, że Claude Code zwielokrotnia możliwości:

1. Hierarchia konfiguracji: steruje zachowaniem
2. System uprawnień: kontroluje dostęp do operacji
3. System hooks: umożliwia deterministyczną automatyzację
4. Protokół MCP: rozszerza możliwości
5. System subagents: obsługuje złożone, wieloetapowe zadania

Najważniejsze wnioski

• O efektywności decyduje pięć systemów: hierarchia konfiguracji, uprawnienia, hooks, MCP i subagents kontrolują wszystko — od zachowania po automatyzację.
• Warto przenosić pracę do warstwy delegowania: subagents zapobiegają nadmiernemu rozrostowi kontekstu, izolując eksplorację w czystych oknach kontekstowych i zwracając wyłącznie podsumowania.
• Hooks gwarantują wykonanie, prompty — nie: do lintowania, formatowania i kontroli bezpieczeństwa, które muszą być uruchamiane za każdym razem niezależnie od zachowania modelu, należy używać hooks.
• Dobór klasy modelu obniża koszty bez pogarszania jakości: eksplorację wykonywaną przez subagents warto kierować do tańszych modeli, zachowując Opus do rzeczywistych analiz architektonicznych — albo ujednolicić pracę na Opus, jeśli liczy się wyłącznie jakość.
• MCP łączy Claude ze stosem narzędziowym: bazy danych, GitHub, Sentry i ponad 3 000 integracji rozszerzają możliwości Claude poza odczytywanie plików i wykonywanie poleceń bash.

Przez wiele miesięcy testowałem granice możliwości Claude Code w produkcyjnych bazach kodu, potokach CI/CD i wdrożeniach korporacyjnych. Ten przewodnik przekłada zdobyte doświadczenie na kompletne źródło wiedzy, którego brakowało mi na początku. Każda funkcja zawiera rzeczywistą składnię, autentyczne przykłady konfiguracji i przypadki brzegowe, które sprawiają problemy nawet doświadczonym użytkownikom.

Wybór ścieżki

Jak korzystać z tego przewodnika

To ponad 5 000 wierszy dokumentacji — nie trzeba czytać jej od deski do deski. Warto zacząć od miejsca odpowiadającego poziomowi doświadczenia:

Aby wyszukać konkretne flagi, polecenia lub klucze konfiguracyjne, można użyć funkcji Ctrl+F / Cmd+F w przeglądarce. Skrócona karta referencyjna na końcu zawiera przejrzyste podsumowanie wszystkich głównych poleceń.

Powiązane analizy szczegółowe

Poniższe wpisy na blogu szczegółowo omawiają wybrane aspekty Claude Code:

Szybki start w 60 sekund

Jeśli celem jest tylko uruchomienie Claude Code i zobaczenie wyniku, należy wykonać po kolei te kroki:

# 1. Install (pick one)
npm install -g @anthropic-ai/claude-code          # npm users
brew install anthropic/claude/claude              # macOS + Homebrew
curl -sL claude.ai/install.sh | sh                # native installer

# 2. Launch in any project directory
cd ~/your-project && claude

# 3. Authenticate (browser opens automatically on first run)
/login

# 4. Ask your first question
> What does this repo do? Read the key files and summarize.

To wszystko. Wszystko poniżej tej sekcji rozwija opcje instalacji, konfiguruje uprawnienia i hooks, podłącza serwery MCP oraz omawia wdrożenie w przedsiębiorstwie, ale żadna z tych rzeczy nie jest wymagana, aby zacząć.

Wymagania wstępne: Node 18+ jest potrzebny tylko w starszej ścieżce npm; zalecany natywny instalator nie ma zależności od Node. Obsługiwane są macOS / Linux / Windows 10+. Użycie obejmuje subskrypcja Claude Pro, Max, Team albo Enterprise bądź klucz Anthropic API rozliczany za tokeny. Szczegóły dla poszczególnych platform, rozwiązywanie problemów i ścieżkę natywnego pliku binarnego (domyślną od v2.1.113) opisuje sekcja Jak zainstalować Claude Code?. Dowody dotyczące najnowszego wydania w tym przewodniku sprawdzono względem v2.1.154.²⁰⁶

Jak działa Claude Code: model mentalny

Zanim przejdzie się do funkcji, warto zrozumieć, jak architektura Claude Code kształtuje wszystko, co się z nim robi. System działa w trzech warstwach:

┌─────────────────────────────────────────────────────────┐
│                    CLAUDE CODE LAYERS                    │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER                                         │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │   MCP   │  │  Hooks  │  │ Skills  │  │ Plugins │    │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘    │
│  External tools, deterministic automation, domain       │
│  expertise, packaged extensions                          │
├─────────────────────────────────────────────────────────┤
│  DELEGATION LAYER                                        │
│  ┌─────────────────────────────────────────────────┐    │
│  │              Subagents (up to 10 parallel)       │    │
│  │   Explore | Plan | General-purpose | Custom      │    │
│  └─────────────────────────────────────────────────┘    │
│  Isolated contexts for focused work, returns summaries  │
├─────────────────────────────────────────────────────────┤
│  CORE LAYER                                              │
│  ┌─────────────────────────────────────────────────┐    │
│  │         Main Conversation Context                │    │
│  │   Tools: Read, Edit, Bash, Glob, Grep, etc.     │    │
│  └─────────────────────────────────────────────────┘    │
│  Your primary interaction; limited context; costs money │
└─────────────────────────────────────────────────────────┘

Warstwa podstawowa: Główna rozmowa. Każda wiadomość, odczyt pliku i wynik narzędzia zużywa kontekst ze współdzielonego okna (standardowo 200K tokenów⁹¹, 1M tokenów z Opus 4.6 lub modelami o rozszerzonym kontekście). Gdy kontekst się zapełnia, Claude traci z oczu wcześniejsze decyzje, a jakość spada. Ta warstwa generuje koszt za token.

Warstwa delegowania: Subagents uruchamiają się z czystymi kontekstami, wykonują ukierunkowaną pracę i zwracają podsumowania. Wyniki eksploracji nie rozdymają głównej rozmowy; wracają tylko wnioski. Do eksploracji można kierować subagents do tańszych poziomów modeli albo używać przez cały czas modelu głównego, jeśli jakość jest ważniejsza niż koszt.

Warstwa rozszerzeń: MCP łączy usługi zewnętrzne (bazy danych, GitHub, Sentry). Hooks gwarantują wykonanie poleceń shell niezależnie od zachowania modelu. Skills kodują wiedzę domenową, którą Claude stosuje automatycznie. Plugins pakują wszystkie te elementy do dystrybucji.

Kluczowa obserwacja: Większość użytkowników pracuje wyłącznie w warstwie podstawowej, obserwując puchnięcie kontekstu i rosnące koszty. Zaawansowani użytkownicy przenoszą eksplorację i pracę specjalistyczną do warstwy delegowania, utrzymują warstwę rozszerzeń skonfigurowaną pod własny workflow, a warstwy podstawowej używają tylko do orkiestracji i decyzji końcowych.

Spis treści

1. Jak zainstalować Claude Code?
2. Szybki start: pierwsza sesja
3. Podstawowe tryby interakcji
4. Dogłębny opis systemu konfiguracji
5. Który model wybrać?
6. Ile kosztuje Claude Code?
7. Ramy decyzyjne
8. Jak działa system uprawnień?
9. Jak działają hooks?
10. Czym jest MCP (Model Context Protocol)?
11. Czym są subagents?
12. Czym jest tryb rozszerzonego myślenia?
13. Style wyjścia
14. Slash Commands
15. Jak działają skills?
16. System plugins
17. Jak działa pamięć?
18. Obraz i wejście multimodalne
19. Tryb głosowy
20. Jak działa integracja z Git?
21. Jak używać Claude Code w IDE?
22. Zaawansowane wzorce użycia
23. Agenci zdalni i działający w tle [RESEARCH PREVIEW]
24. Claude w Chrome
25. Claude Code w Slack [RESEARCH PREVIEW]
26. Claude Code w przeglądarce [RESEARCH PREVIEW]
27. Optymalizacja wydajności
28. Jak debugować problemy?
29. Wdrożenie w przedsiębiorstwie
30. Skróty klawiaturowe
31. Najlepsze praktyki
32. Przepisy workflow
33. Przewodnik migracji
34. Wskazówki dla konkretnych grup odbiorców
35. Szybka ściąga
36. Changelog
37. Źródła

Jak zainstalować Claude Code?

Wymagania systemowe

Claude Code działa na macOS 13+, Ubuntu 20.04+/Debian 10+ oraz Windows 10+ (natywnie lub WSL). System wymaga co najmniej 4 GB pamięci RAM oraz aktywnego połączenia internetowego.⁹² Najlepszą kompatybilność powłoki zapewniają Bash, Zsh lub Fish.

W przypadku systemu Windows działają zarówno WSL 1, jak i WSL 2. Git Bash również działa, jeśli preferowane jest natywne środowisko Windows. Alpine Linux i inne systemy oparte na musl wymagają dodatkowych pakietów:

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

Macierz wsparcia platform

Instalacja, aktualizacja i odinstalowanie w skrócie

Skanowalna ściąga — każda metoda, każde polecenie, sprawdzenie wersji na jednym ekranie. Poniższe podsekcje obejmują szczegóły dotyczące poszczególnych metod oraz rozwiązywanie problemów.

Od v2.1.113 kanoniczne CLI uruchamia natywny plik binarny Claude Code poprzez opcjonalną zależność dla danej platformy zamiast dołączonego JavaScript — należy używać natywnego instalatora dla testowanej dystrybucji. Ścieżka npm nadal działa, ale otrzymuje powiadomienie o wycofaniu wprowadzone w v2.1.15.

Metody instalacji

Natywna instalacja (zalecana)

Natywny plik binarny zapewnia najczystsze doświadczenie bez zależności od Node.js:

# macOS and Linux
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew alternative
brew install --cask claude-code

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Instalacja konkretnej wersji:

# Install specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Install latest explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell - specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Instalacja przez NPM (przestarzała)

Uwaga: Od v2.1.15 instalacje npm wyświetlają powiadomienie o wycofaniu. Natywny plik binarny jest obecnie zalecaną metodą instalacji. Migrację można wykonać poleceniem claude install.

W przypadku środowisk legacy, w których nadal potrzebny jest npm:

npm install -g @anthropic-ai/claude-code

Nigdy nie należy używać sudo przy instalacji npm. Powoduje to problemy z uprawnieniami, które komplikują wszystko w dalszej kolejności.

Migracja z istniejącej instalacji

Jeśli posiada się starszą instalację opartą na npm, można wykonać migrację do natywnego pliku binarnego:

claude install

Opcje uwierzytelniania

Claude Code obsługuje trzy ścieżki uwierzytelniania, każda z innymi kompromisami:

Claude Console (rozliczenia API)

Łączy się bezpośrednio z API firmy Anthropic przez platform.claude.com (wcześniej console.anthropic.com). Należy utworzyć konto, skonfigurować rozliczenia i uwierzytelnić się przez CLI. Console zapewnia rozliczenia oparte na zużyciu z pełnym dostępem do API. Dedykowany obszar roboczy „Claude Code” jest tworzony automatycznie; nie można utworzyć kluczy API dla tego obszaru roboczego, ale można monitorować zużycie.

Subskrypcja Claude Pro lub Max

Należy użyć danych logowania konta claude.ai. Subskrypcja pokrywa zarówno interfejs webowy, jak i użycie CLI w ramach jednego miesięcznego planu. Subskrypcja upraszcza rozliczenia dla użytkowników indywidualnych, którzy oczekują przewidywalnych kosztów.

Platformy korporacyjne

AWS Bedrock, Google Vertex AI i Microsoft Foundry zapewniają dostęp klasy korporacyjnej z istniejącymi relacjami rozliczeniowymi w chmurze. Kreator konfiguracji Bedrock (v2.1.92+): Interaktywny kreator na ekranie logowania prowadzi przez uwierzytelnianie AWS, wybór regionu, weryfikację poświadczeń oraz przypinanie modelu.¹³⁷ Kreator konfiguracji Vertex AI (v2.1.98+): Pasujący kreator dla Google Cloud, prowadzący przez uwierzytelnianie GCP, konfigurację projektu i regionu, weryfikację poświadczeń oraz przypinanie modelu.¹⁴² Vertex AI mTLS Workload Identity Federation (v2.1.121+): Vertex AI akceptuje teraz Workload Identity Federation oparte na certyfikatach X.509 (mTLS Application Default Credentials) — krótkotrwałe tokeny GCP wybijane z certyfikatu klienta, bez wymogu JSON konta usługi.¹⁵⁴ Zaufanie do certyfikatu CA systemu operacyjnego (v2.1.101+): Korporacyjne proxy TLS działają teraz domyślnie — Claude Code ufa magazynowi certyfikatów systemu operacyjnego. Należy ustawić CLAUDE_CODE_CERT_STORE=bundled, aby używać tylko dołączonych urzędów CA.¹⁴³

# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile

# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project

# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# Optional: API key auth (otherwise uses Entra ID)
export ANTHROPIC_FOUNDRY_API_KEY=your-key

# Amazon Bedrock via Mantle (v2.1.94+)
export CLAUDE_CODE_USE_MANTLE=1

W przypadku wdrożeń korporacyjnych za serwerami proxy lub przez bramy LLM:

# Corporate proxy
export HTTPS_PROXY='https://proxy.example.com:8080'

# LLM gateway (skip native auth)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1

Weryfikacja

claude doctor

Polecenie raportuje typ instalacji, wersję, konfigurację systemu oraz wszelkie wykryte problemy.

Zarządzanie uwierzytelnianiem (v2.1.41+)

Zarządzanie uwierzytelnianiem bez wchodzenia do REPL:⁹⁰

claude auth login          # Log in or switch accounts
claude auth status         # Check current auth state (account, plan, expiry)
claude auth logout         # Clear stored credentials

Typowy przepływ pracy przy przełączaniu między kontami lub organizacjami:

claude auth logout && claude auth login

Patrz także: Jak debugować problemy?, aby uzyskać informacje o rozwiązywaniu problemów z uwierzytelnianiem.

Aktualizacje

Claude Code aktualizuje się automatycznie domyślnie, sprawdzając przy uruchomieniu i okresowo podczas sesji. Aktualizacje pobierają się w tle i są stosowane przy następnym uruchomieniu.

Wyłączanie automatycznych aktualizacji:

export DISABLE_AUTOUPDATER=1

Lub w settings.json:

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

Aktualizacja ręczna:

claude update

Odinstalowanie

Natywna instalacja (macOS/Linux/WSL):

rm -f ~/.local/bin/claude
rm -rf ~/.claude-code

Natywna instalacja (Windows PowerShell):

Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force

Czysta konfiguracja (usuwa wszystkie ustawienia):

rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json

Szybki start: pierwsza sesja

1. Instalacja i uruchomienie:

claude                           # Launch in current directory

2. Przejście do projektu:

cd ~/my-project && claude        # Or launch from any git repo

3. Poproszenie Claude o wykonanie zadania:

> "Explain the architecture of this project"
> "Find all TODO comments and create a summary"
> "Add input validation to the signup form"

4. Korzystanie ze skrótów klawiszowych podczas sesji:

/cost                            # Check token usage and cost
/compact                         # Free up context when it gets large
Alt+T                            # Toggle extended thinking for hard problems
Ctrl+C                           # Cancel current response

5. Kontynuowanie pracy później:

claude -c                        # Resume your most recent session
claude --resume                  # Pick from session list

Wskazówka dla ekspertów: W katalogu głównym projektu warto utworzyć plik CLAUDE.md zawierający polecenia kompilacji, konwencje kodowania i uwagi dotyczące architektury. Claude odczytuje go podczas każdej sesji — to jedna zmiana, która może przynieść największą poprawę jakości.

Podstawowe tryby interakcji

Interaktywny REPL

Uruchom Claude Code bez argumentów, aby przejść do interaktywnej pętli odczyt–obliczenie–wyświetlenie:

cd your-project
claude

REPL zachowuje kontekst rozmowy między kolejnymi turami. Wystarczy wpisywać zapytania, odbierać odpowiedzi i kontynuować pracę aż do zakończenia sesji za pomocą /exit lub Ctrl+D.

Aby nadać sesji określony kierunek, można rozpocząć ją od początkowego promptu:

claude "explain the authentication flow in this project"

Wskazówka ekspercka: REPL zachowuje stan również podczas kompakcji. Gdy kontekst staje się zbyt obszerny, Claude automatycznie podsumowuje starszą część rozmowy, zachowując najważniejsze decyzje i fragmenty kodu. Można również uruchomić ten proces ręcznie za pomocą /compact lub dodać niestandardowe instrukcje określające, co należy zachować.

Tryb nieinteraktywny

Tryb drukowania (-p) wykonuje pojedyncze zapytanie, po czym kończy działanie:

# Direct query
claude -p "list all TODO comments in this project"

# Process piped input
cat error.log | claude -p "identify the root cause of these failures"

# Chain with other tools
claude -p "generate a README" > README.md

Aby uzyskać ustrukturyzowane dane wyjściowe odpowiednie do przetwarzania w skryptach:

claude -p "count lines by file type" --output-format json

Dane wyjściowe JSON zawierają wszystko, co jest potrzebne do automatyzacji:

{
  "type": "result",
  "subtype": "success",
  "total_cost_usd": 0.0034,
  "is_error": false,
  "duration_ms": 2847,
  "duration_api_ms": 1923,
  "num_turns": 4,
  "result": "Response text here...",
  "session_id": "abc-123-def"
}

Do przetwarzania strumieniowych danych wyjściowych w czasie rzeczywistym:

claude -p "build the application" --output-format stream-json | while read line; do
  echo "$line" | jq -r 'select(.result) | .result'
done

Opcje formatu danych wyjściowych:

Tekst subagents w stream-json (v2.1.211+): Domyślnie dane wyjściowe stream-json zawierają wyłącznie zdarzenia z głównej sesji — praca wykonana wewnątrz subagents jest widoczna w formie podsumowania. Flaga --forward-subagent-text (lub CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1) przekazuje do strumienia również tekst i proces rozumowania subagents, dzięki czemu systemy wykonawcze i potoki rejestrowania mogą obserwować delegowaną pracę na bieżąco, zamiast widzieć wyłącznie raport końcowy.¹⁸⁸

Zagnieżdżone subagents są teraz również przekazywane (v2.1.219). Początkowo widoczne były wyłącznie subagents na głębokości 1. Teraz w przekazywanym strumieniu pojawiają się także subagents uruchomione na głębokości 2 i większej, a każde z nich jest identyfikowane przez identyfikator tool_use wywołania Agent, które je uruchomiło — dzięki temu potok może odtworzyć drzewo delegowania zamiast wyświetlać płaską listę tekstu. Funkcja ta bezpośrednio uzupełnia przywróconą w tym samym wydaniu możliwość domyślnego uruchamiania zagnieżdżonych subagents do głębokości 3: bez niej dwa z trzech poziomów pozostałyby niewidoczne.¹⁹⁶

Kody zakończenia:

Sterowanie zachowaniem agentowym w trybie -p:

# Limit autonomous turns (prevents runaway loops)
claude -p "refactor the auth module" --max-turns 10

# Allow specific tools without prompting
claude -p "fix lint errors" --allowedTools "Edit,Bash(npm run lint)"

# Use with a specific model
claude -p "explain this code" --model claude-sonnet-4-5-20250929

# Bare mode: skip hooks, LSP, plugin sync, skill walks (v2.1.81+)
claude -p "count files" --bare

# Channel permission relay: send approval prompts to Telegram/Discord (v2.1.81+)
claude --channels

Wzorzec integracji z CI/CD:

# In a GitHub Action or CI pipeline
result=$(claude -p "review this diff for security issues" --output-format json 2>/dev/null)
is_error=$(echo "$result" | jq -r '.is_error')
if [ "$is_error" = "true" ]; then
  echo "Review failed"
  exit 1
fi
echo "$result" | jq -r '.result'

Zarządzanie sesjami

Sesje zachowują historię rozmowy, umożliwiając jej kontynuowanie. Trwałość sesji ma kluczowe znaczenie w przypadku złożonej pracy rozłożonej na wiele sesji:

# Continue most recent session
claude -c

# Continue with additional prompt
claude -c -p "now add error handling"

# Resume specific session by ID
claude -r "abc123" "implement the remaining tests"

# Fork a session for parallel exploration
claude -r "base-session" --fork-session "try a different approach"

Sesje powiązane z PR (v2.1.27+, rozszerzone w v2.1.119+): Można rozpocząć sesję powiązaną z konkretnym pull requestem lub merge requestem. Od wersji v2.1.119 opcja --from-pr przyjmuje — oprócz adresów z github.com — również adresy URL GitLab MR, Bitbucket PR i GitHub Enterprise PR:⁷⁴¹⁵²

claude --from-pr 123                                                # GitHub PR number (assumes current repo's remote)
claude --from-pr https://github.com/org/repo/pull/123               # GitHub URL
claude --from-pr https://gitlab.com/org/repo/-/merge_requests/45    # GitLab MR (v2.1.119+)
claude --from-pr https://bitbucket.org/org/repo/pull-requests/67    # Bitbucket PR (v2.1.119+)
claude --from-pr https://ghe.example.com/org/repo/pull/89           # GitHub Enterprise (v2.1.119+)

Sesje są również automatycznie wiązane z PR tworzonymi podczas sesji za pomocą gh pr create. Ułatwia to późniejsze wznowienie pracy nad konkretnym PR. Od wersji v2.1.119 odznaka PR w stopce może wskazywać niestandardowy adres URL przeglądu kodu za pośrednictwem ustawienia prUrlTemplate — jest to przydatne, gdy zespół korzysta z odsyłaczy z PR do osobnego narzędzia do przeglądu kodu.¹⁵²

/resume przyjmuje adresy URL PR (v2.1.122+). Wklejenie adresu URL PR w polu wyszukiwania /resume pozwala teraz odnaleźć sesję, w której pierwotnie utworzono ten PR — działa to w serwisach github.com, GitHub Enterprise, gitlab.com (oraz we własnych instancjach GitLab) i bitbucket.org.¹⁵⁴

Nazwane sesje: Sesjom można nadawać nazwy podczas uruchamiania lub w trakcie ich trwania:

# Name session at startup (v2.1.76+)
claude -n "auth-refactor"                  # --name flag sets display name[^125]

# Name current session
> /rename auth-refactor

# Resume by name or number
> /resume 1                    # Resume first session
> /resume auth-refactor        # Resume by name
claude --resume auth-refactor  # Resume from terminal
claude -r 3                    # Resume by number from terminal

# Fork for parallel exploration
claude --resume auth-refactor --fork-session

Uwaga: --session-id wymaga prawidłowego identyfikatora UUID (np. 550e8400-e29b-41d4-a716-446655440000). Aby nadawać sesjom nazwy czytelne dla człowieka, należy używać /rename i --resume.

/fork uruchamia sesję w tle, a /subtask tworzy rozwidlenie w bieżącej sesji (v2.1.212). Polecenie /fork kopiuje teraz bieżącą rozmowę do nowej sesji działającej w tle — otrzymuje ona własny wiersz w claude agents, dzięki czemu kopię można skierować do zbadania alternatywnego rozwiązania, kontynuując jednocześnie główną sesję. Poprzednie działanie — tworzenie rozwidlenia w bieżącej sesji — jest nadal dostępne pod nową nazwą /subtask.¹⁸⁹ Od wersji v2.1.214 sesja rozpoczęta jako rozwidlenie zgłasza źródło hook SessionStart jako "fork" (wcześniej "resume"), dzięki czemu hooks dopasowujące źródło mogą odróżnić te dwa przypadki.¹⁹⁰ W wersji v2.1.216 potwierdzenie /fork skrócono do jednego wiersza zawierającego nazwę nowej sesji oraz jej identyfikator claude attach.¹⁹²

Claude Code przechowuje sesje jako transkrypcje JSONL. Podczas wykonywania Agent przypisywane są unikatowe wartości agentId, a transkrypcje są zapisywane jako agent-{agentId}.jsonl. Wznowienie zachowuje pełny kontekst poprzednich rozmów.

Tryb planowania

Tryb planowania ogranicza Claude do eksploracji tylko do odczytu — bez edytowania plików, wykonywania Bash ani działań destrukcyjnych. Claude opracowuje podejście do implementacji, zapisuje je w pliku planu i czeka na zatwierdzenie przed wykonaniem jakichkolwiek działań.

Przechodzenie do trybu planowania:

# Cycle through modes during a session
Shift+Tab           # Cycles: normal → plan → auto-accept

# Or use the /plan command with an optional description (v2.1.72+)
/plan                                     # Enter plan mode
/plan refactor the auth module            # Enter plan mode with a description

# Or ask Claude directly
"Plan how to refactor the auth module"   # Claude may enter plan mode automatically

Jak to działa:

1. Claude przechodzi do trybu planowania (automatycznie w przypadku złożonych zadań lub za pomocą Shift+Tab)
2. Eksploruje bazę kodu przy użyciu narzędzi tylko do odczytu: Read, Glob, Grep, WebSearch, WebFetch
3. Zapisuje plan w .claude/plans/{session-slug}.md
4. Opuszcza tryb planowania za pomocą ExitPlanMode, przedstawiając plan do weryfikacji
5. Można zatwierdzić plan, poprosić o zmiany lub go odrzucić

Narzędzia dostępne w trybie planowania: Read, Glob, Grep, LS, WebSearch, WebFetch, AskUserQuestion. Narzędzia do edycji (Edit, Write, Bash, NotebookEdit) są zablokowane.

Po zatwierdzeniu planu (v2.1.32+): Claude oferuje trzy opcje: - „Tak, wyczyść kontekst i automatycznie akceptuj zmiany” (Shift+Tab) — rozpoczyna pracę od nowa, z pełnym kontekstem przeznaczonym na plan - „Tak, i ręcznie zatwierdzaj zmiany” — zachowuje kontekst, a każdą zmianę należy zatwierdzić - „Tak, automatycznie akceptuj zmiany” — zachowuje kontekst, a Claude wykonuje plan bez zatwierdzania każdej zmiany osobno

Automatyczne czyszczenie kontekstu po zatwierdzeniu jest zalecanym sposobem pracy. Zapewnia planowi świeże okno kontekstu, co znacznie zwiększa zgodność realizacji z planem — Claude dłużej trzyma się wyznaczonego kierunku, ponieważ wcześniejsza rozmowa nie zakłóca pracy.

Kiedy warto używać trybu planowania: - Implementowanie nowych funkcji wymagających decyzji architektonicznych - Refaktoryzacja wielu plików, gdy najpierw należy zweryfikować podejście - Nieznane bazy kodu, w których eksploracja powinna poprzedzać modyfikacje - Każde zadanie, dla którego istnieje kilka prawidłowych podejść i potrzebne jest uzgodnienie wyboru

Wskazówka ekspercka: Im więcej czasu poświęci się na tryb planowania, tym większe prawdopodobieństwo, że Claude pomyślnie przeprowadzi implementację. Tryb planowania pozwala na eksplorację praktycznie bez kosztów — nie wiąże się z ryzykownymi wywołaniami narzędzi ani zmarnowanymi zmianami. Warto korzystać z niego często.

Tryb czytnika ekranu (v2.1.208)

Claude Code udostępnia specjalny tryb czytnika ekranu, który dostosowuje interfejs terminala do technologii wspomagających. Można go włączyć na jeden z trzech sposobów:¹⁸⁶

# Flag at launch
claude --ax-screen-reader

# Environment variable
export CLAUDE_AX_SCREEN_READER=1

# Or persistently in settings.json
{ "axScreenReader": true }

Anthropic opisuje ten tryb — wraz ze sposobami interakcji — na nowej stronie poświęconej dostępności w oficjalnej dokumentacji.¹⁸⁶

Szczegółowy opis systemu konfiguracji

Claude Code korzysta z warstwowego systemu konfiguracji. Zrozumienie hierarchii jest kluczowe, ponieważ wyższe poziomy zastępują niższe, a ustawień firmowych nie można w żaden sposób obejść.

Hierarchia konfiguracji

Wskazówka ekspercka: Warto używać .claude/settings.local.json do osobistych preferencji we współdzielonych projektach (i dodać ten plik do .gitignore). Plik .claude/settings.json służy do konfiguracji obejmującej cały zespół, która trafia do systemu kontroli wersji.

Ustawianie konfiguracji z poziomu promptu: /config key=value (v2.1.181)

Od wersji v2.1.181 polecenie /config key=value pozwala ustawić dowolną opcję bezpośrednio z poziomu promptu — np. /config thinking=false — bez otwierania interaktywnego interfejsu /config. Działa ono w sesjach interaktywnych, -p i Remote Control. Polecenie /config --help (v2.1.183) wyświetla dostępne skrócone klucze. W wersji v2.1.183 zmieniono również interaktywny interfejs /config: zarówno Enter, jak i spacja przełączają wybrane ustawienie, a Esc zapisuje zmiany i zamyka interfejs (wcześniej wycofywał zmiany).¹⁷⁴

Pełna dokumentacja settings.json

Pełna konfiguracja prezentująca wszystkie najważniejsze opcje:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-5-20250929",
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Bash(npm run:*)",
      "Bash(git:*)",
      "Bash(make:*)",
      "Edit(src/**)",
      "mcp__github"
    ],
    "deny": [
      "Read(.env*)",
      "Read(secrets/**)",
      "Bash(rm -rf:*)",
      "Bash(sudo:*)",
      "Edit(package-lock.json)",
      "Edit(.git/**)"
    ],
    "ask": [
      "WebFetch",
      "Bash(curl:*)",
      "Bash(docker:*)"
    ],
    "additionalDirectories": [
      "../shared-lib",
      "../docs"
    ],
    "defaultMode": "acceptEdits"
  },
  "env": {
    "NODE_ENV": "development",
    "DEBUG": "app:*"
  },
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ]
  },
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"]
  },
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30,
  "outputStyle": "Explanatory",
  "language": "en",
  "respectGitignore": true,
  "showTurnDuration": true,
  "plansDirectory": ".claude/plans",
  "spinnerVerbs": ["Thinking", "Processing", "Analyzing"],
  "spinnerTipsOverride": {
    "tips": ["Custom tip 1", "Custom tip 2"],
    "excludeDefault": true
  },
  "skillOverrides": {
    "legacy-skill": "off",
    "manual-only-skill": "user-invocable-only",
    "compact-skill": "name-only"
  },
  "includeGitInstructions": false,
  "modelOverrides": {
    "bedrock": "us.anthropic.claude-opus-4-6-20260312-v1:0",
    "vertex": "claude-opus-4-6@20260312",
    "foundry": "anthropic.claude-opus-4-6"
  },
  "autoMemoryDirectory": ".claude/memory",
  "sandbox": {
    "enableWeakerNetworkIsolation": true
  }
}

skillOverrides przydaje się, gdy zespół dysponuje dużą biblioteką skills, ale chce ściślej kontrolować ich dostępność w środowisku wykonawczym. Warto użyć off, aby ukryć skill zarówno przed modelem, jak i selektorem poleceń slash, user-invocable-only, aby zachować możliwość wywoływania go według nazwy, jednocześnie wyłączając go z wyboru dokonywanego przez model, oraz name-only, aby pozostawić widoczną wyłącznie nazwę skill bez pełnego opisu.¹⁵⁶

Nowsze ustawienia (v2.1.174–176):

• availableModels / enforceAvailableModels (zarządzane, v2.1.175+): lista dozwolonych wartości availableModels ogranicza modele, które można wybrać w sesji. Przy ustawieniu enforceAvailableModels: true lista ta obejmuje również model Default — jeśli Default wskazywałby niedozwolony model, użyty zostanie pierwszy dozwolony model — a ustawienia użytkownika lub projektu nie mogą już rozszerzać zarządzanej listy availableModels. Powiązana poprawka (v2.1.176) eliminuje lukę, przez którą wybranie aliasu mogło przekierować do zablokowanego modelu za pośrednictwem ANTHROPIC_DEFAULT_*_MODEL; ponadto /fast odmawia teraz przełączenia na model spoza listy dozwolonych.¹⁷² Od wersji v2.1.187 organizacje mogą wymuszać ograniczenia modeli bezpośrednio w selektorze /model, opcjach --model i /model oraz zmiennej ANTHROPIC_MODEL — wybranie modelu objętego ograniczeniami powoduje wyświetlenie komunikatu „ograniczony przez ustawienia organizacji”.¹⁷⁶
• language (udoskonalenie w v2.1.176): oprócz określania języka odpowiedzi ustawienie wpływa teraz także na tytuły sesji, które domyślnie są generowane w języku rozmowy; ustawienie language pozwala przypisać tytułom konkretny język.¹⁷²
• footerLinksRegexes (v2.1.176): odznaki linków dopasowywane za pomocą wyrażeń regularnych w wierszu stopki, konfigurowalne w ustawieniach użytkownika lub zarządzanych.¹⁷²
• wheelScrollAccelerationEnabled (v2.1.174): ustawienie false wyłącza przyspieszenie przewijania kółkiem myszy w trybie pełnoekranowym.¹⁷²

Nowsze ustawienia (v2.1.207–v2.1.212):

• vimInsertModeRemaps (v2.1.208): niestandardowe mapowania klawiszy w trybie wstawiania vim — klasycznym przykładem jest przypisanie jj do klawisza Escape (zob. Tryb Vim).¹⁸⁶
• axScreenReader (v2.1.208): trwałe włączenie trybu czytnika ekranu (zob. Tryb czytnika ekranu).¹⁸⁶
• processWrapper (v2.1.208): kierowanie każdego procesu uruchamianego przez Claude Code na własne potrzeby przez wykonywalny program opakowujący — funkcja przeznaczona dla firmowych programów uruchamiających (zob. Wdrożenie firmowe).¹⁸⁶
• Ograniczenie źródła autoMode (v2.1.207): ustawienie autoMode nie jest już odczytywane z pliku .claude/settings.local.json repozytorium — należy skonfigurować je w ~/.claude/settings.json. Eliminuje to możliwość dostarczenia konfiguracji trybu automatycznego przez sklonowane repozytorium.¹⁸⁵

Nowsze ustawienia (v2.1.217):

• emojiCompletionEnabled (v2.1.217): automatyczne uzupełnianie skrótów emoji w polu promptu — wpisanie :heart: wstawia ❤️, a wpisanie fragmentu, takiego jak :hea, wyświetla sugestie. Funkcja jest domyślnie włączona; ustawienie false ją wyłącza.¹⁹⁴

Nowsze ustawienia (v2.1.219):

• sandbox.network.strictAllowlist (v2.1.219): odrzucanie hostów spoza listy dozwolonych w przypadku poleceń uruchamianych w sandboxie bez wyświetlania pytania, zamiast otwierania okna dialogowego uprawnień. Zob. Tryb sandbox.¹⁹⁶
• workflowSizeGuideline (v2.1.219): umożliwia ustawienie doradczego zalecenia dotyczącego rozmiaru Dynamic workflow w dowolnym pliku ustawień — użytkownika, projektu lub zarządzanym — a nie wyłącznie za pośrednictwem /config. Domyślnie Dynamic workflows korzystają z zalecenia medium („należy dążyć do użycia mniej niż 15 agentów”); wiersz /config zostaje ukryty, gdy wartość pochodzi z pliku ustawień. Jest to zalecenie, a nie wymuszony limit. Zob. Subagents.¹⁹⁶

Dokumentacja zmiennych środowiskowych

Uwierzytelnianie i API:

ANTHROPIC_API_KEY=sk-ant-...                    # Direct API authentication
ANTHROPIC_AUTH_TOKEN=token                      # Custom authorization header
ANTHROPIC_CUSTOM_HEADERS="X-Key: val"           # Additional request headers

Konfiguracja modelu:

ANTHROPIC_MODEL=claude-opus-4-7                 # Override default model (Apr 16, 2026)
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7    # Opus 4.7 (Max/Team Premium default)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001
CLAUDE_CODE_SUBAGENT_MODEL=sonnet               # Model for subagents
CLAUDE_CODE_WORKFLOWS=1                         # Enable Workflow tool for deterministic multi-agent orchestration (v2.1.147+)
MAX_THINKING_TOKENS=10000                       # (Opus 4.6 and Sonnet 4.6 only — removed in Opus 4.7)
CLAUDE_CODE_MAX_OUTPUT_TOKENS=4000              # Limit output length
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1          # Enable agent teams (v2.1.32+)

Konfiguracja dostawcy usług chmurowych:

CLAUDE_CODE_USE_BEDROCK=1                       # Use AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1                        # Use Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1                       # Use Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL=https://...          # Custom Bedrock endpoint
ANTHROPIC_BEDROCK_SERVICE_TIER=priority         # Bedrock service tier (v2.1.122+): 'default', 'flex', or 'priority'; sent as X-Amzn-Bedrock-Service-Tier header[^162]
CLAUDE_CODE_SKIP_BEDROCK_AUTH=1                 # Skip Bedrock auth (for gateways)
CLAUDE_CODE_SKIP_VERTEX_AUTH=1                  # Skip Vertex auth
AWS_BEARER_TOKEN_BEDROCK=token                  # Bedrock bearer token
VERTEX_REGION_CLAUDE_3_7_SONNET=us-west1        # Override Vertex region
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1    # Opt in gateway /v1/models discovery for /model picker (v2.1.129+)[^164]

Sterowanie zachowaniem:

DISABLE_AUTOUPDATER=1                           # Prevent automatic background updates
DISABLE_UPDATES=1                               # Block ALL update paths including manual `claude update` (v2.1.118+, stricter than DISABLE_AUTOUPDATER)[^160]
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1       # Homebrew/WinGet installs run package-manager upgrade in background, then prompt restart (v2.1.129+)[^164]
DISABLE_TELEMETRY=1                             # Opt out of usage telemetry
DISABLE_ERROR_REPORTING=1                       # Disable Sentry
DISABLE_BUG_COMMAND=1                           # Disable /bug command
DISABLE_COST_WARNINGS=1                         # Hide cost warnings
DISABLE_PROMPT_CACHING=1                        # Disable prompt caching globally
DISABLE_PROMPT_CACHING_SONNET=1                 # Disable for Sonnet only
DISABLE_PROMPT_CACHING_OPUS=1                   # Disable for Opus only
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1             # Skip non-critical API calls
ENABLE_PROMPT_CACHING_1H=1                      # Opt into 1-hour prompt cache TTL (v2.1.108+, API/Bedrock/Vertex/Foundry)
ENABLE_PROMPT_CACHING_1H_BEDROCK=1              # Deprecated alias for the above; v2.1.108+ still honors it on Bedrock but logs a deprecation notice
FORCE_PROMPT_CACHING_5M=1                       # Force 5-minute cache TTL (v2.1.108+)
ENABLE_TOOL_SEARCH=true                         # Re-enable tool search on Vertex AI (disabled by default v2.1.119+ to avoid unsupported beta header). Valid values: true, false, auto, auto:N[^160]
CLAUDE_CODE_HIDE_CWD=1                          # Hide the working directory in the startup logo (v2.1.119+)[^160]
CLAUDE_CODE_FORK_SUBAGENT=1                     # Enable forked subagents on external builds (v2.1.117+)[^160]
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1                 # Force synchronized terminal output when auto-detection misses it, such as Emacs eat (v2.1.129+)[^164]
CLAUDE_CODE_SESSION_ID=...                      # Read-only: present in the Bash tool subprocess; matches the session_id passed to hooks (v2.1.132+)[^168]
CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1          # Skip the fullscreen alternate-screen renderer; keep the conversation in the terminal's native scrollback (v2.1.132+)[^168]
CLAUDE_EFFORT=...                               # Read-only: current effort level inside hooks and Bash tool subprocess (v2.1.133+)[^169]
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1             # Include subagent text + thinking in stream-json output; pairs with --forward-subagent-text (v2.1.211+). Covers depth-2+ nested subagents as of v2.1.219[^205][^213]
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION=200    # Per-session WebSearch cap (default 200; v2.1.212+)[^206]
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=200       # Per-session subagent-spawn cap (default 200; /clear resets the budget; v2.1.212+)[^206]
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=20         # Cap on concurrently-RUNNING subagents (default 20; distinct from the per-session total above; v2.1.217+)[^211]
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=3          # Nested subagent spawn depth. Default 3 as of v2.1.219; set 1 to disable nesting. Default history: 5 (v2.1.172–v2.1.216) → 1 (v2.1.217) → 3 (v2.1.219). Set it explicitly[^211][^213]

Konfiguracja narzędzi:

BASH_DEFAULT_TIMEOUT_MS=30000                   # Bash command timeout (30s)
BASH_MAX_TIMEOUT_MS=600000                      # Maximum bash timeout (10min)
BASH_MAX_OUTPUT_LENGTH=50000                    # Bash output limit
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1     # Reset CWD after each bash
MCP_TIMEOUT=5000                                # MCP server startup timeout
MCP_TOOL_TIMEOUT=30000                          # MCP tool execution timeout
MAX_MCP_OUTPUT_TOKENS=25000                     # MCP output limit
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS=120000       # Threshold before a long MCP tool call moves to the background (default 2 min; v2.1.212+)[^206]
SLASH_COMMAND_TOOL_CHAR_BUDGET=15000            # Slash command context limit

Sieć i proxy:

HTTP_PROXY=http://proxy:8080                    # HTTP proxy
HTTPS_PROXY=https://proxy:8080                  # HTTPS proxy
NO_PROXY=localhost,example.com                  # Bypass proxy for domains
CLAUDE_CODE_CLIENT_CERT=/path/to/cert           # mTLS certificate
CLAUDE_CODE_CLIENT_KEY=/path/to/key             # mTLS private key
CLAUDE_CODE_CLIENT_KEY_PASSPHRASE=pass          # mTLS passphrase

Interfejs użytkownika i terminal:

CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1            # Don't update terminal title
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1             # Skip IDE extension install
CLAUDE_CODE_SHELL=/bin/zsh                      # Override shell detection
USE_BUILTIN_RIPGREP=1                           # Use included ripgrep (default)
CLAUDE_CONFIG_DIR=~/.myconfig                   # Custom config directory
IS_DEMO=1                                       # Hide sensitive UI elements[^37]
CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1          # Disable background tasks and Ctrl+B[^46]
CLAUDE_CODE_TMPDIR=/path/to/tmp                 # Override temp directory[^50]
CLAUDE_CODE_DISABLE_1M_CONTEXT=1               # Disable 1M context window (use standard 200K)[^103]
CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=120000       # Plugin marketplace git timeout (default 120s, was 30s)[^105]
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1        # Remove built-in commit/PR instructions[^117]
CLAUDE_CODE_DISABLE_CRON=1                    # Stop scheduled cron jobs mid-session[^121]
CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS=30000 # SessionEnd hooks timeout (default varies)[^123]
CLAUDE_CODE_USE_POWERSHELL_TOOL=1             # Enable Windows PowerShell tool on Linux/macOS (requires pwsh on PATH; v2.1.111+)[^153]
CLAUDE_CODE_DISABLE_MOUSE_CLICKS=1           # Disable mouse click/drag/hover in fullscreen mode; wheel scroll still works (v2.1.195+)[^196]
CLAUDE_ENABLE_STREAM_WATCHDOG=0              # Disable the streaming idle watchdog (on by default for all providers since v2.1.196: aborts+retries after 5 min of silence)[^198]
CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP=1 # Turn off automatic memory-pressure reaping of idle background shell commands (v2.1.193+)[^196]
CLAUDE_CODE_ENABLE_AWAY_SUMMARY=1             # Force Session Recap when telemetry disabled (v2.1.108+)[^153]
CLAUDE_AX_SCREEN_READER=1                     # Enable screen reader mode; same as --ax-screen-reader or "axScreenReader": true (v2.1.208+)[^203]
OTEL_LOG_RAW_API_BODIES=1                     # Emit full API request/response bodies as OTel log events (v2.1.111+)[^153]
TRACEPARENT=00-...                            # W3C Trace Context parent (v2.1.110+, SDK/headless)[^153]
TRACESTATE=vendor=value                       # W3C Trace Context state (v2.1.110+, SDK/headless)[^153]

Eksportery OpenTelemetry i kontrola dostępu do pól poufnych:²⁰⁷

OTEL_LOGS_EXPORTER=none                       # OTel logs exporter (supports 'none' for disable; v2.1.85 fixed crash)
OTEL_METRICS_EXPORTER=none                    # OTel metrics exporter (supports 'none'; v2.1.85 fixed crash)
OTEL_TRACES_EXPORTER=none                     # OTel traces exporter (supports 'none'; v2.1.85 fixed crash)
OTEL_LOG_TOOL_CONTENT=1                       # Opt in to emitting tool content in OTel spans (v2.1.101+, sensitive by default)
OTEL_LOG_TOOL_DETAILS=1                       # Opt in to tool_parameters in OTel tool_result events (v2.1.85+)
OTEL_LOG_USER_PROMPTS=1                       # Opt in to emitting user prompts in OTel traces (v2.1.101+, sensitive by default)
OTEL_LOG_ASSISTANT_RESPONSES=0                # Gate the claude_code.assistant_response log event holding the model's response text (v2.1.193+)
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH=60000     # Truncation limit for OTel content attributes (default 60 KB; v2.1.214+)[^207]
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1    # Disable release-notes fetch (v2.0.17+); v2.1.110 also stopped the auto-title Haiku request in headless/SDK when set

Atrybuty spanów żądań LLM w wersji v2.1.121+: stop_reason, gen_ai.response.finish_reasons i user_system_prompt są teraz emitowane w spanach żądań LLM. Atrybut user_system_prompt wymaga włączenia za pomocą OTEL_LOG_USER_PROMPTS=1, ponieważ może zawierać dane osobowe.¹⁵⁴

Zmiany na poziomie zdarzeń w wersji v2.1.122+: atrybuty liczbowe w zdarzeniach dziennika api_request i api_error są teraz emitowane jako liczby (wcześniej były ciągami znaków) — rozwiązuje to problemy z dalszymi kolektorami OTel, które wymagały ścisłego typowania schematu. Nowe zdarzenie dziennika claude_code.at_mention jest wyzwalane, gdy Claude Code rozpoznaje wzmiankę @.¹⁵⁴

Zdarzenie dziennika claude_code.assistant_response w wersji v2.1.193+: Claude Code może emitować pełny tekst odpowiedzi modelu jako zdarzenie dziennika OTel, pod warunkiem włączenia OTEL_LOG_ASSISTANT_RESPONSES. Z mechanizmem włączania wiąże się istotna pułapka podczas aktualizacji: gdy OTEL_LOG_ASSISTANT_RESPONSES nie jest ustawione, przejmuje wartość OTEL_LOG_USER_PROMPTS, dlatego każde wdrożenie, które już rejestruje treść promptów, po aktualizacji zacznie również otrzymywać treść odpowiedzi asystenta. Aby telemetria nadal obejmowała wyłącznie prompty, należy ustawić OTEL_LOG_ASSISTANT_RESPONSES=0.¹⁷⁹

Dodatki telemetryczne w wersji v2.1.214: zdarzenia dziennika OTel zawierają teraz atrybuty message.uuid, client_request_id i tool_source, które umożliwiają korelację na poziomie wiadomości oraz określenie pochodzenia narzędzi; dane subagentStatusLine zawierają poziom nakładu rozumowania subagenta, dzięki czemu niestandardowe wiersze statusu mogą wyświetlać jednocześnie model i poziom nakładu; natomiast nowa zmienna środowiskowa CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH pozwala skonfigurować limit obcinania atrybutów treści OTel, wynoszący domyślnie 60 KB.¹⁹⁰

API / Sterowanie modelem:²⁰⁷

CLAUDE_CODE_EXTRA_BODY='{...}'                # Inject extra body fields into API calls; v2.1.113 fixed 400 errors with output_config.effort on Vertex/subagent calls
CLAUDE_CODE_MAX_CONTEXT_TOKENS=200000         # Override max context tokens (pre-existing var; v2.1.98 fixed handling of DISABLE_COMPACT when both are set)
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS=25000 # Override default token limit for file read operations (v2.1.0+)
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1   # Do not fall back to non-streaming API on streaming failures (v2.1.83+)
ANTHROPIC_BETAS=beta1,beta2                   # Enable beta API headers; v2.1.78 fixed silent ignore on Haiku models
ANTHROPIC_SMALL_FAST_MODEL=arn:...            # Fast model ID (Bedrock ARN supported; v0.2.125 stopped escaping slashes in ARN)

Plugins / MCP:²⁰⁷

CLAUDE_CODE_PLUGIN_CACHE_DIR=~/.claude/plugins # Plugin cache directory (v2.1.72 fixed literal '~' dir on some shells)
CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1 # Preserve plugin marketplace cache when git pull fails (offline-friendly; v2.1.90+)
CLAUDE_CODE_MCP_SERVER_NAME=server1           # Passed to MCP headersHelper scripts so one helper can serve multiple servers (v2.1.85+)
CLAUDE_CODE_MCP_SERVER_URL=https://...        # Passed to MCP headersHelper scripts alongside the name (v2.1.85+)

Shell / IDE:²⁰⁷

CLAUDE_CODE_SHELL_PREFIX="time "              # Wrap every Claude-invoked shell command with a prefix (v1.0.61+)
CLAUDE_CODE_GIT_BASH_PATH=C:\Program\ Files\Git\bin\bash.exe  # Custom Git Bash path on Windows (v2.1.98+)
CLAUDE_CODE_EXIT_AFTER_STOP_DELAY=60000       # SDK: exit after N ms idle (v2.0.35+)
CLAUDE_CODE_AUTO_CONNECT_IDE=false            # Disable IDE auto-connection (v1.0.61+)

Środowisko firmowe / uwierzytelnianie:²⁰⁷

CLAUDE_CODE_PROXY_RESOLVES_HOSTS=1            # Opt into proxy-side DNS resolution (v2.0.55 moved this from default-on to opt-in)
CLAUDE_CODE_API_KEY_HELPER_TTL_MS=300000      # TTL for dynamically generated API keys via apiKeyHelper (apiKeyHelper refresh added v0.2.74 with 5-min default; env var added v0.2.117)
CLAUDE_CODE_PROCESS_WRAPPER=/path/to/wrapper  # Route all Claude Code self-spawned processes through a wrapper executable; same as the processWrapper setting (v2.1.208+)[^203]

Zmienne skills (v2.1.69+):

${CLAUDE_SKILL_DIR}                            # Self-reference for skills to locate their own directory[^117]

Tożsamość wywołującego SDK (v2.1.51+):

CLAUDE_CODE_ACCOUNT_UUID=uuid                  # Provide account UUID synchronously for SDK callers
CLAUDE_CODE_USER_EMAIL=user@example.com        # Provide user email for SDK callers
CLAUDE_CODE_ORGANIZATION_UUID=uuid             # Provide organization UUID for SDK callers

Debugowanie:

ANTHROPIC_LOG=debug                             # Enable API request logging

Który model wybrać?

Wybór odpowiedniego modelu do każdego zadania ma istotny wpływ zarówno na koszty, jak i jakość. Claude Code umożliwia elastyczne przełączanie modeli na wielu poziomach.

Dostępne modele

Dwie zmiany niezgodne wstecznie przy przenoszeniu środowiska wykonawczego z Opus 4.8 na Opus 5:¹⁹⁷

1. Rozumowanie jest domyślnie włączone. W Opus 4.8 żądanie bez pola thinking było wykonywane bez rozumowania; w Opus 5 takie samo żądanie wykorzystuje rozumowanie adaptacyjne. max_tokens pozostaje nieprzekraczalnym limitem wszystkich danych wyjściowych — rozumowania oraz tekstu odpowiedzi — dlatego należy ponownie sprawdzić dostępny zapas dla każdego obciążenia, które wcześniej działało bez rozumowania. Aby przywrócić wcześniejsze zachowanie, należy przekazać thinking: {type: "disabled"}, z zastrzeżeniem opisanym w następnym punkcie.
2. Po wyłączeniu rozumowania maksymalnym poziomem wysiłku jest high. Połączenie thinking: {type: "disabled"} z poziomem wysiłku xhigh lub max zwraca błąd 400. Weryfikacja odbywa się osobno dla każdego żądania — podniesienie poziomu wysiłku do xhigh przy wyłączonym rozumowaniu zostanie odrzucone, nawet jeśli wcześniejsze tury tej samej rozmowy zostały zaakceptowane.

W samym Claude Code: domyślną wartością effort w Opus 5 jest high (tak samo jak w Claude API), a dostępna jest pełna skala — low, medium, high, xhigh, max. W swoich zaleceniach dotyczących migracji Anthropic sugeruje przetestowanie poziomu wysiłku max, gdy możliwości są ważniejsze niż zużycie tokenów. Tryb szybki obejmuje Opus 5 w cenie $10/$50 za MTok (zob. Tryb szybki).¹⁹⁷¹⁹⁸

Claude Fable 5 (9 czerwca 2026): Nowy poziom modelu ponad Opus — najpotężniejszy i najbardziej inteligentny model Anthropic, osiągający najnowocześniejsze wyniki w niemal każdym teście porównawczym, w którym został sprawdzony, oraz zaprojektowany tak, by zachowywać spójność w kontekście obejmującym miliony tokenów. Fable 5 to czołowy model klasy „Mythos” przygotowany do bezpiecznego, powszechnego użytku: wyposażono go w klasyfikatory bezpieczeństwa, które w przypadku zapytań dotyczących cyberbezpieczeństwa, biologii i chemii oraz destylacji modeli przełączają się awaryjnie na Opus 4.8 (Claude Mythos 5 to ten sam model bez tych zabezpieczeń, przeznaczony dla upoważnionych badaczy). Możliwość wybrania go w Claude Code pojawiła się w v2.1.170 (9 czerwca 2026) — należy uruchomić claude update, a następnie /model fable (krótki alias; model można również wybrać za pomocą /model claude-fable-5 oraz aliasu best) — i do 22 czerwca 2026 model jest stopniowo udostępniany w planach subskrypcyjnych. Identyfikator modelu: claude-fable-5. Fable 5 domyślnie oferuje okno kontekstu 1M, więc sufiks [1m] jest zbędny — a od v2.1.173 (11 czerwca 2026) nazwa modelu claude-fable-5[1m] jest automatycznie normalizowana przez usunięcie tego sufiksu do claude-fable-5 (sufiks miał znaczenie wyłącznie w przypadku Opus/Sonnet, gdzie dostęp do kontekstu 1M wymaga [1m]); maksymalnie 128K danych wyjściowych. Cena wynosi $10/MTok za dane wejściowe i $50/MTok za dane wyjściowe — około 2 razy więcej niż w przypadku Opus 4.8 — dlatego warto zachować ten model do naprawdę trudnych zadań wymagających rozumowania, a nie do rutynowych zmian. Udostępnia ten sam interfejs żądań co Opus 4.8 (wyłącznie adaptacyjne rozumowanie; usunięto temperature/top_p/top_k oraz budget_tokens), z jedną nową różnicą: jawne ustawienie thinking: {type: "disabled"} zwraca błąd 400, dlatego w celu działania bez rozumowania należy całkowicie pominąć parametr thinking.²⁰⁰

W samym Claude Code: Fable 5 obsługuje pełną skalę wysiłku (low/medium/high/xhigh/max, domyślnie high), tak samo jak Opus 5. W Fable 5 nie można wyłączyć rozumowania — przełącznik rozumowania sesji, ustawienie alwaysThinkingEnabled oraz MAX_THINKING_TOKENS=0 nie mają żadnego wpływu; model zawsze rozumuje adaptacyjnie. Pełny zestaw konfiguracji rodziny fable odpowiada opcjom Opus: ANTHROPIC_DEFAULT_FABLE_MODEL przypina model, na który wskazuje alias fable (co jest przydatne w Bedrock/Vertex/Foundry), DISABLE_PROMPT_CACHING_FABLE wyłącza buforowanie promptów dla Fable, a w bramach korporacyjnych stosowane jest automatyczne przełączanie awaryjne zależne od treści. /model opus wybiera teraz Opus 5 (domyślnie z wysokim poziomem wysiłku, /effort xhigh do najtrudniejszych zadań), natomiast Sonnet 5 jest domyślnym modelem od razu po instalacji począwszy od wersji v2.1.197; Fable 5 należy wybierać świadomie za pomocą /model fable, gdy potrzebne są absolutnie najwyższe możliwości.²⁰⁰¹⁹⁷

Opus 4.7 (16 kwietnia 2026): Flagowy model poprzedniej generacji, nadal w pełni dostępny. Okno kontekstu 1M tokenów w standardowej cenie — bez dopłaty za długi kontekst. Maksymalnie 128K danych wyjściowych, wyłącznie adaptacyjne rozumowanie (usunięto rozszerzone rozumowanie) oraz nowy poziom wysiłku xhigh, zalecany jako punkt wyjścia dla programowania i obciążeń agentowych.¹⁴⁵ Wiarygodna granica wiedzy: styczeń 2026. Granica danych treningowych: styczeń 2026. Identyfikator modelu: claude-opus-4-7. Cena odpowiada Opus 4.6 i wynosi $5/$25 za MTok, przy czym zapis w 5-minutowej pamięci podręcznej kosztuje $6.25, zapis w 1-godzinnej pamięci podręcznej $10, a odczyt z pamięci podręcznej $0.50 za MTok.¹⁴⁴ Opus 4.7 rozwiązuje 3 razy więcej zadań produkcyjnych w SWE-Bench niż Opus 4.6, uzyskuje 70% w CursorBench (wobec 58% dla wersji 4.6) i zwiększa skuteczność rozwiązywania o 13% w wewnętrznym teście programistycznym Anthropic obejmującym 93 zadania.¹⁴⁴ Korzysta z nowego tokenizatora — dla tego samego tekstu należy oczekiwać liczby tokenów wyższej około 1–1,35 raza; warto zwiększyć zapas max_tokens oraz progi kompakcji.¹⁴⁵ Obsługa obrazu obejmuje obrazy o rozdzielczości do 2 576 px / 3,75 MP ze współrzędnymi pikseli 1:1.¹⁴⁵

Testy programistyczne Opus 4.7 (kwiecień 2026):¹⁵¹

Domyślny model według planu (Claude Code):¹⁴⁷

Zmiany niezgodne wstecznie w Messages API w Opus 4.7 (widoczne dla wywołującego):¹⁴⁵ - Usunięto budget_tokens dla rozszerzonego myślenia. Zamiast tego należy używać thinking: {type: "adaptive"}. Adaptacyjne myślenie jest domyślnie wyłączone; żądania bez pola thinking są wykonywane bez myślenia. - Ustawienie temperature, top_p lub top_k na wartość inną niż domyślna powoduje zwrócenie błędu HTTP 400. Należy pominąć te parametry i sterować modelem za pomocą promptów. - Treść procesu myślenia jest domyślnie pomijana w odpowiedziach. Aby ponownie wyświetlać tok rozumowania, należy ustawić thinking.display: "summarized" (jest to wymagane, jeśli produkt strumieniuje użytkownikom proces myślenia).

Budżety zadań (nagłówek beta task-budgets-2026-03-13) pozwalają wskazać modelowi docelową liczbę tokenów dla całej pętli agentowej za pomocą output_config.task_budget; minimum wynosi 20 tys. tokenów.¹⁴⁵

Opus 4.6 (starsza wersja): Nadal dostępny jako claude-opus-4-6 z kontekstem 1 mln tokenów i maksymalnym wyjściem 128 tys. tokenów. Warto rozważyć migrację do Opus 4.7, który lepiej radzi sobie z programowaniem agentowym. Opus 4.6 został pierwotnie wydany 5 lutego 2026.⁷⁹¹⁴⁴ Od wersji v2.1.117 (22 kwietnia 2026) subskrybenci planów Pro i Max domyślnie korzystają z poziomu wysiłku high w Opus 4.6 i Sonnet 4.6 (wcześniej medium); w Opus 4.7 nadal obowiązuje xhigh. Zmiana ta przywróciła poziom inteligencji po obniżeniu wysiłku między 4 marca a 7 kwietnia, opisanym w analizie incydentu opublikowanej 23 kwietnia.¹⁵²¹⁵³

Sonnet 5 (30 czerwca 2026): Obecny model klasy Sonnet, określany jako „najlepsze połączenie szybkości i inteligencji”. Anthropic podaje, że jego wydajność jest zbliżona do Opus 4.8, ale przy niższych cenach, a w porównaniu z Sonnet 4.6 stanowi on znaczący postęp w zakresie rozumowania agentowego, używania narzędzi, programowania i pracy z wiedzą — jednocześnie wykazuje ogólnie niższy odsetek niepożądanych zachowań oraz znacznie słabsze możliwości w zakresie cyberbezpieczeństwa niż modele Opus (kompromis dotyczący bezpieczeństwa, który umożliwił jego wydanie bez ograniczeń kontroli eksportu). Identyfikator modelu: claude-sonnet-5 (przypięta migawka bez daty). Okno kontekstu 1 mln tokenów, maksymalne wyjście 128 tys. tokenów (do 300 tys. w interfejsie Batches API z nagłówkiem beta output-300k-2026-03-24), wyłącznie adaptacyjne myślenie. Wiarygodna data graniczna wiedzy: styczeń 2026. Cena: 3 USD/15 USD za milion tokenów wejściowych/wyjściowych, z ceną promocyjną 2 USD/10 USD do 31 sierpnia 2026 — około 40% mniej niż 5 USD/25 USD za Opus 4.8. W Claude Code parametr effort ma w Sonnet 5 domyślną wartość high (aby ją zmienić, należy ustawić ją jawnie). Model można wybrać za pomocą /model sonnet (lub /model claude-sonnet-5).¹⁸⁰ Od wersji v2.1.197 (30 czerwca 2026) Sonnet 5 jest domyślnym modelem w Claude Code dla nowych sesji, zastępując Opus 4.8 jako wybór dostępny od razu; Opus nadal można bez przeszkód wybrać.¹⁸¹

Sonnet 4.6 (17 lutego 2026, obecnie zastąpiony przez Sonnet 5): Zrównoważony model; zastąpił Sonnet 4.5 jako domyślny model w claude.ai i Claude Cowork.⁹³ Cena taka sama jak w przypadku Sonnet 4.5 (3 USD/15 USD za milion tokenów). Lepsza wydajność wyszukiwania agentowego przy zużyciu mniejszej liczby tokenów. Obsługuje rozszerzone myślenie, adaptacyjne myślenie i okno kontekstu 1 mln tokenów (beta). Maksymalne wyjście 64 tys. tokenów (górny limit 128 tys. w wersji v2.1.77).¹¹⁹ Data graniczna wiedzy: sierpień 2025 (wiarygodna), styczeń 2026 (dane treningowe). Identyfikator modelu: claude-sonnet-4-6.

Claude Mythos Preview (7 kwietnia 2026): Model graniczny w wersji badawczej przeznaczony do defensywnych zastosowań w cyberbezpieczeństwie, oferowany w ramach Project Glasswing.¹³⁹ Dostępny wyłącznie na zaproszenie; nie jest powszechnie dostępny. Anthropic przedstawia Opus 4.7 jako celowo mniej zaawansowany od Mythos w obszarach cyberbezpieczeństwa — jest to kompromis dotyczący bezpieczeństwa — oraz uruchomił Cyber Verification Program pod adresem https://claude.com/form/cyber-use-case dla uprawnionych badaczy bezpieczeństwa potrzebujących rozszerzonego dostępu.¹⁴⁶

Dlaczego te różnice cenowe mają znaczenie: Typowa sesja programistyczna zużywa 50–200 tys. tokenów wejściowych i 10–50 tys. tokenów wyjściowych. W przypadku Haiku koszt wynosi 0,10–0,45 USD za sesję. Ta sama sesja z Opus kosztuje 0,50–2,25 USD, czyli 5 razy więcej. Opus warto zachować do naprawdę trudnych problemów.¹

Kiedy używać poszczególnych modeli

Haiku: Warto używać go dla subagents wykonujących rozpoznanie, proste wyszukiwanie plików i obsługujących szybkie pytania. Jest około 5 razy tańszy od Opus i szybciej odpowiada. Doskonale nadaje się do zadań działających w tle, które nie wymagają głębokiego rozumowania.

Sonnet: Podstawowy model do codziennej pracy programistycznej, gdy liczą się koszty. Radzi sobie z większością zadań programistycznych: implementowaniem funkcji, naprawianiem błędów, pisaniem testów i przeglądem kodu. Sonnet 4.6 oferuje lepsze wyszukiwanie agentowe i wydajniejsze wykorzystanie tokenów niż Sonnet 4.5, a także obsługę adaptacyjnego myślenia i okno kontekstu 1 mln tokenów w standardowej cenie.⁹³ Od wydania Opus 4.7 (16 kwietnia 2026) Claude Code domyślnie używa Opus tylko w planach Max i Team Premium; na kontach Pro, Team Standard, Enterprise i API domyślnym modelem pozostaje Sonnet 4.6, przy czym plany Enterprise i API przechodzą na Opus 4.7 23 kwietnia 2026.¹⁴⁷ Sonnet warto wybrać, gdy potrzebne są tańsze tokeny, krótsze opóźnienia lub korzystniejsza ekonomika subagents.

Opus: Flagowa klasa modeli od 16 kwietnia 2026 i domyślny wybór w planach Max oraz Team Premium.¹⁴⁴¹⁴⁷ Kosztowniejsze rozumowanie warto zarezerwować dla sytuacji, w których przynosi największe korzyści: decyzji architektonicznych, trudnego debugowania, poznawania złożonych systemów, analizy bezpieczeństwa i długotrwałej pracy agentowej. Opus 4.7 rozwiązuje 3 razy więcej zadań produkcyjnych w SWE-Bench niż Opus 4.6, uzyskuje 70% w CursorBench (wobec 58%) i zwiększa skuteczność rozwiązywania problemów o 13% w wewnętrznym benchmarku programistycznym obejmującym 93 zadania.¹⁴⁴ Claude Code domyślnie ustawia poziom wysiłku xhigh dla Opus 4.7, który można dostosować za pomocą /effort (od wersji v2.1.111).¹⁴⁶¹⁴⁷ Auto Mode jest dostępny dla subskrybentów planu Max korzystających z Opus 4.7 za pośrednictwem Anthropic API bez konieczności używania --enable-auto-mode; dostępność w innych planach i u innych dostawców zależy od konkretnego planu oraz ustawień administratora.¹⁴⁶ Kontekst 1 mln tokenów w standardowej cenie — bez dopłaty za długi kontekst. Warto znać następujące zmiany zachowania: Opus 4.7 bardziej dosłownie wykonuje instrukcje, dostosowuje długość odpowiedzi do złożoności zadania, domyślnie uruchamia mniej subagents i przyjmuje bardziej bezpośredni ton, rzadziej używając sformułowań nastawionych na potwierdzanie. Jeśli prompty zawierają mechanizmy wymuszające okresowe raporty o postępach lub ponowne sprawdzanie wyników, warto spróbować je usunąć.¹⁴⁵

Opusplan: Tryb hybrydowy, który używa Opus do planowania (gdzie jakość rozumowania ma największe znaczenie), a Sonnet do wykonania (gdzie liczy się szybkość). Doskonale nadaje się do złożonego refaktoryzowania, gdy potrzebny jest najlepszy plan, lecz poszczególne zmiany nie wymagają rozumowania na poziomie Opus.

Przełączanie modeli

Podczas sesji:

> /model opus
> /model sonnet
> /model haiku

Przy uruchamianiu:

claude --model opus

Za pomocą zmiennej środowiskowej:

export ANTHROPIC_MODEL=opus

W settings.json:

{
  "model": "claude-sonnet-4-5-20250929"
}

Specjalnie dla subagents:

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

Łańcuch modeli zapasowych (od wersji v2.1.166): ustawienie fallbackModel pozwala skonfigurować maksymalnie 3 modele zapasowe, wypróbowywane kolejno, gdy model podstawowy jest przeciążony lub niedostępny. Flaga --fallback-model (wcześniej służąca wyłącznie do przełączania modelu w trakcie sesji) ma teraz zastosowanie również do sesji interaktywnych od momentu ich uruchomienia.²⁰²

{
  "model": "claude-opus-4-8",
  "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"]
}

Gdy API zwróci nieoczekiwany błąd, którego nie można ponowić, Claude Code podejmuje teraz także jeszcze jedną próbę wykonania tury za pomocą modelu zapasowego przed zgłoszeniem niepowodzenia. Dzięki temu przejściowy problem z modelem podstawowym powoduje łagodne przełączenie, zamiast przerwać turę.²⁰²

Od wersji v2.1.178 kompaktowanie również uwzględnia łańcuch modeli zapasowych — jeśli model podstawowy zostanie przeciążony lub stanie się niedostępny w trakcie kompaktowania, ten etap przełączy się na skonfigurowany łańcuch fallbackModel/--fallback-model, zamiast przerywać turę. W przypadku długiego autonomicznego działania eliminuje to lukę, przez którą możliwe do odzyskania kompaktowanie mogło zakończyć sesję wskutek przejściowego błędu modelu.¹⁷³

Rozszerzony kontekst

W przypadku dużych baz kodu lub długich sesji należy włączyć kontekst 1 mln tokenów:

claude --model sonnet[1m]
claude --model opus[1m]           # Opus 4.7 with 1M context

Lub podczas sesji:

> /model sonnet[1m]
> /model opus[1m]

Opus 4.7, Opus 4.6 i Sonnet 4.6 oferują pełne okno kontekstu 1 mln tokenów w standardowej cenie — bez dopłaty za długi kontekst.¹⁴⁸ Żądanie obejmujące 900 tys. tokenów jest rozliczane według tej samej stawki za token co żądanie obejmujące 9 tys. tokenów. Rabaty za buforowanie promptów i przetwarzanie wsadowe obowiązują według standardowych stawek w całym oknie kontekstu.

W subskrypcjach Max, Team i Enterprise Opus z kontekstem 1 mln tokenów jest dostępny automatycznie — sufiks [1m] nie jest potrzebny (funkcja jest domyślnie włączona od wersji v2.1.75 z 13 marca 2026).¹¹⁷¹⁴⁷ W planie Pro kontekst 1 mln tokenów jest dostępny w ramach dodatkowego użycia. Użytkownicy API i rozliczani zgodnie z rzeczywistym użyciem mają pełny dostęp do 1 mln tokenów według standardowych stawek za token.¹⁴⁷

Aby wyłączyć warianty z kontekstem 1 mln tokenów w selektorze modeli, należy ustawić CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

Sprawdzanie bieżącego modelu

> /status

Polecenie wyświetla bieżący model, informacje o koncie, zastosowane ustawienia i pozostały stan sesji. Etykiety selektora modeli (v2.1.51+): selektor /model wyświetla teraz czytelne etykiety (np. „Sonnet 4.6”) zamiast surowych identyfikatorów modeli w przypadku przypiętych wersji, a także podpowiedzi dotyczące aktualizacji, gdy dostępne są nowsze wersje.⁹⁸ W wersji v2.1.219 poprawiono renderowanie scalonego wiersza Opus jako zwykłego „Opus” zamiast „Opus (kontekst 1M)” oraz ograniczono wyróżnienie nowej wersji wyłącznie do nazwy najnowszego modelu, dzięki czemu wskazuje ono faktycznie wydaną nowość, a nie przypadkowy fragment listy.¹⁹⁶

Tryb Fast (v2.1.36+)

Tryb Fast zapewnia znacznie szybsze generowanie odpowiedzi przez ten sam model; nie przełącza na tańszy model. Podczas sesji można go włączać i wyłączać za pomocą /fast.⁸⁶

> /fast            # Toggle fast mode on/off

Obsługiwane modele (stan na v2.1.219): tryb Fast działa z modelami Claude Opus 5 i Claude Opus 4.8. W wersji v2.1.219 usunięto jego obsługę z Opus 4.7, a funkcja nigdy nie była dostępna w modelach Sonnet, Haiku ani Fable. Nadal ma status wersji testowej do celów badawczych i jest dostępna wyłącznie w Claude API (w tym w Claude Managed Agents) — nie jest dostępna w Amazon Bedrock, Google Cloud, Microsoft Foundry ani Claude Platform on AWS. Dostęp jest ograniczony: należy skontaktować się z opiekunem konta lub zapisać na listę oczekujących.¹⁹⁶¹⁹⁸

Ceny (tryb Fast w Opus 5 / Opus 4.8):¹⁹⁸

Pułapka związana z Opus 4.7 (v2.1.219). Nieobsługiwane modele zachowują się w różny sposób. Żądanie do claude-opus-4-7 z speed: "fast" zwraca teraz błąd — nie następuje ciche przełączenie na standardową szybkość. Wyjątkiem, o którym warto wiedzieć, jest Opus 4.6: akceptuje speed: "fast", ale mimo to działa ze standardową szybkością, nalicza opłaty według standardowych stawek i raportuje usage.speed: "standard". Jeśli używany harness miał przypiętą wersję 4.7 i zakładał, że żądania trybu Fast będą po cichu przełączane na tryb standardowy, teraz zakończą się one błędem; należy zmienić przypięty model na Opus 5 lub 4.8.¹⁹⁸

Kiedy używać trybu Fast: - Podczas szybkiego iterowania nad niewielkimi zmianami, gdy wąskim gardłem są opóźnienia - Przy generowaniu testów, kodu szablonowego lub powtarzalnego kodu, gdy szybkość jest ważniejsza od kosztów - Podczas sekwencyjnej realizacji listy podobnych zadań

Kiedy NIE używać trybu Fast: - Przy długotrwałych zadaniach agentowych (koszt całego przebiegu nadal jest dwukrotnie wyższy) - Przy pracy subagents w tle (nikt nie czeka na wynik) - Podczas sesji z ograniczonym budżetem

Tryb Fast obejmuje pełne okno kontekstu 1M (v2.1.50+). Cena jest ustalana za pomocą stałego mnożnika dla całego kontekstu, w tym żądań przekraczających 200K tokenów wejściowych — bez dodatkowej opłaty za długi kontekst — i sumuje się z mnożnikami dotyczącymi buforowania promptów oraz miejsca przechowywania danych.⁹⁶¹⁹⁸

Uwagi eksploatacyjne. Tryb Fast ma własny limit żądań, niezależny od standardowych limitów Opus; jego przekroczenie zwraca 429 z nagłówkiem retry-after (nagłówki odpowiedzi anthropic-fast-*-tokens-* informują o pozostałym limicie). Przełączanie między trybem Fast a standardowym unieważnia pamięć podręczną promptów — żądania o różnych szybkościach nie współdzielą zapisanych prefiksów, dlatego przełączenie /fast w trakcie sesji powoduje nietrafienie w pamięci podręcznej. Tryb Fast nie jest dostępny z Batch API ani w ramach zobowiązania Priority Tier.¹⁹⁸

Wskazówka dla ekspertów: trybu Fast nie można łączyć z opusplan (opusplan już wykorzystuje połączenie Opus i Sonnet, a tryb Fast wpływa wyłącznie na część obsługiwaną przez Opus). Warto używać go, gdy opóźnienie ma większe znaczenie niż koszt, i wyłączać przy pracy autonomicznej lub wsadowej. /fast wymaga dodatkowego użycia; administratorzy planów Team/Enterprise mogą najpierw potrzebować włączyć tę funkcję (poprawka w v2.1.37). Można ją całkowicie wyłączyć za pomocą CLAUDE_CODE_DISABLE_FAST_MODE=1. Od wersji v2.1.218 Claude Code informuje, gdy zmiana modelu za pomocą /config model=<x> lub Remote Control zmienia stan trybu Fast, natomiast w v2.1.219 poprawiono problem, przez który klienci Remote Control zachowywali nieaktualny stan trybu Fast po zmianie modelu, ponownym połączeniu lub nieudanej weryfikacji organizacji.^86149195196

Sterowanie poziomem wysiłku (v2.1.111+, Opus 4.7)

Opus 4.7 wprowadza nowe ustawienie poziomu wysiłku, które reguluje kompromis między szybkością a inteligencją. Podczas sesji należy użyć /effort:

> /effort              # opens an interactive slider (arrow keys + Enter)
> /effort xhigh        # set directly

Tryb Auto w planie Max (v2.1.111+)

Tryb Auto — bezpieczniejszy zamiennik --dangerously-skip-permissions — jest dostępny dla subskrybentów planu Max korzystających z Opus 4.7 za pośrednictwem Anthropic API, bez konieczności używania --enable-auto-mode.¹⁴⁶ Klasyfikator Sonnet-4.6 sprawdza każdą czynność przed jej wykonaniem, oceniając zgodność z intencją i bezpieczeństwo. Uwaga (v2.1.111+): flaga --enable-auto-mode została usunięta; aby rozpocząć sesję w trybie Auto, należy zamiast niej użyć --permission-mode auto. Tryb Auto nie jest dostępny w planie Pro; zgodnie z dokumentacją trybów uprawnień Anthropic jest on domyślnie dostępny bezpośrednio w Anthropic API. Bedrock/Vertex/Foundry (v2.1.158+): na tych bramach tryb Auto stał się opcjonalną funkcją dla Opus 4.7 i Opus 4.8, włączaną za pomocą CLAUDE_CODE_ENABLE_AUTO_MODE=1.²⁰⁵ Od wersji v2.1.207 nie trzeba już go włączać: tryb Auto działa w AWS Bedrock, Google Vertex AI i Microsoft Foundry bez CLAUDE_CODE_ENABLE_AUTO_MODE, a administratorzy, którzy chcą go wyłączyć, mogą użyć zarządzanego ustawienia disableAutoMode. W tej samej wersji Claude Opus 4.8 staje się modelem domyślnym w Bedrock, Vertex AI i Claude Platform on AWS, a ustawienie autoMode przestaje być odczytywane z pliku .claude/settings.local.json repozytorium — reguły trybu Auto należy zamiast tego skonfigurować w ~/.claude/settings.json.¹⁸⁵

Reguły niestandardowe bez utraty reguł domyślnych (v2.1.118+). We wcześniejszych wersjach ustawienia autoMode.allow, autoMode.soft_deny i autoMode.environment działały na zasadzie wyboru jednej z dwóch opcji: zdefiniowanie własnej listy powodowało utratę wbudowanych reguł bezpieczeństwa. Problem ten rozwiązuje znacznik $defaults — rozwija się w miejscu użycia do wbudowanej listy, dokładnie w pozycji, w której został umieszczony, dzięki czemu można otoczyć reguły domyślne własnymi regułami:¹⁵²

// .claude/settings.json
{
  "autoMode": {
    "allow": [
      "Bash(npm test:*)",        // your additions, prepended
      "$defaults",                // built-in allow list inserted here
      "Bash(git push:origin/feature/*)"  // appended after
    ]
  }
}

Opcjonalne „Nie pytaj ponownie” (v2.1.118+). Monit o włączenie trybu Auto zawiera teraz opcję „Nie pytaj ponownie”, dzięki czemu osoby często korzystające z tej funkcji mogą ukryć objaśnienie bez konieczności stosowania flagi w skrypcie.¹⁵²

Zabezpieczenia przed destrukcyjnymi poleceniami (v2.1.183). Tryb Auto bezwzględnie blokuje teraz zestaw nieodwracalnych poleceń, chyba że użytkownik wyraźnie poprosił o nie w trakcie sesji: destrukcyjne operacje git (git reset --hard, git checkout -- ., git clean -fd, git stash drop), gdy nie poproszono o odrzucenie lokalnych zmian; git commit --amend, gdy commit nie został utworzony przez agenta w tej sesji; oraz usuwanie infrastruktury (terraform destroy, pulumi destroy, cdk destroy), chyba że wskazano konkretny stos. Ogranicza to zakres potencjalnych szkód powodowanych przez klasyfikator właśnie w przypadku operacji, które mogą niepostrzeżenie usunąć pracę lub zlikwidować środowiska — agent nadal może je wykonać, ale wyłącznie na wyraźne polecenie użytkownika, a nie z własnej inicjatywy.¹⁷⁴

Klasyfikowanie każdego polecenia powłoki (v2.1.193). Domyślnie klasyfikator trybu Auto sprawdza wyłącznie polecenia powłoki pasujące do wzorców wykonywania dowolnego kodu; rutynowe polecenia są pomijane. Nowe ustawienie autoMode.classifyAllShell kieruje zamiast tego wszystkie polecenia Bash/PowerShell do klasyfikatora, co zapewnia szczelniejsze zabezpieczenie kosztem niewielkiego wzrostu opóźnienia, gdy wymagana jest kontrola każdego wywołania powłoki. Ta sama wersja wyświetla również przyczyny odmowy przez tryb Auto w transkrypcji, powiadomieniu o odmowie oraz sekcji ostatnich odmów w /permissions, dzięki czemu zablokowane polecenie zawiera teraz wyjaśnienie przyczyny blokady.¹⁷⁹ Trzy kolejne reguły wzmacniające zabezpieczenia (v2.1.205). Tryb auto blokuje teraz manipulowanie plikami transkrypcji sesji — sam ślad audytowy pozostaje poza zasięgiem agenta; pyta przed uruchomieniem rm -rf na zmiennej, której wartości nie można ustalić na podstawie kontekstu — eliminując tym samym klasę wypadków związanych z rm -rf $DIR, gdy wartość $DIR jest nieznana; ponadto powiadomienia o zadaniach w tle wyraźnie informują teraz, że nie doszło do żadnej interakcji ze strony człowieka, dzięki czemu sfabrykowanego wiersza „użytkownik zatwierdził” wewnątrz transkrypcji nie można wykorzystać jako podstawy do wykonania zatwierdzonej rzekomo czynności.¹⁸³ Trzeci mechanizm stanowi zabezpieczenie przed wstrzyknięciem promptu, które warto zapamiętać: zatwierdzenie musi nadejść przez kanał zatwierdzania, a środowisko wykonawcze jasno określa teraz to założenie.

Podstawienie polecenia nie ukryje katastrofy (v2.1.208). Polecenia powodujące katastrofalne usunięcia, takie jak rm -rf ~, wymagają teraz potwierdzenia nawet wtedy, gdy są ukryte wewnątrz $(...), znaków backtick lub podstawienia procesu (<(...)) — a monit pojawia się nawet w trybach --dangerously-skip-permissions i auto. Opakowanie destrukcyjnego polecenia w podstawienie nie pozwala już ominąć mechanizmu zabezpieczającego.¹⁸⁶

Resetowanie stanu trybu auto: claude auto-mode reset (v2.1.212). Nowe podpolecenie resetuje stan trybu auto z poziomu terminala; przekazanie --yes pozwala pominąć monit o potwierdzenie:¹⁸⁹

claude auto-mode reset          # Confirmation prompt
claude auto-mode reset --yes    # Skip confirmation (scripts)

Mniej okien dialogowych, równie dokładna kontrola (v2.1.218). Trzy kontrole, które wcześniej przerywały tryb auto oknem dialogowym uprawnień — niebezpieczne użycie rm, operator tła & oraz podejrzane ścieżki systemu Windows — już tego nie robią; zamiast tego rozstrzyga je klasyfikator trybu auto, dzięki czemu kontrola bezpieczeństwa nadal się odbywa, ale nie wymaga za każdym razem udziału użytkownika. W tym samym wydaniu mechanizm ten rozszerzono na tryb planowania z auto: polecenia Bash, w przypadku których analizator statyczny nie może potwierdzić, że służą wyłącznie do odczytu, nie wyświetlają już monitu — ocenia je klasyfikator, zamiast domyślnie otwierać okno dialogowe.¹⁹⁵

Nowe polecenia w wersjach v2.1.105–v2.1.114¹⁴⁶¹⁵⁰

Powiadomienia push (v2.1.110+)

Gdy w konfiguracji Remote Control włączona jest opcja „Push when Claude decides”, Claude może teraz według własnego uznania wysyłać mobilne powiadomienia push za pomocą nowego narzędzia do powiadomień. Funkcja uzupełnia istniejący mobilny/internetowy interfejs Remote Control.¹⁴⁶ Polecenia /context, /exit i /reload-plugins działają teraz również w klientach Remote Control.

Natywne narzędzie Windows PowerShell (v2.1.111+, wdrażanie)

Claude Code stopniowo wdraża natywne narzędzie Windows PowerShell. W systemach Linux/macOS można je włączyć za pomocą CLAUDE_CODE_USE_POWERSHELL_TOOL=1 (wymaga pwsh w PATH). W systemie Windows ta sama zmienna pozwala włączyć lub wyłączyć funkcję podczas jej wdrażania.¹⁴⁶

Automatyczne zatwierdzanie w trybie uprawnień (v2.1.119+). Polecenia narzędzia PowerShell mogą być teraz automatycznie zatwierdzane w trybie uprawnień tak samo jak polecenia Bash. Reguły zezwoleń, takie jak PowerShell(Get-*:*), oraz istniejąca składnia wzorców pozwalają teraz pominąć monit w przypadku operacji służących wyłącznie do odczytu, zapewniając zespołom taką samą wygodę obsługi jak w systemach Linux/macOS.¹⁵²

Ograniczenie liczby monitów o uprawnienia: Bash tylko do odczytu (v2.1.111+)

Wzorce Bash służące wyłącznie do odczytu i zawierające argumenty glob (np. ls *.ts, cat src/*.md) oraz polecenia rozpoczynające się od cd <project-dir> && nie wyświetlają już monitu o uprawnienia.¹⁴⁶ W połączeniu z /less-permission-prompts powinno to znacznie ograniczyć liczbę przerw w codziennej pracy.

Śledzenie rozproszone (v2.1.110+)

Sesje SDK i headless odczytują teraz TRACEPARENT oraz TRACESTATE ze środowiska, łącząc uruchomienia Claude Code ze śladami rozproszonymi. W połączeniu z OTEL_LOG_RAW_API_BODIES=1 (v2.1.111+) można rejestrować pełne treści żądań i odpowiedzi API jako zdarzenia dziennika OpenTelemetry na potrzeby debugowania.¹⁴⁶

Dystrybucja natywnego pliku binarnego (v2.1.113+)¹⁵⁰

Wersja v2.1.113 zmienia sposób uruchamiania CLI: polecenie claude uruchamia teraz natywny plik binarny Claude Code za pośrednictwem opcjonalnej zależności właściwej dla danej platformy, zamiast uruchamiać dołączony JavaScript. Polecenia instalowania i aktualizowania pozostają bez zmian, a zespoły nie muszą modyfikować skryptów wdrożeniowych.

Skróty edytora promptów (v2.1.113+)¹⁵⁰

Edytor promptów otrzymuje nawigację w stylu readline podczas wprowadzania tekstu wielowierszowego oraz przewijanie widoku pełnoekranowego:

Limit czasu bezczynności subagenta (v2.1.113+)¹⁵⁰

Subagents, którzy przestaną odpowiadać w trakcie przesyłania strumieniowego, kończą teraz działanie z jasnym komunikatem o błędzie po 10 minutach, zamiast zawieszać się bez żadnej informacji. Warto używać tej funkcji razem z CLAUDE_STREAM_IDLE_TIMEOUT_MS (v2.1.84+), aby szerzej wykrywać zawieszone procesy podczas strumieniowych wywołań API.

Poprawka stabilności w v2.1.114¹⁵⁰

Wersja v2.1.114 (18 kwietnia 2026) zawiera jedną poprawkę: okno dialogowe uprawnień mogło ulec awarii, gdy członek zespołu Agent Teams żądał uprawnienia do użycia narzędzia. W przypadku korzystania z Agent Teams należy przeprowadzić aktualizację.

Ile kosztuje Claude Code?

Zrozumienie i kontrolowanie kosztów ma kluczowe znaczenie dla zrównoważonego korzystania z Claude Code. Informacje o możliwościach modeli zawiera również sekcja Wybór modelu, a pomoc w doborze właściwego modelu do konkretnego zadania — sekcja Ramy decyzyjne.

Wyświetlanie kosztów

> /cost

Dane wyjściowe:

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    247 lines added, 89 lines removed

Użytkownicy subskrypcji widzą w /cost zestawienie według modeli i trafień w pamięci podręcznej, które dokładnie pokazuje, jakie modele zużyły tokeny i jaka część danych została pobrana z pamięci podręcznej (v2.1.92+).¹³⁷

Plany subskrypcyjne

Limity szybkości (sierpień 2025): Anthropic wprowadziło tygodniowe limity szybkości dla płatnych subskrybentów. Subskrybenci Max mogą dokupić dodatkowy limit po przekroczeniu tego progu, według standardowych stawek API.¹⁴

Podwojenie limitów szybkości (6 maja 2026): Podczas wydarzenia Code with Claude SF firma Anthropic podwoiła pięciogodzinne limity szybkości Claude Code w planach Pro, Max, Team oraz Enterprise opartych na liczbie stanowisk, zniosła obniżenie limitów w godzinach szczytu na kontach Pro i Max oraz „znacznie” zwiększyła limity szybkości API dla modeli Claude Opus. Zabezpieczeniem dostępu do mocy obliczeniowej jest umowa dotycząca SpaceX Colossus 1: „ponad 300 megawatów nowej mocy (przeszło 220 000 układów NVIDIA GPU) w ciągu miesiąca”.¹⁵⁷

Ceny tokenów API (kwiecień 2026)¹¹⁴⁴

Dla użytkowników rozliczanych przez API ceny za milion tokenów wynoszą:

Cena kontekstu 1M (kwiecień 2026): Opus 4.7, Opus 4.6, Sonnet 4.6 oraz Mythos Preview obejmują kontekst 1M według standardowych stawek za MTok — bez dopłaty za długi kontekst.¹⁴⁸ To niedawne ujednolicenie; starsze informacje, według których w przypadku Opus 4.6 lub Sonnet 4.6 powyżej 200K tokenów wejściowych obowiązywała stawka 2× za dane wejściowe i 1,5× za dane wyjściowe, są już nieaktualne. Starsze modele Opus 4.5 i wcześniejsze zachowują pierwotne struktury cenowe.

Cena za lokalizację danych: Określenie w inference_geo, że wnioskowanie ma odbywać się wyłącznie w Stanach Zjednoczonych, powoduje zastosowanie mnożnika 1,1× do wszystkich cen tokenów, w tym odczytów i zapisów w pamięci podręcznej (modele Opus 4.6+).¹⁴⁸

Buforowanie promptów znacznie ogranicza koszty powtarzających się danych wejściowych: zapis w pamięci podręcznej kosztuje 1,25× stawki bazowej (pamięć na 5 min) lub 2× (pamięć na 1 godz.), natomiast odczyt kosztuje zaledwie 0,1×, co oznacza oszczędność 90%. W przypadku systemów RAG i asystentów programistycznych wielokrotnie korzystających z tego samego kontekstu buforowanie może obniżyć koszty o 88–95%.

Batch API oferuje 50% zniżki przy realizacji w ciągu 24 godzin w przypadku niepilnych zadań, takich jak uruchamiane nocą zestawy testów.

Zasady dotyczące wielu kont⁵²

Czy można mieć wiele kont Claude? Tak, w uzasadnionych przypadkach. Anthropic wyraźnie zezwala na wiele kont, jeśli służą one różnym celom.

Co jest dozwolone:

Ograniczenia techniczne: - Za pomocą tego samego numeru telefonu można zweryfikować maksymalnie 3 konta - Wiele płatnych subskrypcji używanych z tego samego adresu IP lub w tej samej sieci jest wyraźnie obsługiwanych - Konta są całkowicie oddzielne; nie można przenosić między nimi czatów ani projektów

Co jest zabronione (zgodnie z Zasadami użytkowania): - Tworzenie kont w celu obejścia blokady po zablokowaniu - Koordynowanie szkodliwej aktywności między kontami w celu uniknięcia wykrycia - Używanie wielu kont w celu obchodzenia limitów szybkości lub limitów bezpłatnej warstwy

Przykład z praktyki: W styczniu 2026 zaawansowany użytkownik Jeffrey Emanuel (@doodlestein) miał 22 konta Max, które zostały automatycznie oznaczone i tymczasowo zablokowane. Pracownik Anthropic Thariq (@trq212) rozwiązał problem w ciągu 4 godzin po potwierdzeniu, że konta były wykorzystywane w uzasadniony sposób. Jeśli intensywnie korzysta Pan/Pani z Claude Code zarówno w pracy, jak i w projektach prywatnych na wielu kontach, usługa jest przeznaczona właśnie do takich zastosowań — nie należy jednak próbować manipulować systemem.

W razie wątpliwości: Warto skontaktować się z pomocą techniczną Anthropic, aby uzyskać pisemne potwierdzenie dotyczące konkretnej konfiguracji.

Czynniki wpływające na koszty

Przykładowe koszty z praktyki

Wskazówka dotycząca oszczędności: Używanie Haiku w subagents do eksploracji, a Sonnet do implementacji zazwyczaj obniża koszty o 40–50% w porównaniu z używaniem Sonnet do wszystkich zadań.

Zarządzanie kosztami zespołu

Zalecane wartości TPM/RPM według wielkości zespołu:

Ukryte opłaty za narzędzia

Poza opłatami za tokeny niektóre narzędzia wiążą się z osobnymi kosztami:⁹

Koszty te kumulują się w pętlach agentów. Cykl debugowania obejmujący 100 iteracji z Bash generuje sam narzut wynoszący ok. 24 500 dodatkowych tokenów wejściowych.

Strategie obniżania kosztów

1. Używać Haiku w subagents: Większość eksploracji nie wymaga Sonnet
2. Włączyć buforowanie promptów: Jest domyślnie włączone, ale warto sprawdzić, czy nie zostało wyłączone
3. Ustawić maksymalną liczbę tur: claude --max-turns 5 zapobiega niekontrolowanemu przedłużaniu rozmów
4. Ustawić limit kwotowy: claude --max-budget-usd 5 definitywnie zatrzymuje sesję po osiągnięciu limitu wydatków. Od wersji v2.1.217 limit obejmuje również działające w tle subagents — po jego osiągnięciu nowe uruchomienia są odrzucane, a działające w tle agenty zostają zatrzymane (wcześniej agenty działające w tle nie podlegały budżetowi)¹⁹⁴
5. Używać trybu planowania do eksploracji: Brak wykonywania = brak przypadkowych, kosztownych operacji
6. Proaktywnie kompaktować: Mniejszy kontekst = mniej tokenów
7. Ograniczyć dane wyjściowe: export CLAUDE_CODE_MAX_OUTPUT_TOKENS=2000
8. Używać Batch API do niepilnych zadań: 50% zniżki zarówno na tokeny wejściowe, jak i wyjściowe

Monitorowanie użycia

• Konsola Claude: platform.claude.com (wymaga roli Admin lub Billing)
• Limity obszaru roboczego: Ustawianie limitów wydatków dla poszczególnych obszarów roboczych
• Bedrock/Vertex: Korzystanie z natywnych narzędzi chmurowych do monitorowania kosztów
• LiteLLM: Szczegółowe śledzenie użycia przez poszczególnych użytkowników u zewnętrznych dostawców

Zużycie tokenów w tle

Niektóre operacje zużywają tokeny w tle: - Podsumowywanie rozmów na potrzeby /resume - Polecenia /cost i /status - Automatyczna kompaktacja

Zazwyczaj kosztują mniej niż $0.04 na sesję.

Analityczne API Claude Code (Team/Enterprise)⁴⁶

Admin API umożliwia programowy dostęp do danych analitycznych dotyczących użycia Claude Code w organizacji oraz do wskaźników produktywności.

Endpoint: GET /v1/organizations/usage_report/claude_code

Wymagania: - Klucz Admin API (sk-ant-admin...) - Plan Team lub Enterprise - Rola Admin, Billing lub Developer

Dostępne wskaźniki:

Przykładowe żądanie:

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?starting_at=2026-01-15" \
  -H "x-api-key: sk-ant-admin..." \
  -H "anthropic-version: 2023-06-01"

Przypadki użycia: - Analiza produktywności programistów (sesje, commity, PR) - Wskaźniki użycia narzędzi (współczynniki akceptacji/odrzucenia dla Edit, Write itd.) - Śledzenie i przypisywanie kosztów do zespołów - Uzasadnienie ROI dla narzędzi programistycznych wykorzystujących AI

Uwaga: Dane pojawiają się w ciągu 1 godziny od zakończenia aktywności. Ze względu na spójność odpowiedzi obejmują wyłącznie dane starsze niż 1 godzina.

Struktury decyzyjne

Sama znajomość dostępnych funkcji nie wystarczy. Trzeba jeszcze wiedzieć, kiedy użyć każdej z nich. Te drzewa decyzyjne pomagają przełożyć wiedzę na działanie.

Którego modelu użyć?

START → Is the task simple? (file search, quick question, formatting)
         │
         ├── YES → Use Haiku
         │         Cost: ~$0.03/task
         │         Speed: Fastest
         │
         └── NO → Does it require deep reasoning?
                  (architecture, complex debugging, security analysis)
                  │
                  ├── YES → Use Opus 4.7 (xhigh effort default)
                  │         Cost: ~$2.00/task
                  │         Quality: Highest (1M context at standard price, adaptive reasoning)
                  │
                  └── NO → Use Sonnet
                           Cost: ~$0.75/task
                           Balance: Best overall when cost matters

Ogólna zasada: Opus 4.7 jest modelem domyślnym w planach Max i Team Premium. W planach Pro/Team Standard/Enterprise/API domyślnym modelem jest Sonnet 4.6 (w planach Enterprise + Anthropic API 23 kwietnia 2026 nastąpi przejście na Opus 4.7).¹⁴⁷ W przypadku subagents warto przejść na Haiku. Jeśli odpowiedź Sonnet wydaje się powierzchowna, należy przejść na Opus. W agent teams (v2.1.32+) Opus może koordynować wielu agentów pracujących równolegle nad różnymi zadaniami cząstkowymi.⁷⁹

Polecenie, skill, subagent czy agent team?

Do you want explicit control over when it runs?
│
├── YES → Use Slash Command
│         Example: /deploy, /test, /security-review
│         You invoke it. You control timing.
│
└── NO → Should the expertise apply automatically based on context?
         │
         ├── YES → Use Skill
         │         Example: Security patterns, domain rules, code standards
         │         Claude recognizes context and applies expertise.
         │
         └── NO → Does the work need isolated context?
                  │
                  ├── YES → Is there one subtask or many parallel subtasks?
                  │         │
                  │         ├── ONE → Use Subagent (Task tool)
                  │         │         Example: Deep exploration, parallel analysis
                  │         │         Prevents context bloat in main conversation.
                  │         │
                  │         └── MANY → Use Agent Team (v2.1.32+)
                  │                   Example: 5 agents reviewing different modules simultaneously
                  │                   Opus coordinates; each agent works independently.
                  │
                  └── NO → Just prompt directly
                           Not everything needs abstraction.

Hook czy prompt?

Must the action ALWAYS happen, regardless of Claude's judgment?
│
├── YES → Use Hook (deterministic)
│         Examples:
│         - Format code after every edit
│         - Log all bash commands
│         - Block access to .env files
│         Claude cannot skip, forget, or decide otherwise.
│
└── NO → Use Prompt (probabilistic)
         Examples:
         - "Consider adding tests"
         - "Think about edge cases"
         - "Review for security if relevant"
         Claude decides based on context.

Kiedy używać rozszerzonego rozumowania?

Is this a genuinely hard problem?
│
├── Architectural decision with many tradeoffs → YES, use thinking
├── Complex debugging with unclear root cause → YES, use thinking
├── Security analysis requiring careful reasoning → YES, use thinking
├── Understanding unfamiliar codebase → YES, use thinking
│
├── Routine bug fix → NO, skip thinking
├── Simple refactoring → NO, skip thinking
├── Code formatting → NO, skip thinking
└── Quick questions → NO, skip thinking

Funkcję można przełączać podczas sesji za pomocą Alt+T. Większy budżet rozumowania oznacza wyższy koszt; najlepiej zacząć od minimum i zwiększyć go tylko wtedy, gdy odpowiedzi sprawiają wrażenie zbyt pobieżnych.

Adaptacyjne rozumowanie w Opus 4.6: Opus 4.6 automatycznie dostosowuje głębokość rozumowania do złożoności problemu. W przypadku większości zadań jawne sterowanie budżetem rozumowania nie jest konieczne — przy trudnych problemach Opus zwiększa jego zakres, a przy prostych zachowuje szybkość. Ręczne przełączanie rozumowania jest najbardziej przydatne w modelu Sonnet, gdy zależy Panu/Pani na wymuszeniu głębszej analizy.

Który sposób wykonywania zadań wybrać?

Where should this work happen?
│
├── Requires YOUR local files and tools
│   │
│   ├── Interactive, iterative work → Main REPL session
│   ├── One-shot scripted task → claude -p "prompt" (print mode)
│   ├── CI/CD automation → claude -p --json (non-interactive + structured output)
│   └── Parallel isolated tasks → Subagents via Task tool
│
├── Requires SOMEONE ELSE'S environment
│   │
│   └── Remote codebase or server → Background agent (cloud)
│
└── Doesn't require any environment
    │
    ├── Research or analysis → Subagent with Explore type
    └── Web content extraction → WebFetch / WebSearch tools

Agent teams, subagents czy sesje równoległe?

Do you need multiple agents working on related subtasks?
│
├── YES → Are the subtasks independent (no shared state)?
│         │
│         ├── YES → Can they share the same codebase?
│         │         │
│         │         ├── YES → Use Agent Team (v2.1.32+)
│         │         │         Opus coordinates. Agents share repo access.
│         │         │         Example: "Review auth, API, and DB modules in parallel"
│         │         │
│         │         └── NO → Use Parallel Sessions (separate terminals)
│         │                  Each has its own working directory.
│         │                  Example: "Fix repo-A and repo-B simultaneously"
│         │
│         └── NO → Use Sequential Subagents
│                  Results from one feed into the next.
│                  Example: "Explore → Plan → Implement"
│
└── NO → Use Single Subagent or Main REPL

Którego typu hook użyć?

What kind of automation do you need?
│
├── Run a shell command at a specific event?
│   │
│   └── Use Command Hook
│       Trigger: PreToolUse, PostToolUse, Notification, Stop, SubagentStop
│       Example: "Run prettier after every file edit"
│       Config: hooks.PostToolUse[].command = "prettier --write $FILE"
│
├── Modify Claude's system prompt based on context?
│   │
│   └── Use Prompt Hook (v2.1.35+)
│       Trigger: Same events
│       Example: "Inject project rules when working in /src/auth/"
│       Config: hooks.PreToolUse[].prompt = "When editing auth files..."
│
└── Have Claude make a judgment call before proceeding?
    │
    └── Use Agent Hook (v2.1.35+)
        Trigger: Same events
        Example: "Evaluate if this bash command is safe before running"
        Config: hooks.PreToolUse[].agent = { prompt: "Is this safe?" }

Kiedy używać /fast?

Is response speed more important than depth right now?
│
├── YES → Use /fast   (Opus 5 or Opus 4.8 only, v2.1.219+)
│         Same model, ~2.5× output speed at 2× price
│         Good for: quick questions, simple edits, code explanations,
│                   file searches, formatting tasks
│
└── NO → Stay in normal mode
         Good for: architecture decisions, complex debugging,
                   security reviews, multi-file refactors,
                   anything requiring deep reasoning

/fast przełącza tryb szybki w bieżącej sesji. Korzysta z tego samego modelu — Opus 5 lub Opus 4.8, czyli jedynych dwóch modeli obsługujących tryb szybki od wersji v2.1.219 — ze zoptymalizowaną szybkością generowania odpowiedzi. NIE przełącza na tańszy model, a przy cenie 10/50 USD za MTok również nie jest tańszy.¹⁹⁶¹⁹⁸

Jak działa system uprawnień?

System uprawnień Claude Code zapewnia szczegółową kontrolę nad tym, jakie operacje mogą zostać wykonane. Jego zrozumienie ma kluczowe znaczenie zarówno dla bezpieczeństwa, jak i sprawności pracy. Warto również zapoznać się z sekcją Wdrożenie w przedsiębiorstwie, która opisuje zarządzane ustawienia wymuszające uprawnienia w całej organizacji.

Poziomy uprawnień

Narzędzia tylko do odczytu (zatwierdzane automatycznie): - Read — odczytywanie zawartości plików - Glob — wyszukiwanie plików według wzorca - Grep — przeszukiwanie zawartości plików - WebSearch — przeszukiwanie internetu - LSP — inteligentna analiza kodu (przechodzenie do definicji, wyszukiwanie odwołań, dokumentacja po wskazaniu kursorem)¹⁸

Możliwości narzędzia LSP (v2.0.74+): Narzędzie LSP zapewnia inteligentną analizę kodu podobną do dostępnej w IDE: - Przechodzenie do definicji: przejście do miejsca, w którym zdefiniowano symbol - Wyszukiwanie odwołań: wyświetlenie wszystkich użyć symbolu w całej bazie kodu - Dokumentacja po wskazaniu kursorem: uzyskiwanie informacji o typie i dokumentacji dowolnego symbolu - Działa z TypeScript, Python, Go, Rust oraz innymi językami obsługującymi LSP - Wymaga dostępności serwera językowego (zazwyczaj instalowanego wraz z zestawem narzędzi)

Narzędzia modyfikujące (wymagają zatwierdzenia): - Edit — modyfikowanie istniejących plików - Write — tworzenie nowych plików - Bash — wykonywanie poleceń powłoki - WebFetch — pobieranie zawartości adresów URL - NotebookEdit — modyfikowanie notebooków Jupyter

Przy pierwszym uruchomieniu narzędzia modyfikującego Claude Code prosi o zatwierdzenie. Zatwierdzenia obowiązują przez całą sesję, chyba że wyraźnie skonfigurowano inaczej.

Narzędzie EndConversation (v2.1.214). Claude Code ma teraz tę samą możliwość kończenia rozmowy, którą Claude dysponuje w serwisie claude.ai od 2025 roku: w rzadkich przypadkach wyjątkowo obraźliwych treści lub uporczywych prób jailbreaku Claude może natychmiast zakończyć sesję za pomocą wbudowanego narzędzia EndConversation. Jest to mechanizm odporności na nadużycia i ochrony dobrostanu modelu, a nie funkcja usprawniająca pracę — w zwykłych sesjach programistycznych nigdy nie zostaje uruchomiony.¹⁹⁰¹⁹³

Tryby uprawnień

Od v2.1.200 tryb default nosi nazwę „Manual”. Zmiana nazwy obejmuje CLI, --help, VS Code i JetBrains; wartość konfiguracyjna nie uległa zmianie, dlatego "defaultMode": "default" nadal działa, a --permission-mode manual i "defaultMode": "manual" są obecnie akceptowane jako aliasy. Działanie pozostaje identyczne — prośba o zatwierdzenie przy pierwszym użyciu każdego narzędzia — zmieniono jedynie etykietę, aby nie sugerowała „trybu, który akurat jest domyślny”, skoro w rzeczywistości chodzi o tryb ręcznego zatwierdzania. W tej samej wersji okna dialogowe AskUserQuestion domyślnie nie powodują już automatycznego kontynuowania; subagent, który zada pytanie, czeka teraz na odpowiedź zamiast kontynuować po przekroczeniu limitu czasu, a limit bezczynności można ponownie włączyć za pomocą /config.

Pliki konfiguracyjne umożliwiające wykonywanie kodu wymagają teraz zatwierdzenia nawet w trybie acceptEdits (v2.1.160). Tryb acceptEdits automatycznie zatwierdza zwykłe edycje, jednak od v2.1.160 zatrzymuje się i prosi o zgodę przed zapisaniem plików, które mogą umożliwić ciche wykonywanie poleceń: plików startowych powłoki (.zshenv, .zlogin, .bash_login), plików w ~/.config/git/ oraz konfiguracji narzędzi kompilacji (.npmrc, .yarnrc*, bunfig.toml, .bazelrc, .pre-commit-config.yaml, .devcontainer/ i podobnych). Wynika to z faktu, że edycja któregokolwiek z tych plików może sprawić, iż następne uruchomienie powłoki, instalacja lub commit stanie się wektorem wykonania — dlatego nawet w trybie zaufanego projektu, który zwykle przepuszcza edycje bez pytania, wymagają one świadomego zatwierdzenia. Jest to ten sam model zagrożeń, na którym opierają się istniejące zabezpieczenia zapisu w .claude/, .git/ i .vscode/, rozszerzony na szerszą kategorię plików, w których „edycja staje się wykonaniem”.²⁰⁴

Auto Mode (v2.1.85+): Bezpieczniejszy zamiennik --dangerously-skip-permissions. Osobny model klasyfikatora (Sonnet 4.6) sprawdza każdą operację przed jej wykonaniem, weryfikując jej zgodność z intencją użytkownika i bezpieczeństwo.¹²⁴

Sposób działania: - Operacje tylko do odczytu i edycje plików w katalogu roboczym są zatwierdzane automatycznie - Najpierw rozstrzygane są niestandardowe reguły zezwalające i blokujące - Wszystkie pozostałe operacje trafiają do klasyfikatora w celu oceny - Jeśli operacja zostanie zablokowana, Claude automatycznie próbuje zastosować inne podejście

Domyślnie automatycznie blokowane są: curl | bash, wymuszony push do gałęzi main, wdrożenia i migracje produkcyjne, masowe usuwanie zasobów w chmurze, zmiany IAM lub uprawnień oraz wysyłanie danych wrażliwych na zewnątrz.¹²⁵

Wyłącznik bezpieczeństwa: 3 kolejne blokady lub łącznie 20 blokad podczas sesji powoduje powrót do ręcznych próśb o zatwierdzenie.¹²⁵

# Enable at startup
claude --enable-auto-mode

# Or cycle into it during a session
Shift+Tab  # Cycles through: Manual (aka default) → acceptEdits → auto → plan

Dostępność: najpierw dla użytkowników planu Team, a następnie Enterprise i API. Wymaga Sonnet 4.6 lub Opus 4.6.¹²⁴

Tryb YOLO (v2.0.68+): Aby korzystać z w pełni autonomicznego działania bez klasyfikatora bezpieczeństwa, należy użyć flagi --dangerously-skip-permissions. Flaga zatwierdza wszystko: edycje plików, polecenia bash i wszystkie wywołania narzędzi. Słowo „dangerous” użyte jest celowo. W większości zastosowań zalecaną alternatywą jest Auto Mode.⁵⁴

claude --dangerously-skip-permissions

Ustawianie trybu za pomocą CLI:

claude --permission-mode auto  # or acceptEdits, plan, bypassPermissions

Przełączanie podczas sesji:

Shift+Tab  # Cycles through modes

W settings.json:

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

Składnia reguł uprawnień

Szczegółowe reguły kontrolują określone operacje. Reguły są oceniane kolejno: obowiązuje pierwsze dopasowanie.

Wzorce poleceń Bash:

{
  "allow": [
    "Bash(npm run build)",
    "Bash(npm run test:*)",
    "Bash(git commit:*)",
    "Bash(make:*)"
  ],
  "deny": [
    "Bash(rm -rf:*)",
    "Bash(sudo:*)",
    "Bash(curl|wget:*)"
  ]
}

Gwiazdka umożliwia dopasowywanie prefiksów: Bash(npm run test:*) zezwala na npm run test, npm run test:unit i npm run test:integration.

Ważne ograniczenie: Wzorce Bash dopasowują wyłącznie prefiksy, a nie wyrażenia regularne. Wzorzec taki jak Bash(curl http:*) nie dopasuje curl -X GET http://..., ponieważ opcje występują przed adresem URL. Aby niezawodnie blokować operację, należy zablokować całe polecenie: Bash(curl:*).

Wzorce operacji na plikach:

{
  "allow": [
    "Edit(src/**)",
    "Read(docs/**)"
  ],
  "deny": [
    "Read(.env*)",
    "Read(secrets/**)",
    "Edit(.git/**)",
    "Edit(node_modules/**)"
  ]
}

Składnia ścieżek: - Ścieżki względne: Edit(src/**) — względem katalogu roboczego - Ścieżki bezwzględne względem pliku ustawień: Edit(/build/**) — względem lokalizacji pliku ustawień - Rzeczywiste ścieżki bezwzględne: Edit(//tmp/**) — zaczynają się od // - Katalog domowy: Read(~/.zshrc)

Jednosegmentowe reguły zezwalające dir/** dopasowują teraz wyłącznie <cwd>/dir (v2.1.214) — należy sprawdzić istniejące reguły. Przed v2.1.214 reguła zezwalająca taka jak Edit(src/**) automatycznie zatwierdzała zapis w każdym katalogu o nazwie src w dowolnym miejscu drzewa — między innymi vendor/src/ i packages/foo/src/. Obecnie dopasowuje wyłącznie katalog src znajdujący się bezpośrednio w katalogu roboczym. Jeśli używane było wcześniejsze dopasowywanie na dowolnej głębokości, regułę należy zmienić na Edit(**/src/**). Reguły deny i ask zachowują dopasowywanie na dowolnej głębokości — zmiana zawęża wyłącznie zakres automatycznego zatwierdzania, nigdy zakres blokowania. Reguła, która po cichu przestała pasować, po aktualizacji powoduje wyświetlanie nowych próśb o uprawnienie, a nie błędu, dlatego warto sprawdzić wszystkie reguły zezwalające zapisane w formie jednosegmentowej. Warunki if: w hooks otrzymały w tej wersji takie samo ograniczenie do cwd (zob. Wzorce dopasowania).¹⁹⁰

Należy używać Edit(path)/Read(path), a nie Write(path)/NotebookEdit(path)/Glob(path) (v2.1.210). Claude Code wyświetla teraz podczas uruchamiania ostrzeżenie dotyczące reguł uprawnień zapisanych dla Write(path), NotebookEdit(path) lub Glob(path). Kanoniczne formy to dwie rodziny reguł, które faktycznie kontrolują dostęp do plików: Edit(path) obejmuje wszystkie narzędzia zapisujące pliki (w tym Write i NotebookEdit), natomiast Read(path) obejmuje narzędzia odczytujące pliki (w tym Glob). Starsze reguły należy zmigrować, aby usunąć ostrzeżenie i jednoznacznie określić intencję.¹⁸⁷

Opcja „Always allow” zapisuje reguły w katalogu głównym repozytorium (v2.1.211). Reguły uprawnień utworzone za pomocą opcji „Always allow” w monicie są teraz zapisywane w katalogu głównym repozytorium, a nie w bieżącym worktree. Dzięki temu zatwierdzenie udzielone w jednym worktree pozostaje aktywne w kolejnych sesjach i we wszystkich worktree danego repozytorium — nie trzeba już ponownie zatwierdzać tego samego polecenia w każdym równoległym checkout.¹⁸⁸

Wzorce narzędzi MCP:

{
  "allow": [
    "mcp__github",
    "mcp__database__query",
    "mcp__myserver__*"
  ],
  "deny": [
    "mcp__dangerous_server",
    "mcp__untrusted__*"
  ]
}

Aby zezwolić na wszystkie narzędzia z określonego serwera MCP lub je zablokować, należy użyć składni z symbolem wieloznacznym mcp__server__*.³² Składnia ta pozwala szybko włączyć wszystkie narzędzia z zaufanych serwerów albo zablokować całe serwery pochodzące z niezaufanych źródeł.

Od v2.1.166 reguły blokujące akceptują również glob w miejscu nazwy narzędzia: sam symbol "*" w polu nazwy narzędzia blokuje wszystkie narzędzia, dzięki czemu można zablokować wszystko, a następnie zezwolić na wąski zestaw. Reguły zezwalające odrzucają natomiast globy niezwiązane z MCP — nie można w ten sam sposób ogólnie zezwolić na wszystko, co pozwala zachować restrykcyjne ustawienia domyślne.²⁰²

Dopasowywanie na poziomie parametrów — Tool(param:value) (v2.1.178):

Oprócz nazwy narzędzia reguła może dopasowywać jego parametry wejściowe, przy czym * pełni funkcję symbolu wieloznacznego wartości:

{
  "deny": [
    "Agent(model:opus)"
  ]
}

Agent(model:opus) blokuje każdego subagenta uruchamianego na poziomie Opus — blokowane jest samo jego uruchomienie, a nie tylko przekazywana w prompt prośba o nieużywanie go. Rozszerza to kontrolę uprawnień z poziomu „które narzędzie” na „w jaki sposób jest wywoływane”, w postaci deterministycznej reguły zamiast żądania zawartego w prompt. Mechanizm ten współdziała z zarządzanym ustawieniem enforceAvailableModels: lista dozwolonych elementów określa, które poziomy modeli są dostępne w sesji, natomiast reguły Tool(model:...) ograniczają sposób, w jaki subagents mogą z nich korzystać.¹⁷³

Od v2.1.186 reguły Agent(...) są również egzekwowane przy uruchamianiu nazwanych subagents: reguły blokujące Agent(agent_type) i ograniczenia dozwolonych typów Agent(x,y) obowiązują teraz przy uruchamianiu konkretnego nazwanego agenta (za pomocą workflow, --agents lub agent team), a nie tylko anonimowych uruchomień w stylu Task. Uruchomienie zostaje zablokowane na samym początku, co eliminuje lukę pozwalającą nazwanemu agentowi ominąć regułę, która miała go ograniczać.¹⁷⁵

Wzorce WebFetch:

{
  "allow": [
    "WebFetch(domain:github.com)",
    "WebFetch(domain:api.example.com)"
  ]
}

Dodatkowe katalogi

Rozszerzanie dostępu Claude poza bieżący projekt:

{
  "permissions": {
    "additionalDirectories": [
      "../shared-lib",
      "../docs",
      "~/reference-projects/design-system"
    ]
  }
}

Dodatkowe katalogi są niezbędne w monorepo lub gdy Claude musi odwoływać się do kodu w katalogach równorzędnych.

Tryb sandbox

Włączanie izolacji systemu plików i sieci:

> /sandbox

Można też skonfigurować ją w ustawieniach:

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["git", "docker"],
    "network": {
      "allowUnixSockets": ["~/.ssh/agent-socket"],
      "allowLocalBinding": true,
      "deniedDomains": ["pastebin.com", "transfer.sh", "0x0.st"]
    }
  }
}

Od v2.1.187 ustawienie sandbox.credentials uniemożliwia poleceniom wykonywanym w sandbox odczytywanie plików poświadczeń i tajnych zmiennych środowiskowych — zapewniając wielowarstwową ochronę przed wykradaniem sekretów przez polecenia uruchamiane w sandbox.¹⁷⁶

Od v2.1.216 ustawienie sandbox.filesystem.disabled pomija izolację systemu plików, zachowując kontrolę wychodzącego ruchu sieciowego — jest to przydatne, gdy izolacja systemu plików zakłóca działanie narzędzia kompilacji, ale nadal wymagane jest egzekwowanie listy dozwolonych domen dla ruchu wychodzącego.¹⁹²

Od v2.1.219 ustawienie sandbox.network.strictAllowlist bezwarunkowo odrzuca hosty spoza listy dozwolonych, bez wyświetlania monitu. Domyślnie polecenie uruchomione w sandbox, które próbuje połączyć się z hostem spoza allowedDomains, powoduje wyświetlenie prośby o uprawnienie; po włączeniu strictAllowlist połączenie jest po prostu odrzucane. To ustawienie odpowiednie dla operacji nienadzorowanych — CI, agentów działających w tle i nocnych pętli — w których monit pozostawiony bez odpowiedzi powoduje zastój, a polityka „zapytaj o nieoczekiwany ruch wychodzący” i tak nie jest właściwa. Uzupełnia ono sieciową triadę: allowedDomains określa, co jest dozwolone, deniedDomains (poniżej) wycina wyjątki z szerokiego zezwolenia, a strictAllowlist decyduje, czy wszystko pozostałe powoduje pytanie, czy błąd.¹⁹⁶

Podczas pracy w sandbox: - Dostęp do systemu plików jest ograniczony do katalogu projektu - Dostęp do sieci jest kontrolowany - Określone polecenia są wyłączone z ograniczeń sandbox - Polecenia Bash są automatycznie dozwolone, jeśli autoAllowBashIfSandboxed ma wartość true

Wskazówka dla zaawansowanych: Tryb sandbox doskonale nadaje się do uruchamiania Claude na niezaufanych bazach kodu. Warto włączyć go podczas analizowania nieznanych projektów lub gdy potrzebna jest dodatkowa warstwa ochrony. Wewnętrzne testy Anthropic wykazały, że sandbox ogranicza liczbę próśb o uprawnienia o 84%.³⁸ Sandbox wykorzystuje mechanizmy na poziomie systemu operacyjnego (macOS seatbelt i Linux bubblewrap) do izolowania systemu plików i sieci, dzięki czemu nawet udany prompt injection pozostaje w pełni odizolowany. Anthropic udostępnił runtime sandbox jako open source dla zespołów tworzących własnych agentów.⁸²

Uwagi dotyczące bezpieczeństwa (v2.1.34+): Polecenia wyłączone z sandbox za pomocą sandbox.excludedCommands lub dangerouslyDisableSandbox mogły wcześniej omijać regułę uprawnień Bash wymagającą zatwierdzenia, gdy włączone było autoAllowBashIfSandboxed; naprawiono to w v2.1.34.⁸⁷ Od v2.1.38 zapisy w .claude/skills są blokowane w trybie sandbox, co uniemożliwia prompt injection modyfikowanie definicji skills.⁸⁸ W v2.1.77 dodano ustawienie systemu plików sandbox allowRead, które ponownie zezwala na odczyt w obszarach objętych denyRead — jest to przydatne, gdy trzeba zablokować większość drzewa katalogów, ale umieścić określone podkatalogi na białej liście.¹¹⁹

Wyjątek dla konfiguracji agentów w .claude/ (v2.1.121+): --dangerously-skip-permissions nie wyświetla już próśb o zatwierdzenie zapisu w .claude/skills/, .claude/agents/ i .claude/commands/.¹⁵⁴

Rozpoznawanie zagnieżdżonych .claude/ (v2.1.178): Skills w zagnieżdżonych katalogach .claude/skills są teraz ładowane automatycznie podczas pracy z plikami znajdującymi się pod takim katalogiem, a nie wyłącznie z katalogu głównego repozytorium; w przypadku konfliktu nazw do zagnieżdżonego skill można odwołać się jako <dir>:<name>, dzięki czemu oba pozostają dostępne. Pozostałe elementy projektu są rozpoznawane w ten sam sposób — gdy nazwa agenta, workflow lub stylu wyjściowego koliduje między zagnieżdżonymi katalogami .claude/, pierwszeństwo ma element najbliższy katalogowi roboczemu, a zapis workflow w zakresie projektu trafia do najbliższego istniejącego .claude/workflows/. W przypadku monorepo lub repozytorium zawierającego inne repozytoria zapewnia to narzędzia właściwe dla poszczególnych pakietów, które aktywują się kontekstowo zamiast tworzyć jedną płaską, globalną powierzchnię.¹⁷³

Niestandardowe ścieżki bubblewrap i socat (v2.1.133+): Zarządzane ustawienia sandbox.bwrapPath i sandbox.socatPath pozwalają administratorom wskazać we wdrożeniach Linux/WSL niestandardowe lokalizacje plików binarnych bubblewrap i socat. Jest to przydatne, gdy dystrybucje instalują te narzędzia poza $PATH lub gdy organizacja dostarcza własne, wzmocnione wersje.¹⁶⁰

Wzmocnienie zabezpieczeń w v2.1.113:¹⁵⁰

• sandbox.network.deniedDomains blokuje określone hosty nawet wtedy, gdy szerszy symbol wieloznaczny w allowedDomains w przeciwnym razie by na nie zezwolił. Za pomocą listy blokad można odciąć serwisy do wklejania treści, przechowywania plików lub znane złośliwe hosty bez przepisywania całej polityki zezwoleń. Warto połączyć ją z sandbox.network.strictAllowlist (v2.1.219, powyżej), jeśli wszystko spoza listy dozwolonych ma być po cichu odrzucane zamiast powodować wyświetlenie monitu.
• Reguły blokujące polecenia opakowujące. Reguły blokujące Bash dopasowują teraz polecenia opakowane w env, sudo, watch, ionice, setsid i podobne nakładki wykonawcze. Reguły takie jak Bash(rm:*) wykrywają teraz env rm -rf, sudo rm -rf i podobne sposoby obejścia zabezpieczeń.
• Reguły zezwalające Bash(find:*) nie zatwierdzają już automatycznie find -exec ani find -delete. Flagi te wykonują polecenia i usuwają pliki, dlatego Claude Code kieruje je przez standardową ścieżkę uprawnień.
• Ochrona przed usuwaniem w macOS. Reguły zezwalające Bash(rm:*) traktują teraz /private/etc, /private/var, /private/tmp i /private/home jako niebezpieczne cele usuwania. /var, /etc i /tmp są dowiązaniami symbolicznymi do /private/, dlatego wcześniejsza postać reguły nie obejmowała ścieżek kanonicznych.

Wzmocnienia uprawnień zgodnie z zasadą fail-closed w v2.1.214:¹⁹⁰

W jednej wersji zamknięto szereg luk w sprawdzaniu uprawnień, konsekwentnie zgodnie z zasadą fail-closed — gdy analizator nie ma pewności, wyświetla prośbę o zatwierdzenie:

• Naprawiono obejście w Windows PowerShell 5.1. Polecenia uruchamiane w sesjach PowerShell 5.1 mogły wcześniej omijać sprawdzanie uprawnień.
• Przekierowania deskryptorów plików Bash działają zgodnie z zasadą fail-closed. Formy przekierowań interpretowane przez bash inaczej niż przez analizator uprawnień powodują teraz wyświetlenie monitu zamiast wykonania.
• Polecenia dłuższe niż 10 000 znaków zawsze wymagają zatwierdzenia. Bardzo długie polecenia były wcześniej błędnie oceniane; obecnie nigdy nie są wykonywane automatycznie.
• Indeksy dolne i modyfikatory zsh w [[ ]] powodują wyświetlenie monitu. Indeksy dolne zmiennych i modyfikatory w porównaniach [[ ]] były traktowane jako nieaktywny tekst; ponieważ mogą wykonywać kod, wymagają teraz zatwierdzenia.
• Niebezpieczne warianty help/man nie są już zatwierdzane automatycznie. Niektóre wywołania mogły uruchamiać niebezpieczne opcje, podstawienia poleceń lub ścieżki z ukośnikami odwrotnymi pod pozorem odczytywania dokumentacji.
• Kolejność monitów w sesjach zdalnych. Prośby o uprawnienia w sesjach zdalnych nie mogą już zostać obsłużone przed lokalnym oknem dialogowym potwierdzenia.
• Flagi docker przekierowujące do demona wymagają zatwierdzenia. Polecenia docker (w tym shim docker dostarczany przez Podman) zawierające --url, --connection, --identity lub tryb zdalny Podman były wcześniej wykonywane bez monitu — flagi te kierują polecenie do zupełnie innego demona.
• file traci automatyczne uprawnienie tylko do odczytu, gdy wskazano mu miejsce zapisu. file -m/--magic-file oraz -f/--files-from wymagają teraz uprawnienia, zamiast być automatycznie zatwierdzane jako operacje tylko do odczytu.

Jak działają hooks?

Hooks wykonują deterministyczne polecenia powłoki w określonych punktach przepływu pracy Claude Code. W przeciwieństwie do wydawania Claude instrukcji wykonania działań hooks gwarantują ich wykonanie niezależnie od zachowania modelu. Są niezbędne do egzekwowania standardów zespołu i automatyzacji powtarzalnych zadań. Drzewo decyzyjne „Który typ hooka?” obejmujące hooks typu command, prompt i agent znajduje się w sekcji Schematy podejmowania decyzji.

Dlaczego hooks zamiast promptów: Polecenie Claude, aby „zawsze uruchamiał Prettier po edycji plików”, czasami działa. Claude może jednak o tym zapomnieć, nadać priorytet szybkości albo uznać zmianę za „zbyt małą”. Hooks gwarantują wykonanie: każde użycie Edit lub Write zawsze uruchamia formatter, bez wyjątków. W przypadku zgodności z wymaganiami, bezpieczeństwa i standardów zespołowych determinizm jest lepszy od probabilistyki.⁴

Dostępne zdarzenia

Wartości source zdarzenia SessionStart. Dane wejściowe hooka SessionStart zawierają pole source, które wskazuje sposób rozpoczęcia sesji: "startup", "resume", "clear" lub "compact". Od wersji v2.1.214 sesja utworzona jako fork zgłasza source: "fork" zamiast "resume" — jest to odpowiednik po stronie hooka zmiany z v2.1.212, która przeniosła /fork do działania w tle. Jeśli hook SessionStart rozgałęzia logikę na podstawie source (na przykład ponownie wstrzykując kontekst tylko dla "resume"), należy zaktualizować listę dopasowań, aby uwzględniała również "fork".¹⁹⁰

Konfiguracja hooks

Hooks należy zdefiniować w settings.json lub osobnym pliku hooks.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/inject-context.sh"
          }
        ]
      }
    ]
  }
}

Matchers

Pole matcher określa, które narzędzia wyzwalają hook:

{"matcher": "*"}              // Match all tools
{"matcher": "Bash"}           // Match Bash only
{"matcher": "Edit|Write"}     // Match Edit or Write
{"matcher": "mcp__github"}    // Match MCP server tools
{"matcher": ""}               // Match for events without tools (like UserPromptSubmit)

Aby dopasować wiele narzędzi, należy użyć | (Edit|Write). Od wersji v2.1.191 poprawnie działają także matchers rozdzielone przecinkami (np. Bash,PowerShell) — wcześniejsze wersje po cichu je pomijały, dlatego hook z matcherem zawierającym przecinek nigdy się nie uruchamiał.¹⁷⁸ Od wersji v2.1.195 matchers z identyfikatorami zawierającymi łącznik (np. code-reviewer, mcp__brave-search) stosują dopasowanie dokładne zamiast przypadkowego dopasowywania podciągów, dzięki czemu hook nie uruchamia się już dla niezamierzonych narzędzi, które jedynie zawierają dany ciąg. Aby dopasować każde narzędzie z serwera MCP o nazwie zawierającej łącznik, należy użyć jawnego wzorca, takiego jak mcp__brave-search__.*.¹⁷⁹

Od wersji v2.1.214 warunki ścieżek if: hooków są ograniczone do cwd. Ta sama zmiana zakresu pojedynczego segmentu, która objęła reguły zezwoleń uprawnień (zob. Składnia reguł uprawnień), dotyczy warunków if: hooków: warunek taki jak dir/** dopasowuje teraz wyłącznie <cwd>/dir, a nie każdy katalog dir/ w drzewie. Aby przywrócić dopasowywanie na dowolnej głębokości, należy zapisać **/dir/**.¹⁹⁰

Protokół wejścia/wyjścia hooks

Hooks otrzymują JSON przez stdin:

{
  "tool_name": "Bash",
  "tool_input": {
    "command": "npm test",
    "description": "Run test suite"
  },
  "session_id": "abc-123"
}

Wzbogacenie zdarzeń hooków (v2.1.69+): Wszystkie zdarzenia hooków zawierają teraz pola agent_id i agent_type, gdy zostały wyzwolone z subagenta lub sesji --agent, a polecenia hooków wiersza stanu zawierają również pole worktree.¹¹⁰

Hooks Stop/SubagentStop (v2.1.47+) otrzymują dodatkowe pole last_assistant_message zawierające tekst końcowej odpowiedzi Claude, dzięki czemu hooks mogą sprawdzić dane wyjściowe bez analizowania plików transkrypcji:

{
  "session_id": "abc-123",
  "last_assistant_message": "I've completed the refactoring. Here's what changed..."
}

Łagodna informacja zwrotna bez blokowania (v2.1.163+): Hooks Stop i SubagentStop mogą zwrócić hookSpecificOutput.additionalContext w swoich danych wyjściowych JSON, aby przekazać Claude informację zwrotną i kontynuować turę bez oznaczania odpowiedzi jako błędu hooka. Wcześniej jedynym realnym mechanizmem hooka Stop było blokowanie kodem wyjścia 2 (co wygląda jak błąd i wlicza się do limitu kolejnych blokad); additionalContext dodaje kanał sterowania dla wskazówek w rodzaju „oto co zostało pominięte, proszę kontynuować”, który nie zakłóca pętli.²⁰³

Kody wyjścia sterują zachowaniem: - 0: Powodzenie: operacja jest kontynuowana. Stdout jest wyświetlany w trybie szczegółowym (Ctrl+O). W przypadku UserPromptSubmit i SessionStart stdout zostaje dodany do kontekstu. - 2: Błąd blokujący: operacja zostaje zatrzymana. Stderr staje się komunikatem o błędzie przekazywanym z powrotem do Claude. - 1, 3 itd.: Błąd nieblokujący: operacja jest kontynuowana. Stderr jest wyświetlany jako ostrzeżenie w trybie szczegółowym.

W celu uzyskania zaawansowanej kontroli hooks mogą zwracać JSON:

{
  "decision": "allow",
  "message": "Command validated and modified",
  "modifications": {
    "tool_input": {
      "command": "npm test -- --coverage"
    }
  }
}

Sterowanie decyzjami PreToolUse (preferowany format): Hooks PreToolUse korzystają z hookSpecificOutput, aby zapewnić bogatsze możliwości sterowania: trzy wyniki (allow/deny/ask), a także możliwość modyfikowania danych wejściowych narzędzia i wstrzykiwania kontekstu:⁸⁹

{
  "hookSpecificOutput": {
    "hookEventName": "PreToolUse",
    "permissionDecision": "allow",
    "permissionDecisionReason": "Command validated and modified",
    "updatedInput": {
      "command": "npm test -- --coverage --ci"
    },
    "additionalContext": "Note: This database has a 5-second query timeout."
  }
}

Uwaga: Pola najwyższego poziomu decision i reason są przestarzałe dla PreToolUse. Zamiast nich należy używać hookSpecificOutput.permissionDecision oraz hookSpecificOutput.permissionDecisionReason. Inne zdarzenia (PostToolUse, Stop itd.) nadal używają pola decision najwyższego poziomu.⁸⁹

Tytuł sesji UserPromptSubmit (v2.1.94+): Hooks UserPromptSubmit mogą ustawić tytuł sesji za pomocą hookSpecificOutput.sessionTitle.¹⁴⁰

Asynchroniczne hooks (styczeń 2026)

Hooks mogą teraz działać w tle bez blokowania wykonywania Claude Code. Do konfiguracji hooka należy dodać async: true:⁸¹

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/notify-slack.sh",
            "async": true
          }
        ]
      }
    ]
  }
}

Kiedy używać asynchronicznych hooks: - Powiadomienia (Slack, e-mail, Pushover), które nie powinny spowalniać sesji - Rejestrowanie i telemetria, które mogą działać w tle - Niekrytyczne przetwarzanie końcowe (analityka, kopie zapasowe)

Kiedy NIE używać asynchronicznych hooks: - Formatowanie (musi zakończyć się przed następną edycją) - Walidacja (musi blokować w razie niepowodzenia) - Każdy hook, który musi modyfikować dane wejściowe/wyjściowe narzędzia

Hooks oparte na promptach i agentach (v2.1.32+)

Oprócz hooks poleceń powłoki (type: "command") Claude Code obsługuje dwa typy hooks wykorzystujące LLM, które oceniają warunki za pomocą rozumowania AI, a nie skryptów.⁸⁹

Prompt hooks (type: "prompt") wysyłają jednoturowy prompt do szybkiego modelu Claude. Model zwraca { "ok": true }, aby zezwolić, lub { "ok": false, "reason": "..." }, aby zablokować:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "prompt",
            "prompt": "Evaluate if Claude should stop: $ARGUMENTS. Check if all requested tasks are complete and tests pass.",
            "timeout": 30
          }
        ]
      }
    ]
  }
}

HTTP hooks (type: "http") wysyłają dane wejściowe JSON zdarzenia jako żądanie POST pod wskazany URL i otrzymują w odpowiedzi JSON. Należy ich używać do webhooków, zewnętrznych usług powiadamiania lub walidacji opartej na API (v2.1.63+):¹⁰⁴

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "http",
            "url": "https://api.example.com/notify",
            "headers": {
              "Authorization": "Bearer $MY_TOKEN"
            },
            "allowedEnvVars": ["MY_TOKEN"]
          }
        ]
      }
    ]
  }
}

HTTP hooks używają tego samego formatu decyzji co command hooks (zwracają JSON z polami decision i reason). Gdy sandboxing jest włączony, są kierowane przez sieciowy serwer proxy sandboxa. Nie są obsługiwane dla zdarzeń SessionStart/Setup.

Agent hooks (type: "agent") uruchamiają subagenta z dostępem do narzędzi (Read, Grep, Glob) w celu wieloturowej weryfikacji. Należy ich używać, gdy sprawdzenie wymaga inspekcji rzeczywistych plików lub wyników testów:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "agent",
            "prompt": "Verify all unit tests pass. Run the test suite and check results. $ARGUMENTS",
            "timeout": 120
          }
        ]
      }
    ]
  }
}

Symbolu zastępczego $ARGUMENTS należy użyć dla danych wejściowych JSON hooka. Oba typy obsługują pola model (domyślnie szybki model) oraz timeout. Obsługiwane zdarzenia: PreToolUse, PostToolUse, PostToolUseFailure, PermissionRequest, UserPromptSubmit, Stop, SubagentStop, TaskCompleted. TeammateIdle nie obsługuje prompt/agent hooks.

Hooks narzędzi MCP (v2.1.118+)

Hooks mogą teraz wywoływać narzędzie MCP bezpośrednio za pomocą type: "mcp_tool", eliminując potrzebę opakowywania w podproces Bash wywołujący serwer.¹⁵²

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit",
        "hooks": [
          {
            "type": "mcp_tool",
            "server": "linear",
            "tool": "create_comment",
            "input": {"issue_id": "ENG-123", "body": "Auto-updated by Claude Code"}
          }
        ]
      }
    ]
  }
}

Dobrze współgra to z serwerami MCP, które użytkownicy już skonfigurowali: każde narzędzie dostępne z /mcp może zostać wywołane przez hook.

duration_ms w hooks PostToolUse (v2.1.119+)

Dane wejściowe hooks PostToolUse i PostToolUseFailure zawierają teraz duration_ms, czyli czas wykonania narzędzia z wyłączeniem monitów o uprawnienia i hooks PreToolUse.¹⁵² Jest to przydatne do wykrywania powolnych narzędzi, prowadzenia dzienników audytu i pomiaru opóźnień poszczególnych narzędzi:

# Stderr-flagged warning when an Edit takes more than 10 seconds
DUR=$(jq -r '.duration_ms')
if [ "$DUR" -gt 10000 ]; then
  echo "[slow-edit] ${DUR}ms — investigate $TOOL_INPUT_FILE_PATH" >&2
fi

updatedToolOutput dla wszystkich narzędzi (v2.1.121+)

W wersji v2.1.118 hooks narzędzi MCP zyskały możliwość zastępowania danych wyjściowych narzędzia za pomocą hookSpecificOutput.updatedToolOutput. Od wersji v2.1.121 to samo pole działa dla każdego hooka PostToolUse — narzędzi wbudowanych (Bash, Read, Edit, Glob, Grep itd.), narzędzi subagentów oraz narzędzi MCP. Przykładowe zastosowania: redagowanie poufnych treści z danych wyjściowych dowolnego narzędzia, normalizowanie struktury na potrzeby dalszych odbiorców, wstrzykiwanie metadanych przed odczytaniem wyniku przez agenta.¹⁵⁴

Zmienne środowiskowe hooks

Hooks mają dostęp do zmiennych środowiskowych służących do rozwiązywania ścieżek:⁸⁹

Utrwalanie zmiennych środowiskowych z SessionStart:

#!/bin/bash
if [ -n "$CLAUDE_ENV_FILE" ]; then
  echo 'export NODE_ENV=production' >> "$CLAUDE_ENV_FILE"
fi
exit 0

Bezpieczeństwo HTTP hooks (v2.1.51+): HTTP hooks, które interpolują zmienne środowiskowe w nagłówkach, wymagają teraz jawnej listy allowedEnvVars. Zapobiega to eksfiltracji dowolnych zmiennych środowiskowych przez wartości nagłówków. Gdy sandboxing jest włączony, HTTP hooks są również kierowane przez sieciowy serwer proxy sandboxa, który egzekwuje listę dozwolonych domen. HTTP hooks nie są obsługiwane dla zdarzeń SessionStart/Setup.⁹⁸

{
  "hooks": {
    "PostToolUse": [{
      "hooks": [{
        "type": "command",
        "command": "curl -H 'Authorization: Bearer $MY_TOKEN' https://api.example.com/notify",
        "allowedEnvVars": ["MY_TOKEN"]
      }]
    }]
  }
}

Zaufanie do przestrzeni roboczej hooks (v2.1.51+): Polecenia hooks statusLine i fileSuggestion wymagają teraz zaakceptowania zaufania do przestrzeni roboczej przed wykonaniem w trybie interaktywnym, co eliminuje potencjalny wektor ataku.⁹⁸

Praktyczne przykłady hooks

Automatyczne formatowanie plików TypeScript po edycji:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "bash -c '[[ \"$FILE_PATH\" == *.ts ]] && npx prettier --write \"$FILE_PATH\" || true'"
          }
        ]
      }
    ]
  }
}

Rejestrowanie wszystkich poleceń bash:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.command' >> ~/.claude/bash-history.log"
          }
        ]
      }
    ]
  }
}

Blokowanie dostępu do poufnych plików:

#!/bin/bash
# .claude/hooks/protect-files.sh
data=$(cat)
path=$(echo "$data" | jq -r '.tool_input.file_path // empty')

if [[ "$path" == *".env"* ]] || [[ "$path" == *"secrets/"* ]] || [[ "$path" == *".pem"* ]]; then
  echo "Blocked: Cannot access sensitive file $path" >&2
  exit 2  # Exit 2 = block the tool call. Exit 1 = non-blocking error (hook failure only).
fi
exit 0