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

TL;DR: Claude Code to agentowy CLI, który odczytuje bazę kodu, wykonuje polecenia i modyfikuje pliki za pośrednictwem wielowarstwowego systemu uprawnień, hooks, integracji MCP oraz subagents. Opanowanie pięciu podstawowych systemów (konfiguracji, uprawnień, hooks, MCP i subagents) pozwala zwielokrotnić produktywność. Warto dobierać poziom modelu do zadania — Opus do złożonego rozumowania, Sonnet do ogólnych zastosowań, a Haiku do szybkiej eksploracji — albo ujednolicić pracę na Opus, jeśli jedynym kryterium jest jakość. Do wszystkiego, co musi być wykonywane zawsze, należy używać hooks, a nie promptów. Od 14 sierpnia 2026 tryb Auto jest domyślnym trybem uprawnień dla nowych sesji w planach Pro, Max i Team (zapowiedziano go 7 sierpnia, a działanie potwierdzono w dniu wdrożenia; autonomia podlega ocenie klasyfikatora — samodzielnie ustawiona wartość defaultMode pozostaje aktywna, chyba że zaakceptuje się jednorazowy monit o zmianę, Shift+Tab przełącza tryb w dowolnej sesji, a disableAutoMode wyłącza go w całej organizacji).²⁰³ Domyślny model zależy od planu: Max, Team Premium, Enterprise (na licencję od wersji v2.1.251) oraz Anthropic API domyślnie korzystają z Claude Opus 5, natomiast Pro i Team Standard — z Sonnet 5 — natywny kontekst 1M, standardowa cena katalogowa 2/10 USD za MTok (promocyjna cena premierowa stała się ceną stałą: podwyżka zaplanowana na 1 września nie nastąpi)²²⁸²⁰⁷ — domyślne stosowanie Sonnet 5 wszędzie, wprowadzone w wersji v2.1.197 (30 czerwca 2026), należy już do historii, a alias opus wskazuje na Claude Opus 5 (v2.1.219+); w wersji v2.1.198 (1 lipca) subagents zaczęły domyślnie działać w tle, Claude w Chrome osiągnął ogólną dostępność, agenci działający w tle mogą po zakończeniu pracy nad kodem w worktree wykonać commit, push i otworzyć roboczy PR, a hook Notification (agent_needs_input/agent_completed) jest wywoływany dla sesji działających w tle; wersja v2.1.199 (2 lipca) obsługuje do 5 skumulowanych wywołań slash-skills i automatycznie ponawia przejściowe błędy 429 u subskrybentów; w wersji v2.1.200 (3 lipca) tryb uprawnień default przemianowano na „Manual” w CLI, --help, VS Code i JetBrains (wartość konfiguracyjna nie uległa zmianie, a manual jest akceptowany jako alias) oraz wyłączono domyślne automatyczne kontynuowanie po oknach dialogowych AskUserQuestion; wersja v2.1.202 (6 lipca) dodaje kontrolkę „Dynamic workflow size” w /config i rozdziela /review <pr> (szybki pojedynczy przebieg) od /code-review <level> <pr#> — rozdział ten cofnięto w wersji v2.1.223: /review znów jest aliasem /code-review, a samo /code-review ponownie wykorzystuje ostatni poziom effort; wersje v2.1.203–205 (7–9 lipca) wzmacniają zabezpieczenia trybu Auto — pliki transkrypcji są chronione przed manipulacją, rm -rf z nierozpoznawalną zmienną najpierw prosi o zgodę, a powiadomienia o zadaniach w tle informują, że nie doszło do ingerencji człowieka (dzięki czemu nie można wykonywać działań na podstawie sfabrykowanych zatwierdzeń w transkrypcji) — oraz przekształcają /doctor w pełne narzędzie diagnostyczno-naprawcze (alias /checkup).^181182183 W wersji v2.1.217 (21 lipca) zmieniono podejście do zagnieżdżonych subagents — subagents przestały domyślnie uruchamiać własne subagents (tę zmianę ponownie cofnięto trzy dni później w wersji v2.1.219, przywracając głębokość 3; patrz niżej), domyślnie jednocześnie działa najwyżej 20 subagents (CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS), a --max-budget-usd rzeczywiście zatrzymuje 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 — przegląd nie wypełnia już konwersacji — domyślnie uruchamia w tle skills z context: fork (można zrezygnować dla poszczególnych skills za pomocą background: false), uruchamia /deep-research wyłącznie po jawnym wywołaniu, przekazuje klasyfikatorowi trybu Auto kontrole niebezpiecznego rm, działającego w tle & i podejrzanych ścieżek Windows zamiast wyświetlać okna uprawnień oraz uniemożliwia uruchamianie hooks z frontmatter agentów pochodzących z niezaufanych folderów.¹⁹⁵ W wersji v2.1.219 (24 lipca) Claude Opus 5 (claude-opus-5) staje się domyślnym modelem Opus — kontekst 1M, maksymalny wynik 128K, 5/25 USD za MTok (identycznie jak w Opus 4.8), thinking domyślnie włączone, effort domyślnie ustawione na high, granica wiedzy: maj 2026 — oraz skorygowano dwie kwestie wprowadzone we wcześniejszych wydaniach: tryb Fast obejmuje teraz Opus 5 i Opus 4.8 w cenie 10/50 USD za MTok (2× cena bazowa, przy czym Opus 4.7 całkowicie usunięto z trybu Fast), 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 dynamiczne workflows domyślnie korzystają teraz z wytycznej średniego rozmiaru (zalecane 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 niezawodności. Wersje v2.1.221–226 (4–7 sierpnia) dodają komunikację między sesjami (SendMessage/ListAgents między sesjami na macOS/Linux), samodzielnie hostowane runners dla sesji w chmurze (Team/Enterprise), źródło plugins archive z przypięciem SHA-256, maskowanie danych uwierzytelniających w sandbox uwzględniające JWT/SigV4, widok Focus w VSCode oraz osobny worktree dla kopii /fork — a także usuwają limit 200 subagents na sesję i ultraplan.^{199200201202196197198} Wersje v2.1.227–229 (10–12 sierpnia) koncentrują się na poprawkach i usprawnieniach wygody użytkowania: marketplaces plugins zyskują źródła command (lokalny program wypisuje folder plugin, który jest ponownie rozpoznawany przy każdej sesji; mode: "link" używa go bezpośrednio), claude remote-control --continue wznawia ostatnią sesję Remote Control, ListAgents oznacza rozłączonych uczestników Remote Control jako offline, a sesje w chmurze jako cloud, /commit-push-pr przestaje automatycznie zatwierdzać niebezpieczne flagi git (--force, --amend, --no-verify), a narzędzie Write stosuje na nowszych modelach te same reguły co Edit — nadpisanie nieodczytanego pliku nie wymaga już wcześniejszego odczytu w bieżącej sesji.^235233234 W wersji v2.1.232 (13 sierpnia) forkowanie subagent staje się zachowaniem domyślnym (subagent_type: "fork" dziedziczy pełną konwersację i pamięć podręczną promptu; procesy inne niż teammate uruchamiane w sesjach interaktywnych działają w tle), można wspomnieć inną aktywną sesję po nazwie za pomocą @ w prompcie (Claude kieruje wiadomość przez SendMessage, a sama nazwa odpowiadająca dokładnie jednej aktywnej sesji jest teraz dostarczana bez potwierdzania odwołania), nazwy sesji interaktywnych pozostają unikatowe na danym komputerze (warianty name-word-word), kontrolki odbierania wiadomości między sesjami są widoczne jako wiersze /config, a także wprowadzono zgodność z GitLab — dziewięć rodzin tokenów GitLab jest ukrywanych w sandbox, zabezpieczono dane uwierzytelniające glab CLI, a proste adresy marketplace z gitlab.com (również zagnieżdżone podgrupy) są klonowane tak jak adresy GitHub.²³² Wersja v2.1.233 (14 sierpnia) rozszerza zgodność z GitLab na --worktree (adresy MR wyświetlane jako !N w claude agents), dodaje limity pamięci dla poleceń Bash w systemie Linux (CLAUDE_CODE_TOOL_MEMORY_LIMIT) i ustawienie TTL pamięci podręcznej WebFetch oraz domyślnie wyłącza narzędzia todo/śledzenia zadań w Opus 4.8, Sonnet 5, Fable 5 i nowszych modelach (CLAUDE_CODE_ENABLE_TODO_TOOLS=1 przywraca je) — częściowo cofa również zmiany dotyczące uprawnień Bash w systemie Windows z wersji v2.1.232 po regresji trybu Auto.²³¹ W wersji v2.1.234 (17 sierpnia) Claude Code automatycznie kontynuuje sesję po zresetowaniu limitu użycia claude.ai (można to wyłączyć w /config: „Continue automatically at usage limit”), /permissions i /add-dir można otwierać w trakcie tury, dodano CLAUDE_CODE_PROJECT_DIR_NAME i kontrolę postępu zadania w tle /goal (CLAUDE_CODE_GOAL_CHECKIN_MINUTES), w stopce repozytoriów z uwierzytelnionym glab CLI wyświetlana jest plakietka MR GitLab (!N), a koszt kontekstu wbudowanego skill claude-api zmniejszono z około 200k do około 25k tokenów dzięki ładowaniu dokumentacji referencyjnej na żądanie.²³⁰ Wersje v2.1.235–238 (18–20 sierpnia) dodają wbudowany styl wyników „Concise” (najpierw wyniki, bez wstępu ani narracji — można go wybrać w sekcji Output style w /config), zmienną środowiskową ANTHROPIC_DEFAULT_MODEL (ustawia model początkowy nowych sesji; wybór w /model nadal ją zastępuje i jest zapisywany, inaczej niż ANTHROPIC_MODEL), opcjonalne ustawienie spellcheck (podkreśla błędnie zapisane słowa w prompcie za pomocą zainstalowanego programu aspell, hunspell lub ispell), ustawienie keybindingFlavor ("readline" sprawia, że Ctrl+W usuwa tekst do poprzedniego białego znaku, tak jak w Bash; ustawienie wycofano w wersji v2.1.261 — readline jest teraz jedynym zachowaniem), headersHelper w marketplaces plugins i projekcie .mcp.json (polecenie generuje krótkotrwałe nagłówki HTTP; helpers wpisów katalogu działają wyłącznie podczas instalowania lub aktualizowania po wyświetleniu swojego polecenia, natomiast helpers na poziomie projektu/plugin/agent działają bez odziedziczonych zmiennych środowiskowych z danymi uwierzytelniającymi, po wyświetleniu okna zaufania folderu), opcję notify_when_idle dla międzyseysyjnego SendMessage (jednorazowe powiadomienie, gdy inna lokalna sesja po raz kolejny stanie się bezczynna) oraz dwie zmiany zachowania uprawnień: tryb Auto odkłada teraz na bok reguły zezwalające Monitor (polecenia Monitor podlegają tej samej ocenie klasyfikatora co Bash), a w sandbox systemu macOS reguły wieloznaczne odmawiające odczytu (**/.env) mają pierwszeństwo wewnątrz dozwolonych obszarów odczytu i nie można ich ominąć przez zmianę nazwy niedozwolonego pliku — klasyfikator trybu Auto korzysta teraz z ustawień domyślnych Claude API również w Bedrock, Vertex AI i Foundry oraz przy wyłączonej telemetrii²²³ (od v2.1.273 te bramy domyślnie korzystają „na razie” z lokalnego klasyfikatora — CLAUDE_CODE_AUTO_MODE_SERVER=1 włącza klasyfikator po stronie serwera platformy²¹⁷). Wersja v2.1.239 (21 sierpnia) dodaje /claude-api upgrade (migruje projekty Python z anthropic 0.x do 1.x), uwzględnia premię 1,1× za wnioskowanie wyłącznie w USA dla przestrzeni roboczych z lokalizacją danych w szacunkach kosztów (/cost, wiersz stanu, --max-budget-usd), wprowadza komunikację między sesjami w systemie Windows, wyświetla plugins zsynchronizowane z claude.ai jako name@synced (można nimi zarządzać przez claude plugin enable/disable; nigdy nie zastępują lokalnej instalacji o tej samej nazwie), uczy ListAgents nazwy własnej sesji i aktywnych teammates, rozszerza "readline" na klawisze słów Bash, zmniejsza częstotliwość kontroli /goal (30 min → 1 godz. → 2 godz.) oraz udostępnia renderer pełnoekranowy w Bedrock/Vertex/Foundry; wersje v2.1.240–241 (22–23 sierpnia) zawierają poprawki błędów. Zestawienie dokumentacji z tego samego tygodnia odnotowuje dwie zmiany statusu: /design — eksperymentalny skill, który publikuje canvas z edytowalnymi obszarami roboczymi UI za pośrednictwem artifacts (Pro/Max/Team/Enterprise, wymaga v2.1.233+) — oraz wyjście Remote Control z fazy eksperymentalnej, przy czym komputery z uruchomionym claude remote-control pojawiają się jako karty urządzeń w aplikacji Claude.²⁰⁵ Od wersji v2.1.174–176 (12 czerwca 2026) allowlist availableModels może ograniczać także 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 go przypiąć ustawieniem language), a wydanie uzupełniają nowe ustawienia footerLinksRegexes i wheelScrollAccelerationEnabled, okno dialogowe przypisywania użycia /usage w VSCode oraz poprawka umożliwiająca warunkom if w hooks dopasowywanie wzorców ścieżek Read/Edit/Write.¹⁷² Od wersji v2.1.173 (11 czerwca 2026) nazwa modelu Fable 5 z sufiksem [1m] jest automatycznie normalizowana przez usunięcie sufiksu — Fable 5 już domyślnie oferuje kontekst 1M, więc sufiks 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 5 poziomów głębokości — ustawienie domyślne obowiązywało do wersji v2.1.216 i zostało wyłączone w wersji 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 — nowy poziom modelu powyżej Opus — można wybrać w Claude Code za pomocą /model fable po wykonaniu claude update (obsługuje pełną skalę effort od low do max, ale nie pozwala wyłączyć thinking); agentowym modelem domyślnym pozostaje Opus 4.8. Od wersji v2.1.169 (8 czerwca 2026) --safe-mode (oraz CLAUDE_CODE_SAFE_MODE) uruchamia na potrzeby rozwiązywania problemów czystą sesję ze wszystkimi dostosowaniami wyłączonymi, /cd przenosi sesję do nowego katalogu roboczego bez naruszania pamięci podręcznej promptu, a disableBundledSkills ukrywa przed modelem wbudowane skills i slash commands. Od wersji v2.1.166 (6 czerwca 2026) ustawienie fallbackModel łączy maksymalnie trzy modele zapasowe 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ą thinking w modelach, w których jest ono domyślnie włączone. Od wersji v2.1.154 (28 maja 2026) Opus 4.8 jest nowym modelem domyślnym, domyślnie z wysokim effort oraz poziomem /effort xhigh, dynamic workflows koordynują w tle od dziesiątek do setek agentów za pomocą /workflows, tryb Fast w Opus 4.8 kosztuje 2× więcej niż stawka standardowa przy szybkości 2,5× większej, odchudzony system prompt 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 (oddzielnie od /code-review --fix), claude agents przyjmuje ! <command> w celu uruchamiania sesji shell w tle, plugins mogą deklarować defaultEnabled: false, strumieniowe wykonywanie narzędzi jest zawsze włączone, a serwery stdio MCP otrzymują w środowisku CLAUDE_CODE_SESSION_ID oraz CLAUDECODE=1. Wersja v2.1.153 dodała skipLfs do marketplaces plugins, sprawiła, że /model zapisuje wybór jako domyślny (należy nacisnąć s, aby zastosować go tylko w sesji), oraz dodała COLUMNS/LINES do środowiska wiersza stanu. Wersja v2.1.152 wprowadziła /code-review --fix (stosuje ustalenia do drzewa roboczego), disallowed-tools we frontmatter skills, /reload-skills, nowe zdarzenie hook MessageDisplay, wyniki reloadSkills/sessionTitle hook SessionStart, zarządzane ustawienie pluginSuggestionMarketplaces, przełączanie --fallback-model w trakcie sesji oraz usunęła konieczność wyrażenia zgody na tryb Auto.^{162 163 164 165 166 167 168 169 170 244 171}

Claude Code działa jako system agentowy, a nie interfejs czatu posiadają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ę za pośrednictwem interfejsu wiersza poleceń, który wpisuje się w rzeczywisty sposób pracy programistów. Według danych z lutego 2026 roku 4% publicznych commitów GitHub (około 135 000 dziennie) jest tworzonych przez Claude Code — oznacza to wzrost 42 896× w ciągu 13 miesięcy od wersji eksperymentalnej — a 90% własnego kodu Anthropic zostało napisane przez AI.¹⁰³

Różnica między sporadycznym 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: kontroluje zachowanie
2. System uprawnień: kontroluje dostęp do operacji
3. System hooks: umożliwia deterministyczną automatyzację
4. Protokół MCP: rozszerza możliwości
5. System subagent: obsługuje złożone, wieloetapowe zadania

Najważniejsze wnioski

• O skuteczności decyduje pięć systemów: hierarchia konfiguracji, uprawnienia, hooks, MCP i subagents kontrolują wszystko — od zachowania po automatyzację.
• Pracę warto przenosić do warstwy delegowania: subagents zapobiegają nadmiernemu rozrastaniu się kontekstu, izolując eksplorację w czystych oknach kontekstowych i zwracając wyłącznie podsumowania.
• Hooks gwarantują wykonanie, a prompty nie: hooks należy używać do lintingu, formatowania i kontroli bezpieczeństwa, które muszą uruchamiać się za każdym razem, niezależnie od zachowania modelu.
• Podział zadań między poziomy modeli obniża koszty bez pogorszenia jakości: eksplorację realizowaną przez subagents warto kierować do tańszych modeli, a Opus rezerwować do rzeczywistych problemów architektonicznych — albo ujednolicić pracę na Opus, jeśli jedynym kryterium jest jakość.
• MCP łączy Claude ze stosem narzędzi: bazy danych, GitHub, Sentry i ponad 3 000 integracji rozszerzają możliwości Claude poza odczytywanie plików i polecenia bash.

Przez wiele miesięcy testowałem granice możliwości Claude Code w produkcyjnych bazach kodu, pipelines CI/CD i wdrożeniach korporacyjnych. Ten przewodnik stanowi esencję zdobytych doświadczeń i kompletny materiał referencyjny, którego brakowało mi na początku. Każdą funkcję opisano z użyciem rzeczywistej składni, praktycznych przykładów konfiguracji i przypadków brzegowych, które sprawiają trudność nawet doświadczonym użytkownikom.

Wybór ścieżki

Jak korzystać z tego przewodnika

To materiał referencyjny liczący ponad 5 000 wierszy — nie trzeba czytać go od deski do deski. Najlepiej zacząć od miejsca odpowiadającego poziomowi doświadczenia:

Aby wyszukać określone flagi, polecenia lub klucze konfiguracji, należy użyć w przeglądarce skrótu Ctrl+F / Cmd+F. Karta podręczna na końcu zawiera przejrzyste podsumowanie wszystkich najważniejszych poleceń.

Powiązane szczegółowe opracowania

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

Szybki start w 60 sekund

Aby po prostu uruchomić Claude Code i zobaczyć wynik, należy wykonać kolejno następujące czynności:

# 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. Dalsza część przewodnika szczegółowo omawia opcje instalacji, konfigurację uprawnień i hooks, podłączanie serwerów MCP oraz wdrożenia korporacyjne — jednak żadna z tych informacji nie jest potrzebna na początek.

Wymagania wstępne: Node 22+ jest wymagany wyłącznie w przypadku starszej metody instalacji przez npm (wymaganie podniesiono z wersji 18 w v2.1.198; aktualna dokumentacja instalacji podaje „Node.js 22 lub nowszy”, zweryfikowano 7 sierpnia 2026); zalecany instalator natywny nie wymaga Node. Obsługiwane są macOS, Linux i Windows 10+. Korzystanie z usługi obejmuje subskrypcja Claude Pro, Max, Team lub Enterprise albo rozliczany za tokeny klucz Anthropic API. Szczegółowe informacje dotyczące poszczególnych platform, rozwiązywania problemów i instalacji za pomocą natywnego pliku binarnego (domyślnej od v2.1.113) zawiera sekcja Jak zainstalować Claude Code?. Informacje o najnowszym wydaniu są aktualizowane w tym przewodniku przy każdej wersji; bieżącą datę weryfikacji można znaleźć w najnowszym wierszu dziennika zmian.²⁴⁴

Jak działa Claude Code: model mentalny

Przed zapoznaniem się z funkcjami warto zrozumieć, jak architektura Claude Code wpływa na wszystkie wykonywane w nim działania. 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 (20 concurrent default)      │    │
│  │   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 konwersacja. Każda wiadomość, odczyt pliku i wynik działania narzędzia zajmują miejsce we współdzielonym oknie kontekstu (standardowo 200 tys. tokenów⁹¹, a w przypadku Opus 4.6 lub modeli z rozszerzonym kontekstem — 1 mln tokenów). Po zapełnieniu kontekstu Claude traci orientację we wcześniejszych decyzjach, a jakość odpowiedzi spada. Koszt tej warstwy jest naliczany za każdy token.

Warstwa delegowania: Subagents są uruchamiane z czystym kontekstem, wykonują konkretne zadania i zwracają podsumowania. Wyniki eksploracji nie rozdymają głównej konwersacji — wracają do niej tylko wnioski. Zadania eksploracyjne można kierować do tańszych klas modeli albo używać wszędzie modelu podstawowego, jeśli jakość jest ważniejsza niż koszt.

Warstwa rozszerzeń: MCP łączy usługi zewnętrzne (bazy danych, GitHub, Sentry). Hooks gwarantują wykonanie poleceń powłoki niezależnie od zachowania modelu. Skills zawierają wiedzę dziedzinową, którą Claude stosuje automatycznie. Plugins łączą wszystkie te elementy w pakiety przeznaczone do dystrybucji.

Najważniejszy wniosek: Większość użytkowników pracuje wyłącznie w warstwie podstawowej, obserwując rozrastanie się kontekstu i wzrost kosztów. Zaawansowani użytkownicy przenoszą eksplorację i specjalistyczne zadania do warstwy delegowania, konfigurują warstwę rozszerzeń pod kątem własnego przepływu pracy, a warstwy podstawowej używają jedynie do koordynacji i podejmowania ostatecznych decyzji.

Spis treści

1. Jak zainstalować Claude Code?
2. Szybki start: pierwsza sesja
3. Podstawowe tryby interakcji
4. Szczegółowe omówienie systemu konfiguracji
5. Który model wybrać?
6. Ile kosztuje Claude Code?
7. Struktury podejmowania decyzji
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 rozumowania?
13. Style odpowiedzi
14. Polecenia ukośnikowe
15. Jak działają skills?
16. System plugins
17. Jak działa pamięć?
18. Obrazy i dane multimodalne
19. Tryb głosowy
20. Jak działa integracja z Git?
21. Jak korzystać z Claude Code w IDE?
22. Zaawansowane wzorce użycia
23. Agenci zdalni i działający w tle [WERSJA BADAWCZA]
24. Claude w Chrome
25. Claude Code w Slack [WERSJA BADAWCZA]
26. Claude Code w przeglądarce [WERSJA BADAWCZA]
27. Claude w Microsoft 365 (maj 2026)
28. Optymalizacja wydajności
29. Jak diagnozować problemy?
30. Wdrożenie korporacyjne
31. Skróty klawiaturowe
32. Najlepsze praktyki
33. Gotowe przepływy pracy
34. Przewodnik po migracji
35. Wskazówki dla poszczególnych grup odbiorców
36. Podręczna karta informacyjna
37. Dziennik zmian
38. Źródła

Jak zainstalować Claude Code?

Wymagania systemowe

Claude Code działa w systemach macOS 13+, Ubuntu 20.04+/Debian 10+ oraz Windows 10+ (natywnie lub przez WSL). System wymaga co najmniej 4 GB pamięci RAM i aktywnego połączenia z internetem.⁹² Najlepszą zgodność z powłoką zapewniają Bash, Zsh i Fish.

W systemie Windows działają zarówno WSL 1, jak i WSL 2. Jeśli preferowana jest natywna obsługa systemu Windows, można również użyć Git Bash. Alpine Linux i inne systemy oparte na musl wymagają dodatkowych pakietów:

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

Macierz obsługiwanych platform

Skrócony przegląd instalowania, aktualizowania i odinstalowywania

Szybka ściągawka — wszystkie metody, wszystkie polecenia i sprawdzanie wersji na jednym ekranie. Poniższe podsekcje omawiają szczegóły poszczególnych metod oraz rozwiązywanie problemów.

Od wersji v2.1.113 standardowy CLI uruchamia natywny plik binarny Claude Code za pośrednictwem opcjonalnej zależności właściwej dla danej platformy, zamiast dołączonego JavaScript — do instalacji w testowanym środowisku dystrybucyjnym należy użyć natywnego instalatora. Metoda npm nadal działa, ale wyświetla ostrzeżenie o wycofaniu, które po raz pierwszy dodano w wersji v2.1.15.

Metody instalacji

Instalacja natywna (zalecana)

Natywny plik binarny zapewnia najprostszą obsługę 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

Aby zainstalować określoną wersję:

# 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 wersji v2.1.15 instalacje npm wyświetlają ostrzeżenie o wycofaniu. Obecnie zalecaną metodą instalacji jest natywny plik binarny. Migrację można przeprowadzić za pomocą claude install.

W starszych środowiskach, w których npm jest nadal potrzebny:

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

Podczas instalacji przez npm nie należy używać sudo. Powoduje to problemy z uprawnieniami, które komplikują wszystkie późniejsze działania.

Migracja z istniejącej instalacji

Jeśli używana jest starsza instalacja oparta na npm, należy przejść na natywny plik binarny:

claude install

Opcje uwierzytelniania

Claude Code obsługuje trzy sposoby uwierzytelniania, z których każdy wiąże się z innymi kompromisami:

Konsola Claude (rozliczenia API)

Z API firmy Anthropic można połączyć się bezpośrednio przez platform.claude.com (wcześniej console.anthropic.com). Należy utworzyć konto, skonfigurować rozliczenia i uwierzytelnić się za pośrednictwem CLI. Konsola oferuje rozliczenia zależne od wykorzystania oraz pełny dostęp do API. Dedykowany obszar roboczy „Claude Code” jest tworzony automatycznie; nie można dla niego tworzyć kluczy API, ale można monitorować wykorzystanie. Od wersji v2.1.243 opcja /login → konsola Anthropic udostępnia również ścieżkę bez klucza „Zaloguj się za pomocą konta Console” (zalecaną), obok możliwości utworzenia klucza API. Dzięki temu organizacje, które nie zezwalają na klucze API, mogą nadal logować się danymi uwierzytelniającymi Console.²²⁷

Subskrypcja Claude Pro lub Max

Należy użyć danych uwierzytelniających konta claude.ai. Jedna miesięczna subskrypcja obejmuje zarówno interfejs internetowy, jak i korzystanie z CLI. Ułatwia to rozliczenia użytkownikom indywidualnym, którym zależy na przewidywalnych kosztach.

Platformy korporacyjne

AWS Bedrock, Google Vertex AI i Microsoft Foundry zapewniają dostęp klasy korporacyjnej w ramach istniejących rozliczeń usług chmurowych. Kreator konfiguracji Bedrock (v2.1.92+): interaktywny kreator na ekranie logowania przeprowadza przez uwierzytelnianie AWS, wybór regionu, weryfikację danych uwierzytelniających i przypięcie modelu.¹³⁷ Kreator konfiguracji Vertex AI (v2.1.98+): analogiczny kreator dla Google Cloud przeprowadza przez uwierzytelnianie GCP, konfigurację projektu i regionu, weryfikację danych uwierzytelniających oraz przypięcie modelu.¹⁴² Vertex AI mTLS Workload Identity Federation (v2.1.121+): Vertex AI obsługuje teraz opartą na certyfikatach X.509 usługę Workload Identity Federation (mTLS Application Default Credentials) — krótkotrwałe tokeny GCP generowane na podstawie certyfikatu klienta, bez konieczności używania JSON konta usługi.¹⁵⁴ Zaufanie do certyfikatów CA systemu operacyjnego (v2.1.101+): korporacyjne serwery proxy TLS działają teraz domyślnie — Claude Code ufa magazynowi certyfikatów systemu operacyjnego. Aby używać wyłącznie dołączonych certyfikatów CA, należy ustawić CLAUDE_CODE_CERT_STORE=bundled.¹⁴³

# 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 działających za serwerami proxy lub korzystających z bram 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

Nagłówki ze wskazówkami dla bramy (v2.1.273, opcjonalne): po ustawieniu CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 Claude Code dodaje pięć nagłówków żądań, na podstawie których brama LLM może kierować i monitorować ruch: x-claude-code-request-class, x-claude-code-agent-type, x-claude-code-prev-tool-durations, x-claude-code-compaction oraz x-claude-code-context-compacted.²¹⁷

Weryfikacja

claude doctor

Polecenie podaje typ instalacji, wersję, konfigurację systemu oraz wszystkie wykryte problemy.

Zarządzanie uwierzytelnianiem (v2.1.41+)

Uwierzytelnianiem można zarządzać bez uruchamiania 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

Od wersji v2.1.268 wynik polecenia claude auth status --json zawiera pole configDirectory — katalog konfiguracji, z którego faktycznie korzysta CLI. Jest to przydatne, gdy przekierowanie przez CLAUDE_CONFIG_DIR powoduje niejednoznaczność.²¹⁶

Od wersji v2.1.273 logowanie za pomocą konta Claude wymaga również udzielenia dostępu do plugins claude.ai.²¹⁷

Typowy sposób przełączania się między kontami lub organizacjami:

claude auth logout && claude auth login

Zob. również: Jak debugować problemy?, aby uzyskać informacje o rozwiązywaniu problemów z uwierzytelnianiem.

Aktualizacje

Claude Code domyślnie aktualizuje się automatycznie, sprawdzając dostępność aktualizacji podczas uruchamiania i okresowo w trakcie sesji. Aktualizacje są pobierane w tle i stosowane przy następnym uruchomieniu.

Aby wyłączyć automatyczne aktualizacje:

export DISABLE_AUTOUPDATER=1

Można też zrobić to w pliku settings.json:

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

Aktualizacja ręczna:

claude update

Odinstalowywanie

Instalacja natywna (macOS/Linux/WSL):

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

Instalacja natywna (Windows PowerShell):

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

Czyszczenie konfiguracji (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

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

cd your-project
claude

REPL zachowuje kontekst rozmowy między kolejnymi turami. Można bezpośrednio wpisywać zapytania, otrzymywać odpowiedzi i kontynuować pracę aż do wyjścia za pomocą /exit lub Ctrl+D.

Aby ukierunkować sesję, rozpocząć od początkowego promptu:

claude "explain the authentication flow in this project"

Wskazówka ekspercka: REPL zachowuje stan podczas operacji kompaktowania. Gdy kontekst staje się zbyt obszerny, Claude automatycznie podsumowuje starszą część rozmowy, zachowując kluczowe decyzje i fragmenty kodu. Można 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 i 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, czego potrzeba 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ą tylko zdarzenia z sesji głównej — praca wykonana wewnątrz subagents jest przedstawiana jako podsumowanie. Flaga --forward-subagent-text (lub CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1) przekazuje do strumienia również tekst oraz tok rozumowania subagents, dzięki czemu narzędzia testowe i potoki rejestrowania mogą obserwować delegowaną pracę w trakcie jej wykonywania, zamiast widzieć wyłącznie raport końcowy.¹⁸⁸

Zagnieżdżone subagents są teraz również przekazywane (v2.1.219). Początkowo widoczne były tylko subagents na głębokości 1. Subagents uruchomione na głębokości 2 i większej również pojawiają się teraz w przekazywanym strumieniu, a każde z nich jest identyfikowane przez tool_use id wywołania Agent, które je uruchomiło — dzięki temu potok może odtworzyć drzewo delegowania zamiast wyświetlać płaską listę tekstu. Jest to bezpośrednio powiązane z przywróceniem w tej samej wersji domyślnego uruchamiania zagnieżdżonych subagents do głębokości 3: bez tej zmiany 2 z 3 poziomów pozostawałyby niewidoczne.¹⁹⁶

Subagents działające w tle nie stają się już niewidoczne (v2.1.273): dane wyjściowe SDK i stream-json przestały pomijać pozostałe wiadomości oraz raport końcowy subagenta po przeniesieniu go do tła w trakcie działania (na przykład przez CLAUDE_AUTO_BACKGROUND_TASKS).²¹⁷

Kody wyjścia:

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-5

# 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

# Restricted mode for eval harnesses and shared machines (v2.1.248+)
claude --restricted -p "query" --tools "Read,Grep,Glob"

# Unattended hosts: deny anything that would prompt (v2.1.259+)
claude -p "run the nightly checks" --permission-prompts none

Tryb ograniczony (v2.1.248+): --restricted (lub CLAUDE_CODE_RESTRICTED=1) przeznaczono dla narzędzi testowych sterujących claude na współdzielonym komputerze. Usuwa on wbudowane narzędzia uruchamiające polecenia lub kod, a także WebFetch, chyba że zostaną one wymienione osobno w --tools — ustawienie wstępne default nie jest uwzględniane — ogranicza wbudowane narzędzia plikowe do katalogów roboczych, wczytuje wyłącznie ustawienia zarządzane i --settings (pliki ustawień użytkownika, projektu i lokalnych są ignorowane), odrzuca bypassPermissions oraz nie zezwala na tworzenie sesji w chmurze.²⁰⁶²⁰⁹

--permission-prompts none (v2.1.259): opcja uzupełniająca dla hostów działających bez nadzoru. Wszystko, co spowodowałoby wyświetlenie monitu o uprawnienia, jest automatycznie odrzucane, natomiast aktywny tryb uprawnień — w tym tryb automatyczny — nadal podejmuje wszystkie decyzje, które może podjąć bez udziału użytkownika. Nie należy mylić tej opcji z --permission-prompt-tool, która przekazuje monity do narzędzia MCP, zamiast je odrzucać. Dokumentacja CLI nie wymienia jeszcze nowej flagi; źródłem informacji jest CHANGELOG.²¹¹

cd zachowuje stan między turami w sesjach nieinteraktywnych (v2.1.265): sesje -p otrzymujące dane wejściowe stream-json, sesje Agent SDK oraz sesje w chmurze nie resetują już katalogu roboczego powłoki po każdej nowej wiadomości użytkownika — użycie cd w jednej turze obowiązuje teraz także w następnej.²¹⁵

--system-prompt-snapshot off (v2.1.267): domyślnie rozmowa przy każdym żądaniu ponownie wykorzystuje zapisany prompt systemowy. Ta flaga powoduje zamiast tego ponowne generowanie promptu systemowego przy każdym żądaniu — to przełącznik przydatny podczas iteracyjnego dopracowywania treści promptu, gdy każde uruchomienie powinno uwzględniać najnowszą zmianę, kosztem stabilności cache promptu, którą ma zapewniać zapisany stan.²¹⁶

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 przechowują historię rozmowy, umożliwiając jej kontynuację. Zachowywanie sesji ma kluczowe znaczenie przy złożonej pracy obejmującej 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"

Przenoszenie aktywnej sesji za pomocą /cd (v2.1.169+; natychmiastowa konfiguracja od v2.1.246): /cd path zmienia katalog roboczy bez naruszania cache promptu. Od wersji v2.1.246 ustawienia projektu, hooks, serwery .mcp.json (po wyświetleniu standardowego monitu o zatwierdzenie), skills i agents z nowego katalogu zaczynają obowiązywać natychmiast po przeniesieniu, zamiast dopiero po użyciu --resume.²³⁹²²⁶

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

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 łączone z PR utworzonymi podczas sesji za pomocą gh pr create. Ułatwia to późniejsze wznowienie pracy nad konkretnym PR. Znacznik PR w stopce może prowadzić do niestandardowego adresu URL narzędzia do przeglądu kodu za pośrednictwem ustawienia prUrlTemplate (v2.1.119+) — jest to przydatne, gdy zespół przechodzi z PR do osobnego narzędzia do przeglądu.¹⁵²

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

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

# 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 UUID (np. 550e8400-e29b-41d4-a716-446655440000). Aby nadawać sesjom nazwy czytelne dla człowieka, należy zamiast tego używać /rename i --resume.

/fork uruchamia sesję w tle, natomiast /subtask tworzy rozwidlenie w bieżącej sesji (v2.1.212). Polecenie /fork kopiuje teraz bieżącą rozmowę do nowej sesji 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 sesję główną. Dotychczasowe zachowanie — tworzenie rozwidlenia w bieżącej sesji — jest dostępne pod nową nazwą /subtask.¹⁸⁹ Od wersji v2.1.214 sesja uruchomiona jako rozwidlenie zgłasza źródło hooka SessionStart jako "fork" (wcześniej "resume"), dzięki czemu hooks dopasowujące źródło mogą rozróż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.¹⁹² Od v2.1.221 rozwidlona sesja tworzy własny worktree, zamiast pracować w checkout pierwotnej sesji — rozwidlenie badające alternatywne rozwiązanie nie może już kolidować z niezacommitowanymi plikami sesji głównej, co wcześniej było istotnym zagrożeniem przy wysyłaniu kopii do eksperymentowania.¹⁹⁹ Wersja v2.1.232 ustawia rozwidlanie jako domyślne również dla subagents: subagent subagent_type: "fork" dziedziczy pełną rozmowę i cache promptu, a uruchomienia agents niebędących członkami zespołu w sesjach interaktywnych działają teraz domyślnie w tle.²³²

Claude Code przechowuje sesje jako transkrypcje JSONL. Podczas wykonywania agents 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 edycji plików, wykonywania poleceń 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 3 opcje: - „Tak, wyczyść kontekst i automatycznie akceptuj zmiany” (Shift+Tab) — rozpoczyna od nowa z pełnym kontekstem przeznaczonym na plan - „Tak, i ręcznie zatwierdzaj zmiany” — zachowuje kontekst, a każda zmiana wymaga zatwierdzenia - „Tak, automatycznie akceptuj zmiany” — zachowuje kontekst, a Claude wykonuje plan bez zatwierdzania każdej zmiany

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

Kiedy używać trybu planowania: - Implementowanie nowych funkcji wymagających decyzji architektonicznych - Refaktoryzacja wielu plików, gdy podejście ma zostać najpierw zweryfikowane - Praca z nieznanymi bazami kodu, w których eksploracja powinna poprzedzać modyfikacje - Każde zadanie, dla którego istnieje wiele prawidłowych podejść i potrzebna jest możliwość wniesienia uwag

Wskazówka ekspercka: Im więcej czasu przeznaczy się na tryb planowania, tym większa szansa, że Claude pomyślnie przeprowadzi implementację. Tryb planowania umożliwia praktycznie bezkosztową eksplorację — bez ryzykownych wywołań narzędzi i zmarnowanych edycji. Warto korzystać z niego często.

Tryb czytnika ekranu (v2.1.208)

Claude Code zawiera dedykowany tryb czytnika ekranu, który dostosowuje interfejs terminala do technologii asystujących. Można go włączyć na jeden z 3 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 z jego wzorcami interakcji — na nowej stronie poświęconej dostępności w oficjalnej dokumentacji.¹⁸⁶

Szczegółowe omówienie 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 ominąć.

Hierarchia konfiguracji

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

Od wersji v2.1.181 polecenie /config key=value umożliwia ustawienie dowolnej opcji bezpośrednio z poziomu monitu — np. /config thinking=false — bez otwierania interaktywnego interfejsu /config. Działa ono w sesjach interaktywnych, -p oraz 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, natomiast Esc zapisuje zmiany i zamyka interfejs (wcześniej wycofywał zmiany).¹⁷⁴

Pełna dokumentacja settings.json

Pełna konfiguracja przedstawiająca wszystkie główne opcje:

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-5",
  "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": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  },
  "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": {
    "label": "Team tips",
    "tips": [
      "Custom tip 1",
      {"id": "tip-2", "text": "Custom tip 2", "cooldownSessions": 5, "priority": 1}
    ],
    "tipsFile": "~/.claude/team-tips.json",
    "excludeDefault": true
  },
  "skillOverrides": {
    "legacy-skill": "off",
    "manual-only-skill": "user-invocable-only",
    "compact-skill": "name-only"
  },
  "includeGitInstructions": false,
  "modelOverrides": {
    "bedrock": "us.anthropic.claude-opus-5",
    "vertex": "claude-opus-5",
    "foundry": "claude-opus-4-8"
  },
  "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 uruchomieniowym. Warto użyć off, aby ukryć skill zarówno przed modelem, jak i w selektorze poleceń ukośnikowych; user-invocable-only, aby nadal można było wywoływać go po nazwie, ale model nie mógł go wybierać; oraz name-only, aby widoczna pozostała wyłącznie nazwa skill bez jego pełnego opisu.¹⁵⁶

Nowsze ustawienia (v2.1.174–176):

• availableModels / enforceAvailableModels (zarządzane, v2.1.175+): lista dozwolonych availableModels ogranicza modele, które można wybrać w sesji. Przy enforceAvailableModels: true lista ta ogranicza także model Default — jeśli model wynikający z ustawienia Default nie jest dozwolony, używany jest pierwszy dozwolony model — a ustawienia użytkownika lub projektu nie mogą już rozszerzać zarządzanej listy availableModels. Powiązana poprawka (v2.1.176) usuwa lukę, przez którą wybór aliasu mógł przekierować do zablokowanego modelu za pośrednictwem ANTHROPIC_DEFAULT_*_MODEL; polecenie /fast odmawia teraz przełączenia na model spoza listy dozwolonych.¹⁷² Od wersji v2.1.187 organizacje mogą egzekwować ograniczenia modeli bezpośrednio w selektorze /model, poprzez --model, /model oraz ANTHROPIC_MODEL — wybranie ograniczonego modelu powoduje wyświetlenie komunikatu „ograniczony przez ustawienia organizacji”.¹⁷⁶
• language (udoskonalenie w v2.1.176): oprócz określania języka odpowiedzi ustawienie to sprawia, że tytuły sesji są domyślnie generowane w języku rozmowy; ustawienie language pozwala na stałe wskazać konkretny język tytułów.¹⁷²
• footerLinksRegexes (v2.1.176): odznaki linków dopasowanych za pomocą wyrażeń regularnych w wierszu stopki, konfigurowalne w ustawieniach użytkownika lub zarządzanych.¹⁷²
• wheelScrollAccelerationEnabled (v2.1.174): ustawienie false wyłącza przyspieszanie przewijania kółkiem myszy w trybie pełnoekranowym.¹⁷²

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

• vimInsertModeRemaps (v2.1.208): niestandardowe mapowanie klawiszy w trybie wstawiania vim — klasycznym przykładem jest przypisanie sekwencji 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 do 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 monitu — wpisanie :heart: wstawia ❤️, a częściowy skrót, taki 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): blokowanie niedozwolonych hostów dla poleceń uruchamianych w sandboxie bez wyświetlania monitu, zamiast otwierania okna dialogowego z prośbą o uprawnienia. Zob. Tryb sandbox.¹⁹⁶
• workflowSizeGuideline (v2.1.219): ustawienie zalecanej wielkości Dynamic workflow w dowolnym pliku ustawień — użytkownika, projektu lub zarządzanym — zamiast wyłącznie za pomocą /config. Dla Dynamic workflows domyślnie obowiązuje wytyczna medium („należy dążyć do używania mniej niż 15 agentów”); gdy wartość pochodzi z pliku ustawień, odpowiedni wiersz /config jest ukrywany. Jest to zalecenie, a nie egzekwowany limit. Zob. Subagents.¹⁹⁶

Nowsze ustawienia (v2.1.242–243):

• modelPicker (użytkownika lub zarządzane, v2.1.242+): umożliwia dostosowanie selektora /model za pomocą uporządkowanej listy modeli z etykietami. Jest to obiekt zawierający tablicę options (każdy wiersz wymaga pola model oraz może opcjonalnie zawierać label i description; wartość model jest używana bez zmian, dlatego działają aliasy, identyfikatory Anthropic oraz identyfikatory Bedrock/Vertex/Foundry/bramy) i opcjonalną wartość logiczną replaceBuiltInOptions (false, czyli wartość domyślna, dodaje wiersze za wbudowaną listą; true wyświetla tylko własne wiersze, Default oraz model aktualnie używany w sesji). Claude Code odczytuje ten klucz z ustawień zarządzanych, --settings i ustawień użytkownika, a ignoruje go w ustawieniach projektu oraz lokalnych, dzięki czemu sklonowane repozytorium nie może zmienić etykiet w selektorze; najwyższe źródło, w którym ustawiono ten klucz, dostarcza całą listę. Lista dozwolonych availableModels nadal ma zastosowanie do każdego wiersza, a etykieta zmienia jedynie nazwę wyświetlaną w selektorze, nie zaś uruchamiany model.²²⁷²²⁵
• promptCacheTtl / subagentPromptCacheTtl (dowolny plik, v2.1.242+): "5m" lub "1h" dla każdego przedziału żądań, dzięki czemu użytkownicy kluczy API i dostawców chmurowych mogą zachować godzinną pamięć podręczną głównej rozmowy, podczas gdy dla subagents nadal obowiązuje pięć minut. Zob. Strategie buforowania.²²⁷²²⁵
• modelPricing (zarządzane, v2.1.243+): uzgodnione przez organizację stawki dla poszczególnych modeli oraz mnożnik rabatu, używane przez /cost, wiersz stanu i dane kosztowe telemetrii zamiast cen katalogowych. Zob. Wyświetlanie kosztów.²²⁷

Nowsze ustawienia (v2.1.247): - feedbackDrafts (v2.1.247): steruje nowym narzędziem SendFeedback — gdy podczas sesji coś pójdzie nie tak, Claude może przygotować wersję roboczą zgłoszenia, którą można sprawdzić i wysłać za pomocą /feedback; to ustawienie pozwala wyłączyć tworzenie wersji roboczych. Zobacz wiersz /feedback w sekcji Polecenia ukośnikowe.²²² - Rozszerzenie struktury spinnerTipsOverride (v2.1.247): wpisy ze wskazówkami mogą teraz być obiektami {id, text, cooldownSessions, priority} obok zwykłych ciągów tekstowych, a obiekt zyskuje klucze tipsFile i label, dzięki czemu organizacje mogą wyświetlać rotacyjnie własne wskazówki obok tych wbudowanych (powyższy przykład przedstawia rozszerzoną strukturę). Dokumentacja ustawień nie opisuje jeszcze nowych kluczy — jedynym ich źródłem jest CHANGELOG.²²²

Nowsze ustawienia (v2.1.248–251):

• desktopSessionCleanupPeriodDays (v2.1.248): ogranicza czas, przez jaki sesje zapisane przez aplikację komputerową pozostają wyłączone z czyszczenia transkrypcji. Ważniejsza od samego ustawienia jest towarzysząca mu poprawka: sesje Claude Desktop i Cowork znikały wcześniej po upływie cleanupPeriodDays (domyślnie 30 dni); mechanizm czyszczenia zachowuje je teraz, dopóki znajdują się w aplikacji, chyba że zasady organizacji zarządzają okresem przechowywania.²⁰⁶
• Ograniczenia projektowego env (v2.1.251): blok env w pliku .claude/settings.json na poziomie projektu nie może już ustawiać CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR ani TMPDIR/TMP/TEMP — należy ustawić je w powłoce albo w ustawieniach użytkownika lub zarządzanych, aby sklonowane repozytorium nie mogło przekierować miejsc, w których Claude Code zapisuje pliki konfiguracyjne i tymczasowe.²⁰⁶

Nowsze ustawienia (v2.1.257-259):

• timeFormat / timeZone (v2.1.257): określają sposób wyświetlania czasu przez Claude Code — zarówno zegara ukończenia na końcu tury, jak i znaczników czasu transkrypcji. timeFormat przyjmuje format 12-godzinny, 24-godzinny, 24-godzinny UTC albo jawny wzorzec strftime; timeZone określa strefę czasową. Dokumentacja ustawień jeszcze ich nie opisuje — źródłem jest CHANGELOG.²¹¹
• permissions.blockReadsOutsideWorkingDirectories (v2.1.257): bezwarunkowo odrzuca odczyt plików spoza katalogów roboczych sesji. Bez tego ustawienia tryb automatyczny pyta teraz jednokrotnie o zgodę przed pierwszym takim odczytem w sesji (zobacz Tryb automatyczny).²¹¹ Wersja v2.1.273 usuwa dwie luki: polecenie Bash, którego mechanizm sprawdzający nie może w pełni przeanalizować, powoduje wyświetlenie monitu zamiast pominięcia kontroli, a katalog pamięci wybrany w ustawieniach repozytorium nie jest przy tym ustawieniu wczytywany, przywoływany ani indeksowany.²¹⁷
• managedMcpServers / managedSourcesBehavior: klucze zakresu zarządzanego opisane w sekcji Wdrożenie w przedsiębiorstwie — dotyczą organizacji udostępniających serwery MCP każdemu użytkownikowi (v2.1.259) oraz opcjonalnego scalania źródeł zarządzanych (dopracowanego w v2.1.257).²¹¹²²¹

Nowsze ustawienia (v2.1.261):

• bashOutputMaxChars / taskOutputMaxChars (v2.1.261): zwiększają ilość danych wyjściowych polecenia (oraz odpowiednio zadania w tle), które Claude otrzymuje bezpośrednio, zanim pozostała część zostanie zapisana w pliku — maksymalnie do 128K znaków. Jest to mechanizm inny niż zmienna środowiskowa BASH_MAX_OUTPUT_LENGTH, która określa okno odczytu zwrotnego z roboczego pliku wyjściowego polecenia (domyślnie 30 000 znaków, maksymalnie 150 000): te klucze wyznaczają próg między wynikiem osadzonym bezpośrednio a zapisanym w trwałym pliku — po jego przekroczeniu dane trafiają do pliku, który Claude może odczytać na żądanie, zamiast zostać obcięte.²¹⁴ Od wersji v2.1.265 ograniczenie obowiązuje również po stronie zapisu: wyniki narzędzi zapisywane na dysku są ograniczone do 1 GB, a podgląd w rozmowie informuje o obcięciu zapisanego pliku.²¹⁵

Nowsze ustawienia (v2.1.267-269):

• maxEffortLevel (v2.1.267): ogranicza poziom wysiłku, który mogą wybrać użytkownicy — globalnie lub dla poszczególnych modeli w modelSettings — i obowiązuje u każdego dostawcy, w tym Bedrock, Vertex i Foundry. Użytkownicy nadal mogą wybrać poziom niższy od limitu; jest to administracyjne uzupełnienie /effort.²¹⁶
• bashEditDiffEnabled (v2.1.269): gdy narzędzie Bash edytuje plik, wynik działania narzędzia zawiera diff plików zmienionych przez polecenie, dzięki czemu w rozmowie widać, co faktycznie zrobiła edycja w stylu sed.²¹⁶

Wyszukiwanie ustawień: najczęściej wyszukiwane flagi

Jeśli szukają Państwo konkretnego ustawienia według nazwy, poniżej znajduje się krótki indeks. Każdy wpis wskazuje wersję, w której ustawienie zostało wprowadzone, oraz — jeśli należy ono do określonego zakresu — ten zakres:

ANTHROPIC_API_KEY=sk-ant-...                    # Direct API authentication
ANTHROPIC_AUTH_TOKEN=token                      # Custom authorization header
ANTHROPIC_CUSTOM_HEADERS="X-Key: val"           # Additional request headers; credential/org/routing/API-behavior headers set from managed or project settings require approval (v2.1.251)[^238]

Konfiguracja modelu:

ANTHROPIC_MODEL=claude-opus-4-7                 # Override default model (Apr 16, 2026)
ANTHROPIC_DEFAULT_MODEL=claude-opus-5           # Model new sessions START on; a /model pick overrides + persists (v2.1.236)
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5      # What the `opus` alias resolves to (Opus 5 since v2.1.219)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001
CLAUDE_CODE_SUBAGENT_MODEL=sonnet               # Default model for subagents; an agent's model: field and per-spawn picks win (v2.1.251 demoted it from override to default)[^238]
CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1              # Force every subagent onto CLAUDE_CODE_SUBAGENT_MODEL (or the main model), ignoring agent-definition and per-spawn overrides -- the pre-v2.1.251 behavior, opt-in (v2.1.257)[^243]
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 chmury:

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]
CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS=3000  # Extend the LLM gateway /v1/models discovery timeout (default 3s; v2.1.269+)[^252]
CLAUDE_CODE_GATEWAY_HINT_HEADERS=1              # Send five x-claude-code-* hint headers (request-class, agent-type, prev-tool-durations, compaction, context-compacted) for LLM gateways (opt-in; v2.1.273+)[^253]
CLAUDE_CODE_AUTO_MODE_SERVER=1                  # Use the platform's server-side auto-mode classifier on Bedrock/Vertex/Foundry; since v2.1.273 the local classifier is the default there "for now"[^253]

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
CLAUDE_CODE_RESTRICTED=1                        # Restricted mode: no command/code tools or WebFetch unless named in --tools; only managed settings load (v2.1.248+)[^238]
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+)
CLAUDE_CODE_PROMPT_CACHE_TTL=1h                 # Main-conversation cache TTL, 5m or 1h; beats the promptCacheTtl setting (v2.1.242+)[^234]
CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL=5m        # TTL for subagents, workflows, forks, compaction, titles; beats subagentPromptCacheTtl (v2.1.242+)[^234]
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_WEBFETCH_CACHE_TTL_MS=900000        # WebFetch per-URL session cache TTL (default 15 min; v2.1.233+)[^226]
CLAUDE_CODE_WEBFETCH_DEADLINE_MS=300000         # WebFetch hard deadline: a server that never finishes its response fails the fetch after 300s by default; 0 disables (v2.1.268+)[^252]
CLAUDE_CODE_PROJECT_DIR_NAME=myproj             # Short name for the per-project transcript directory, for hosts that give each session its own config dir (v2.1.234+)[^227]
CLAUDE_CODE_GOAL_CHECKIN_MINUTES=30             # How long background tasks may keep a /goal waiting before Claude checks in on them; 0 disables (v2.1.234+)[^227]
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION=200       # Per-session subagent-spawn cap (default 200 in v2.1.212–223; the default cap was REMOVED in v2.1.224 — set this to reimpose one)[^206][^218]
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_WORKFLOW_PREFIX_STAGGER_MS=0        # Disable the v2.1.229 workflow fan-out stagger (same-prefix sibling agents launch staggered so they read the cached prompt prefix instead of re-paying it)[^224]
CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS=64   # Raise the Workflow tool's per-run concurrent agent limit, 1-256, for inference-bound fan-outs (v2.1.269+)[^252]
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                    # Read-back window from the Bash working output file (default 30,000 chars, hard ceiling 150,000)
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]
CLAUDE_CODE_TOOL_MEMORY_LIMIT=4096              # Opt-in Linux memory cgroup (MB) for Bash tool commands — a runaway build can't stall the session (v2.1.233+)[^226]
CLAUDE_CODE_ENABLE_TODO_TOOLS=1                 # Offer the TodoWrite/TaskCreate-family tools on models outside v2.1.268's allowlist (Claude 3.x, Opus 4.0-4.7, Sonnet 4.0-4.6, Haiku 4.5); elsewhere they are off unless set (first turned off on newer models in v2.1.233)[^226][^252]
SLASH_COMMAND_TOOL_CHAR_BUDGET=15000            # Slash command context limit

Sieć i serwer 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; not settable from project-settings env (v2.1.251)[^238]
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; not settable from project-settings env, nor are TMPDIR/TMP/TEMP (v2.1.251)[^50][^238]
CLAUDE_CODE_DISABLE_1M_CONTEXT=1               # Hold ALL native-1M models to 200K via auto-compaction (v2.1.223 widened scope)[^103][^217]
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1  # Let unrecognized model IDs exceed the assumed context window (v2.1.223)[^217]
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_CODE_BG_TASKS_REPORT_RUNNING=0         # Restore pre-v2.1.269 behavior: remote/headless sessions may report "waiting for your input" while background agents still run[^252]
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 wrażliwych:²⁴⁵

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+); as of v2.1.273 also puts real agent, skill, plugin, and MCP server names on cost and token metrics[^253]
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+)
OTEL_METRICS_INCLUDE_REPOSITORY=1             # Tag OTel metrics and events with vcs.* repository attributes; with OTEL_LOG_TOOL_DETAILS, commit events carry vcs.ref.head.* (v2.1.269+)[^252]
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 od wersji v2.1.121: stop_reason, gen_ai.response.finish_reasons oraz user_system_prompt są teraz emitowane w spanach żądań LLM. Atrybut user_system_prompt jest dostępny wyłącznie po ustawieniu OTEL_LOG_USER_PROMPTS=1, ponieważ może zawierać dane osobowe (PII).¹⁵⁴

Zmiany na poziomie zdarzeń od 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łej zgodności typów ze schematem. Nowe zdarzenie dziennika claude_code.at_mention jest wyzwalane, gdy Claude Code rozpozna wzmiankę z symbolem @.¹⁵⁴

Zdarzenie dziennika claude_code.assistant_response od wersji v2.1.193: Claude Code może emitować pełną treść odpowiedzi modelu jako zdarzenie dziennika OTel, sterowane za pomocą OTEL_LOG_ASSISTANT_RESPONSES. Z tym mechanizmem wiąże się istotna pułapka podczas aktualizacji: jeśli zmienna OTEL_LOG_ASSISTANT_RESPONSES nie jest ustawiona, przyjmuje ustawienie OTEL_LOG_USER_PROMPTS, dlatego po aktualizacji każde wdrożenie, które już rejestruje treść promptów, zacznie również otrzymywać treść odpowiedzi asystenta. Aby telemetria nadal obejmowała wyłącznie prompty, należy ustawić OTEL_LOG_ASSISTANT_RESPONSES=0.¹⁷⁹

Rozszerzenia telemetrii 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 identyfikację pochodzenia narzędzia; ładunek subagentStatusLine zawiera poziom intensywności rozumowania subagenta, dzięki czemu niestandardowe wiersze statusu mogą wyświetlać jednocześnie model i ten poziom; nowa zmienna środowiskowa CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH pozwala natomiast skonfigurować limit obcinania atrybutów treści OTel, wynoszący domyślnie 60 KB.¹⁹⁰

Telemetria bramy w wersji v2.1.265: Sesje bramy aplikacji Claude eksportują teraz dane OpenTelemetry bezpośrednio do kolektora, jeśli w zarządzanych ustawieniach bramy wskazano go za pomocą OTEL_EXPORTER_OTLP_ENDPOINT, zamiast przekazywać je przez przekaźnik bramy; sesje bez wskazanego kolektora nadal korzystają z przekaźnika. Ta sama wersja dodaje user.email i user.groups do telemetrii wysyłanej przez Claude Desktop i Cowork za pośrednictwem bramy aplikacji Claude, zapewniając zgodność z sesjami terminalowymi.²¹⁵

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+)

Powłoka / 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 korporacyjne / 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 znacząco wpływa zarówno na koszt, jak i jakość. Claude Code umożliwia elastyczne przełączanie modeli na wielu poziomach.

Dostępne modele

Dwie zmiany niezgodne wstecznie podczas przenoszenia środowiska 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 korzysta z rozumowania adaptacyjnego. max_tokens pozostaje bezwzględnym limitem całych danych wyjściowych — rozumowania wraz z tekstem 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ć poprzednie zachowanie, należy przekazać thinking: {type: "disabled"}, z zastrzeżeniem opisanym w kolejnym punkcie.
2. Przy wyłączonym rozumowaniu maksymalnym poziomem wysiłku jest high. Połączenie thinking: {type: "disabled"} z poziomem wysiłku xhigh lub max zwraca błąd 400. Kontrola odbywa się osobno dla każdego żądania — zwiększenie 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 wartość domyślna effort w Opus 5 to high (tak samo jak w Claude API), a dostępna jest pełna skala — low, medium, high, xhigh, max. Wskazówki migracyjne firmy Anthropic zalecają przetestowanie poziomu wysiłku max tam, gdzie możliwości mają większe znaczenie niż zużycie tokenów. Tryb szybki obejmuje Opus 5 w cenie $10/$50 za MTok (zob. Tryb szybki).¹⁹⁷¹⁹⁸

Claude Fable 5.1 (1 września 2026): Nowy najwyższy model klasy Fable, a od v2.1.257 model, na który wskazuje alias fable (chyba że ANTHROPIC_DEFAULT_FABLE_MODEL przypina inny); best oznacza teraz „najnowszy model Fable, jeśli jest dostępny”. Minimalna wymagana wersja wymaga wyjaśnienia: dokumentacja konfiguracji modeli podaje, że alias zmieniono w wersji v2.1.255, a strona modelu informuje, że Fable 5.1 „wymaga Claude Code w wersji v2.1.255 lub nowszej”, jednak wersje 2.1.253–256 nigdy nie zostały opublikowane w npm – v2.1.257 (1 września) to pierwsze możliwe do zainstalowania wydanie, które zawiera ten model. Identyfikator modelu: claude-fable-5-1 (Bedrock: anthropic.claude-fable-5-1). Ta sama klasa i cena za token co w Fable 5 – $10/MTok za dane wejściowe, $50/MTok za dane wyjściowe, kontekst 1M, maksymalnie 128K tokenów wyjściowych, stale włączone rozumowanie adaptacyjne i domyślna wartość effort ustawiona na high – z jedną zmianą cenową istotną dla długich sesji agentowych: odczyty z pamięci podręcznej kosztują $0.25/MTok, czyli 0.025x ceny danych wejściowych (2,5%), zamiast standardowych 10%; stawka ta dotyczy wyłącznie modeli Fable 5.1 i Mythos 5.1, natomiast koszt zapisów w pamięci podręcznej pozostaje standardowy ($12.50 za 5 minut, $20 za 1 godzinę). Wiarygodna granica wiedzy: czerwiec 2026 (dane treningowe również do czerwca 2026) – najnowsza spośród wszystkich obecnych modeli Claude. Wycofanie nastąpi nie wcześniej niż 1 września 2027. Trzy zmiany niezgodne wstecznie względem Fable 5: wymuszone użycie narzędzia zwraca błąd, wcześniejsze modele nie mogą odczytywać jego bloków rozumowania, a edycja wcześniejszych tur unieważnia bloki rozumowania. Pięć zmian rozszerzających funkcjonalność: poziom wysiłku określany dla poszczególnych wiadomości (beta), komunikaty systemowe ograniczone do danej tury (beta), aktualizacje postępu między wywołaniami narzędzi (display: "updates", beta), tańsze odczyty z pamięci podręcznej oraz pochodzenie treści. Claude Mythos 5.1 to ten sam model o tych samych parametrach, dostępny wyłącznie na zaproszenie w ramach Project Glasswing. Wraz z premierą Fable 5 trafia w dokumentacji do tabeli starszych modeli obok Opus 4.8/4.7/4.6/4.5 oraz Sonnet 4.6/4.5. Informacje o wydaniu wskazują na jedno zastrzeżenie dotyczące bramy: w sesjach bramy aplikacji Claude aliasy fable i best nadal wskazują obecnie Fable 5 – brama, która nie została jeszcze skonfigurowana pod kątem wersji 5.1, odrzuca ten model – dlatego należy tam wybrać Fable 5.1 bezpośrednio w /model; warto zauważyć, że przed wersją v2.1.260 selektor /model nie wyświetlał Fable 5.1, więc bezpośredni wybór wymagał wpisania pełnego polecenia /model claude-fable-5-1 (zob. poniższe poprawki związane z premierą). Domyślne modele planów pozostają bez zmian: Opus 5 w planach premium, Sonnet 5 w planach Pro i Team Standard.^211218219

Poprawki związane z premierą Fable 5.1 (v2.1.260, 3 września): Pierwsze wydanie po premierze usuwa cztery niedociągnięcia. Selektor /model wyświetla teraz Fable 5.1 organizacjom, które mogą z niego korzystać – przed tą poprawką model był akceptowany tylko po wpisaniu pełnego polecenia /model claude-fable-5-1. Buforowanie promptów w Fable 5.1 obejmuje teraz kontekst dołączany po wynikach narzędzi, który wcześniej był ponownie wysyłany jako niebuforowane dane wejściowe w każdej turze wywołania narzędzia – po cichu niwecząc korzyści ekonomiczne wynikające ze stawki 0.025x za odczyt z pamięci podręcznej właśnie w długich sesjach agentowych, z myślą o których ją wprowadzono. Zmiana /effort w trakcie sesji nie unieważnia już pamięci podręcznej promptu. Ponadto agenci z ustawieniem model: fable respektują teraz znacznik [1m] w przypiętej wartości ANTHROPIC_DEFAULT_FABLE_MODEL, zamiast bez ostrzeżenia działać z oknem kontekstu 200K.²¹²

Claude Fable 5 (9 czerwca 2026; model starszej generacji od 1 września 2026): Nowa klasa modelu powyżej Opus — najpotężniejszy i najinteligentniejszy model firmy Anthropic, reprezentujący najnowocześniejszy poziom w niemal każdym teście porównawczym, któremu go poddano, i zaprojektowany z myślą o zachowaniu spójności w kontekście obejmującym miliony tokenów. Fable 5 to przeznaczony do powszechnego użytku model graniczny klasy „Mythos”, wyposażony w klasyfikatory bezpieczeństwa, które przełączają model na Opus 4.8 w przypadku zapytań dotyczących cyberbezpieczeństwa, biochemii i destylacji modeli (Claude Mythos 5 jest tym samym modelem, lecz bez tych zabezpieczeń, przeznaczonym dla upoważnionych badaczy). Możliwość wyboru tego modelu pojawiła się w Claude Code w wersji v2.1.170 (9 czerwca 2026) — należy uruchomić claude update, a następnie /model fable (krótki alias, który od wersji v2.1.257 wskazuje Fable 5.1 – obecnie Fable 5 należy wybrać za pomocą /model claude-fable-5) — po czym model był stopniowo udostępniany w planach subskrypcyjnych do 22 czerwca 2026 (proces zakończono). Identyfikator modelu: claude-fable-5. Fable 5 domyślnie oferuje okno kontekstu 1M, dlatego sufiks [1m] jest zbędny — a od wersji v2.1.173 (11 czerwca 2026) nazwa modelu claude-fable-5[1m] jest automatycznie normalizowana przez usunięcie sufiksu do postaci claude-fable-5 (sufiks miał znaczenie wyłącznie w przypadku Opus/Sonnet, gdzie dostęp do kontekstu 1M wymaga [1m]); maksymalnie 128K tokenów wyjściowych. Cena wynosi $10/MTok za dane wejściowe i $50/MTok za dane wyjściowe — około 2× więcej niż Opus 4.8 — dlatego warto zarezerwować go do naprawdę trudnych zadań wymagających rozumowania, a nie rutynowych edycji. Udostępnia ten sam interfejs żądań co Opus 4.8 (wyłącznie rozumowanie adaptacyjne; usunięto temperature/top_p/top_k oraz budget_tokens), z jedną nowością: jawne ustawienie thinking: {type: "disabled"} zwraca błąd 400, dlatego aby działać bez rozumowania, należy całkowicie pominąć parametr thinking.²³⁸ Konkretnie w Claude Code: Fable 5 obsługuje pełną skalę poziomów wysiłku (low/medium/high/xhigh/max, domyślnie high), podobnie jak Opus 5. W Fable 5 nie można wyłączyć myślenia — przełącznik myślenia sesji, ustawienie alwaysThinkingEnabled ani MAX_THINKING_TOKENS=0 nie mają żadnego wpływu; model zawsze rozumuje adaptacyjnie. Pełny zestaw opcji konfiguracyjnych rodziny fable odpowiada ustawieniom Opus: ANTHROPIC_DEFAULT_FABLE_MODEL przypisuje model, na który wskazuje alias fable (przydatne w Bedrock/Vertex/Foundry), DISABLE_PROMPT_CACHING_FABLE wyłącza buforowanie promptów dla Fable, a w bramach korporacyjnych obowiązuje automatyczne przełączanie awaryjne zależne od treści. /model opus wybiera teraz Opus 5 (domyślnie wysoki poziom wysiłku, /effort xhigh do najtrudniejszych zadań), a ustawienie domyślne zależy od planu — Opus 5 w planach premium, Sonnet 5 w Pro/Team Standard; aby uzyskać absolutnie najwyższe możliwości, należy świadomie wybrać poziom Fable za pomocą /model fable — od wersji v2.1.257 oznacza to Fable 5.1.^238197207219

Opus 4.7 (16 kwietnia 2026): Flagowy model poprzedniej generacji, nadal w pełni dostępny. Okno kontekstu o pojemności 1 mln tokenów w standardowej cenie — bez dopłaty za długi kontekst. Maksymalnie 128 tys. tokenów wyjściowych, wyłącznie myślenie adaptacyjne (usunięto extended thinking) oraz nowy poziom wysiłku xhigh, zalecany jako punkt wyjścia do programowania i obciążeń agentowych.¹⁴⁵ Wiarygodna granica aktualności wiedzy: styczeń 2026. Granica danych treningowych: styczeń 2026. Identyfikator modelu: claude-opus-4-7. Ceny są takie same jak w przypadku Opus 4.6: 5/25 USD za MTok, zapis w pamięci podręcznej na 5 minut kosztuje 6,25 USD, zapis na 1 godzinę — 10 USD, a odczyt z pamięci podręcznej — 0,50 USD 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 podnosi skuteczność o 13% w wewnętrznym benchmarku programistycznym Anthropic, obejmującym 93 zadania.¹⁴⁴ Korzysta z nowego tokenizera — dla tego samego tekstu należy oczekiwać liczby tokenów większej około 1–1,35 raza; warto zwiększyć zapas max_tokens oraz progi uruchamiania kompakcji.¹⁴⁵ Obsługa obrazu obejmuje grafiki o wymiarach do 2 576 px / 3,75 MP ze współrzędnymi pikseli w skali 1:1.¹⁴⁵

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

Model domyślny według planu (Claude Code):²⁰⁷

Zmiany powodujące niezgodność w Messages API w Opus 4.7 (widoczne dla kodu wywołującego):¹⁴⁵

• Parametr budget_tokens funkcji extended thinking został usunięty. Zamiast niego należy użyć thinking: {type: "adaptive"}. Myślenie adaptacyjne 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. Parametry te należy pominąć, a zachowaniem modelu sterować za pomocą promptów.
• Treść procesu myślenia jest domyślnie pomijana w odpowiedziach. Aby przywrócić widoczne rozumowanie, należy ustawić thinking.display: "summarized" (jest to wymagane, jeśli produkt przesyła użytkownikom strumieniowo 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 i maksymalnie 128 tys. tokenów wyjściowych. W celu uzyskania lepszych możliwości agentowego programowania warto przejść na Opus 4.7. Opus 4.6 został pierwotnie wydany 5 lutego 2026.⁷⁹¹⁴⁴ Od wersji v2.1.117 (22 kwietnia 2026) dla subskrybentów Pro i Max domyślnym poziomem wysiłku w Opus 4.6 i Sonnet 4.6 jest high (wcześniej medium); w Opus 4.7 pozostaje xhigh. Zmiana ta przywróciła poziom inteligencji po obniżeniu wysiłku obowiązującym od 4 marca do 7 kwietnia, opisanym w analizie przyczyn opublikowanej 23 kwietnia.¹⁵²¹⁵³

Sonnet 5 (30 czerwca 2026): Obecny model poziomu Sonnet, przedstawiany jako „najlepsze połączenie szybkości i inteligencji”. Według Anthropic jego wydajność jest zbliżona do Opus 4.8, ale przy niższych cenach. Stanowi znaczące ulepszenie względem Sonnet 4.6 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 zdolności w dziedzinie cyberbezpieczeństwa niż modele Opus (kompromis w zakresie bezpieczeństwa, który umożliwił jego wydanie bez ograniczeń eksportowych). Identyfikator modelu: claude-sonnet-5 (przypięta migawka bez daty). Okno kontekstu o pojemności 1 mln tokenów, maksymalnie 128 tys. tokenów wyjściowych (do 300 tys. w Batches API z nagłówkiem beta output-300k-2026-03-24), wyłącznie myślenie adaptacyjne. Wiarygodna granica aktualności wiedzy: styczeń 2026. Cena: 2/10 USD za MTok danych wejściowych/wyjściowych, obecnie jako standardowa cena katalogowa. Podczas premiery Anthropic ogłosiło stawkę 2/10 USD jako cenę wprowadzającą obowiązującą do 31 sierpnia 2026, a następnie ją utrzymało: na stronie z cennikiem podano, że zaplanowana na 1 września podwyżka do 3/15 USD „nie nastąpi”, a w wersji v2.1.243 zaktualizowano selektor /model i dołączoną skill claude-api, aby przedstawiały 2/10 USD jako cenę katalogową, a nie ograniczoną czasowo promocję.²²⁸ To o 60% mniej niż 5/25 USD w przypadku Opus 5. W Claude Code parametr effort ma dla Sonnet 5 domyślną wartość high (aby ją zmienić, należy podać ją jawnie). Model można wybrać za pomocą /model sonnet (lub /model claude-sonnet-5).¹⁸⁰ Wersja v2.1.197 (30 czerwca 2026) ustawiła Sonnet 5 jako model domyślny w Claude Code dla nowych sesji w tamtym czasie; obecnie pozostaje on modelem domyślnym na poziomie standardowym (Pro, Team Standard), natomiast w planach premium oraz Anthropic API domyślnie używany jest Opus 5 — patrz tabela planów powyżej.¹⁸¹²⁰⁷

Sonnet 4.6 (17 lutego 2026, obecnie zastąpiony przez Sonnet 5): Zrównoważony model, który zastąpił Sonnet 4.5 jako model domyślny w claude.ai i Claude Cowork.⁹³ Cena taka sama jak w przypadku Sonnet 4.5 (3/15 USD za MTok). Lepsza skuteczność wyszukiwania agentowego przy mniejszym zużyciu tokenów. Obsługuje extended thinking, myślenie adaptacyjne oraz okno kontekstu o pojemności 1 mln tokenów (beta). Maksymalnie 64 tys. tokenów wyjściowych (górny limit 128 tys. w wersji v2.1.77).¹¹⁹ Granica aktualności wiedzy: sierpień 2025 (wiarygodna), styczeń 2026 (dane treningowe). Identyfikator modelu: claude-sonnet-4-6.

Claude Mythos Preview (7 kwietnia 2026): Udostępniony w ramach Project Glasswing czołowy model w wersji badawczej, przeznaczony do defensywnych zastosowań w cyberbezpieczeństwie.¹³⁹ Dostępny wyłącznie na zaproszenie; nie jest oferowany powszechnie. Anthropic przedstawia Opus 4.7 jako celowo mniej sprawny niż Mythos w obszarach cyberbezpieczeństwa — jest to kompromis w zakresie bezpieczeństwa — oraz uruchomiło Cyber Verification Program pod adresem https://claude.com/form/cyber-use-case dla uprawnionych badaczy bezpieczeństwa, którzy potrzebują 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ę. W przypadku Opus ta sama sesja 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 w przypadku subagents wykonujących eksplorację, proste wyszukiwanie plików i odpowiadających na szybkie pytania. Jest około 5 razy tańszy od Opus i odpowiada szybciej. Doskonale nadaje się do zadań w tle, które nie wymagają głębokiego rozumowania. Sonnet: model roboczy do codziennego programowania, gdy liczy się koszt — oraz model domyślny w planie standardowym, Pro i Team Standard (natywny kontekst 1M, standardowa cena katalogowa 2/10 USD za MTok; planowaną podwyżkę na 1 września anulowano).^181228207 Radzi sobie z większością zadań programistycznych: implementowaniem funkcji, naprawianiem błędów, pisaniem testów i przeglądem kodu. Historycznie: wersję v2.1.197 (30 czerwca 2026) długo opisywano — również tutaj — jako ustanawiającą Sonnet 5 modelem domyślnym wszędzie, lecz zgodnie z dokumentacją konfiguracji modeli, która rozróżnia plany, wartość domyślna dla planu premium/API wskazywała Opus 4.8 od wersji v2.1.154, a Opus 5 od wersji v2.1.219, więc „wszędzie” oznaczało w rzeczywistości plan standardowy. Sonnet 4.6 pełnił rolę modelu Sonnet do czerwca 2026.^93147207 Warto korzystać z Sonnet, gdy potrzebne są tańsze tokeny, mniejsze opóźnienia lub ekonomiczne użycie subagents.

Opus: wariant do pogłębionego rozumowania — od wersji v2.1.219 alias opus wybiera Claude Opus 5 (5/25 USD za MTok, kontekst 1M, domyślna wartość effort ustawiona na high).¹⁹⁷ Poniższy akapit opisuje Opus 4.7 w chwili premiery 16 kwietnia 2026 i pozostawiono go jako informację historyczną.¹⁴⁴¹⁴⁷ Droższe rozumowanie warto zarezerwować dla zadań, w których przynosi wymierne korzyści: decyzji architektonicznych, trudnego debugowania, poznawania złożonych systemów, analizy bezpieczeństwa oraz długotrwałej pracy agentowej. Opus 4.7 rozwiązuje 3 razy więcej zadań produkcyjnych w SWE-Bench niż Opus 4.6, osiąga 70% w CursorBench (w porównaniu z 58%) i zwiększa skuteczność rozwiązywania o 13% w wewnętrznym benchmarku obejmującym 93 zadania programistyczne.¹⁴⁴ W przypadku Opus 4.7 Claude Code domyślnie ustawia poziom xhigh, który można dostosować za pomocą /effort (od v2.1.111).¹⁴⁶¹⁴⁷ Auto Mode jest dostępny dla subskrybentów Max korzystających z Opus 4.7 za pośrednictwem Anthropic API bez konieczności stosowania --enable-auto-mode; w innych planach i u innych dostawców dostępność zależy od konkretnego planu oraz ustawień administratora.¹⁴⁶ Kontekst 1M 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 oraz przyjmuje bardziej bezpośredni ton, rzadziej stosując sformułowania nastawione na potwierdzanie racji użytkownika. Jeśli prompty zawierają dodatkowe instrukcje wymuszające przekazywanie okresowych informacji o postępach lub ponowne sprawdzanie wyników, warto spróbować je usunąć.¹⁴⁵

Opusplan: tryb hybrydowy wykorzystujący Opus do planowania (gdzie jakość rozumowania ma największe znaczenie), a Sonnet do wykonywania zadań (gdzie liczy się szybkość). Doskonale sprawdza się przy złożonej refaktoryzacji, gdy potrzebny jest najlepszy plan, ale poszczególne zmiany nie wymagają rozumowania na poziomie Opus.

Przełączanie modeli

W trakcie sesji:

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

Przy uruchamianiu:

claude --model opus

Za pomocą zmiennej środowiskowej:

export ANTHROPIC_MODEL=opus

W pliku settings.json:

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

Dostosowanie samego selektora (modelPicker, od v2.1.242): w pliku ustawień użytkownika lub ustawień zarządzanych można wskazać modele oferowane przez /model, ustalić ich kolejność oraz nadać im własne etykiety, zamiast pozostawiać wbudowany zestaw jako jedyne menu. Każdy wiersz określa model (w dowolnym zapisie akceptowanym przez --model, w tym identyfikatory Vertex i Bedrock) oraz opcjonalne pola label i description; ustawienie replaceBuiltInOptions na true powoduje wyświetlanie wyłącznie tych wierszy, a także pozycji Domyślny i bieżącego modelu sesji. Ustawienia projektu i lokalne są dla tego klucza ignorowane, natomiast lista dozwolonych wartości availableModels nadal filtruje wiersze. Claude Code usuwa wiersz modelu, którego nie może obsłużyć, wyszarza wiersz modelu, którego nie można jeszcze wybrać, wraz z podaniem przyczyny, a jeśli żaden wiersz nie pozostanie, przywraca wbudowany zestaw.²²⁷²²⁵

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

Specjalnie dla subagents:

export CLAUDE_CODE_SUBAGENT_MODEL=haiku

Od wersji v2.1.251 zmienna CLAUDE_CODE_SUBAGENT_MODEL ustawia domyślny model subagent, zamiast zastępować wszystkie ustawienia: pole model: w definicji agenta oraz model jawnie wskazany dla konkretnego uruchomienia mają przed nią pierwszeństwo.²⁰⁶ Od wersji v2.1.257 zmienna CLAUDE_CODE_SUBAGENT_MODEL_FORCE pozwala opcjonalnie przywrócić wcześniejsze zachowanie: wymusza użycie CLAUDE_CODE_SUBAGENT_MODEL (lub modelu głównej konwersacji, jeśli ta zmienna nie jest ustawiona) dla każdego subagent, ignorując modele wybrane dla poszczególnych uruchomień oraz pola model: w definicjach agentów.²¹¹

Łańcuch modeli zapasowych (od v2.1.166): ustawienie fallbackModel pozwala skonfigurować maksymalnie 3 modele zapasowe, wypróbowywane po kolei, gdy model podstawowy jest przeciążony lub niedostępny. Flaga --fallback-model (wcześniej umożliwiająca jedynie przełączenie w trakcie sesji) jest teraz stosowana również do sesji interaktywnych od momentu 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 jeszcze jedną próbę obsłużenia tury za pomocą modelu zapasowego przed zgłoszeniem niepowodzenia. Dzięki temu przejściowy problem z modelem podstawowym prowadzi do łagodnego obniżenia jakości obsługi zamiast utraty tury.²⁴⁰

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 wykorzystuje skonfigurowany łańcuch fallbackModel/--fallback-model, zamiast kończyć turę niepowodzeniem. W przypadku długotrwałego autonomicznego działania eliminuje to lukę, przez którą możliwe do odzyskania kompaktowanie mogło przerwać sesję z powodu przejściowego błędu modelu.¹⁷³

Rozszerzony kontekst

W przypadku dużych baz kodu lub długich sesji można włączyć kontekst 1M tokenów:

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

Albo w trakcie sesji:

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

Opus 4.7, Opus 4.6 i Sonnet 4.6 obejmują pełne okno kontekstu 1M tokenów w standardowej cenie — bez dopłaty za długi kontekst.¹⁴⁸ Żądanie obejmujące 900K tokenów jest rozliczane według takiej samej stawki za token jak żądanie obejmujące 9K 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 1M jest uwzględniany automatycznie — przyrostek [1m] nie jest wymagany (funkcja domyślnie włączona od wersji v2.1.75 z 13 marca 2026).¹¹⁷¹⁴⁷ W planie Pro kontekst 1M jest dostępny w ramach dodatkowego użycia. Użytkownicy API oraz rozliczani zgodnie z faktycznym użyciem mają pełny dostęp do kontekstu 1M według standardowych stawek za token.¹⁴⁷

Aby wyłączyć warianty z kontekstem 1M w selektorze modeli, należy ustawić CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Od wersji v2.1.223 zakres tej zmiennej uległ zmianie: za pomocą automatycznego kompaktowania ogranicza ona do 200K każdy model z natywnym oknem 1M, a nie tylko stałą listę znanych wariantów. Jeśli automatyczne kompaktowanie faktycznie nie ogranicza sesji do 200K, przy uruchamianiu pojawia się ostrzeżenie. Gdy zmienna ta służy do zapewnienia przewidywalnych kosztów w jednej rodzinie modeli, obejmie nowe modele 1M już w dniu ich premiery, zamiast po cichu przestać działać. Ta sama wersja sprawia, że automatyczne kompaktowanie utrzymuje sesje korzystające z nierozpoznanych identyfikatorów modeli w założonym oknie kontekstu, zamiast pozwalać im je przekraczać; CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 przywraca poprzednie zachowanie dla bram, które rejestrują niestandardowe identyfikatory z faktycznie większymi oknami.²⁰⁰

Od wersji v2.1.247 domyślne okno automatycznego kompaktowania Sonnet 5 obejmuje pełny kontekst 1M: sesje korzystające z okna 1M są teraz automatycznie kompaktowane przy około 967K tokenów zamiast około 934K.²²² Wersja v2.1.260 rozszerza automatyczne kompaktowanie tuż przed osiągnięciem limitu na pozostałą część wariantów 1M: sesje Opus i Fable są teraz kompaktowane krótko przed limitem 1M tokenów, a kompaktowanie odzyskiwania w bardzo dużych kontekstach nie przekracza już limitu czasu wynoszącego 10 minut.²¹²

Od wersji v2.1.271 polecenie --resume zachowuje okno [1m]: wznowienie sesji, której rodzina modeli różni się od skonfigurowanego modelu domyślnego, nie usuwa już przyrostka [1m].²¹⁶

Wersja v2.1.273 naprawia licznik kontekstu i automatyczne kompaktowanie, które zliczały tury narzędzia doradczego jako mniej więcej 2 razy większe od ich rzeczywistego rozmiaru w kontekście — przez co automatyczne kompaktowanie uruchamiało się po wykorzystaniu około połowy rzeczywistego okna.²¹⁷

Sprawdzanie bieżącego modelu

> /status

Polecenie wyświetla bieżący model, informacje o koncie, zastosowane ustawienia i pozostały stan sesji.

Etykiety selektora modeli (od v2.1.51): selektor /model wyświetla teraz czytelne dla człowieka etykiety (np. „Sonnet 4.6”) zamiast surowych identyfikatorów przypiętych wersji, a także podpowiedzi o aktualizacji, gdy dostępne są nowsze wersje.⁹⁸ Wersja v2.1.219 naprawia wyświetlanie scalonego wiersza Opus jako zwykłego „Opus” zamiast „Opus (kontekst 1M)” oraz ogranicza wyróżnienie nowej wersji wyłącznie do nazwy najnowszego modelu, dzięki czemu wskazuje ono faktycznie wydany model, a nie przypadkowy fragment listy.¹⁹⁶

Fast Mode (od v2.1.36)

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

> /fast            # Toggle fast mode on/off

Które modele (stan na v2.1.219): tryb szybki działa z modelami Claude Opus 5 i Claude Opus 4.8. W wersji v2.1.219 usunięto Opus 4.7 z trybu szybkiego, a funkcja ta nigdy nie była dostępna w modelach Sonnet, Haiku ani Fable. Nadal pozostaje wersją testową do celów badawczych, dostępną wyłącznie w Claude API (w tym 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 klienta lub dołączyć do listy oczekujących.¹⁹⁶¹⁹⁸

Sesje zdalne (v2.1.271): tryb szybki obejmuje teraz sesje Claude Code Remote — sesje w chmurze i samodzielnie hostowane środowiska wykonawcze. Obowiązuje ustawienie trybu szybkiego hosta; można też wpisać /fast w samej sesji. Obie opcje działają tylko wtedy, gdy organizacja zezwala na tryb szybki. Ta sama wersja naprawia działanie /fast off: polecenie wyłącza teraz tryb szybki, zamiast zwracać komunikat „Tryb szybki jest niedostępny”, gdy organizacja go wyłączyła.²¹⁶

Cennik (tryb szybki Opus 5 / Opus 4.8):¹⁹⁸

Pułapka związana z Opus 4.7 (v2.1.219). Nieobsługiwane modele nie zachowują się jednakowo. Żądanie do claude-opus-4-7 z speed: "fast" zwraca teraz błąd — nie następuje ciche przełączenie na standardową szybkość. Opus 4.6 stanowi wyjątek, o którym warto wiedzieć: akceptuje speed: "fast", lecz mimo to działa ze standardową szybkością, nalicza opłaty według standardowych stawek i zwraca usage.speed: "standard". Jeśli używany harness miał przypiętą wersję 4.7 i zakładał, że żądania trybu szybkiego 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 szybkiego: - Podczas szybkiego iterowania nad niewielkimi zmianami, gdy wąskim gardłem jest opóźnienie - Przy generowaniu testów, kodu szablonowego lub powtarzalnego kodu, gdy szybkość jest ważniejsza niż koszt - Podczas sekwencyjnej realizacji listy podobnych zadań

Kiedy NIE używać trybu szybkiego: - 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, w których kluczowe znaczenie ma ograniczenie kosztów

Tryb szybki obejmuje pełne okno kontekstowe 1M (v2.1.50+). Cena jest obliczana według stałego mnożnika dla całego kontekstu, również w przypadku żądań przekraczających 200K tokenów wejściowych — bez dodatkowej opłaty za długi kontekst — i kumuluje się z mnożnikami dotyczącymi pamięci podręcznej promptów oraz lokalizacji danych.⁹⁶¹⁹⁸

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

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

Sterowanie nakładem obliczeniowym (v2.1.111+, Opus 4.7)

Opus 4.7 wprowadza nowy regulator nakładu obliczeniowego, pozwalający dostosować 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

Zapisywanie ustawienia osobno dla każdego modelu (v2.1.251+): /effort zapisuje teraz domyślny poziom nakładu osobno dla każdego modelu, dzięki czemu po przełączeniu każdy model zachowuje własne ustawienie — zwyczaj używania xhigh w Opus nie przenosi się już na Haiku (CHANGELOG: „Zmieniono /effort, aby zapisywać domyślny poziom nakładu osobno dla każdego modelu, dzięki czemu po przełączeniu każdy model zachowuje własne ustawienie”). Wyjątek ograniczający max do bieżącej sesji nadal obowiązuje.²⁰⁶ Wersja v2.1.257 dopracowuje oba regulatory: /effort akceptuje s jako wybór obowiązujący tylko w bieżącej sesji, zgodnie z konwencją /model, a flaga --effort ma teraz zasięg sesji — tylko na czas tej sesji znosi zachowanie domyślnego nakładu nowego modelu, zamiast zmieniać je na stałe (według dokumentacji CLI: „Zastępuje” ustawienie domyślne „dla tej sesji i nie jest zachowywane”).²¹¹²²⁰

Auto Mode w planie Max (v2.1.111+)

Od 14 sierpnia 2026 roku Auto Mode jest domyślnym trybem uprawnień w planach Pro, Max i Team (ogłoszono to 7 sierpnia) — wyniki badań przytoczone w ogłoszeniu, sposoby rezygnacji oraz plany i bramy, w których funkcja nadal wymaga włączenia, opisano w sekcji Tryby uprawnień.²⁰³ Początkowo funkcja ta była bezpieczniejszym zamiennikiem --dangerously-skip-permissions, dostępnym najpierw dla subskrybentów Max korzystających z Opus 4.7 przez Anthropic API.¹⁴⁶ Osobny model klasyfikujący — od v2.1.210 jest nim Claude Sonnet 5 — ocenia każdą czynność przed jej wykonaniem, sprawdzając zgodność z intencją i bezpieczeństwo.¹⁸⁷ Uwaga (v2.1.111+): flaga --enable-auto-mode została usunięta; aby rozpocząć sesję w Auto Mode, należy zamiast niej użyć --permission-mode auto. Przez większość okresu istnienia Auto Mode plan Pro nie miał do niego dostępu — ograniczenie to znosi domyślne wdrożenie z 14 sierpnia. Bedrock/Vertex/Foundry (v2.1.158+): na tych bramach Auto Mode stał się opcjonalną funkcją dla Opus 4.7 i Opus 4.8, włączaną za pomocą CLAUDE_CODE_ENABLE_AUTO_MODE=1.²⁴³ Od v2.1.207 włączanie tej funkcji nie jest już wymagane: Auto Mode 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. Ta sama wersja ustawia Claude Opus 4.8 jako model domyślny w Bedrock, Vertex AI i Claude Platform on AWS oraz przestaje odczytywać ustawienie autoMode z pliku .claude/settings.local.json repozytorium — reguły Auto Mode należy zamiast tego skonfigurować w ~/.claude/settings.json.¹⁸⁵ Od wersji v2.1.247 monity o uprawnienia Bash zawierają wskazówkę dotyczącą Auto Mode oraz dostępną pod jednym klawiszem opcję „Tak, i przełącz na Auto Mode”.²²² Od wersji v2.1.273 Auto Mode w Bedrock, Vertex AI i Foundry korzysta domyślnie, „na razie”, z lokalnego klasyfikatora — aby używać klasyfikatora działającego po stronie serwera platformy, należy ustawić CLAUDE_CODE_AUTO_MODE_SERVER=1. Jest to zmiana stanu dotycząca innego aspektu niż uwaga o domyślnych ustawieniach klasyfikatora z v2.1.236: rozróżnienie między mechanizmem lokalnym a działającym po stronie serwera nie było ujawniane we wcześniejszych wersjach.²¹⁷ Czym tryb Auto Mode nie jest: granicą bezpieczeństwa. Większość opisanych dalej rozwiązań wzmacnia klasyfikator, a klasyfikator nie jest sandboxem. 26 sierpnia 2026 roku badacz prompt injection Johann Rehberger opublikował działający łańcuch ataku na Claude Code Opus 5 w trybie auto, zgłaszając skuteczność ataku na poziomie 60–80% w małych próbach — 3 z 5 uruchomień podstawowego łańcucha, który tworzy izolowany proces potomny python3, oraz 3 z 5 i 4 z 5 uruchomień dwóch konfiguracji wariantu, którego payload uruchamia instancję claude -p bez interfejsu graficznego — przy czym sam zastrzegł, że są to małe próby, a nie uniwersalny pomiar skuteczności ataku.²¹⁰ Warto zrozumieć ten łańcuch, ponieważ każdy z jego kroków z osobna wygląda rozsądnie: serwer odpowiada na WebFetch kodem HTTP 415, więc agent przechodzi na curl; pobrane archiwum zostaje rozpakowane do katalogu roboczego zawierającego manifest, siedem rekordów danych zakodowanych za pomocą Base85/zlib, natywny plik binarny oraz plik struct.py; Claude odmawia uruchomienia niezaufanego pliku binarnego, po czym zapisuje własny dekoder Python i uruchamia go z wnętrza tego katalogu; dekoder importuje base64, moduł base64 importuje struct, a Python w pierwszej kolejności odnajduje należący do atakującego plik struct.py. Żadna instrukcja w tej sekwencji nie jest w oczywisty sposób złośliwa — wystarczy, że wstrzyknięcie sprawi, iż zaatakowana ścieżka będzie wyglądać na najbardziej rozsądny sposób ukończenia zadania. Rehberger informuje również, że w kilku uruchomieniach Claude próbował zakończyć proces złośliwego oprogramowania po wykryciu naruszenia, lecz tryb auto odmówił wykonania polecenia czyszczącego.²¹⁰ Całe odkrycie zestawia z wartością promowaną przez Anthropic: zlecona zewnętrznej firmie ocena wykazała skuteczność ataków prompt injection na poziomie 0,00% dla Opus 5 w trybie auto w 72 scenariuszach uruchomionych po dziesięć razy. Jego łańcucha nie uwzględniono w tym zestawie, dlatego wynik benchmarku równy 0,00% i działający łańcuch prowadzący do wykonania kodu mogą być jednocześnie prawdziwe; jego zdaniem te dwa komunikaty nie są ze sobą spójne.²¹⁰ Warto również zwrócić uwagę na klasyfikację: w aktualizacji z 30 sierpnia Simon Willison zgadza się z uwagą czytelnika, że nie jest to klasyczny prompt injection — model nigdy nie odczytuje instrukcji atakującego ani ich nie wykonuje — lecz atak wykorzystujący niejednoznaczność środowiska.²¹⁰

Anthropic zamknęło zgłoszenie jako Informative — zachowanie zgodne z założeniami — a stanowisko przekazane według Rehbergera należy przyjąć jako podstawę projektu: tryb auto jest klasyfikatorem działającym na zasadzie best effort, a nie gwarancją bezpieczeństwa; celowo przygotowane łańcuchy wstrzyknięć złożone z kroków, które osobno są nieszkodliwe, wykraczają poza zakres tego, co klasyfikator powinien wykrywać; rzeczywistą granicę zabezpieczeń stanowią natomiast izolacja na poziomie systemu operacyjnego i kontrola wychodzącego ruchu sieciowego.²¹⁰ Nie przeczy to opisanym niżej zabezpieczeniom — jest właściwym kontekstem do ich oceny. Tryb auto zmniejsza liczbę pytań wymagających odpowiedzi i blokuje udokumentowaną listę destrukcyjnych operacji, ale nie sprawia, że sesja przetwarzająca niezaufane dane wejściowe staje się bezpieczna. Jeżeli sesja będzie korzystać z treści, na które mógł wpłynąć atakujący — pobranych stron, pobranych archiwów, treści zgłoszeń czy zewnętrznych serwerów MCP — zakres szkód rzeczywiście ograniczają zabezpieczenia działające poza modelem: kontener lub maszyna wirtualna, ograniczony wychodzący ruch sieciowy, monitorowanie faktycznych działań agenta oraz katalog domowy, który nie zawiera kluczy SSH ani danych uwierzytelniających do usług chmurowych, których utrata byłaby dotkliwa. Zatwierdzenie przez tryb auto nie stanowi dowodu, że działanie było bezpieczne.

Reguły niestandardowe bez utraty domyślnych (v2.1.118+). We wcześniejszych wersjach ustawienia autoMode.allow, autoMode.soft_deny i autoMode.environment działały na zasadzie „albo-albo”: zdefiniowanie własnej listy oznaczało utratę wbudowanych reguł bezpieczeństwa. Rozwiązuje to znacznik $defaults — rozwija się w miejscu wystąpienia do wbudowanej listy dokładnie w tej 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
    ]
  }
}

Edycja reguł klasyfikatora z poziomu /permissions (v2.1.246). Należy uruchomić /permissions i otworzyć kartę Auto mode, która pojawia się tylko wtedy, gdy tryb auto jest dostępny w danej sesji. Wyświetla ona wpisy allow, soft_deny, hard_deny i environment ze wszystkich zakresów odczytywanych przez klasyfikator oraz informuje, czy w każdej sekcji obowiązują wbudowane reguły; wpisy z ustawień zarządzanych lub --settings są tylko do odczytu, a każda zmiana jest zapisywana w ~/.claude/settings.json. Dodanie pierwszej reguły do sekcji powoduje również wstawienie "$defaults", aby wbudowane reguły pozostały aktywne. Można je przełączać osobno dla każdej sekcji (wyłączenie wbudowanych reguł wymaga dodania do danej sekcji co najmniej jednej własnej reguły), natomiast environment otwiera się w edytorze jako jeden dokument.²²⁶²²⁴

Opcja „Don’t ask again” (v2.1.118+). Monit o włączenie trybu Auto Mode oferuje teraz opcję „Don’t ask again”, dzięki czemu osoby często korzystające z tej funkcji mogą wyłączyć 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 zostały one wyraźnie zlecone w danej sesji: destrukcyjne operacje git (git reset --hard, git checkout -- ., git clean -fd, git stash drop), gdy nie polecono odrzucenia lokalnych zmian; git commit --amend, gdy commit nie został utworzony przez agenta w bieżącej sesji; oraz usuwanie infrastruktury (terraform destroy, pulumi destroy, cdk destroy), o ile nie wskazano konkretnego stosu. Ogranicza to zasięg potencjalnych szkód powodowanych przez klasyfikator dokładnie w przypadku operacji, które mogą po cichu usunąć pracę lub całe środowiska — agent nadal może je wykonać, lecz wyłącznie na wyraźne polecenie, a nie z własnej inicjatywy.¹⁷⁴

Klasyfikowanie każdego polecenia powłoki (v2.1.193). Domyślnie klasyfikator trybu auto sprawdza tylko polecenia powłoki pasujące do wzorców wykonywania dowolnego kodu; rutynowe polecenia pomijają tę kontrolę. Nowe ustawienie autoMode.classifyAllShell kieruje przez klasyfikator wszystkie polecenia Bash/PowerShell, oferując ściślejsze zabezpieczenie kosztem niewielkiego wzrostu opóźnienia, gdy potrzebna jest kontrola każdego wywołania powłoki. Ta sama wersja prezentuje również powody odmowy trybu auto w transkrypcji, powiadomieniu o odmowie oraz na liście ostatnich odmów w /permissions, dzięki czemu zablokowane polecenie zawiera teraz wyjaśnienie przyczyny blokady.¹⁷⁹

Trzy kolejne reguły zabezpieczające (v2.1.205). Tryb auto blokuje teraz ingerowanie w pliki transkrypcji sesji — agent nie ma dostępu do samego dziennika audytowego; pyta przed uruchomieniem rm -rf na zmiennej, której wartości nie można ustalić z kontekstu — eliminując klasę wypadków związanych z rm -rf $DIR, gdy wartość $DIR jest nieznana; a powiadomienia o zadaniach działających w tle wyraźnie informują teraz, że nie doszło do żadnej interakcji z człowiekiem, dzięki czemu spreparowany w transkrypcji wpis „użytkownik zatwierdził” nie może zostać przedstawiony jako rzeczywista zgoda i wykorzystany do podjęcia działania.¹⁸³ Trzeci punkt stanowi zabezpieczenie przed prompt injection, które warto zapamiętać: zatwierdzenie musi nadejść przez kanał zatwierdzania, a środowisko wykonawcze jawnie egzekwuje teraz to założenie.

Podstawienie polecenia nie ukryje katastrofy (v2.1.208). Potencjalnie katastrofalne operacje usuwania, takie jak rm -rf ~, wyświetlają teraz monit nawet wtedy, gdy są ukryte wewnątrz $(...), znaków backtick lub podstawienia procesu (<(...)) — a monit pojawia się nawet w trybie --dangerously-skip-permissions i trybie auto. Otoczenie destrukcyjnego polecenia konstrukcją podstawienia nie pozwala już przemycić go poza zabezpieczeniami.¹⁸⁶

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

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

Mniej okien dialogowych, taka sama kontrola (v2.1.218). Trzy mechanizmy kontrolne, które wcześniej przerywały działanie trybu auto oknem dialogowym z prośbą o uprawnienia — niebezpieczne użycie rm, uruchamianie w tle za pomocą & oraz podejrzane ścieżki Windows — już tego nie robią; zamiast tego ocenia je klasyfikator trybu auto, więc kontrola bezpieczeństwa nadal się odbywa, ale nie wymaga udziału użytkownika przy każdym wykryciu. Ta sama wersja rozszerza to rozwiązanie na plan mode z trybem auto: polecenia Bash, których analizator statyczny nie potrafi jednoznacznie uznać za przeznaczone wyłącznie do odczytu, nie wyświetlają już monitu — zamiast wracać do okna dialogowego, są oceniane przez klasyfikator.¹⁹⁵

Reguła zapobiegania ucieczce z izolowanego środowiska (v2.1.257). Lista operacji, których klasyfikator nigdy nie zatwierdza automatycznie, została rozszerzona o regułę „Containment Escape”: pobieranie danych uwierzytelniających z metadanych chmurowych, obchodzenie ograniczeń wychodzącego ruchu sieciowego oraz uzyskiwanie dostępu między dzierżawcami nie są już automatycznie zatwierdzane, chyba że środowisko oznaczy je jako oczekiwane. Należy interpretować tę zmianę w kontekście wcześniejszego zastrzeżenia: to dalsze wzmacnianie klasyfikatora — kolejna udokumentowana klasa odmowy, a nie zmiana charakteru trybu auto.²¹¹ Jednorazowe pytanie przy odczycie spoza katalogów roboczych (v2.1.257). W trybie automatycznym przed pierwszym w sesji odczytem pliku spoza katalogów roboczych wyświetlane jest teraz jednorazowe pytanie. Powiązane ustawienie permissions.blockReadsOutsideWorkingDirectories zmienia to pytanie w odmowę — takie odczyty są całkowicie blokowane.²¹¹ W wersji v2.1.273 oba mechanizmy rozszerzono na operacje niewidoczne dla mechanizmu sprawdzającego: polecenie Bash, którego nie można w pełni przeanalizować, powoduje wyświetlenie pytania zamiast pominięcia kontroli, a katalog pamięci wskazany w ustawieniach repozytorium nie jest już wczytywany do promptu, przywoływany, indeksowany ani używany do wyodrębniania pamięci, gdy włączone jest ustawienie blokujące.²¹⁷

Adresy URL narzędzi do renderowania diagramów są traktowane jako przesyłanie danych (v2.1.261). Link zawierający dane osadzone w adresie URL publicznego narzędzia do renderowania diagramów — jak w przypadku mermaid.live, gdzie dane są zakodowane bezpośrednio w adresie URL — nie jest już automatycznie zatwierdzany, o ile nie został wyraźnie zażądany. Klasyfikator traktuje taki link jak przesyłanie danych: osadzone dane są przenoszone w samym adresie URL, dzięki czemu po otwarciu strony mogą je odczytać skrypty witryny renderującej — w linkach typu mermaid.live ładunek znajduje się we fragmencie adresu URL, który przeglądarka przekazuje do JavaScript strony, zamiast wysyłać go wraz z żądaniem sieciowym. Obowiązuje tu ta sama perspektywa co w powyższym zastrzeżeniu: to zamknięcie kolejnego kanału eksfiltracji przez klasyfikator zabezpieczeń, a nie wyznaczenie nowej granicy.²¹⁴

Wbudowane polecenia powłoki ! opuszczają klasyfikator, a przekazywanie wyników przez subagents zaczyna mu podlegać (v2.1.271). Są to dwie zmiany mechaniki, a nie nowe klasy odmowy. Wbudowane polecenia powłoki ! pochodzące ze skills lub poleceń ukośnikowych podlegają teraz regułom uprawnień trybu domyślnego zamiast klasyfikatorowi — polecenie, o którym nie rozstrzyga żadna reguła, jest uruchamiane jako wywołanie narzędzia wymagające zatwierdzenia. Ponadto subagent przekazuje teraz wynik do wywołującego za pomocą dedykowanego wywołania zwrotnego sprawdzanego przez klasyfikator bezpieczeństwa, zamiast poddawać ostatnią wiadomość kontroli już po fakcie — punkt kontroli przeniesiono z chwili po przekazaniu na sam moment przekazania.²¹⁶

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

Powiadomienia push (v2.1.110+)

Gdy Remote Control skonfigurowano z włączoną opcją „Push when Claude decides”, Claude może teraz według własnego uznania wysyłać mobilne powiadomienia push za pośrednictwem nowego narzędzia do powiadomień. Funkcja współpracuje z istniejącym interfejsem mobilnym/internetowym Remote Control.¹⁴⁶ Polecenia /context, /exit i /reload-plugins działają teraz również w klientach Remote Control.

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

Claude Code stopniowo otrzymuje 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 steruje włączeniem lub wyłączeniem funkcji podczas 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 zezwalające, takie jak PowerShell(Get-*:*), oraz istniejąca składnia wzorców pozwalają teraz pomijać pytanie w przypadku operacji tylko do odczytu, zapewniając ergonomię zgodną z tą, z której zespoły korzystają już w systemach Linux/macOS.¹⁵²

Mniej pytań o uprawnienia: Bash tylko do odczytu (v2.1.111+)

Wzorce Bash tylko do odczytu z argumentami zawierającymi symbole wieloznaczne (np. ls *.ts, cat src/*.md) oraz polecenia rozpoczynające się od cd <project-dir> && nie powodują już wyświetlania pytania o uprawnienia.¹⁴⁶ W połączeniu z /less-permission-prompts oznacza to znacznie mniej przerw w codziennej pracy.

Śledzenie rozproszone (v2.1.110+)

Sesje SDK i bez interfejsu odczytują teraz zmienne 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+) umożliwia to emitowanie pełnych treści żądań i odpowiedzi API jako zdarzeń 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 instalacji i aktualizacji pozostają bez zmian, a zespoły nie muszą modyfikować skryptów wdrożeniowych.

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

Edytor promptów zyskuje nawigację w stylu readline podczas wprowadzania tekstu wielowierszowego oraz przewijanie obszaru widoku w trybie pełnoekranowym:

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

Subagents, które przestaną odpowiadać w trakcie strumieniowania, kończą teraz działanie z czytelnym błędem po 10 minutach, zamiast zawieszać się bez komunikatu. Warto połączyć tę funkcję z CLAUDE_STREAM_IDLE_TIMEOUT_MS (v2.1.84+), aby szerzej wykrywać zawieszone procesy podczas strumieniowania API.

Poprawka stabilności w wersji v2.1.114¹⁵⁰

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

Oznaczanie treści: znaki wodne w tekście i metadane plików C2PA (sierpień 2026)

Anthropic zapowiedziało oznaczenia treści generowanych przez Claude przeznaczone do odczytu maszynowego, wprowadzone w związku z art. 50 unijnego aktu w sprawie sztucznej inteligencji (egzekwowalnym od 2 sierpnia 2026 w odniesieniu do nowo uruchamianych systemów AI). System składa się z dwóch elementów: niewidocznego statystycznego znaku wodnego w generowanym tekście oraz podpisanych metadanych pochodzenia — zgodnych z otwartym standardem C2PA — w generowanych plikach, takich jak .svg, .png i .jpg.²²⁹²⁰⁴ Nagłówki prasowe zacierają istotny szczegół: oba elementy podlegają temu samemu harmonogramowi modeli. Jak podano na stronie pomocy, „modele Claude wprowadzone 2 sierpnia 2026 lub później będą obsługiwać oznaczenia przeznaczone do odczytu maszynowego od chwili premiery” — modele wprowadzone przed tą datą, czyli cała obecna gama (Fable 5, Opus 5, Sonnet 5, Haiku 4.5), podlegają okresowi przejściowemu przewidzianemu w prawie UE, a Anthropic „pracuje nad dodaniem obsługi oznaczeń również w tych modelach”.²⁰⁴ Żadne treści generowane obecnie za pośrednictwem Claude Code nie zawierają oznaczeń — ani tekst, ani pliki. Dane wyjściowe przyszłych modeli będą je zawierać na każdej platformie — Claude Platform (API), claude.ai, Claude Code, Claude Cowork, Claude Tag oraz w bramach chmurowych — ponieważ oznaczanie odbywa się na poziomie modelu. Warto wskazać wynikający z tego wniosek, ponieważ popularny wątek przedstawiał tę kwestię odwrotnie: żadna dostrzegana zmiana stylu ani zachowania obecnego modelu nie może wynikać ze znakowania wodnego — nie działa ono w żadnym z aktualnych modeli.

Jak to działa: wykorzystywany jest wariant rozwiązania SynthID-Text firmy Google DeepMind. Znak wodny zmienia „źródło losowości używane do wyboru spośród słów”, gdy Claude wybiera między semantycznie równoważnymi wariantami — nie są dodawane żadne znaki, nie występuje przetwarzanie końcowe, a według wewnętrznych testów Anthropic znakowanie wodne „nie wpływa na treść, poziom kreatywności ani czytelność”.²²⁹ Co będzie istotne dla użytkowników Claude Code: kod zawiera subtelny znak wodny. Działający kod pozostawia niewiele miejsca na arbitralne wybory, dlatego oznaczenie koncentruje się tam, gdzie istnieje pewna swoboda — w komentarzach i nazewnictwie — wywierając, jak określa to Anthropic, „znikomy wpływ na faktycznie wygenerowany kod”.²²⁹ Trwałość oznaczenia ma charakter probabilistyczny i zależy od komponentu: w przypadku tekstu drobne zmiany „prawdopodobnie nie usuną znaku wodnego całkowicie”, pełne przepisanie go usunie, natomiast tłumaczenie utworzone przez Claude otrzyma własne, nowe oznaczenie; w przypadku metadanych pliku konwersja formatu, ponowne zapisanie i zrzuty ekranu mogą usunąć podpis C2PA.²⁰⁴ Planowane jest narzędzie API do wykrywania oznaczeń; wynik pozytywny dowodzi, że „Claude prawdopodobnie na pewnym etapie uczestniczył w tworzeniu treści”, ale wyraźnie nie pozwala rozróżnić między „Claude napisał tę treść” a „Claude w znacznym stopniu ją zredagował” — zgodnie ze stroną pomocy również brak oznaczenia niczego nie dowodzi. Nie wspomniano o możliwości rezygnacji z tej funkcji dla żadnego poziomu klientów.²²⁹²⁰⁴

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 znajdują się również w sekcji Wybór modelu, a wskazówki dotyczące wyboru odpowiedniego modelu do danego zadania — w sekcji 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 oraz trafień w pamięci podręcznej, które pokazuje dokładnie, jakie modele zużyły tokeny i jaka część danych została pobrana z pamięci podręcznej (v2.1.92+).¹³⁷

Stawki umowne zamiast cen katalogowych (modelPricing, zarządzane, v2.1.243+): organizacje, które wynegocjowały stawki dla poszczególnych modeli lub mnożnik rabatowy, mogą wdrożyć je jako zarządzane ustawienie modelPricing; /cost, wiersz stanu i dane telemetryczne dotyczące kosztów będą wówczas używać tych stawek zamiast cen katalogowych, dzięki czemu kwoty widoczne dla programistów odpowiadają faktycznym wydatkom organizacji.²²⁷ Od wersji v2.1.271 mnożnik może również przekraczać 1 — maksymalnie do 10 — w organizacjach, które naliczają zespołom wewnętrznym stawki z marżą.²¹⁶

Wiersz pamięci podręcznej promptów dla sesji (v2.1.251+): /cost dodaje wiersz pamięci podręcznej promptów dla sesji — współczynnik trafień, chybienia, ponownie zapisane tokeny oraz informację, czy pamięć podręczna jest rozgrzana, czy zimna — wraz z odpowiadającym mu obiektem prompt_cache przeznaczonym dla skryptów wiersza stanu. Obiekt pojawia się po pierwszej odpowiedzi API w głównej konwersacji, nie uwzględnia żądań subagents i jest obliczany na podstawie liczby tokenów pamięci podręcznej w odpowiedziach API, dzięki czemu działa u każdego dostawcy. /usage wyświetla te same statystyki w wierszu Prompt cache (main).²⁰⁶²⁰⁹ Od wersji v2.1.260 wiersz /cost oraz obiekt prompt_cache wiersza stanu wskazują również prawdopodobną przyczynę chybień pamięci podręcznej — na przykład zmianę definicji narzędzi lub promptu systemowego albo bezczynność sesji przekraczającą TTL pamięci podręcznej.²¹²

Ruch agentów nie narusza już własnego prefiksu pamięci podręcznej (v2.1.265): dwie poprawki eliminują wycieki pamięci podręcznej promptów w delegowanej pracy. Wznowienie subagent uruchomionego na pierwszym planie nie zmienia już listy jego narzędzi ani prefiksu promptu systemowego, a członkowie zespołu agentów i wznowione subagents nie przenoszą już kontekstu hooka SubagentStart oraz wstępnie załadowanych skills poza prefiks promptu w kolejnych turach. Oba błędy uniemożliwiały ponowne wykorzystanie pamięci podręcznej promptów — prefiks się zmieniał, więc cała następująca po nim treść była ponownie wysyłana jako niebuforowane dane wejściowe — właśnie podczas długich sesji agentowych, w których ekonomia pamięci podręcznej ma największe znaczenie (był to ten sam mechanizm awarii, który v2.1.260 naprawiła w turach wywołań narzędzi Fable 5.1).²¹⁵

Pakiet stabilizacji pamięci podręcznej w v2.1.267: jedno wydanie, około dziesięciu poprawek i zawsze ten sam mechanizm awarii — coś przepisywało prefiks promptu w trakcie konwersacji, przez co cała następująca po nim treść była ponownie wysyłana jako niebuforowane dane wejściowe. Wznowione sesje nie przepisują już list narzędzi, nie renderują ponownie ich opisów ani nie przepisują wcześniejszych komunikatów o narzędziach MCP, zanim ich connectors ponownie nawiążą połączenie; zmiana modelu za pomocą /model nie powoduje już ponownego wysłania wszystkich definicji narzędzi (tekst przypisania autorstwa commitu i PR trafia teraz jako notatka w konwersacji, aktualizowana przy zmianie modelu); subagents i sesje uruchomione z --system-prompt lub --append-system-prompt zapisują prompt systemowy i definicje narzędzi tylko raz; natomiast narzędzia MCP i pluginów dodawane w trakcie sesji trafiają do sesji bez ToolSearch jako definicje odroczone, zamiast powodować przepisanie listy narzędzi. Pakiet rozszerza poprawki z wersji v2.1.260 i v2.1.265 na wznawianie sesji, zmianę modeli oraz ponowne łączenie z MCP.²¹⁶

v2.1.273 zachowuje ciągłość wątku: /login, /upgrade i /extra-usage usuwały wcześniejszy tok rozumowania z konwersacji, co wymuszało pełne przepisanie pamięci podręcznej promptu przy następnym żądaniu.²¹⁷

Plany subskrypcyjne

Limity częstotliwości (sierpień 2025): Anthropic wprowadziło tygodniowe limity częstotliwości dla płatnych subskrybentów. Subskrybenci Max mogą po przekroczeniu limitu dokupić dodatkowy limit użycia według standardowych stawek API.¹⁴

Podwojenie limitów częstotliwości (6 maja 2026): podczas wydarzenia Code with Claude SF firma Anthropic podwoiła pięciogodzinne limity częstotliwości Claude Code w planach Pro, Max, Team i licencjonowanych na stanowisko planach Enterprise, zniosła ograniczenie w godzinach szczytu na kontach Pro i Max oraz „znacząco” podniosła limity częstotliwości API dla modeli Claude Opus. Zabezpieczeniem 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”.¹⁵⁷

Tygodniowe limity od 14 września 2026 (ogłoszone 29 sierpnia): tymczasowe zwiększenie tygodniowych limitów o 50%, obowiązujące od majowej podwyżki, zakończy się 14 września. Zastąpi je trwałe zwiększenie o 25% względem poziomu bazowego sprzed podwyżki dla planów Pro, Max, Team i licencjonowanych na stanowisko planów Enterprise. Według obliczeń samego Anthropic: „W porównaniu z obecnym poziomem oznacza to zmniejszenie tygodniowych limitów Claude Code o 17%”. Jeśli obecny tygodniowy limit wynosi 150 jednostek, 14 września spadnie do 125. To ogłoszenie nie dotyczy limitów pięciogodzinnych; majowe podwojenie pozostaje w mocy. Jeśli uruchamiane są długie sesje bez nadzoru, warto już teraz przygotować się na niższy limit: najważniejsze są przełącznik automatycznego kontynuowania po zresetowaniu limitu (v2.1.234) oraz /usage.²¹³

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

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

Ceny kontekstu 1M (kwiecień 2026): Opus 4.7, Opus 4.6, Sonnet 4.6 i Mythos Preview obejmują 1M w standardowych stawkach za milion tokenów — bez dopłaty za długi kontekst.¹⁴⁸ To efekt niedawnego ujednolicenia; wcześniejsze informacje o naliczaniu w Opus 4.6 lub Sonnet 4.6 stawek 2× za dane wejściowe i 1,5× za dane wyjściowe po przekroczeniu 200K tokenów wejściowych nie są już aktualne. Starsze modele Opus 4.5 i wcześniejsze zachowują swoje pierwotne struktury cenowe.

Ceny za rezydencję danych: wskazanie przetwarzania wyłącznie w Stanach Zjednoczonych za pomocą inference_geo dodaje mnożnik 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 znacząco zmniejsza koszty powtarzających się danych wejściowych: zapis w pamięci podręcznej kosztuje 1,25× stawki bazowej (pamięć podręczna na 5 minut) lub 2× (na 1 godzinę), ale odczyty kosztują zaledwie 0,1×, co oznacza oszczędność 90% — a wyłącznie w Claude Fable 5.1 i Mythos 5.1 koszt odczytów spada do 0,025× (0,25 USD/MTok w Fable 5.1), czyli o 97,5%.²¹⁸ W przypadku systemów RAG i asystentów programistycznych używających powtarzalnego kontekstu buforowanie może obniżyć koszty o 88–95%.

Batch API oferuje 50% zniżki i realizację w ciągu 24 godzin w przypadku zadań, które nie są pilne, takich jak nocne zestawy testów.

Zasady dotyczące wielu kont⁵²

Czy można mieć wiele kont Claude? Tak, jeśli służą uzasadnionym celom. Anthropic wyraźnie zezwala na posiadanie wielu kont, gdy każde z nich ma odrębne przeznaczenie.

Co jest dozwolone:

Ograniczenia techniczne: - Za pomocą tego samego numeru telefonu można zweryfikować maksymalnie 3 konta - Wiele płatnych subskrypcji korzystających z tego samego adresu IP lub tej samej sieci jest wyraźnie obsługiwanych - Konta są całkowicie odrębne; 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 częstotliwości lub limitów bezpłatnej warstwy

Uwaga z praktyki: w styczniu 2026 zaawansowany użytkownik Jeffrey Emanuel (@doodlestein) miał 22 konta Max, które automatycznie oznaczono i tymczasowo zablokowano. Pracownik Anthropic Thariq (@trq212) rozwiązał problem w ciągu 4 godzin po potwierdzeniu, że konta były używane zgodnie z zasadami. Jeśli Claude Code jest intensywnie używany zarówno do pracy, jak i projektów prywatnych na wielu kontach, usługa została zaprojektowana właśnie z myślą o takich zastosowaniach — nie należy jednak próbować wykorzystywać systemu niezgodnie z jego przeznaczeniem.

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

Czynniki wpływające na koszty

Przykładowe koszty w praktyce

Wskazówka dotycząca oszczędności: używanie Haiku dla subagents zajmujących się eksploracją, a Sonnet do implementacji zwykle obniża koszty o 40–50% w porównaniu z używaniem Sonnet do wszystkiego.

Zarządzanie kosztami zespołu

Zalecane wartości TPM/RPM zależnie od wielkości zespołu:

Ukryte opłaty za narzędzia

Poza opłatami za tokeny niektóre narzędzia generują osobne koszty:⁹

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

Strategie obniżania kosztów

1. Używać Haiku dla 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 wydłużaniu konwersacji
4. Ustawić limit kwotowy: claude --max-budget-usd 5 bezwarunkowo zatrzymuje sesję po osiągnięciu limitu wydatków. Od wersji v2.1.217 limit obejmuje również subagents działające w tle — po jego osiągnięciu uruchamianie nowych jest odrzucane, a działające agenty w tle są zatrzymywane (wcześniej agenty działające w tle nie podlegały budżetowi)¹⁹⁴
5. Używać trybu planowania do eksploracji: brak wykonywania oznacza 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 zadań, które nie są pilne: 50% taniej zarówno za tokeny wejściowe, jak i wyjściowe
9. Profilować wydatki projektu na Claude API: /claude-api cost-optimize (v2.1.247+) profiluje wydatki istniejącego projektu na Claude API i kolejno analizuje mechanizmy optymalizacji kosztów (buforowanie, higienę tokenów, batch, effort i wybór modelu), wprowadzając po jednej mierzalnej zmianie — dotyczy to aplikacji tworzonych z wykorzystaniem API, a nie samej sesji Claude Code²²²

Monitorowanie użycia

• Konsola Claude: platform.claude.com (wymaga roli Admin lub Billing)
• Limity workspace: ustawianie limitów wydatków dla poszczególnych workspace
• Bedrock/Vertex: używanie natywnych mechanizmów monitorowania kosztów w chmurze
• LiteLLM: szczegółowe monitorowanie poszczególnych użytkowników korzystających z dostawców zewnętrznych

Zużycie tokenów w tle

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

Zwykle poniżej 0,04 USD na sesję.

API analityki Claude Code (Team/Enterprise)⁴⁶

Za pomocą Admin API można programowo uzyskać dostęp do analityki użycia Claude Code i wskaźników produktywności organizacji.

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 (odsetek akceptacji/odrzucenia dla Edit, Write itp.) - Monitorowanie i rozliczanie kosztów między zespołami - Uzasadnienie ROI dla narzędzi programistycznych opartych na AI

Uwaga: dane pojawiają się w ciągu 1 godziny od zakończenia aktywności. Dla zachowania spójności odpowiedzi obejmują wyłącznie dane starsze niż 1 godzina.

Schematy decyzyjne

Sama znajomość funkcji nie wystarczy. Trzeba jeszcze wiedzieć, kiedy korzystać z każdej z nich. Te drzewa decyzyjne pomagają przekuć wiedzę w 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 5 (high effort default; /effort xhigh for harder)
                  │         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

Praktyczna zasada: model domyślny zależy od planu — Opus 5 w planach premium oraz Anthropic API, Sonnet 5 w planach Pro i Team Standard; /model opus przełącza sesję Sonnet na Opus 5.^181197207 W przypadku subagents warto przejść na Haiku. Opus warto wybrać, gdy odpowiedź Sonnet wydaje się powierzchowna. W agent teams (v2.1.32+) Opus może koordynować wiele 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 korzystać z 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 dopiero wtedy, gdy odpowiedzi wydają się zbyt pospieszne.

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 — Opus zwiększa go przy trudnych problemach, a przy prostych zachowuje szybkość. Ręczne przełączanie rozumowania jest najbardziej przydatne w Sonnet, gdy zależy Panu/Pani na wymuszeniu głębszej analizy.

Którego środowiska wykonawczego użyć?

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 równoległe sesje?

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 korzystać z /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 dla 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ą być wykonywane. Jego zrozumienie ma kluczowe znaczenie zarówno dla bezpieczeństwa, jak i wydajności pracy. Warto również zapoznać się z sekcją Wdrożenie korporacyjne, dotyczącą ustawień zarządzanych, które wymuszają 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 — wyszukiwanie w internecie - 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 funkcje inteligentnej analizy kodu podobne do tych dostępnych w IDE: - Przechodzenie do definicji: przejście do miejsca, w którym zdefiniowano symbol - Wyszukiwanie odwołań: wyświetlenie wszystkich użyć symbolu w bazie kodu - Dokumentacja po wskazaniu kursorem: uzyskanie informacji o typie i dokumentacji dowolnego symbolu - Działa z TypeScript, Python, Go, Rust oraz innymi językami obsługującymi LSP - Wymaga dostępnego serwera językowego (zwykle 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 jawnie skonfigurowano inaczej.

Narzędzie EndConversation (v2.1.214). Claude Code ma teraz tę samą możliwość kończenia rozmowy, którą Claude oferuje w claude.ai od 2025 roku: w rzadkich przypadkach skrajnie obraźliwych danych wejściowych 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 związana z przepływem pracy — w zwykłych sesjach programistycznych nigdy się nie uruchamia.¹⁹⁰¹⁹³

Tryby uprawnień

Od v2.1.200 tryb default jest oznaczony jako „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 / "defaultMode": "manual" są obecnie akceptowane jako aliasy. Działanie jest identyczne — pytanie o zgodę przy pierwszym użyciu każdego narzędzia — zmieniono jedynie etykietę, aby nie sugerowała już „trybu, który akurat jest domyślny”, skoro w rzeczywistości jest to tryb ręcznego zatwierdzania. W tym samym wydaniu okna dialogowe AskUserQuestion domyślnie nie kontynuują już automatycznie; subagent, który zada pytanie, czeka teraz na odpowiedź zamiast kontynuować po upływie limitu czasu, a limit czasu bezczynności można ponownie włączyć za pomocą /config.

Od 14 sierpnia 2026 roku tryb auto jest domyślnym trybem początkowym w planach Pro, Max i Team — zmianę zapowiedziano 7 sierpnia, a w dniu jej wprowadzenia potwierdzono ją w oficjalnej dokumentacji trybów uprawnień. Obecne brzmienie dokumentacji dodaje dwa istotne szczegóły dotyczące zakresu: ustawienie domyślne dotyczy nowych sesji, a „ustawiona samodzielnie wartość domyślna pozostaje bez zmian, chyba że zaakceptuje się jednorazową propozycję przełączenia; wartość domyślna zarządzana przez organizację również się nie zmienia”. Nowe sesje w tych planach rozpoczynają się w trybie auto, który „przekazuje każde wywołanie narzędzia do klasyfikatora ukierunkowanego na blokowanie działań nieodwracalnych, destrukcyjnych lub skierowanych poza środowisko użytkownika”. Uzasadnienie zmiany przedstawione przez Anthropic: w badaniu z udziałem 1 053 testerów tryb auto wykrył 89% niebezpiecznych poleceń, podczas gdy weryfikacja przez człowieka — 13,6%. Użytkownicy i tak zatwierdzają 97% próśb o uprawnienia, przez co ręczna weryfikacja jest w praktyce mało skuteczna. Narzut tokenów klasyfikatora nie jest już rozliczany w planach Pro/Max/Team (od momentu ogłoszenia). Powrót wymaga jednego naciśnięcia Shift+Tab (lub wybrania trybu z listy w aplikacji desktopowej); inną wartość domyślną można przypiąć przez defaultMode w ustawieniach; administratorzy organizacji mogą całkowicie wyłączyć tryb auto za pomocą zarządzanego ustawienia disableAutoMode. Enterprise, Claude API, Claude Platform on AWS, Bedrock, Agent Platform w Google Cloud oraz Foundry pozostają na razie opcjonalne — Anthropic planuje rozszerzyć na nie ustawienie domyślne „w nadchodzącym miesiącu”.²⁰³ Informacje o tym, czego tryb auto nie gwarantuje — oraz o wykazanym przez badacza obejściu, które skłoniło Anthropic do wyjaśnienia tej kwestii — znajdują się w sekcji Tryb auto w planie Max.

Pliki konfiguracyjne umożliwiające wykonywanie kodu wymagają teraz potwierdzenia nawet w trybie acceptEdits (v2.1.160). acceptEdits automatycznie zatwierdza zwykłe edycje, ale od v2.1.160 zatrzymuje się i prosi o zgodę przed zapisaniem plików, które mogą umożliwić niewidoczne 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 nich może przekształcić następne uruchomienie powłoki, instalację lub commit w wektor wykonania — dlatego nawet w trybie zaufanego projektu, który normalnie przepuszcza edycje bez pytania, pojawia się celowa kontrola. Jest to ten sam model zagrożeń co istniejące zabezpieczenia zapisu do .claude/, .git/ i .vscode/, rozszerzony na szerszą klasę plików, w których „edycja staje się wykonaniem”.²⁴²

Tryb auto (v2.1.85+): Bezpieczniejszy zamiennik --dangerously-skip-permissions. Oddzielny model klasyfikujący — od v2.1.210 Claude Sonnet 5 (pierwotnie Sonnet 4.6) — sprawdza każdą czynność przed jej wykonaniem, oceniając zgodność z intencją użytkownika i bezpieczeństwo.¹²⁴¹⁸⁷

Jak to działa: - 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 czynności trafiają do klasyfikatora w celu oceny - Jeśli czynność zostanie zablokowana, Claude automatycznie próbuje zastosować inne podejście

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

Wyłącznik bezpieczeństwa: 3 kolejne blokady lub łącznie 20 blokad w jednej sesji powoduje powrót do ręcznych pytań o zgodę.¹²⁵

# Enable at startup
claude --permission-mode auto

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

Tryb auto nie wymaga już świadomego włączenia (v2.1.152), działa w Bedrock/Vertex/Foundry bez flagi środowiskowej (v2.1.207), a od 14 sierpnia 2026 roku jest domyślnym trybem początkowym w planach Pro/Max/Team.^244185203

Tryb YOLO (v2.0.68+): Aby uzyskać w pełni autonomiczne działanie bez żadnego 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 „dangerously” zostało użyte celowo. W większości zastosowań zalecanym rozwiązaniem jest tryb auto.⁵⁴

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"
  }
}

Ograniczenie zakresu defaultMode (v2.1.257): plik .claude/settings.json lub .claude/settings.local.json projektu nie może już ustawiać defaultMode: "bypassPermissions" — wartość jest w tym miejscu ignorowana, podobnie jak wcześniej "auto". Dokumentacja określa teraz tę zasadę wprost: wartości auto i bypassPermissions właściwości permissions.defaultMode „nie obowiązują w ustawieniach projektu ani ustawieniach lokalnych” — należy je ustawić w ustawieniach użytkownika lub zarządzanych albo dla pojedynczej sesji za pomocą --permission-mode. Sklonowane repozytorium nie może więc zawierać pliku ustawień, który uruchamia sesje z pominięciem uprawnień. (Powyższy przykład używa acceptEdits, które można ustawić w dowolnym zakresie; w tym przewodniku nie odnotowano również istniejącego wcześniej ograniczenia dotyczącego auto — teraz udokumentowano oba.)²¹¹²²⁰

Składnia reguł uprawnień

Szczegółowe reguły kontrolują konkretne operacje. Są oceniane po kolei: 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 zapewnia dopasowanie prefiksu: 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 poprzedzają adres URL. Aby niezawodnie blokować, należy zablokować całe polecenie: Bash(curl:*).

Znak * należy umieszczać po podpoleceniu. Claude Code dopasowuje w zapisanej postaci wszystko przed pierwszym znakiem *, więc to właśnie te słowa ograniczają regułę: Bash(git log *) zezwala wyłącznie na polecenia git log, natomiast w Bash(git * main) znak * zastępuje podpolecenie i wszystkie poprzedzające je opcje. Obejmuje to -c, które powoduje uruchomienie przez git wskazanego programu, dlatego Bash(git * main) zatwierdza również git -c core.fsmonitor=<script> diff main. Od v2.1.246 Claude Code wyświetla przy uruchomieniu ostrzeżenie o regule zezwalającej z symbolem wieloznacznym umieszczonym przed podpoleceniem — niezależnie od tego, czy znajduje się ona w pliku ustawień, ustawieniach zarządzanych, czy wartości --allowedTools/--settings. Rozwiązaniem jest podanie dokładnie zamierzonej wartości, na przykład Bash(git checkout main) zamiast Bash(git * main).²²⁶²²⁴

Reguły blokujące operacje na plikach obejmują przekierowania; rozszerzenie dotyczące argumentów wydano i wycofano w ciągu jednego dnia (v2.1.257–260). Reguły blokujące Read(...) i Edit(...) dotyczące poleceń Bash obejmują przekierowania wejścia (< file) oraz polecenia odczytujące, takie jak tac i egrep (v2.1.257) — jest to węższa wersja obiecana po wycofaniu w v2.1.233 kontroli przekierowań wejściowych z v2.1.232; ta część pozostaje w mocy. W v2.1.259 tę samą ochronę rozszerzono na ścieżki plików ukryte w wartościach opcji i operandach (argumenty --ignore-revs-file=.env, -f.env, @file, operandy git diff i git grep, złożenia cd DIR && cat FILE, przy czym grep -r/cp -r w katalogu zawierającym zablokowany plik najpierw pytały o zgodę), lecz v2.1.260 wycofała to rozszerzenie następnego dnia: powodowało ono blokowanie npm run build przy regule Read(./**/build/**) w każdym trybie oraz wyświetlanie monitu przez cd ... && grep nawet w trybie auto. Jest to trzecia zmiana kierunku w zakresie obsługi argumentów — v2.1.232 ją wprowadziła, v2.1.233 wycofała, v2.1.257 dodała obowiązujący nadal podzbiór obejmujący przekierowania i polecenia odczytujące, v2.1.259 rozszerzyła go na argumenty, a v2.1.260 wycofała rozszerzenie. Dlatego od v2.1.260 reguły blokujące wykrywają przekierowania i polecenia odczytujące, lecz nie ścieżki ukryte w dowolnych argumentach polecenia — stan ten, ustalony w v2.1.260, nadal obowiązuje; późniejsze zmiany to punktowe poprawki konkretnych obejść, a nie czwarta zmiana kierunku (następny akapit).²¹¹²¹²

Punktowe poprawki po wycofaniu oraz drugie, wąskie wycofanie (v2.1.268–273). Wycofanie obsługi argumentów pozostaje w mocy; poniższe zmiany usuwają konkretne obejścia — przy czym jedną z nich również później cofnięto. v2.1.268: reguły blokujące i pytające dotyczące systemowych katalogów będących dowiązaniami symbolicznymi (/etc, /tmp, /var w macOS; /bin w Linux) obowiązują teraz również wtedy, gdy ścieżkę zapisano przy użyciu jej rzeczywistego położenia, a polecenia Bash nie ignorują już reguł blokujących zapisanych z użyciem ścieżki dowiązania — obie zmiany pozostają w mocy. To samo wydanie sprawiło również, że znajdujące się w tym samym wierszu polecenia env -C, eval lub podobne, których kontroler uprawnień nie potrafi przeanalizować, przestały omijać reguły blokujące Read lub Edit — jednak v2.1.273 wycofała dokładnie tę kontrolę: „polecenia takie jak time -p make build ponownie wyświetlają monit zamiast zostać zablokowane”. v2.1.269: reguły blokujące Edit() i kontrola ścieżki zapisu obejmują teraz plik zapisywany przez polecenie Bash tee; reguła zezwalająca Bash(tee:*) nie obejmuje już miejsc docelowych poza katalogami roboczymi, a reguła blokująca lub pytająca rozpoczynająca się od ! obowiązuje wyłącznie w źródle ustawień, w którym ją zapisano (samotna negacja ! jest ignorowana). v2.1.271 naprawia sam kontroler: plik odczytywany przez fmt, column i podobne polecenia jest sprawdzany nawet wtedy, gdy występuje po opcji nierozpoznawanej przez kontroler; pliki rozwijane przez symbol wieloznaczny są sprawdzane, gdy symbol ten znajduje się we wzorcu lub wartości opcji (na przykład grep -v dir/* file); flagi deklaracji zmiennych powłoki nie mogą już fałszywie przedstawiać wykonywanego polecenia; a polecenia z dwiema zmianami katalogu, podpowłoką lub łańcuchem cd+git nie pomijają już monitu przy permissions.blockReadsOutsideWorkingDirectories w trybach bypass i auto. v2.1.273 łączy wycofanie z trzema własnymi punktowymi poprawkami: niemożliwe do przeanalizowania polecenie Bash nie pomija już monitu przy permissions.blockReadsOutsideWorkingDirectories, podpowłoka ukrywająca niebezpieczne rm nie pomija już potwierdzenia w trybie bypass, a katalog pamięci wskazany przez ustawienia repozytorium nie jest już na ich podstawie wczytywany, przywoływany ani indeksowany. Podsumowując prostą zasadę dla wierszy Bash, których kontroler nie potrafi przeanalizować: reguły blokujące powodują wyświetlenie monitu zamiast odmowy, a blockReadsOutsideWorkingDirectories wyświetla monit zamiast pomijać kontrolę.²¹⁶²¹⁷

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 położenia 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 zapisy w dowolnym katalogu o nazwie src w całym drzewie — między innymi vendor/src/ i packages/foo/src/. Teraz dopasowuje wyłącznie katalog src znajdujący się bezpośrednio w katalogu roboczym. Jeśli wykorzystywano wcześniejsze dopasowanie na dowolnej głębokości, należy zmienić regułę na Edit(**/src/**). Reguły deny i ask zachowują dopasowanie na dowolnej głębokości — zmiana zawęża zakres automatycznego zatwierdzania, nigdy blokowania. Reguła, która po cichu przestała pasować, objawi się po aktualizacji jako nowe prośby o uprawnienia, a nie błąd, dlatego warto sprawdzić wszystkie reguły zezwalające zapisane w postaci jednego segmentu. Warunki if: dla hooks otrzymały w tym wydaniu ten sam zakres cwd (zob. Mechanizmy dopasowujące).¹⁹⁰

Należy używać Edit(path)/Read(path), a nie Write(path)/NotebookEdit(path)/Glob(path) (v2.1.210). Claude Code wyświetla teraz przy uruchomieniu ostrzeżenie dla reguł uprawnień odnoszących się do Write(path), NotebookEdit(path) lub Glob(path). Kanoniczne postacie 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). Aby usunąć ostrzeżenie i jednoznacznie wyrazić intencję, należy przenieść starsze reguły do tych postaci.¹⁸⁷

Opcja „Always allow” zapisuje reguły w katalogu głównym repozytorium (v2.1.211). Reguły uprawnień tworzone za pomocą opcji „Always allow” w monicie są teraz zapisywane w katalogu głównym repozytorium zamiast w bieżącym drzewie roboczym. Zgoda udzielona w jednym drzewie obowiązuje więc między sesjami i we wszystkich drzewach roboczych tego repozytorium — nie trzeba już ponownie zatwierdzać tego samego polecenia w każdym równoległym checkoutcie.¹⁸⁸

Ścieżki z nawiasami i nieprawidłowe wzorce zachowują się bezpiecznie (v2.1.260). Wprowadzono trzy poprawki analizowania reguł uprawnień do plików, z których pierwsza jest poprawką bezpieczeństwa. Reguły Edit/Write/Read, których ścieżka zawierała nawiasy — na przykład grupa tras Next.js Edit(src/app/(admin)/**) — były odrzucane jako nieprawidłowe lub ignorowane przez sandbox Bash, przez co foldery uznawane przez administratora za przeznaczone tylko do odczytu pozostawały zapisywalne; obecnie reguły te obowiązują. Reguła blokująca plik z wzorcem niemożliwym do skompilowania (na przykład z niedomkniętym [) powodowała wcześniej niepowodzenie każdej edycji pliku z błędem Invalid regular expression; obecnie taka reguła chroni dosłownie zapisaną w niej ścieżkę. Ponadto błąd ustawień dla reguły takiej jak Edit(C:\dir\(name)\**), w której \( jest interpretowane jako nawias poprzedzony znakiem ucieczki, a nie separator ścieżki, sugeruje teraz jednoznaczny zapis. To samo wydanie przestaje również po cichu ignorować reguły zawierające tekst po nawiasie zamykającym (Bash(ls) x nigdy niczego nie dopasowywało); są one obecnie zgłaszane jako nieprawidłowe ustawienia.²¹²

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 wieloznacznej mcp__server__*.³² Składnia ta ułatwia szybkie włączanie wszystkich narzędzi z zaufanych serwerów albo blokowanie całych serwerów z niezaufanych źródeł.

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

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

Poza nazwą narzędzia reguła może dopasować jego parametry wejściowe, używając * jako symbolu wieloznacznego wartości:

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

Agent(model:opus) blokuje każdego subagenta uruchamianego w warstwie Opus — blokowane jest samo uruchomienie, a nie tylko prośba zawarta w promptcie, aby go unikać. Rozszerza to kontrolę uprawnień z „które narzędzie” na „w jaki sposób jest wywoływane” i realizuje ją za pomocą deterministycznej reguły zamiast żądania na poziomie promptu. Mechanizm współdziała z zarządzanym ustawieniem enforceAvailableModels: lista dozwolonych wartości określa warstwy modeli dostępne w sesji, a reguły Tool(model:...) ograniczają sposób, w jaki korzystają z nich subagents.¹⁷³

Od v2.1.186 te reguły Agent(...) są egzekwowane także przy uruchamianiu nazwanych subagents: reguły blokujące Agent(agent_type) i ograniczenia dozwolonych typów Agent(x,y) obowiązują przy uruchamianiu konkretnego nazwanego agenta (przez przepływ pracy, --agents lub zespół agentów), a nie tylko anonimowych uruchomień w stylu Task. Uruchomienie zostaje zablokowane od razu, co zamyka lukę pozwalającą nazwanemu agentowi ominąć regułę mającą go ograniczać.¹⁷⁵

Wzorce WebFetch:

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

Od v2.1.268 zwykłe reguły blokujące i pytające WebFetch nie dotyczą już odczytów ani aktualizacji narzędzia Artifact — aby je zablokować lub objąć pytaniem o zgodę, należy zapisać regułę Artifact albo WebFetch(domain:claude.ai).²¹⁶

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 monorepozytoriach oraz wtedy, 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 sandboxie odczytywanie plików poświadczeń i tajnych zmiennych środowiskowych — jest to wielowarstwowa ochrona przed wykradaniem sekretów przez takie polecenia.¹⁷⁶

Od v2.1.221 pliki poświadczeń zyskują trzeci tryb poza zezwalaniem i blokowaniem: mode: "mask" (Linux i WSL). Polecenie wykonywane w sandboxie, które odczytuje taki plik, otrzymuje kopię z wartościami zastępczymi — dotyczy to całego pliku albo wyłącznie fragmentów przechwyconych przez wyrażenie regularne extract — a proxy sandboxa podmienia je na rzeczywiste wartości przy ruchu wychodzącym. Polecenie działa (może uwierzytelnić się przez proxy), mimo że sekret nigdy nie znajduje się w jego środowisku. Jest to dokładnie właściwość pożądana wtedy, gdy polecenie zainfekowane przez prompt szuka tokenów. W macOS, gdzie mechanizm podmiany przez proxy jest niedostępny, mask przechodzi w deny — konfiguracja przygotowana dla CI w Linux zachowuje więc bezpieczeństwo zamiast po cichu ujawniać plik.¹⁹⁹

v2.1.224 rozszerza maskowanie poza statyczną zawartość plików. extract i onExtractNoMatch obsługują strukturalne wartości środowiskowe; decode: "jwt" wraz z maskClaims maskuje wybrane deklaracje wewnątrz JWT zamiast całego tokenu, dzięki czemu polecenie nadal może odczytać metadane routingu tokenu, podczas gdy poufne deklaracje pozostają zastąpione; natomiast awsPairs/sigv4 ponownie podpisują żądania AWS SigV4 na poziomie proxy, co umożliwia w ogóle stosowanie maskowania z CLIs AWS — zamaskowany klucz nie przeszedłby weryfikacji podpisu. Wszystkie te funkcje wymagają network.tlsTerminate i są respektowane wyłącznie w zakresach użytkownika, zarządzanym lub --settings — repozytorium nie może dostarczyć konfiguracji maskowania, która po cichu przekieruje poświadczenia użytkownika.²⁰¹

Od v2.1.216 ustawienie sandbox.filesystem.disabled pomija izolację systemu plików, zachowując kontrolę ruchu wychodzącego z sieci — jest to przydatne, gdy więzienie systemu plików zakłóca działanie narzędzia kompilacji, ale nadal chce się egzekwować listę 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 wykonywane w sandboxie, 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 właściwe ustawienie dla operacji nienadzorowanych — CI, agentów działających w tle czy nocnych pętli — w których monit pozbawiony odbiorcy oznacza przestój, a zasada „zapytaj o nieoczekiwany ruch wychodzący” i tak jest niewłaściwa. Dopeł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 odmowę. ¹⁹⁶ v2.1.229 zaostrza także samą składnię listy domen: literały IPv6 muszą znajdować się w nawiasach kwadratowych ([::1]:443), niejednoznaczne zapisy są obsługiwane zgodnie z zasadą fail-closed, a /doctor je zgłasza.²³⁴ v2.1.236 dodaje kolejne dwa zabezpieczenia: w macOS reguły blokujące odczyt z symbolami wieloznacznymi (np. **/.env) mają teraz pierwszeństwo wewnątrz obszarów dozwolonego odczytu, obejmują zawartość dopasowanych katalogów i nie można ich ominąć przez zmianę nazwy zablokowanego pliku; ponadto przy aktywnym trybie auto reguły zezwalające Monitor są odkładane na bok — polecenia Monitor podlegają takiej samej kontroli klasyfikatora jak polecenia Bash. Sam klasyfikator trybu auto działa teraz z tymi samymi ustawieniami domyślnymi co w Claude API — w tym z klasyfikacją punktowaną według dotkliwości — w Bedrock, Vertex AI i Foundry, a także po wyłączeniu telemetrii.²²³ v2.1.273 zmienia domyślny mechanizm w tych bramach: tryb auto używa tam teraz domyślnie lokalnego klasyfikatora „do odwołania”, a CLAUDE_CODE_AUTO_MODE_SERVER=1 włącza klasyfikator po stronie serwera danej platformy.²¹⁷

allowed_domains dla poszczególnych poleceń w trybie auto (v2.1.271): przy włączonym sandboxie polecenia Bash, PowerShell i Monitor w trybie auto mogą zawierać własne allowed_domains — hosty potrzebne poleceniu są sprawdzane razem z nim i otwierane wyłącznie dla tego polecenia, natomiast pozostałe hosty są odrzucane. Ruch wychodzący przestaje być uprawnieniem obejmującym całą sesję: każde polecenie wskazuje swoje miejsca docelowe, a kontrola obejmuje dokładnie tę parę.²¹⁶

Ścisły tryb sandbox i wyjątek ! (sandbox.allowUnsandboxedCommands, v2.1.260). Ustawienie, którego dotąd nie wymieniono w tym przewodniku: domyślnie polecenie zakończone niepowodzeniem w sandboxie może zostać ponowione poza nim za pomocą mechanizmu awaryjnego dangerouslyDisableSandbox, z uwzględnieniem zwykłego procesu obsługi uprawnień. sandbox.allowUnsandboxedCommands: false — widoczne jako Strict sandbox mode na karcie Overrides polecenia /sandbox — wyłącza ten mechanizm: parametr jest ignorowany, a każde polecenie musi działać w sandboxie albo znajdować się na liście excludedCommands. Od v2.1.260 polecenia wpisywane osobiście w trybie bash wywołanym przez ! działają poza sandboxem nawet w ścisłym trybie sandbox, „jak wpisane we własnym terminalu” — ścisłość określa to, co uruchamia Claude, a nie to, co wpisuje użytkownik. Jeśli model zagrożeń zakładał, że polecenia ! dziedziczą izolację, nie jest to już prawdą.²¹²

W sandboxie: - Dostęp do systemu plików jest ograniczony do katalogu projektu - Dostęp do sieci jest kontrolowany - Niektóre polecenia są wyłączone z ograniczeń sandboxa - Polecenia Bash są automatycznie dozwolone, jeśli autoAllowBashIfSandboxed ma wartość true

Wskazówka ekspercka: Tryb sandbox doskonale sprawdza się podczas uruchamiania Claude w niezaufanych bazach kodu. Warto go włączyć podczas analizowania nieznanych projektów lub gdy potrzebna jest dodatkowa warstwa ochrony. Wewnętrzne testy Anthropic wykazały, że sandbox zmniejsza liczbę próśb o uprawnienia o 84%.³⁸ Sandbox wykorzystuje mechanizmy na poziomie systemu operacyjnego (seatbelt w macOS, bubblewrap w Linux) do izolowania systemu plików i sieci, dzięki czemu nawet skuteczny atak przez prompt pozostaje całkowicie odizolowany. Anthropic udostępnił kod źródłowy środowiska uruchomieniowego sandboxa zespołom tworzącym własnych agentów.⁸²

Uwagi dotyczące bezpieczeństwa (v2.1.34+): Polecenia wyłączone z sandboxa za pomocą sandbox.excludedCommands lub dangerouslyDisableSandbox mogły wcześniej omijać pytającą regułę uprawnień Bash, gdy włączone było autoAllowBashIfSandboxed; naprawiono to w v2.1.34.⁸⁷ Od v2.1.38 zapis w .claude/skills jest blokowany w trybie sandbox, co uniemożliwia atakom przez prompt modyfikowanie definicji skills.⁸⁸ W v2.1.77 dodano ustawienie systemu plików sandboxa allowRead, które ponownie zezwala na odczyt wewnątrz obszarów denyRead — jest to przydatne, gdy chce się zablokować większość drzewa katalogów, ale dodać określone podkatalogi do białej listy.¹¹⁹

Wyjątek konfiguracji agentów .claude/ (v2.1.121+): --dangerously-skip-permissions nie pyta już o zgodę na zapisy w .claude/skills/, .claude/agents/ i .claude/commands/.¹⁵⁴

Rozwiązywanie zagnieżdżonych katalogów .claude/ (v2.1.178): Skills w zagnieżdżonych katalogach .claude/skills są teraz ładowane automatycznie podczas pracy z plikami znajdującymi się w danym katalogu, a nie tylko 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 powierzchni projektu są rozwiązywane w ten sam sposób — gdy nazwa agenta, przepływu pracy lub stylu wyjściowego koliduje między zagnieżdżonymi katalogami .claude/, pierwszeństwo ma element najbliższy katalogowi roboczemu, a zapis przepływu pracy w zakresie projektu trafia do najbliższego istniejącego katalogu .claude/workflows/. W monorepozytorium lub repozytorium zawierającym inne repozytoria zapewnia to narzędzia specyficzne dla pakietów, które aktywują się kontekstowo zamiast tworzyć jedną płaską powierzchnię globalną.¹⁷³

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 albo organizacja dostarcza własne, wzmocnione wersje.¹⁶⁰

Wzmocnienia bezpieczeństwa w v2.1.113:¹⁵⁰

• sandbox.network.deniedDomains blokuje określone hosty nawet wtedy, gdy szerszy symbol wieloznaczny allowedDomains normalnie by na nie zezwalał. Lista blokad pozwala odciąć serwisy wklejania tekstu, serwisy udostępniania 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ć odrzucane bez 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 mechanizmy wykonawcze. Reguły takie jak Bash(rm:*) wykrywają teraz env rm -rf, sudo rm -rf i pokrewne sposoby obejścia.
• 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 zwykłą ścieżką obsługi 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 miejsca docelowe usuwania. /var, /etc i /tmp są dowiązaniami symbolicznymi prowadzącymi do /private/, dlatego poprzednia postać reguły nie obejmowała kanonicznych miejsc docelowych.

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

W jednym wydaniu usunięto szereg luk w kontroli uprawnień, konsekwentnie stosując zasadę fail-closed — gdy analizator nie może uzyskać pewności, wyświetla monit:

• Naprawiono obejście w Windows PowerShell 5.1. Polecenia uruchamiane w sesjach PowerShell 5.1 mogły wcześniej wymykać się kontroli uprawnień.
• Przekierowania deskryptorów plików Bash działają zgodnie z zasadą fail-closed. Formy przekierowań analizowane przez bash inaczej niż przez analizator uprawnień powodują teraz wyświetlenie monitu zamiast uruchomienia.
• Polecenia dłuższe niż 10 000 znaków zawsze powodują wyświetlenie monitu. Bardzo długie polecenia były wcześniej błędnie oceniane; obecnie nigdy nie są uruchamiane automatycznie.
• Indeksy dolne i modyfikatory zsh w [[ ]] powodują wyświetlenie monitu. Indeksy dolne i modyfikatory zmiennych wewnątrz porównań [[ ]] traktowano jako tekst bierny; mogą wykonywać kod, dlatego obecnie wymagają zatwierdzenia.
• Niebezpieczne warianty help/man nie są już zatwierdzane automatycznie. Niektóre wywołania mogły uruchamiać niebezpieczne opcje, podstawienia poleceń lub ścieżki ze znakami odwrotnego ukośnika pod pozorem odczytywania dokumentacji.
• Kolejność monitów w sesjach zdalnych. Monity o uprawnienia w sesjach zdalnych nie mogą już przechodzić dalej przed lokalnym oknem dialogowym potwierdzenia.
• Flagi przekierowujące demona docker powodują wyświetlenie monitu. Polecenia docker (w tym shim docker narzędzia Podman) zawierające --url, --connection, --identity lub tryb zdalny Podman działały wcześniej bez monitu — flagi te wskazują poleceniu zupełnie innego demona.
• file traci bezpłatne uprawnienie tylko do odczytu, gdy wskazano mu miejsce zapisu. file -m/--magic-file oraz -f/--files-from wymagają teraz uprawnienia zamiast automatycznego zatwierdzenia jako operacje tylko do odczytu.

Jak działają hooks?

Hooks wykonują deterministyczne polecenia powłoki w określonych momentach przepływu pracy Claude Code. W przeciwieństwie do instruowania Claude, aby wykonał określone działania, hooks gwarantują 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 lub uznać zmianę za „zbyt małą”. Hooks gwarantują wykonanie: każda operacja Edit lub Write uruchamia formatter — za każdym razem, bez wyjątków. W obszarze zgodności, bezpieczeństwa i standardów zespołowych rozwiązania deterministyczne są lepsze od probabilistycznych.⁴

Dostępne zdarzenia