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

TL;DR: Claude Code to agentowy CLI, który odczytuje bazę kodu, uruchamia polecenia i edytuje pliki, a jego działaniem zarządza pięć systemów: konfiguracja, uprawnienia, hooks, MCP oraz subagents. Wszystko, co musi być uruchamiane za każdym razem, należy realizować za pomocą hooks, a nie promptów.

Aktualny stan (CLI v2.1.292, 6 października 2026; wersje npm latest i next to 2.1.292, a stable to 2.1.285):²³⁴

• Domyślny model: Claude Opus 5.5 (claude-opus-5-5) w planach Pro, Max, Team i Enterprise, w ramach Anthropic API, a także na Claude Platform w AWS, Amazon Bedrock oraz Agent Platform od Google Cloud. Wyjątkiem jest Microsoft Foundry: domyślnie korzysta z Sonnet 4.5, a alias opus oznacza Opus 4.6.²²¹
• Opus 5.5 w skrócie: 4/20 USD za milion tokenów, odczyty z cache kosztujące 0,20 USD, kontekst 1M domyślnie w ramach Anthropic API, a od wersji v2.1.287 również w Bedrock, Agent Platform i Foundry, domyślny poziom wysiłku medium oraz rozumowanie, którego nie można wyłączyć. Tryb szybki uruchamia go w cenie 8/40 USD. Sonnet 5.5 (2/10 USD; sonnet w ramach Anthropic API od wersji v2.1.284) jest tańszym wyborem, gdy zadanie nie wymaga modelu Opus.^{220222223228232}
• Tryb Auto jest początkowym trybem uprawnień dla interaktywnych sesji terminala i VS Code we wszystkich planach i u wszystkich dostawców (v2.1.283–284), a także dla sesji claude -p i Python Agent SDK u zewnętrznych dostawców lub przy wyłączonej telemetrii (v2.1.285); pozostałe sesje -p i SDK rozpoczynają się w trybie Manual. Kontrole bezpieczeństwa są wykonywane na serwerze bezpłatnie dla kont Enterprise i Claude API, na Claude Platform w AWS, Bedrock, Agent Platform i Foundry oraz przez bramy, natomiast płatne kontrole lokalne stanowią rozwiązanie zapasowe.^{219227228229230}
• AGENTS.md: od wersji v2.1.277 plik AGENTS.md jest odczytywany jako instrukcje projektu, jeśli projekt nie zawiera pliku CLAUDE.md. Nie dotyczy to sytuacji, w których flagi funkcji nie są pobierane (np. w Bedrock), ani pierwszej sesji po instalacji lub uaktualnieniu.²¹⁹²²³

Historia poszczególnych wydań znajduje się w dzienniku zmian.

Claude Code działa jako system agentowy, a nie interfejs czatu wyposażony w 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 stanu na luty 2026 roku Claude Code jest autorem 4% publicznych commitów w GitHub (około 135 000 dziennie) — oznacza to wzrost 42 896-krotny w ciągu 13 miesięcy od wersji research preview — a 90% własnego kodu Anthropic zostało napisane przez AI.¹⁰³

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

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

Najważniejsze wnioski

• O skuteczności decyduje pięć systemów: hierarchia konfiguracji, uprawnienia, hooks, MCP oraz subagents kontrolują wszystko — od zachowania po automatyzację.
• Warto przenosić zadania do warstwy delegowania: subagents zapobiegają przepełnianiu kontekstu, izolując eksplorację w czystych oknach kontekstowych i zwracając wyłącznie podsumowania.
• Hooks gwarantują wykonanie, a prompty nie: hooks należy stosować do lintowania, formatowania i kontroli bezpieczeństwa, które muszą być uruchamiane za każdym razem, niezależnie od zachowania modelu.
• Podział modeli na poziomy obniża koszty bez utraty jakości: eksplorację wykonywaną przez subagents warto kierować do tańszych modeli, a Opus zarezerwować dla zadań rzeczywiście wymagających rozumowania architektonicznego — albo ujednolicić pracę na modelu Opus, jeśli jedynym kryterium jest jakość.
• MCP łączy Claude ze stosowanym zestawem narzędzi: bazy danych, GitHub, Sentry oraz 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, potokach CI/CD i wdrożeniach korporacyjnych. Ten przewodnik przekłada zdobyte doświadczenie na kompletne źródło wiedzy, którego brakowało mi na początku. Każda funkcja została opisana z użyciem rzeczywistej składni, praktycznych przykładów konfiguracji oraz przypadków brzegowych, które sprawiają trudności nawet doświadczonym użytkownikom.

Proszę wybrać ścieżkę

Jak korzystać z tego przewodnika

To dokumentacja licząca ponad 5 000 wierszy — nie trzeba czytać jej od początku do końca. Najlepiej zacząć od miejsca odpowiadającego poziomowi doświadczenia:

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

Powiązane szczegółowe omówienia

Poniższe wpisy na blogu szczegółowo analizują 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 oraz aktywnego połączenia z internetem.⁹² Najlepszą zgodność zapewniają powłoki Bash, Zsh i Fish.

W systemie Windows działają zarówno WSL 1, jak i WSL 2. Jeśli preferowane jest natywne środowisko 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

Instalacja, aktualizacja i odinstalowanie w skrócie

Szybki przegląd — wszystkie metody, wszystkie polecenia i sprawdzanie wersji na jednym ekranie. Poniższe podsekcje opisują szczegóły poszczególnych metod oraz rozwiązywanie problemów.

Od wersji v2.1.113 kanoniczny CLI uruchamia natywny plik binarny Claude Code za pośrednictwem opcjonalnej zależności właściwej dla danej platformy, zamiast dołączonego JavaScript — w przypadku testowanej dystrybucji należy używać instalatora natywnego. Metoda npm nadal działa, ale wyświetla komunikat o wycofywaniu, wprowadzony po raz pierwszy w wersji v2.1.15.

Metody instalacji

Instalacja natywna (zalecana)

Natywny plik binarny zapewnia najprostsze środowisko 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

Jedna wersja, której nigdy nie należy przypinać za serwerem proxy ani bramą: 2.1.275. W tej kompilacji każde żądanie kończy się błędem 400 ... Input tag 'advisor_20260301', gdy ANTHROPIC_BASE_URL wskazuje serwer proxy lub bramę; wersja 2.1.276 naprawia tę regresję.²¹⁸

Instalacja przez NPM (wycofywana)

Uwaga: Od wersji v2.1.15 instalacje npm wyświetlają komunikat o wycofywaniu. Zalecaną metodą instalacji jest obecnie 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 nigdy nie należy używać sudo. Powoduje to problemy z uprawnieniami, które komplikują wszystkie kolejne działania.

Migracja z istniejącej instalacji

Starszą instalację opartą na npm można przenieść na natywny plik binarny:

claude install

Opcje uwierzytelniania

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

Konsola Claude (rozliczenia API)

Można połączyć się bezpośrednio z usługą API firmy Anthropic za pośrednictwem platform.claude.com (wcześniej console.anthropic.com). Należy utworzyć konto, skonfigurować rozliczenia i uwierzytelnić się przez CLI. Konsola oferuje rozliczenia zależne od użycia oraz pełny dostęp do API. Automatycznie tworzony jest dedykowany obszar roboczy „Claude Code”; nie można utworzyć dla niego kluczy API, ale można monitorować użycie. Od wersji v2.1.243 opcja /login → Konsola Anthropic udostępnia również ścieżkę bez klucza — „Zaloguj się za pomocą konta Konsoli” (zalecane) — obok możliwości utworzenia klucza API. Dzięki temu organizacje, które nie zezwalają na klucze API, mogą nadal logować się przy użyciu danych dostępowych do Konsoli.²⁵⁰

Subskrypcja Claude Pro lub Max

Należy użyć danych logowania do konta claude.ai. Subskrypcja obejmuje zarówno interfejs internetowy, jak i korzystanie z CLI w ramach jednego miesięcznego planu. 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 z wykorzystaniem istniejących rozliczeń chmurowych. Kreator konfiguracji Bedrock (v2.1.92+): interaktywny kreator na ekranie logowania prowadzi przez uwierzytelnianie AWS, wybór regionu, weryfikację danych dostępowych i przypinanie modelu.¹³⁷ Kreator konfiguracji Vertex AI (v2.1.98+): analogiczny kreator dla Google Cloud prowadzi przez uwierzytelnianie GCP, konfigurację projektu i regionu, weryfikację danych dostępowych oraz przypinanie modelu.¹⁴² Vertex AI mTLS Workload Identity Federation (v2.1.121+): Vertex AI obsługuje teraz Workload Identity Federation opartą na certyfikatach X.509 (mTLS Application Default Credentials) — krótkoterminowe 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 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): Claude Code może dodawać nagłówki żądań, których brama LLM może używać do routingu i obserwacji — x-claude-code-request-class, x-claude-code-agent-type, x-claude-code-prev-tool-durations, x-claude-code-compaction, x-claude-code-context-compacted oraz, od wersji v2.1.283, x-claude-code-prompt-id, czyli losowy UUID wspólny dla każdego żądania obsługującego jeden prompt użytkownika, w tym dla tur subagents.²¹⁷²²⁶ W przypadku niestandardowego bazowego adresu URL lub zewnętrznego dostawcy, takiego jak Bedrock, nagłówki pozostają wyłączone do czasu ustawienia CLAUDE_CODE_GATEWAY_HINT_HEADERS=1. Dokumentacja protokołu bramy podaje również, że bezpośrednie połączenie z API firmy Anthropic wysyła je domyślnie, natomiast CLAUDE_CODE_GATEWAY_HINT_HEADERS=0 wyłącza je dla każdego połączenia.²²⁷

Weryfikacja

claude doctor

Polecenie wyświetla 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 configDirectory — katalog konfiguracyjny, z którego faktycznie korzysta CLI. Jest to przydatne, gdy pośrednie wskazanie przez CLAUDE_CONFIG_DIR powoduje niejednoznaczność.²¹⁶

Od wersji v2.1.273 logowanie za pomocą konta Claude żąda również dostępu do plugins powiązanych z kontem claude.ai.²¹⁷

Od wersji v2.1.286 polecenie claude auth status zgłasza zapisany klucz API używany do logowania w Konsoli jako api_key, a nie 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 oraz okresowo w trakcie sesji. Aktualizacje są pobierane w tle i stosowane przy następnym uruchomieniu.

Aby wyłączyć aktualizacje automatyczne:

export DISABLE_AUTOUPDATER=1

Lub w pliku settings.json:

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

Aktualizacja ręczna:

claude update

Odinstalowanie

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 odczytu, wykonania i wyświetlania wyników:

cd your-project
claude

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

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

claude "explain the authentication flow in this project"

Wskazówka ekspercka: REPL zachowuje stan między operacjami 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ć własne instrukcje określające, co należy zachować.

Tryb nieinteraktywny

Tryb wyświetlania (-p) wykonuje pojedyncze zapytanie, a następnie kończy działanie:

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

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

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

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

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

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

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

Do przetwarzania strumieniowych danych wyjściowych w czasie rzeczywistym:

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

Opcje formatu danych wyjściowych:

Tekst subagents w stream-json (v2.1.211+): Domyślnie dane wyjściowe stream-json zawierają wyłącznie zdarzenia sesji głównej — praca wykonana wewnątrz subagents jest przedstawiana w formie podsumowania. Flaga --forward-subagent-text (lub CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1) przekazuje do strumienia również tekst i tok rozumowania subagents, dzięki czemu środowiska testowe i potoki rejestrowania mogą obserwować delegowaną pracę na bieżąco, zamiast widzieć jedynie 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. Obecnie w przekazywanym strumieniu pojawiają się także subagents utworzone na głębokości 2 i większej — każde z nich jest identyfikowane za pomocą identyfikatora tool_use wywołania Agent, które je utworzyło. Dzięki temu potok może odtworzyć drzewo delegowania zamiast wyświetlać płaską listę tekstu. Zmiana ta bezpośrednio uzupełnia przywrócone w tym samym wydaniu domyślne zagnieżdżone tworzenie na głębokości 3: bez niej dwa z trzech poziomów pozostałyby niewidoczne.¹⁹⁶

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

Zawieszone wykonanie -p kończy się teraz błędem (v2.1.277): Sesje claude -p i Agent SDK, w których wystąpił błąd wewnętrzny, mogły wcześniej zawiesić się bez wyniku — był to najgorszy możliwy tryb awarii potoku, ponieważ wykonanie kończyło się dopiero po upłynięciu zewnętrznego limitu czasu. Teraz zgłaszają błąd i kończą działanie z kodem 1, dzięki czemu poniższa tabela kodów zakończenia ponownie opisuje pełny kontrakt. To samo wydanie sprawia również, że sesje headless zapisują przy zakończeniu łączne koszty i wykorzystanie: wznowienie headless (claude -p --resume, SDK, ponowne wczytanie okna rozszerzenia VS Code) nie rozpoczyna już naliczania wartości sesji od zera, dzięki czemu rozliczanie kosztów wznowionych wykonań headless nie zaniża ich zużycia.²¹⁹

Kody zakończenia:

Sterowanie zachowaniem agentycznym 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+); only CLI-named MCP servers (v2.1.286)
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+): Opcja --restricted (lub CLAUDE_CODE_RESTRICTED=1) jest przeznaczona dla środowisk testowych uruchamiających claude na współdzielonej maszynie. Usuwa wbudowane narzędzia wykonujące polecenia lub kod oraz WebFetch, chyba że zostaną wskazane pojedynczo w --tools — ustawienie wstępne default się nie liczy — 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 odmawia tworzenia sesji w chmurze.²⁰⁶²⁰⁹

--permission-prompts none (v2.1.259): opcja uzupełniająca dla hostów bez nadzoru. Wszystko, co wywołałoby monit o uprawnienia, jest automatycznie odrzucane, natomiast aktywny tryb uprawnień — w tym tryb automatyczny — nadal samodzielnie podejmuje wszystkie możliwe decyzje. Nie należy mylić tej opcji z --permission-prompt-tool, która deleguje monity do narzędzia MCP, zamiast je odrzucać. Dokumentacja CLI nie zawiera 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 — polecenie cd wykonane w jednej turze obowiązuje 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 natomiast ponowne generowanie promptu systemowego dla każdego żądania — jest to przełącznik przydatny podczas iteracyjnego dopracowywania treści promptu, gdy każde wykonanie powinno uwzględniać najnowszą zmianę zamiast migawki, kosztem stabilności pamięci podręcznej promptu, którą migawka ma chronić.²¹⁶

--bare przestrzega swoich ograniczeń (v2.1.286): Opcja --bare łączy się teraz wyłącznie z serwerami MCP wskazanymi w wierszu poleceń, nie wysyła modelowi żadnych przypomnień systemowych i nie uruchamia zadań w tle; polecenie powłoki, które osiągnie limit czasu, zatrzymuje się zamiast przechodzić do tła. Dokumentacja trybu headless informuje, że przed wersją v2.1.286 ograniczenia te obowiązywały tylko częściowo, i zaleca stosowanie --bare w wywołaniach skryptowych oraz SDK.²³¹²³³

Wzorzec integracji z CI/CD:

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

Zarządzanie sesjami

Sesje zachowują historię rozmowy, aby można było ją kontynuować. Trwałość sesji jest niezbędna w przypadku 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"

# Open the Claude desktop app on this directory, or on a session (v2.1.285)
claude --desktop
claude --desktop --continue

Przenoszenie aktywnej sesji za pomocą /cd (v2.1.169+; natychmiastowe zastosowanie konfiguracji od v2.1.246): Polecenie /cd path zmienia katalog roboczy bez naruszania pamięci podręcznej promptu. Od wersji v2.1.246 ustawienia projektu, hooks, serwery z .mcp.json (po standardowym monicie o zatwierdzenie), skills i agenci 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 konkretnym pull requestem lub merge requestem. Od wersji v2.1.119 opcja --from-pr akceptuje — oprócz adresów github.com — także 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ą także automatycznie wiązane z PR, gdy zostaną one utworzone 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 przeglądu kodu dzięki ustawieniu prUrlTemplate (v2.1.119+) — jest to przydatne, gdy zespół łączy PR z osobnym narzędziem do przeglądu.¹⁵²

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

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

# 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: Opcja --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 tworzy sesję w tle, a /subtask jest rozwidleniem w ramach 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, podczas gdy sesja główna będzie kontynuowana. Poprzednie zachowanie — rozwidlenie w ramach bieżącej sesji — jest nadal dostępne pod nową nazwą /subtask.¹⁸⁹ Od wersji v2.1.214 sesja uruchomiona jako rozwidlenie zgłasza źródło hook SessionStart jako "fork" (wcześniej "resume"), dzięki czemu hooks dopasowujące źródło mogą je rozróżnić.¹⁹⁰ Wersja v2.1.216 skraca potwierdzenie /fork do jednego wiersza zawierającego nazwę nowej sesji oraz jej identyfikator claude attach.¹⁹² Od wersji v2.1.221 rozwidlona sesja tworzy własny worktree, zamiast pracować w kopii roboczej pierwotnej sesji — rozwidlenie badające alternatywne rozwiązanie nie może już kolidować z niezatwierdzonymi plikami sesji głównej, co wcześniej stanowiło istotne ryzyko podczas wysyłania kopii do eksperymentowania.¹⁹⁹ W wersji v2.1.232 rozwidlanie staje się domyślne również dla subagents: subagent typu subagent_type: "fork" dziedziczy pełną rozmowę i pamięć podręczną promptu, a agenci niebędący członkami zespołu, utworzeni w sesjach interaktywnych, domyślnie działają teraz w tle.²⁵⁵

Claude Code przechowuje sesje jako transkrypcje JSONL. Wykonanie Agent przypisuje unikatowe wartości agentId, a transkrypcje są zapisywane jako agent-{agentId}.jsonl. Wznowienie zachowuje pełny kontekst wcześniejszych 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 trzy opcje: - „Tak, wyczyść kontekst i automatycznie akceptuj zmiany” (Shift+Tab) — rozpoczyna od nowa z pełnym kontekstem planu - „Tak, i ręcznie zatwierdzaj zmiany” — zachowuje kontekst; każda zmiana wymaga zatwierdzenia - „Tak, automatycznie akceptuj zmiany” — zachowuje kontekst; Claude wykonuje plan bez zatwierdzania każdej zmiany

Automatyczne czyszczenie kontekstu po zatwierdzeniu jest zalecanym sposobem pracy. Zapewnia planowi świeże okno kontekstu, co znacznie 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 - Refaktoryzacje obejmujące wiele plików, gdy najpierw warto zweryfikować podejście - Nieznane bazy kodu, w których eksploracja powinna poprzedzać modyfikacje - Każde zadanie, dla którego istnieje kilka prawidłowych rozwiązań i potrzebna jest możliwość wniesienia uwag

Wskazówka ekspercka: Im więcej czasu poświęci się na tryb planowania, tym większa szansa, że Claude pomyślnie zrealizuje implementację. Tryb planowania zapewnia w praktyce bezpłatną eksplorację — bez ryzykownych wywołań narzędzi i zmarnowanych edycji. Warto korzystać z niego często.

Tryb czytnika ekranu (v2.1.208)

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

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

# Environment variable
export CLAUDE_AX_SCREEN_READER=1

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

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

Bez pauzy przed każdym wierszem (v2.1.287): Tryb czytnika ekranu zapisuje teraz nowe lub zmienione wiersze bez wcześniejszego zatrzymywania kursora na początku wiersza. CLAUDE_AX_PREPARK_MS określa tę pauzę w milisekundach; jej domyślna wartość wynosi teraz 0 (wcześniej 50), dlatego aby ją przywrócić, należy ustawić CLAUDE_AX_PREPARK_MS=50. To samo wydanie usuwa również szereg problemów z czytnikami ekranu, w tym umieszczanie kursora z dala od wpisywanego tekstu w polach wyszukiwania oraz pomijanie zmienionych wierszy w monitach o zatwierdzenie edycji.²³²²³³

Szczegółowe omówienie systemu konfiguracji

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

Hierarchia konfiguracji

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

Od wersji v2.1.181 polecenie /config key=value umożliwia ustawienie dowolnej opcji bezpośrednio z poziomu promptu — na przykład /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ą teraz wybrane ustawienie, natomiast Esc zapisuje zmiany i zamyka interfejs (wcześniej przywracał poprzednie ustawienia).¹⁷⁴

Pełna dokumentacja settings.json

Pełna konfiguracja przedstawiająca wszystkie najważniejsze 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"
  },
  "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": {
    "claude-opus-5-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-prod",
    "claude-sonnet-5": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/sonnet-prod"
  },
  "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. Opcja off ukrywa skill zarówno przed modelem, jak i w selektorze poleceń ukośnikowych, user-invocable-only pozwala nadal wywoływać go po nazwie, jednocześnie wykluczając go z wyboru dokonywanego przez model, a name-only pozostawia widoczną wyłącznie nazwę skill bez jego pełnego opisu.¹⁵⁶

Nowsze ustawienia (v2.1.174–176):

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

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

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

Nowsze ustawienia (v2.1.217):

• emojiCompletionEnabled (v2.1.217): automatyczne uzupełnianie skrótów emoji w polu promptu — wpisanie :heart: wstawia ❤️, a częściowy skrót, taki jak :hea, wyświetla sugestie. Funkcja jest domyślnie włączona; aby ją wyłączyć, należy ustawić false.¹⁹⁴

Nowsze ustawienia (v2.1.219):

• sandbox.network.strictAllowlist (v2.1.219): odrzucanie hostów spoza listy dozwolonych dla poleceń uruchamianych w sandboxie bez wyświetlania pytania, zamiast otwierania okna dialogowego uprawnień. Zob. Tryb sandbox.¹⁹⁶
• workflowSizeGuideline (v2.1.219): umożliwia ustawienie zalecanego rozmiaru Dynamic workflow z dowolnego pliku ustawień — użytkownika, projektu lub zarządzanego — a nie wyłącznie poprzez /config. W przypadku Dynamic workflows domyślnie obowiązuje wytyczna medium („należy dążyć do używania mniej niż 15 agentów”); wiersz /config zostaje ukryty, gdy wartość pochodzi z pliku ustawień. 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 i opisanej etykietami listy modeli. Jest to obiekt z tablicą options (każdy wiersz zawiera wymagane pole model oraz opcjonalne pola label i description; wartość model jest pobierana dosłownie, dlatego działają aliasy, identyfikatory Anthropic oraz identyfikatory Bedrock/Vertex/Foundry/bramy) i opcjonalną wartością logiczną replaceBuiltInOptions (false, czyli wartość domyślna, dodaje wiersze po wbudowanej liście; true wyświetla tylko zdefiniowane wiersze, Default oraz model, na którym działa już sesja). Claude Code odczytuje ten klucz z ustawień zarządzanych, --settings oraz ustawień użytkownika, ignorując go w ustawieniach projektu i lokalnych, dzięki czemu sklonowane repozytorium nie może zmienić etykiet w selektorze; całkowity skład listy pochodzi ze źródła o najwyższym priorytecie, w którym ustawiono ten klucz. Lista dozwolonych availableModels nadal obowiązuje w każdym wierszu, a etykieta zmienia jedynie sposób prezentacji modelu w selektorze, nie zaś uruchamiany model.²⁵⁰²⁴⁸
• promptCacheTtl / subagentPromptCacheTtl (dowolny plik, v2.1.242+): wartość "5m" lub "1h" dla każdego koszyka żądań, dzięki czemu użytkownicy korzystający z klucza API i dostawców chmurowych mogą zachować jednogodzinną pamięć podręczną głównej rozmowy, podczas gdy subagents nadal korzystają z pięciominutowej. Zob. Strategie buforowania.²⁵⁰²⁴⁸
• modelPricing (zarządzane, v2.1.243+): uzgodnione w umowie stawki organizacji dla poszczególnych modeli oraz mnożnik rabatu, używane przez /cost, wiersz stanu i dane telemetryczne dotyczące kosztów 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 przejrzeć i wysłać za pomocą /feedback; to ustawienie pozwala wyłączyć tworzenie wersji roboczych. Więcej informacji znajduje się w wierszu /feedback w sekcji Polecenia slash.²⁴⁵ - Rozszerzenie struktury spinnerTipsOverride (v2.1.247): wpisy wskazówek mogą mieć teraz postać obiektów {id, text, cooldownSessions, priority} lub zwykłych ciągów tekstowych, a obiekt zyskuje klucze tipsFile i label, dzięki czemu organizacje mogą cyklicznie wyświetlać własne wskazówki obok wbudowanych (powyższy przykład przedstawia rozszerzoną strukturę). Dokumentacja ustawień opisuje teraz nowe klucze.²⁴⁵²²⁷

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ą przechowywaniem danych.²⁰⁶
• Ograniczenia projektu dotyczące env (v2.1.251): blok env na poziomie projektu w pliku .claude/settings.json 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ć miejsca, w którym 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 — zegara zakończenia tury oraz znaczników czasu w transkrypcji. timeFormat przyjmuje format 12-godzinny, 24-godzinny, 24-godzinny UTC lub jawny wzorzec strftime; timeZone wskazuje strefę czasową.²¹¹ Dokumentacja ustawień opisuje teraz oba klucze.²²⁷
• permissions.blockReadsOutsideWorkingDirectories (v2.1.257): całkowicie odrzuca odczyt plików spoza katalogów roboczych sesji. Bez tego ustawienia tryb automatyczny pyta teraz o zgodę raz, przed pierwszym takim odczytem w danej sesji (zob. Tryb automatyczny).²¹¹ Wersja v2.1.273 usuwa dwie luki: polecenie Bash, którego mechanizm sprawdzający nie jest w stanie w pełni przeanalizować, wywołuje pytanie zamiast pominięcia kontroli, a katalog pamięci wybrany w ustawieniach repozytorium nie jest przy tym ustawieniu ładowany, przywoływany ani indeksowany.²¹⁷
• managedMcpServers / managedSourcesBehavior: klucze zakresu zarządzanego, omówione w sekcji Wdrożenie w przedsiębiorstwie — dotyczą serwerów MCP udostępnianych przez organizacje 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 działającego w tle), które Claude otrzymuje bezpośrednio, zanim pozostała część zostanie zapisana do pliku — maksymalnie do 128K znaków. Jest to mechanizm odmienny od zmiennej środowiskowej BASH_MAX_OUTPUT_LENGTH, która określa zakres ponownego odczytu z roboczego pliku wyjściowego polecenia (domyślnie 30 000 znaków, maksymalnie 150 000): te klucze wyznaczają próg między wynikiem przekazywanym bezpośrednio a zapisywanym w trwałym pliku — po jego przekroczeniu wynik trafia do pliku, który Claude może odczytać na żądanie, zamiast zostać obcięty.²¹⁴ Od wersji v2.1.265 ograniczenie obowiązuje również po stronie zapisu: wyniki narzędzi zapisywane na dysku mają limit 1 GB, a podgląd w rozmowie informuje o obcięciu zapisanego pliku.²¹⁵ Część dotycząca zadań została wycofana w wersji v2.1.277: usunięto przestarzałe narzędzie TaskOutput — Claude odczytuje plik wyjściowy zadania działającego w tle za pomocą Read — a taskOutputMaxChars i TASK_MAX_OUTPUT_LENGTH nie mają już żadnego działania. Zmiana nie wpływa na bashOutputMaxChars.²¹⁹

Nowsze ustawienia (v2.1.267-269):

• maxEffortLevel (v2.1.267): ogranicza poziom wysiłku, który mogą wybrać użytkownicy — globalnie lub osobno dla poszczególnych modeli w modelSettings — i obowiązuje u każdego dostawcy, w tym Bedrock, Vertex i Foundry. Nadal można 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ć rzeczywisty rezultat edycji wykonanej na przykład za pomocą sed.²¹⁶

Nowsze ustawienia (v2.1.275):

• syncClaudeAiSkills / syncClaudeAiPlugins (v2.1.275): skills i plugins włączone na koncie claude.ai są teraz synchronizowane z sesjami terminala zalogowanymi na to konto. Ustawienie dowolnego z tych kluczy na false sprawia, że sesje terminala korzystają wyłącznie z lokalnych skills i plugins. Zob. Skills oraz System plugins.²¹⁸

Nowsze ustawienia (v2.1.282-283):

• maxProseWidth (v2.1.282): ogranicza szerokość tekstu pisanego przez Claude w szerokim terminalu. Akapity, nagłówki, listy i cytaty blokowe są zawijane do podanej liczby kolumn, natomiast tabele i bloki kodu zachowują pełną szerokość. Wartość musi być całkowitą liczbą kolumn wynoszącą co najmniej 40.²²⁵²²⁷
• deniedModels / availableModelsMatch (zarządzane, v2.1.283): deniedModels blokuje określone modele, nawet jeśli zezwala na nie availableModels. Alias rodziny, taki jak "opus", blokuje całą rodzinę, a "claude-opus-5" blokuje również Opus 5.5 (aby zablokować wyłącznie Opus 5, należy wpisać "claude-opus-5-0"). Domyślnie wpis w availableModels, taki jak "claude-opus-5", zezwala także na późniejsze wersje stanowiące jego rozszerzenie; availableModelsMatch: "exact" sprawia, że każdy wpis zezwala wyłącznie na wskazaną w nim wersję, dlatego nowe wydanie pozostaje zablokowane do czasu dodania go do listy. Claude Code odczytuje oba klucze wyłącznie z ustawień zarządzanych.²²⁶²²⁷
• allowClaudeInChromeWithManagedMcp (zarządzane, v2.1.282): umożliwia działanie claude --chrome równolegle z wyłącznym plikiem managed-mcp.json; komunikat błędu wyświetlany po zablokowaniu Chrome wskazuje teraz ten klucz.²²⁵ Dokumentacja ustawień opisuje już tę opcję: klucz jest odczytywany wyłącznie z własnych ustawień zarządzanych urządzenia, a wpis claude-in-chrome w deniedMcpServers nadal blokuje serwer.²³³

Nowsze ustawienia (v2.1.285):

• allowedProviders (zarządzane, v2.1.285): ogranicza dostawców API, z których może korzystać urządzenie: Anthropic API, niestandardowy punkt końcowy, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform on AWS lub bramę Cloud.²²⁹ Dokumentacja ustawień opisuje ten klucz; lista pochodząca z własnych źródeł administracyjnych urządzenia nadal obowiązuje, gdy ustawienia zarządzane przez serwer również dostarczają taką listę, dlatego sesja może korzystać wyłącznie z dostawców obecnych na obu listach.²³³

Wyszukiwanie ustawień: najczęściej szukane flagi

Jeśli szuka Pan/Pani konkretnego ustawienia według nazwy, poniżej znajduje się skrócony indeks. Każdy wpis wskazuje wydanie, w którym ustawienie zostało wprowadzone, a jeśli należy ono do określonego zakresu — również 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-5         # Model new sessions START on; a /model pick overrides + persists (v2.1.236)
ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5    # What the `opus` alias resolves to (Opus 5.5 since v2.1.280; Opus 5 v2.1.219-278)
ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001  # pin the haiku alias; on the Anthropic API it resolves to Haiku 5.5 (claude-haiku-5-5) as of v2.1.293[^274][^275]
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 usług chmurowych:

CLAUDE_CODE_USE_BEDROCK=1                       # Use AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1                        # Use Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1                       # Use Microsoft Foundry
ANTHROPIC_BEDROCK_BASE_URL=https://...          # Custom Bedrock endpoint
ANTHROPIC_BEDROCK_SERVICE_TIER=priority         # Bedrock service tier (v2.1.122+): 'default', 'flex', or 'priority'; sent as X-Amzn-Bedrock-Service-Tier header[^162]
CLAUDE_CODE_SKIP_BEDROCK_AUTH=1                 # Skip Bedrock auth (for gateways)
CLAUDE_CODE_SKIP_VERTEX_AUTH=1                  # Skip Vertex auth
AWS_BEARER_TOKEN_BEDROCK=token                  # Bedrock bearer token
VERTEX_REGION_CLAUDE_3_7_SONNET=us-west1        # Override Vertex region
VERTEX_REGION_CLAUDE_HAIKU_5_5=us-east5          # Vertex region for Claude Haiku 5.5 (v2.1.293+)[^276]
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 the x-claude-code-* hint headers (request-class, agent-type, prev-tool-durations, compaction, context-compacted, and prompt-id from v2.1.283) through a gateway or third-party provider; a direct Anthropic API connection sends them by default, and =0 stops them everywhere (v2.1.273+)[^253][^262][^263]
CLAUDE_CODE_AUTO_MODE_SERVER=0                  # Opt out of the server-side auto-mode checks, the default since v2.1.278 for Enterprise and Claude API accounts, Claude Platform on AWS, Bedrock, Agent Platform, Foundry, and gateways (not charged when the server performs them; =1 was the v2.1.273-277 opt-in); also applies on a direct Anthropic API connection since v2.1.281, where server-side is the default with telemetry off since v2.1.282; the docs call it temporary[^253][^255][^259][^260][^261]

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_DISABLE_WEB_FETCH=1                 # Turn off the WebFetch tool; WebSearch stays available (v2.1.285+)[^265][^269]
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES=2      # Cap re-sends of a non-streaming fallback request that timed out (v2.1.285+)[^265]
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS=5000 # Starting delay of the exponential backoff between retries of a 529 overloaded request, default 500; whole milliseconds from 500 to 32000; no effect with CLAUDE_CODE_RETRY_WATCHDOG=1 or in fast mode (v2.1.292+)[^272][^276]
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=60000 # Longer maximum delay for that backoff (v2.1.296; release-notes only as of 2026-10-11)[^274]
CLAUDE_CODE_RETRY_WATCHDOG=1                     # Unattended sessions: retry 429 and 529 capacity errors indefinitely, backing off up to 5 minutes or until the limit resets (v2.1.186+)[^276]
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS=1800000   # Cap, per request, on how long the watchdog waits out 429 and 529 errors; unset means no limit (v2.1.295+)[^274][^276]
CLAUDE_CODE_RESTRICTED=1                        # Restricted mode: no command/code tools or WebFetch unless named in --tools; only managed settings load (v2.1.248+)[^238]
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1      # Keep the dangerous-rm prompt waiting in auto mode and --dangerously-skip-permissions instead of denying after 2 minutes (v2.1.281+)[^260]
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1    # Skip the prompt for a recursive rm whose target is only command-substitution output, such as rm -rf "$(pwd)" (v2.1.281+)[^260]
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+). Since v2.1.290 an interactive session's budget refills instead of ending at 200 (next line); the env-vars docs, fetched Oct 6, still describe the 200 cap[^206][^271][^273]
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR=100     # WebSearch budget refill rate: 100 calls/hour by default in an interactive session, 0 (off) in a non-interactive one (v2.1.290+)[^271][^276]
CLAUDE_CODE_DISABLE_ATTACHMENTS=1               # Send @-mentions as plain text instead of expanding file content; a repo's .claude/settings.json or settings.local.json can no longer set it (v2.1.290)[^271][^273]
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_WORKFLOW_SUBAGENT_MODEL=sonnet         # Run every workflow agent on one model while other subagents keep theirs (v2.1.296; release-notes only as of 2026-10-11)[^274]
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_MAX_MCP_DESCRIPTION_LENGTH=8192     # Override the cap on MCP tool descriptions and server instructions, every server in the session: 4,096 chars since v2.1.296, 2,048 in v2.1.280-295[^256][^274]
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_MCP_STARTUP_WAIT_MS=10000           # Bound how long the FIRST non-interactive turn waits for still-connecting MCP servers; 0 = don't wait (v2.1.274+)[^254]
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

Limit czasu poleceń działających w tle (v2.1.285, zawężony w v2.1.288): polecenia Bash i PowerShell działające w tle są zatrzymywane po upływie limitu czasu określonego przez ich parametr timeout, gdy są uruchamiane z run_in_background (domyślnie 30 minut, maksymalnie 2 godziny), a Claude otrzymuje powiadomienie o ich zatrzymaniu.²²⁹ Od wersji v2.1.288 limit obowiązuje wyłącznie w sesjach bez nadzoru (-p, Agent SDK, CI oraz sesjach w chmurze); w terminalu, aplikacji desktopowej i sesjach VS Code polecenia działające w tle nie podlegają limitowi. Potwierdza to dokumentacja narzędzi: „Przed wersją v2.1.288 obowiązywał on w każdej sesji”.²³⁴²³⁷

Sieć i proxy:

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

Interfejs użytkownika i terminal:

CLAUDE_CODE_DISABLE_TERMINAL_TITLE=1            # Don't update terminal title
CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1             # Skip IDE extension install
CLAUDE_CODE_SHELL=/bin/zsh                      # Override shell detection
USE_BUILTIN_RIPGREP=1                           # Use included ripgrep (default)
CLAUDE_CONFIG_DIR=~/.myconfig                   # Custom config directory; 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); also the opt-out for the v2.1.287 1M default on Bedrock/Vertex/Foundry/Claude apps gateway[^103][^217][^268]
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]
CLAUDE_AX_PREPARK_MS=50                       # Screen reader mode: pause before writing a changed line; default 0 since v2.1.287 (was 50)[^268][^269]
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 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; v2.1.290 also skips the startup connection warm-up[^271]

Ustawienia projektu nie mogą włączać telemetrii (v2.1.282): pliki ustawień projektu i ustawień lokalnych ignorują teraz zmienne OpenTelemetry, które włączają eksport, ustawiają jego punkt końcowy lub rejestrują treść, takie jak CLAUDE_CODE_ENABLE_TELEMETRY, selektory eksportera OTEL_*_EXPORTER oraz OTEL_LOG_*. Wartości, które coś wyłączają (none dla selektora eksportera, 0 dla flagi treści), nadal są stosowane z tych plików. Pozostałe należy ustawić w powłoce, ustawieniach użytkownika lub ustawieniach zarządzanych. Gdy plik projektu ustawia którąś z tych zmiennych, podczas uruchamiania sesji interaktywnej wyświetlane jest powiadomienie, a /status i claude doctor pokazują listę ignorowanych nazw; w sesjach -p i Agent SDK powiadomienie nie jest wyświetlane, dlatego po aktualizacji warto sprawdzić, czy kolektor nadal odbiera dane.²²⁵²²⁷

Atrybuty spanów żądań LLM od wersji v2.1.121: na spanach żądań LLM emitowane są teraz atrybuty stop_reason, gen_ai.response.finish_reasons i user_system_prompt. Atrybut user_system_prompt jest dostępny wyłącznie po ustawieniu OTEL_LOG_USER_PROMPTS=1, ponieważ może zawierać dane osobowe.¹⁵⁴

Zmiany na poziomie zdarzeń od wersji v2.1.122: atrybuty liczbowe zdarzeń dziennika api_request i api_error są teraz emitowane jako liczby (wcześniej jako ciągi znaków), co rozwiązuje problemy z kolektorami OTel wymagającymi ścisłej zgodności typów ze schematem. Nowe zdarzenie dziennika claude_code.at_mention jest wyzwalane, gdy Claude Code rozpoznaje wzmiankę @.¹⁵⁴

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, kontrolowane przez OTEL_LOG_ASSISTANT_RESPONSES. Mechanizm ten wiąże się z istotną pułapką podczas aktualizacji: jeśli OTEL_LOG_ASSISTANT_RESPONSES nie jest ustawione, dziedziczy zachowanie OTEL_LOG_USER_PROMPTS, przez co każde wdrożenie, które już rejestruje treść promptów, po aktualizacji zacznie otrzymywać także 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, umożliwiające korelację na poziomie wiadomości oraz identyfikowanie pochodzenia narzędzi; ładunek subagentStatusLine obejmuje poziom intensywności rozumowania subagenta, dzięki czemu niestandardowe wiersze stanu mogą wyświetlać jednocześnie model i ten poziom; natomiast nowa zmienna środowiskowa CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH pozwala konfigurować limit 60 KB, po którego przekroczeniu atrybuty treści OTel są skracane.¹⁹⁰

Telemetria bramy w wersji v2.1.265: sesje bramy aplikacji Claude eksportują teraz dane OpenTelemetry bezpośrednio do kolektora, gdy w zarządzanych ustawieniach bramy wskazano go za pomocą OTEL_EXPORTER_OTLP_ENDPOINT, zamiast przesyłać je przez przekaźnik bramy; sesje bez wskazanego kolektora nadal korzystają z przekaźnika. W tej samej wersji do telemetrii wysyłanej przez Claude Desktop i Cowork za pośrednictwem bramy aplikacji Claude dodano user.email oraz user.groups, ujednolicając ją z telemetrią sesji terminalowych.²¹⁵

Telemetria hooks w wersji v2.1.280: zdarzenie OTel hook_execution_complete zawiera teraz rozmiary danych wyjściowych hooka oraz liczbę zbyt dużych wyników zapisanych w pliku.²²⁰

prompt_text w wersji v2.1.287: zdarzenie user_prompt zawiera teraz prompt_text, czyli kopię prompt przeznaczoną dla backendów, które zagnieżdżają klucze z kropkami. W każdym miejscu, w którym potok usuwa lub maskuje prompt, należy postąpić tak samo z prompt_text.²³²

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+); a Read call with allow_large can pass it when the context has room (v2.1.296+)[^274][^276]
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1   # Do not fall back to non-streaming API on streaming failures (v2.1.83+)
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1      # Stop sending structured outputs, for Mantle or gateways that reject them; session titles, memory recall, and prompt hooks failed there before (v2.1.288+)[^270][^273]
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+)
MCP_SDK_GENERATION=v1                         # Opt out of the v2 MCP client; v2.1.274 made v2 the default on the last holdouts (Bedrock/Vertex/Foundry + telemetry-disabled installs)[^254]
MCP_PROTOCOL_NEGOTIATION=legacy               # Opt out of MCP 2026-07-28 protocol negotiation: with direct HTTP servers (default everywhere as of v2.1.274) and, since v2.1.292, with local (stdio) servers on every install, Bedrock, Vertex, and Foundry included[^254][^272]

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 ma istotny wpływ zarówno na koszt, jak i jakość. Claude Code umożliwia elastyczne przełączanie modeli na wielu poziomach.

Dostępne modele

Claude Sonnet 5.5 (28 września 2026): Domyślny model Sonnet w Anthropic API od wersji v2.1.284, która kieruje do niego alias sonnet; domyślnym modelem we wszystkich planach pozostaje Opus 5.5. Identyfikator modelu: claude-sonnet-5-5 (Bedrock: anthropic.claude-sonnet-5-5). $2/MTok za wejście, $10/MTok za wyjście, czyli tyle samo co w przypadku Sonnet 5; odczyty z cache kosztują $0.10/MTok (0,05-krotności ceny wejścia zgodnie ze stroną cennika, czyli tyle samo co w Opus 5.5; wersja v2.1.296 koryguje własne wartości kosztów w Claude Code, które wcześniej wynosiły $0.20). Okno kontekstu 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). Graniczna data wiarygodnej wiedzy: czerwiec 2026, tak samo jak w Opus 5.5 i Fable 5.1. Wycofanie nastąpi nie wcześniej niż 28 września 2027. W Claude Code domyślna wartość effort dla Sonnet 5.5 to medium (w samym Claude API wartością domyślną jest high), a myślenia nie można wyłączyć. Mechanizm awaryjny oparty na treści: żądanie oznaczone jako dotyczące cyberbezpieczeństwa jest ponownie wykonywane przez Sonnet 5, natomiast żądanie oznaczone jako biologiczne kończy się odmową, ponieważ Sonnet 5.5 nie ma awaryjnego modelu dla biologii. Wymaga Claude Code w wersji v2.1.284 lub nowszej; aby pozostać przy Sonnet 5, należy przypiąć ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5.²²⁸²³⁰

Strona modelu wymienia 5 zmian niezgodnych wstecznie dotyczących kodu API przenoszonego z Sonnet 5: myślenie przed rozpoczęciem działania jest wyłączone przy użyciu between_tools, wymuszone użycie narzędzia zwraca błąd, bloki myślenia są powiązane z modelem i konwersacją, computer_20251124 nie jest akceptowane w Claude API ani Google Cloud, a narzędzie doradcze odrzuca Opus 4.8, Opus 4.7 i Sonnet 5 jako doradców. Tekst między wywołaniami narzędzi również wraca w blokach thinking, dlatego interfejs przesyłający go strumieniowo przestaje go wyświetlać do czasu ustawienia wartości display, która zwraca ten tekst.²³⁰

Claude Opus 5.5 (22 września 2026): Nowy domyślny model Opus w Claude Code od wersji v2.1.280 — a zgodnie z tabelą dokumentacji konfiguracji modeli, podzieloną według planów, także domyślny model we wszystkich planach i u wszystkich dostawców własnych: Pro, Max, Team, Enterprise, Anthropic API, Claude Platform on AWS, Amazon Bedrock oraz Google Cloud’s Agent Platform (Microsoft Foundry pozostaje przy Sonnet 4.5, a jego alias opus wskazuje Opus 4.6). Ta sama wersja zmienia domyślny model w planach Pro i Team Standard z Sonnet na Opus, „zrównując je z Max, Team Premium i Enterprise” — kończąc podział między planami, który obowiązywał od czasu przejścia warstwy premium na Opus. Identyfikator modelu: claude-opus-5-5 (Bedrock: anthropic.claude-opus-5-5) — przypięta migawka bez daty, zgodna ze schematem claude-opus-5. Ceny spadają poniżej poziomu Opus 5: $4/MTok za wejście, $20/MTok za wyjście (Opus 5: $5/$25), przy czym odczyty z cache kosztują $0.20/MTok — 5% ceny wejścia, czyli połowę standardowych 10% (niższa stawka obowiązuje wyłącznie w Fable 5.1 i Mythos 5.1 — 2,5%). Okno kontekstu 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). Adaptacyjne myślenie zawsze włączone — tabela przeglądu modeli określa je tak samo jak w Fable: „Adaptacyjne (zawsze włączone)”, w odróżnieniu od Opus 5, gdzie było domyślnie włączone, ale możliwe do wyłączenia. Domyślna wartość effort to medium (w Opus 5 wartością domyślną było high), a wersja v2.1.280 odpowiednio zmienia regułę przenoszenia ustawień: poziom wysiłku zapisany przed przypisaniem /effort do poszczególnych modeli nie jest już stosowany do nowo wydanych modeli, takich jak Opus 5.5 — model rozpoczyna pracę z własną wartością domyślną, dopóki nie zostanie wybrany inny poziom. Graniczna data wiarygodnej wiedzy: czerwiec 2026 (dane treningowe również z czerwca 2026), co daje mu ex aequo z Fable 5.1 najnowszą wiedzę spośród wszystkich obecnych modeli. Wycofanie nastąpi nie wcześniej niż 22 września 2027. Wymaga Claude Code w wersji v2.1.280 lub nowszej.²²⁰²²¹

Zmiany niezgodne wstecznie przy przenoszeniu kodu API z Opus 5 do Opus 5.5:²²²

1. Myślenia nie można wyłączyć. Zarówno thinking: {type: "disabled"}, jak i thinking: {type: "enabled", budget_tokens: N} zwracają błąd 400. Należy usunąć pole thinking i zamiast niego wybrać poziom wysiłku.
2. Wymuszone użycie narzędzia zwraca błąd. tool_choice przyjmuje wyłącznie auto i none; wartości any i tool zwracają błąd 400, także w punkcie końcowym zliczania tokenów. Należy użyć auto wraz ze ścisłym użyciem narzędzi lub ustrukturyzowanymi danymi wyjściowymi.
3. Bloki myślenia są powiązane z modelem. Router lub mechanizm awaryjny, który przenosi konwersację z Opus 5.5 do innego modelu, wykonuje te tury bez bloków myślenia Opus 5.5 (wyjątkiem są Fable 5.1 i Mythos 5.1 w Claude API).
4. computer_20251124 jest odrzucane w Claude API i Google Cloud. Zamiast niego należy zadeklarować zestaw narzędzi computer_toolset_20260801; Bedrock zachowuje starsze narzędzie. Jeszcze jedna zmiana nie powoduje odrzucenia żadnego żądania, ale zmienia kształt odpowiedzi: tekst generowany przez model między wywołaniami narzędzi wraca w blokach thinking, które przy domyślnym ustawieniu display są puste. Interfejs przesyłający tę narrację strumieniowo milknie, dopóki nie ustawi display: "updates" (beta) lub "summarized".²²²

Awaryjny wybór modelu na podstawie treści w Claude Code. Opus 5.5 działa z klasyfikatorami bezpieczeństwa, które najczęściej oznaczają treści biologiczne i dotyczące cyberbezpieczeństwa. Gdy jeden z nich oznaczy żądanie, Claude Code ponownie uruchamia je na innym modelu i wyświetla powiadomienie: żądania oznaczone jako biologiczne trafiają do Opus 5, żądania dotyczące cyberbezpieczeństwa — do Opus 4.8, a sesja pozostaje na modelu awaryjnym do czasu powrotu za pomocą /model. Aby zamiast tego za każdym razem otrzymywać pytanie, należy wyłączyć opcję Przełączaj modele, gdy wiadomość zostanie oznaczona w /config (switchModelsOnFlag: false).²²³ Od wersji v2.1.287 przełączenie zachowuje bieżący poziom wysiłku zamiast domyślnego poziomu modelu awaryjnego, więc sesja korzystająca z domyślnego dla Opus 5.5 poziomu medium pozostaje na medium po przejściu na Opus 4.8, którego domyślnym poziomem jest high.²³²²³³

Claude Opus 5 (lipiec 2026; poprzedni poziom Opus): Poziom Opus oraz model wskazywany przez alias opus od wersji v2.1.219 (24 lipca 2026) do czasu, gdy w v2.1.280 domyślnym modelem Opus został Opus 5.5; poniżej przedstawiono stan z jego premiery w lipcu 2026. Anthropic opisuje go jako bezpośredni zamiennik Opus 4.8: ta sama cena — 5 USD/MTok za dane wejściowe i 25 USD/MTok za dane wyjściowe, „znacznie lepsza wydajność w tej samej cenie” oraz średnio około 26% mniej tokenów przy maksymalnym poziomie rozumowania niż w Opus 4.8. Był domyślnym modelem w planie Claude Max i najmocniejszym modelem w planie Claude Pro. Identyfikator modelu: claude-opus-5 — przypięta migawka bez daty, według tego samego schematu co claude-opus-4-8 i claude-sonnet-5, a nie wskaźnik zawsze kierujący do najnowszej wersji. Okno kontekstu liczące 1M tokenów (bez nagłówka beta, bez zmian względem Opus 4.8), maksymalnie 128K tokenów wyjściowych (do 300K w Batches API z nagłówkiem beta output-300k-2026-03-24). Wyłącznie adaptacyjne thinking — rozszerzone thinking z thinking.type: "enabled" nie jest obsługiwane. Wiarygodna granica wiedzy: maj 2026 (granica danych treningowych również przypada na maj 2026) — od premiery była najnowsza spośród wszystkich ówczesnych modeli Claude, aż 1 września 2026 pojawił się Fable 5.1 (z granicą wiedzy przypadającą na czerwiec 2026).²⁴¹ Wraz z premierą Opus 5 model Opus 4.8 trafia w dokumentacji do tabeli Legacy models obok wersji 4.7 i 4.6 — nadal jest dostępny, ale nie stanowi już zalecanego wyboru domyślnego.¹⁹⁷

Dwie zmiany niekompatybilne wstecznie podczas przenoszenia harnessu z Opus 4.8 do Opus 5:¹⁹⁷

1. Thinking jest domyślnie włączone. W Opus 4.8 żądanie bez pola thinking działało bez thinking; w Opus 5 to samo żądanie działa z adaptacyjnym thinking. max_tokens nadal stanowi sztywny limit całych danych wyjściowych — thinking wraz z tekstem odpowiedzi — dlatego należy ponownie sprawdzić dostępny zapas w każdym obciążeniu, które wcześniej działało bez thinking. Aby przywrócić poprzednie zachowanie, należy przekazać thinking: {type: "disabled"}, z zastrzeżeniem opisanym w następnym punkcie.
2. Po wyłączeniu thinking 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 — podniesienie poziomu wysiłku do xhigh przy wyłączonym thinking zostanie odrzucone, nawet jeśli wcześniejsze tury tej samej rozmowy zostały zaakceptowane.

W samym Claude Code: domyślnym poziomem effort w Opus 5 jest high (tak samo jak w Claude API), a dostępna jest pełna skala — low, medium, high, xhigh, max. W swoich wskazówkach dotyczących migracji Anthropic zaleca przetestowanie poziomu wysiłku max tam, gdzie możliwości są ważniejsze niż zużycie tokenów. Fast mode obejmuje Opus 5 w cenie 10/50 USD za MTok (zob. Fast Mode).¹⁹⁷¹⁹⁸

Claude Fable 5.1 (1 września 2026): Nowy najwyższy model poziomu Fable oraz — od wersji v2.1.257 — model wskazywany przez alias fable (chyba że ANTHROPIC_DEFAULT_FABLE_MODEL przypina inny); best oznacza teraz „najnowszy model Fable dostępny dla danego użytkownika”. Minimalna wymagana wersja wymaga wyjaśnienia: dokumentacja konfiguracji modeli podaje, że alias zmienił się w v2.1.255, a strona modelu informuje, że Fable 5.1 „wymaga Claude Code v2.1.255 lub nowszej”, lecz wersje 2.1.253–256 nigdy nie zostały opublikowane w npm — v2.1.257 (1 września) jest pierwszą możliwą do zainstalowania wersją, która go zawiera. Identyfikator modelu: claude-fable-5-1 (Bedrock: anthropic.claude-fable-5-1). Ten sam poziom i cena za token co w Fable 5 — 10 USD/MTok za dane wejściowe, 50 USD/MTok za dane wyjściowe, kontekst 1M, maksymalnie 128K tokenów wyjściowych, zawsze włączone adaptacyjne thinking oraz domyślny poziom effort ustawiony na high — z jedną zmianą cenową istotną dla długich sesji agentowych: odczyty z cache kosztują 0,25 USD/MTok, czyli 0,025 ceny danych wejściowych (2,5%), zamiast standardowych 10%; stawka ta dotyczy wyłącznie Fable 5.1 i Mythos 5.1, natomiast zapisy do cache zachowują standardowe ceny (12,50 USD za 5 minut, 20 USD za 1 godzinę). Wiarygodna granica wiedzy: czerwiec 2026 (dane treningowe również do czerwca 2026) — najnowsza spośród wszystkich obecnych modeli Claude, wyrównana przez Opus 5.5 (granica wiedzy: czerwiec 2026) 22 września 2026 oraz Sonnet 5.5 28 września. Wycofanie nastąpi nie wcześniej niż 1 września 2027.

Trzy zmiany niekompatybilne wstecznie względem Fable 5: wymuszone użycie narzędzia zwraca błąd, wcześniejsze modele nie mogą odczytywać jego bloków thinking, a edycja wcześniejszych tur unieważnia bloki thinking. Pięć zmian rozszerzających możliwości: poziom wysiłku ustawiany dla poszczególnych wiadomości (beta), komunikaty systemowe obowiązujące w ramach tury (beta), aktualizacje postępu między wywołaniami narzędzi (display: "updates", beta), tańsze odczyty z cache oraz pochodzenie treści. Claude Mythos 5.1 jest tym samym modelem o identycznej specyfikacji, dostępnym wyłącznie na zaproszenie w ramach Project Glasswing. Wraz z premierą Fable 5 trafia w dokumentacji do tabeli Legacy models obok Opus 4.8/4.7/4.6/4.5 oraz Sonnet 4.6/4.5.

Jedno zastrzeżenie dotyczące gateway z informacji o wydaniu: w sesjach gateway aplikacji Claude aliasy fable i best nadal wskazują obecnie Fable 5 — gateway, który nie został jeszcze skonfigurowany do obsługi wersji 5.1, odrzuca ją — dlatego należy tam jawnie wybrać Fable 5.1 w /model; warto pamiętać, że przed wersją v2.1.260 selektor /model nie wyświetlał Fable 5.1, więc jego jawny wybór wymagał wpisania pełnego polecenia /model claude-fable-5-1 (zob. poprawki z okresu premiery poniżej). Domyślne modele w planach w chwili premiery: Opus 5 w planach premium, Sonnet 5 w planach Pro i Team Standard — zastąpione przez wprowadzony w v2.1.280 domyślny Opus 5.5 we wszystkich planach (22 września 2026).^211241242221

Poprawki z okresu premiery 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 w organizacjach, które mogą z niego korzystać — przed tą poprawką model był akceptowany wyłącznie po wpisaniu pełnego polecenia /model claude-fable-5-1. Cache promptów w Fable 5.1 obejmuje teraz kontekst dołączony po wynikach narzędzi, który wcześniej był ponownie przesyłany jako dane wejściowe niepochodzące z cache przy każdej turze z wywołaniem narzędzia — po cichu niwecząc korzyści ekonomiczne odczytów z cache w cenie 0,025 właśnie w tych długich sesjach agentowych, dla których ta stawka została wprowadzona. Zmiana /effort w trakcie sesji nie unieważnia już cache promptu. Ponadto agenci z ustawieniem model: fable respektują teraz znacznik [1m] w przypięciu ANTHROPIC_DEFAULT_FABLE_MODEL, zamiast bez ostrzeżenia działać z oknem kontekstu 200K.²¹²

Claude Fable 5 (9 czerwca 2026; Legacy od 1 września 2026): Nowy poziom modelu powyżej Opus — najmocniejszy i najinteligentniejszy model Anthropic, osiągający najnowocześniejsze wyniki w niemal każdym benchmarku, w którym go przetestowano, i zaprojektowany tak, aby zachowywać spójność w obrębie milionów tokenów kontekstu. Fable 5 to frontier model klasy „Mythos”, zabezpieczony do użytku ogólnego: jest wyposażony w klasyfikatory bezpieczeństwa, które w przypadku zapytań dotyczących cyberbezpieczeństwa, biologii i chemii oraz destylacji modeli przełączają obsługę na Opus 4.8 (Claude Mythos 5 jest tym samym modelem bez tych zabezpieczeń, przeznaczonym dla upoważnionych badaczy). Możliwość jego wyboru 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 v2.1.257 wskazuje Fable 5.1 — obecnie Fable 5 należy wybrać za pomocą /model claude-fable-5) — po czym do 22 czerwca 2026 został udostępniony we wszystkich planach subskrypcyjnych (wdrożenie zakończone). Identyfikator modelu: claude-fable-5. Fable 5 domyślnie obejmuje 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 do claude-fable-5 przez usunięcie sufiksu (miał on znaczenie wyłącznie w przypadku Opus/Sonnet, w których dostęp do kontekstu 1M wymaga [1m]); maksymalnie 128K tokenów wyjściowych. Cena wynosi 10 USD/MTok za dane wejściowe i 50 USD/MTok za dane wyjściowe — około 2 razy więcej niż w Opus 4.8 — dlatego warto zarezerwować go do naprawdę trudnych zadań wymagających rozumowania, a nie do rutynowych edycji. Korzysta z tego samego interfejsu żądań co Opus 4.8 (wyłącznie adaptacyjne thinking; usunięto temperature/top_p/top_k oraz budget_tokens), z jednym nowym szczegółem: jawne ustawienie thinking: {type: "disabled"} zwraca błąd 400, dlatego aby uruchomić model bez thinking, należy całkowicie pominąć parametr thinking.²⁶¹ Konkretnie w Claude Code: Fable 5 obsługuje pełną skalę wysiłku (low/medium/high/xhigh/max, domyślnie high), podobnie jak Opus 5. W Fable 5 nie można wyłączyć rozumowania — przełącznik rozumowania w 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 przypina model, na który wskazuje alias fable (co jest przydatne w Bedrock/Vertex/Foundry), DISABLE_PROMPT_CACHING_FABLE wyłącza pamięć podręczną promptów dla Fable, a automatyczne przełączanie awaryjne na podstawie treści działa w bramach korporacyjnych. /model opus wybiera teraz Opus 5.5 (v2.1.280; domyślnie wysiłek medium, a /effort xhigh do najtrudniejszych zadań), a ustawienie domyślne nie zależy już od planu — Opus 5.5 jest domyślnym modelem w każdym planie obsługiwanym przez Anthropic, z wyjątkiem Microsoft Foundry; gdy potrzebny jest absolutnie najwyższy poziom możliwości, należy świadomie wybrać wariant Fable za pomocą /model fable — od v2.1.257 oznacza to Fable 5.1.^{261197207242220221}

Opus 4.7 (16 kwietnia 2026): Flagowy model poprzedniej generacji, nadal w pełni dostępny. Okno kontekstu 1M tokenów w standardowej cenie — bez dopłaty za długi kontekst. Maksymalnie 128K tokenów wyjściowych, wyłącznie rozumowanie adaptacyjne (rozszerzone rozumowanie usunięto) oraz nowy poziom wysiłku xhigh, zalecany jako punkt wyjścia do programowania i zadań agentowych.¹⁴⁵ Wiarygodna granica 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 USD/25 USD za MTok, zapis w 5-minutowej pamięci podręcznej kosztuje 6,25 USD, zapis w 1-godzinnej pamięci podręcznej 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, osiąga 70% w CursorBench (wobec 58% dla wersji 4.6) i zwiększa skuteczność rozwiązywania o 13% w wewnętrznym benchmarku programistycznym Anthropic obejmującym 93 zadania.¹⁴⁴ Korzysta z nowego tokenizatora — dla tego samego tekstu należy oczekiwać około 1–1,35 raza większej liczby tokenów; warto zwiększyć zapas max_tokens i progi wyzwalające kompakcję.¹⁴⁵ Funkcja rozpoznawania obrazu obsługuje obrazy o rozdzielczości do 2576 px / 3,75 MP ze współrzędnymi pikseli w skali 1:1.¹⁴⁵

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

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

Od v2.1.280 (22 września 2026) podział według planów już nie obowiązuje: każdy plan obsługiwany przez Anthropic i każdy dostawca własny domyślnie korzysta z Opus 5.5, a jedynym wyjątkiem pozostaje Microsoft Foundry. Wiersz, który wcześniej miał tu największe znaczenie — „z jakiego planu korzystam?” — nie zmienia już odpowiedzi.

Zmiany niekompatybilne w Messages API dla Opus 4.7 (widoczne dla wywołującego):¹⁴⁵

• Usunięto budget_tokens dla rozszerzonego rozumowania. Zamiast tego należy użyć thinking: {type: "adaptive"}. Rozumowanie adaptacyjne jest domyślnie wyłączone; żądania bez pola thinking są wykonywane bez rozumowania.
• 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ść rozumowania 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 treść rozumowania).

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

Opus 4.6 (starsza wersja): Nadal dostępny jako claude-opus-4-6, z kontekstem 1M i maksymalnie 128K tokenów wyjściowych. Ze względu na lepsze możliwości programowania agentowego warto rozważyć migrację do Opus 4.7. Opus 4.6 pierwotnie wydano 5 lutego 2026.⁷⁹¹⁴⁴ Od v2.1.117 (22 kwietnia 2026) subskrybenci planów Pro i Max domyślnie korzystają z wysiłku high w Opus 4.6 i Sonnet 4.6 (wcześniej medium); w Opus 4.7 pozostaje xhigh. Ta zmiana przywróciła poziom inteligencji po obniżeniu wysiłku w okresie od 4 marca do 7 kwietnia, opisanym w analizie awarii z 23 kwietnia.¹⁵²¹⁵³

Sonnet 5 (30 czerwca 2026; poprzedni wariant Sonnet): Model wybierany przez alias sonnet w Anthropic API od v2.1.197 do czasu, gdy v2.1.284 zmieniła go na Sonnet 5.5. W chwili premiery Anthropic przedstawiał go 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, a względem Sonnet 4.6 zapewnia znaczną poprawę w zakresie rozumowania agentowego, używania narzędzi, programowania i pracy z wiedzą — jednocześnie wykazując ogólnie niższy odsetek niepożądanych zachowań oraz znacznie słabsze zdolności w obszarze cyberbezpieczeństwa niż modele Opus (był to kompromis w zakresie bezpieczeństwa, który umożliwił wydanie modelu bez ograniczeń eksportowych). Identyfikator modelu: claude-sonnet-5 (przypięta migawka bez daty). Okno kontekstu 1M tokenów, maksymalnie 128K tokenów wyjściowych (do 300K w Batches API z nagłówkiem beta output-300k-2026-03-24), wyłącznie rozumowanie adaptacyjne. Wiarygodna granica wiedzy: styczeń 2026. Cena: 2 USD/10 USD za MTok danych wejściowych/wyjściowych, obecnie jako standardowa cena katalogowa. W chwili premiery Anthropic ogłosił stawkę 2 USD/10 USD jako cenę promocyjną obowiązującą do 31 sierpnia 2026, a następnie ją utrzymał: strona z cennikiem podaje, że zaplanowana na 1 września podwyżka do 3 USD/15 USD „nie nastąpi”, zaś v2.1.243 zaktualizowała selektor /model i dołączony skill claude-api, aby pokazywały stawkę 2 USD/10 USD jako cenę katalogową, a nie ograniczoną czasowo promocję.²⁵¹ To o 50% mniej niż 4 USD/20 USD w przypadku Opus 5.5 (i o 60% mniej niż 5 USD/25 USD, które kosztował Opus 5). W Claude Code parametr effort ma dla Sonnet 5 domyślną wartość high (aby ją zmienić, należy ustawić ją jawnie). Model można wybrać za pomocą /model claude-sonnet-5.¹⁸⁰²³⁰

v2.1.197 (30 czerwca 2026) ustanowiła Sonnet 5 domyślnym modelem w Claude Code dla nowych sesji w tamtym okresie; model pozostał w standardowym wariancie (Pro, Team Standard) do v2.1.280, która 22 września 2026 przeniosła te plany na Opus. Sonnet 5 nie jest już domyślnym modelem żadnego planu w Claude Code, a od v2.1.284 /model sonnet wybiera zamiast niego Sonnet 5.5 w Anthropic API; aby pozostać przy Sonnet 5, należy użyć /model claude-sonnet-5 lub ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5. Zob. powyższą tabelę planów.^{181207220221228}

Sonnet 4.6 (17 lutego 2026, obecnie zastąpiony przez Sonnet 5): Zrównoważony model; 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 USD/15 USD za MTok). Lepsza wydajność wyszukiwania agentowego przy mniejszym zużyciu tokenów. Obsługuje rozszerzone rozumowanie, rozumowanie adaptacyjne oraz okno kontekstu 1M tokenów (beta). Maksymalnie 64K tokenów wyjściowych (górna granica 128K w v2.1.77).¹¹⁹ Granica wiedzy: sierpień 2025 (wiarygodna), styczeń 2026 (dane treningowe). Identyfikator modelu: claude-sonnet-4-6. Claude Mythos Preview (7 kwietnia 2026): Model graniczny w wersji badawczej, przeznaczony do prac nad cyberbezpieczeństwem defensywnym i oferowany w ramach Project Glasswing.¹³⁹ Dostępny wyłącznie na zaproszenie; nie jest powszechnie udostępniany. Anthropic przedstawia Opus 4.7 jako celowo mniej zaawansowany od Mythos pod względem możliwości cybernetycznych — jest to kompromis służący bezpieczeństwu — oraz uruchomił 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 50K–200K tokenów wejściowych i 10K–50K tokenów wyjściowych. Przy stawkach Haiku 5.5 dla promptów do 100K tokenów koszt wynosi około 0,01–0,05 USD za sesję. W przypadku Opus 5.5 ze stawkami 4/20 USD ta sama sesja kosztuje 0,40–1,80 USD, czyli około 40 razy więcej (przed uwzględnieniem rabatów za buforowanie promptów). W zadaniach, które nie wymagają Opus, warto używać Sonnet lub Haiku.¹²²²

Kiedy używać poszczególnych modeli

Haiku: Warto używać go dla subagents wykonujących rozpoznanie, proste wyszukiwanie plików i odpowiadających na krótkie pytania. Przy stawkach dla promptów do 100K tokenów jest około 40 razy tańszy niż Opus 5.5 (8 razy w przypadku promptu przekraczającego 100K) i szybciej odpowiada. Doskonale sprawdza się w zadaniach wykonywanych w tle, które nie wymagają głębokiego rozumowania.

Sonnet: Model do codziennej pracy programistycznej, gdy koszt ma znaczenie — Sonnet 5.5 w Anthropic API od wersji v2.1.284, w tej samej cenie 2/10 USD co Sonnet 5²²⁸ — a ponieważ w wersji v2.1.280 plany Pro i Team Standard przeszły na Opus, nie jest już domyślnym modelem w żadnym planie (natywny kontekst 1M, standardowa cena katalogowa 2/10 USD za MTok; planowaną podwyżkę z 1 września odwołano).^181251207220 To właśnie tę zmianę należy tutaj uwzględnić: Sonnet jest teraz modelem, który trzeba wybrać, a uzasadnienie tego wyboru sprowadza się do rachunku kosztów — przy takim samym kontekście 1M koszt tokena jest o połowę niższy niż w Opus 5.5. Radzi sobie z większością zadań programistycznych: implementowaniem funkcji, naprawianiem błędów, pisaniem testów i przeglądem kodu. Kontekst historyczny: przez długi czas informowano, że wersja v2.1.197 (30 czerwca 2026) uczyniła Sonnet 5 domyślnym modelem wszędzie — również w tym przewodniku — jednak z opisu poszczególnych planów w dokumentacji konfiguracji modeli wynika, że domyślnym modelem w warstwie premium/API był Opus 4.8 od wersji v2.1.154, a następnie Opus 5 od wersji v2.1.219. „Wszędzie” oznaczało zatem w praktyce warstwę standardową — a wersja v2.1.280 zakończyła również ten stan. Sonnet 4.6 pełnił rolę modelu Sonnet do czerwca 2026.^93147207221 Sonnet warto wybrać, gdy istotne są tańsze tokeny, krótsze opóźnienia lub ekonomia działania subagents.

Opus: Warstwa głębokiego rozumowania — od wersji v2.1.280 alias opus wybiera Claude Opus 5.5 (4/20 USD za MTok, kontekst 1M, domyślna wartość effort to medium), a od tej samej wersji Opus jest również modelem początkowym w każdym planie. Decyzja dotyczy więc tego, kiedy z niego zrezygnować: warto pozostać przy Opus podczas podejmowania decyzji architektonicznych, trudnego debugowania, poznawania złożonych systemów, analizy bezpieczeństwa i długotrwałej pracy agentowej, a przejść na /model sonnet, gdy zadanie jest na tyle rutynowe, że dwukrotnie niższa cena tokenów ma większe znaczenie niż dodatkowe możliwości rozumowania.²²⁰²²¹ (Od wersji v2.1.219 do v2.1.278 alias opus wskazywał Opus 5 w cenie 5/25 USD).¹⁹⁷ Dalsza część tego akapitu opisuje Opus 4.7 w dniu premiery, 16 kwietnia 2026, i została zachowana jako informacja historyczna.¹⁴⁴¹⁴⁷ Opus 4.7 rozwiązuje 3 razy więcej rzeczywistych zadań produkcyjnych w SWE-Bench niż Opus 4.6, osiąga 70% w CursorBench (wobec 58%) i zwiększa skuteczność rozwiązywania zadań o 13% w wewnętrznym benchmarku programistycznym obejmującym 93 zadania.¹⁴⁴ W przypadku Opus 4.7 Claude Code domyślnie ustawia poziom xhigh dla effort; można go dostosować za pomocą /effort (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 planu oraz ustawień administratora.¹⁴⁶ Kontekst 1M w standardowej cenie — bez dopłaty za długi kontekst. Zmiany zachowania, które warto znać: 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 słuszności rozmówcy. Jeśli prompty zawierają dodatkowe instrukcje wymuszające okresowe komunikaty o postępach lub ponowne sprawdzanie wyników, warto spróbować je usunąć.¹⁴⁵

Opusplan: Tryb hybrydowy, który wykorzystuje Opus do planowania (gdzie jakość rozumowania ma największe znaczenie), a Sonnet do wykonania (gdzie liczy się szybkość). Doskonale sprawdza się przy złożonej refaktoryzacji, gdy potrzebny jest najlepszy możliwy plan, ale poszczególne zmiany nie wymagają rozumowania na poziomie Opus.

Przełączanie modeli

Podczas sesji:

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

Przy uruchamianiu:

claude --model opus

Za pomocą zmiennej środowiskowej:

export ANTHROPIC_MODEL=opus

W settings.json:

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

Dostosowywanie samego selektora (modelPicker, v2.1.242+): plik ustawień użytkownika lub ustawień zarządzanych może zawierać listę modeli oferowanych przez /model, ułożonych w wybranej kolejności i opatrzonych własnymi etykietami, dzięki czemu wbudowany zestaw nie musi być jedynym dostępnym menu. Każdy wiersz określa model (w dowolnej postaci akceptowanej 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, pozycji Default oraz bieżącego modelu sesji. Ustawienia projektu i lokalne są ignorowane w przypadku tego klucza, a lista dozwolonych modeli availableModels nadal filtruje wiersze. Claude Code pomija wiersz, którego nie może obsłużyć, wyszarza wiersz, którego nie można jeszcze wybrać, i podaje przyczynę, a jeśli nie pozostanie żaden wiersz, 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 inne ustawienia: pole model: w definicji agenta oraz model jawnie wskazany przy konkretnym uruchomieniu mają przed nią pierwszeństwo.²⁰⁶ Od wersji v2.1.257 zmienna CLAUDE_CODE_SUBAGENT_MODEL_FORCE opcjonalnie przywraca 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 wskazane przy uruchamianiu oraz pola model: w definicjach agentów.²¹¹

Łańcuch modeli rezerwowych (v2.1.166+): ustawienie fallbackModel pozwala skonfigurować maksymalnie 3 modele rezerwowe, wypróbowywane kolejno, gdy model podstawowy jest przeciążony lub niedostępny. Flaga --fallback-model (wcześniej umożliwiająca jedynie przełączenie w trakcie sesji) ma teraz zastosowanie również do sesji interaktywnych od momentu ich uruchomienia.²⁶³

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

Gdy API zwróci nieoczekiwany błąd, który standardowo nie podlega ponowieniu, Claude Code ponawia teraz turę raz przy użyciu modelu rezerwowego, zanim zgłosi niepowodzenie. Dzięki temu chwilowy problem z modelem podstawowym powoduje łagodne przełączenie, zamiast przerwać turę.²⁶³ Od wersji v2.1.286, gdy Anthropic API odrzuci model wynikający z ustawienia domyślnego lub aliasu, Claude Code podejmuje jedną próbę użycia poprzedniego modelu z tej samej warstwy, zamiast powodować niepowodzenie każdej tury. Ponadto po odrzuceniu i ponowieniu przez --fallback-model na modelu, który nie obsługuje trybu fast, działanie jest kontynuowane ze standardową szybkością.²³¹

Od wersji v2.1.178 kompaktowanie również respektuje łańcuch modeli rezerwowych — jeśli model podstawowy zostanie przeciążony lub stanie się niedostępny w trakcie kompaktowania, ten etap korzysta z łańcucha skonfigurowanego przez fallbackModel/--fallback-model, zamiast przerywać turę. W przypadku długotrwałego autonomicznego działania eliminuje to lukę, przez którą przejściowy błąd modelu mógł zakończyć sesję podczas kompaktowania, mimo że sytuację dało się naprawić.¹⁷³

Rozszerzony kontekst

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

claude --model sonnet[1m]
claude --model opus[1m]           # 1M for a model that reaches it only through [1m], such as Opus 4.6

Lub w trakcie sesji:

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

Kiedy sufiks ma znaczenie (październik 2026): w Anthropic API modele Fable 5.1, Fable 5, Sonnet 5.5, Sonnet 5 oraz Opus 4.7 i nowsze (w tym Opus 5.5) korzystają z okna 1M we wszystkich planach, dlatego [1m] niczego tam nie zmienia. Od wersji v2.1.287 tak samo jest w Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry i bramie aplikacji Claude: Opus 4.7 i nowsze oraz Fable domyślnie korzystają z okna 1M bez sufiksu [1m], natomiast CLAUDE_CODE_DISABLE_1M_CONTEXT=1 ogranicza je do 200K. Przed wersją v2.1.287 modele Opus 4.8 i nowsze korzystały u tych dostawców z kontekstu 200K, chyba że identyfikator modelu przypisany w ANTHROPIC_DEFAULT_OPUS_MODEL zawierał [1m]; strony dokumentacji Bedrock i Agent Platform, pobrane 1 października, nadal opisują ten sufiks jako sposób uzyskania tam kontekstu 1M. Sonnet 5 korzysta z 1M u każdego dostawcy. Sufiks wciąż ma znaczenie w przypadku Opus 4.6 i Sonnet 4.6, które uzyskują dostęp do 1M wyłącznie w wariancie [1m].^223232233

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 tej samej stawki za token co żą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. Dostęp do wariantów [1m] zależy od planu: Opus 4.6 z kontekstem 1M jest dostępny w planach Max, Team i Enterprise, natomiast Sonnet 4.6 z kontekstem 1M wymaga kredytów na wykorzystanie w każdym planie subskrypcyjnym, w tym Max.²³³ (Opus z kontekstem 1M stał się domyślnym modelem w planach Max, Team i Enterprise w wersji v2.1.75 z 13 marca 2026 r.)¹¹⁷¹⁴⁷ Użytkownicy API oraz rozliczeń według wykorzystania mają pełny dostęp do kontekstu 1M przy standardowych stawkach 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 zmienił się zakres działania tej zmiennej: ogranicza ona za pomocą automatycznej kompakcji do 200K każdy model z natywnym oknem 1M, a nie tylko stałą listę znanych wariantów. Przy uruchamianiu pojawia się również ostrzeżenie, jeśli automatyczna kompakcja faktycznie nie ogranicza sesji do 200K. Jeśli zmienna ta służy do zapewnienia przewidywalności kosztów w jednej rodzinie modeli, obejmuje teraz nowe modele 1M już w dniu ich udostępnienia, zamiast po cichu przestawać działać. Ta sama wersja sprawia, że automatyczna kompakcja utrzymuje sesje z nierozpoznanymi identyfikatorami modeli w zakładanym oknie kontekstu, zamiast pozwalać im je przekraczać; CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 przywraca poprzednie zachowanie w przypadku bram rejestrujących niestandardowe identyfikatory z faktycznie większymi oknami.²⁰⁰ Od wersji v2.1.287 zmienna ta służy również do ograniczania modeli Opus 4.7 i nowszych oraz Fable do 200K w Bedrock, Vertex, Foundry i bramie aplikacji Claude, gdzie domyślnym ustawieniem stało się 1M.²³²

Od wersji v2.1.247 domyślne okno automatycznej kompakcji modelu Sonnet 5 obejmuje jego 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 automatyczną kompakcję w pobliżu limitu na pozostałe modele z poziomu 1M: sesje Opus i Fable również są teraz kompaktowane krótko przed osiągnięciem limitu 1 miliona tokenów, a kompakcja naprawcza bardzo dużych kontekstów nie kończy się już przekroczeniem limitu czasu wynoszącego 10 minut.²¹²

Niestandardowe bazowe adresy URL otrzymują okno 1M (v2.1.285). Sesje obsługiwane za pośrednictwem niestandardowego ANTHROPIC_BASE_URL korzystają teraz z okna kontekstu 1M w modelach, które je obsługują (Opus 4.7 i nowsze, Sonnet 5 i nowsze oraz Fable). Jeśli używana brama obsługuje maksymalnie 200K, należy uruchomić /autocompact 200k.²²⁹²³³

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 powoduje już usunięcia sufiksu [1m].²¹⁶

Wersja v2.1.273 naprawia licznik kontekstu i automatyczną kompakcję, które uwzględniały tury narzędzia doradczego jako mniej więcej dwukrotnie większe od ich rzeczywistego rozmiaru kontekstu — automatyczna kompakcja uruchamiała się przy około połowie faktycznego okna.²¹⁷

Sprawdzanie bieżącego modelu

> /status

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

Etykiety selektora modeli (v2.1.51+): selektor /model wyświetla teraz czytelne dla człowieka etykiety (np. „Sonnet 4.6”) zamiast nieprzetworzonych identyfikatorów przypiętych wersji modeli, a gdy dostępne są nowsze wersje, pokazuje wskazówki dotyczące aktualizacji.⁹⁸ Wersja v2.1.219 naprawia renderowanie 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 oznacza ono faktycznie udostępniony model, a nie przypadkowy fragment listy.¹⁹⁶ Wersja v2.1.283 usuwa dopisek „(kontekst 1M)” z wiersza Opus oraz nazwy modelu Default, gdy Opus ma już okno kontekstu 1M; samo okno pozostaje bez zmian.²²⁶

Tryb szybki (v2.1.36+)

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

> /fast            # Toggle fast mode on/off

Obsługiwane modele (stan na v2.1.280): tryb szybki działa z modelami Claude Opus 5.5, Opus 5 i Opus 4.8, a od wersji v2.1.280 domyślnym modelem tego trybu jest Opus 5.5 (od wersji v2.1.219 był nim Opus 5). W wersji v2.1.219 usunięto obsługę Opus 4.7 z trybu szybkiego, a funkcja nigdy nie była dostępna w modelach Sonnet, Haiku ani Fable. Nadal pozostaje ona wersją badawczą 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 konta lub dołączyć do listy oczekujących.^196198223

Sesje zdalne (v2.1.271): tryb szybki obejmuje teraz sesje Claude Code Remote — zarówno sesje w chmurze, jak i samodzielnie hostowane środowiska wykonawcze. Obowiązuje ustawienie trybu szybkiego hosta, ale można również wpisać /fast bezpośrednio w sesji; obie metody 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):^198222223

Pułapka Opus 4.7 (v2.1.219). Nie wszystkie nieobsługiwane modele zachowują się tak samo. Żądanie do claude-opus-4-7 z speed: "fast" zwraca teraz błąd — nie przechodzi po cichu do standardowej szybkości. Wyjątkiem, o którym warto wiedzieć, jest Opus 4.6: akceptuje speed: "fast", lecz działa ze standardową szybkością, nalicza opłaty według standardowych stawek i raportuje usage.speed: "standard". Jeśli używane środowisko miało przypiętą wersję 4.7 i polegało na tym, że żądania trybu szybkiego będą łagodnie przechodzić do trybu standardowego, obecnie kończą się one błędem; należy zmienić przypięty model na Opus 5.5, Opus 5 lub Opus 4.8.¹⁹⁸

Kiedy korzystać z trybu szybkiego: - Podczas szybkiego wprowadzania niewielkich zmian, gdy wąskim gardłem jest opóźnienie - Przy generowaniu testów, kodu szablonowego lub powtarzalnego kodu, gdy szybkość jest ważniejsza od kosztu - Podczas sekwencyjnej realizacji listy podobnych zadań

Kiedy NIE korzystać z trybu szybkiego: - Przy długotrwałych zadaniach agentowych (koszt nadal podwaja się w całym przebiegu) - Przy pracy subagents w tle (nikt nie czeka na wynik) - Podczas sesji, w których istotne jest ograniczenie kosztów

Tryb szybki obejmuje pełne okno kontekstu 1M (v2.1.50+). Cena jest mnożona przez stały współczynnik dla całego kontekstu, w tym dla żądań przekraczających 200K tokenów wejściowych — bez dodatkowej opłaty za długi kontekst — i nakłada się na mnożniki związane z pamięcią podręczną promptów oraz lokalizacją danych.⁹⁶¹⁹⁸

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

Wskazówka ekspercka: trybu szybkiego nie można łączyć z opusplan (opusplan już łączy Opus i Sonnet; tryb szybki wpływa tylko na część obsługiwaną przez Opus). Warto go używać, gdy opóźnienie jest ważniejsze od kosztu, i wyłączać przy pracy autonomicznej lub wsadowej. /fast wymaga dodatkowego wykorzystania; administratorzy Team/Enterprise mogą najpierw potrzebować włączyć tę funkcję (poprawka w wersji v2.1.37). Aby całkowicie ją wyłączyć, należy ustawić CLAUDE_CODE_DISABLE_FAST_MODE=1. Od wersji v2.1.218 Claude Code informuje, gdy przełączenie modelu za pomocą /config model=<x> lub Remote Control zmienia stan trybu szybkiego, a wersja v2.1.219 naprawiła problem klientów Remote Control zachowujących nieaktualny stan trybu szybkiego po przełączeniu, ponownym połączeniu lub nieudanym sprawdzeniu organizacji.^86149195196

Kontrola nakładu obliczeniowego (v2.1.111+, Opus 4.7)

Opus 4.7 wprowadza nowy regulator nakładu obliczeniowego, który pozwala 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 osobno dla każdego modelu (v2.1.251+): /effort zapisuje teraz domyślny poziom nakładu pracy osobno dla każdego modelu, dzięki czemu po przełączeniu każdy model zachowuje własne ustawienie — nawyk używania xhigh w Opus nie przenosi się już na Haiku (CHANGELOG: „Zmieniono /effort tak, aby zapisywać domyślny poziom nakładu pracy osobno dla każdego modelu, dzięki czemu po przełączeniu każdy model zachowuje własne ustawienie”). Wyjątek ograniczający max tylko do bieżącej sesji nadal obowiązuje.²⁰⁶ Klawisze suwaka w v2.1.284: akcje przypisania klawiszy effortSlider:decreaseEffort, increaseEffort i toggleUltracode umożliwiają zmianę przypisania klawiszy strzałek oraz Tab suwaka w keybindings.json.²²⁸ Wersja v2.1.257 udoskonala oba mechanizmy regulacji: /effort przyjmuje s, aby zastosować wybór tylko w bieżącej sesji, zgodnie z konwencją /model, a flaga --effort jest teraz ograniczona do sesji — wyłącza blokadę domyślnego nakładu pracy nowego modelu tylko w tej sesji, a nie na stałe (zgodnie z dokumentacją CLI: „zastępuje” wartość domyślną „w tej sesji i nie jest zachowywana”).²¹¹²⁴³

Auto Mode w planie Max (v2.1.111+)

Auto Mode jest wbudowanym początkowym trybem uprawnień dla interaktywnych sesji terminala i VS Code we wszystkich planach i u wszystkich dostawców (v2.1.283–284), a od wersji v2.1.285 również dla sesji claude -p i Python Agent SDK u zewnętrznych dostawców lub przy wyłączonej telemetrii; od 14 sierpnia 2026 był to tryb domyślny w planach Pro, Max i Team (ogłoszono to 7 sierpnia). W sekcji Tryby uprawnień przedstawiono dane liczbowe z badania zawarte w ogłoszeniu, sposoby rezygnacji oraz sesje, które nadal rozpoczynają się w trybie Manual.^{203226227228229}

Oddzielny model klasyfikujący — od wersji v2.1.210 jest nim Claude Sonnet 5 — sprawdza każdą akcję przed jej wykonaniem, weryfikując, czy odpowiada ona intencji użytkownika i jest bezpieczna.¹⁸⁷ Aby rozpocząć sesję w trybie auto, należy użyć --permission-mode auto; w wersji v2.1.111 usunięto starą flagę --enable-auto-mode.

Jak zwiększała się dostępność:

• Rezygnacja: CLAUDE_CODE_AUTO_MODE_SERVER=0 zachowuje lokalny klasyfikator, którego żądania wliczają się do użycia, natomiast 1 włącza kontrole serwerowe. Przed wersją v2.1.281 zmienna nie była odczytywana przy bezpośrednim połączeniu Anthropic API; wersja v2.1.281 stosuje ją również w tym przypadku, a dokumentacja rozliczeń trybu auto informuje teraz, że przy połączeniu bezpośrednim wymagana jest wersja v2.1.281 lub nowsza.²²⁴²²⁷ W dokumentacji zmienną określono jako tymczasową. Ustawienie CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1, gdy ta zmienna nie jest ustawiona, również wyłącza kontrole serwerowe.
• Gdy kontrole serwera nie mogą objąć sesji: najczęstszą przyczyną jest brama lub serwer proxy, który usuwa pole żądania safeguards, pomija safeguard_results w odpowiedziach albo zmienia identyfikatory użycia narzędzi. Claude Code wyświetla jednorazowe powiadomienie („ta sesja nie kwalifikuje się”), podaje nazwę bramy, jeśli potrafi ją zidentyfikować, i przez pozostałą część sesji używa własnych, rozliczanych żądań klasyfikatora. W trybie -p powiadomienie trafia do stderr, a dane wyjściowe stream-json zawierają ostrzeżenie system. Powiadomienie nigdy nie pojawia się w sesjach planów Pro, Max i Team. Aby rozwiązać problem po stronie bramy, należy przekazywać pola żądań i klucze odpowiedzi bez zmian.
• Sprawdzanie sesji: /status wyświetla wiersz Serwer trybu auto z wartością Enabled, gdy kontrole serwera decydują o akcjach w sesji, oraz Disabled, gdy nastąpiło przełączenie na lokalny klasyfikator.²¹⁹

Czym Auto Mode nie jest: granicą bezpieczeństwa. Większość opisanych dalej mechanizmów wzmacnia zabezpieczenia klasyfikatora, a klasyfikator nie jest sandboxem. 26 sierpnia 2026 badacz ataków prompt injection Johann Rehberger opublikował działający łańcuch ataku na Claude Code Opus 5 w trybie auto, zgłaszając skuteczność na poziomie 60–80% w niewielkich próbach — 3 z 5 uruchomień dla głównego łańcucha, który tworzy izolowany proces potomny python3, oraz 3 z 5 i 4 z 5 uruchomień dla dwóch konfiguracji wariantu, którego payload uruchamia bezinterfejsową instancję claude -p — z zastrzeżeniem samego autora, że były to niewielkie próby, a nie uniwersalny pomiar skuteczności ataku.²¹⁰ Warto zrozumieć ten łańcuch, ponieważ każdy z jego kroków z osobna wydaje się uzasadniony: serwer odpowiada na WebFetch kodem HTTP 415, więc agent przełącza się 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 najpierw odnajduje należący do atakującego plik struct.py. Żadna instrukcja w tej sekwencji nie jest w oczywisty sposób złośliwa — wstrzyknięcie musi jedynie sprawić, aby przejęta ścieżka wydawała się najbardziej rozsądnym sposobem 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 odrzucił polecenie czyszczące.²¹⁰ Całe odkrycie zestawia z wartością promowaną marketingowo 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ńcuch nie znalazł się w tym zbiorze, dlatego wynik benchmarku wynoszący 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 nie odczytuje instrukcji atakującego ani ich nie wykonuje — lecz atak wykorzystujący dezorientację co do środowiska.²¹⁰ Anthropic zamknęło zgłoszenie jako Informative — zachowanie uznano za zgodne z założeniami — a stanowisko przedstawione przez Rehbergera wyznacza właściwe ramy projektowe: tryb auto jest klasyfikatorem działającym na zasadzie najlepszych starań, a nie gwarancją bezpieczeństwa; celowo przygotowane łańcuchy wstrzyknięć, złożone z pojedynczo nieszkodliwych kroków, wykraczają poza zakres zdarzeń, które klasyfikator powinien wykrywać; rzeczywistą granicę zabezpieczeń stanowią zaś izolacja na poziomie systemu operacyjnego i kontrola wychodzącego ruchu sieciowego.²¹⁰ Nie przeczy to opisanym poniżej mechanizmom wzmacniania zabezpieczeń — właśnie w takich ramach należy je rozumieć. Tryb auto zmniejsza liczbę pytań wymagających odpowiedzi i blokuje udokumentowaną listę destrukcyjnych operacji, ale nie zapewnia bezpieczeństwa sesji przetwarzającej niezaufane dane wejściowe. Jeśli sesja będzie korzystać z treści, na które może mieć wpływ atakujący — pobranych stron, pobranych archiwów, treści zgłoszeń czy serwerów MCP innych firm — rzeczywiste ograniczenie szkód zapewniają mechanizmy działające poza modelem: kontener lub maszyna wirtualna, ograniczony wychodzący ruch sieciowy, monitorowanie faktycznych działań agenta oraz katalog domowy bez kluczy SSH i 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.

Własne reguły bez utraty domyślnych ustawień (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. Sentinel $defaults rozwiązuje ten problem — w miejscu, w którym zostanie umieszczony, rozwija się do wbudowanej listy, dzięki czemu można otoczyć ją 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. Zawiera ona wpisy allow, soft_deny, hard_deny i environment ze wszystkich zakresów odczytywanych przez klasyfikator oraz informację, czy w każdej sekcji obowiązują wbudowane reguły. Wpisy pochodzące z zarządzanych ustawień 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", dzięki czemu wbudowane reguły pozostają aktywne. Można je włączać i wyłączać osobno dla każdej sekcji (aby można było wyłączyć reguły wbudowane, sekcja musi zawierać co najmniej jedną własną regułę), natomiast environment otwiera się w edytorze jako jeden dokument.²⁴⁹²⁴⁷

Opcja „Don’t ask again” (v2.1.118+). Monit o włączenie Auto Mode zawiera teraz opcję „Don’t ask again”, dzięki której osoby często korzystające z tej funkcji mogą wyłączyć objaśnienie bez tworzenia skryptu z odpowiednią flagą.¹⁵²

Zabezpieczenia przed destrukcyjnymi poleceniami (v2.1.183). Tryb auto blokuje teraz zestaw nieodwracalnych poleceń, o ile podczas sesji nie zażądano ich wprost: destrukcyjne operacje git (git reset --hard, git checkout -- ., git clean -fd, git stash drop), jeśli nie polecono odrzucenia lokalnych zmian; git commit --amend, jeśli commit nie został utworzony przez agenta podczas tej sesji; oraz usuwanie infrastruktury (terraform destroy, pulumi destroy, cdk destroy), jeżeli nie wskazano konkretnego stosu. Ogranicza to potencjalny zakres szkód powodowanych przez klasyfikator dokładnie w przypadku operacji, które mogą po cichu doprowadzić do utraty pracy lub usunięcia środowisk — agent nadal może je wykonać, ale 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 go omijają. Nowe ustawienie autoMode.classifyAllShell kieruje przez klasyfikator wszystkie polecenia Bash/PowerShell, zwiększając nieco opóźnienie w zamian za ściślejszą ochronę, gdy każda operacja powłoki ma zostać sprawdzona. W tej samej wersji przyczyny odmowy w trybie auto są również widoczne w transkrypcji, powiadomieniu o odmowie oraz wśród ostatnich odmów w /permissions, dzięki czemu przy zablokowanym poleceniu wyświetlane jest teraz wyjaśnienie.¹⁷⁹

Trzy kolejne reguły wzmacniające zabezpieczenia (v2.1.205). Tryb auto blokuje teraz ingerowanie w pliki transkrypcji sesji — sama ścieżka audytu jest niedostępna dla agenta; pyta przed uruchomieniem rm -rf na zmiennej, której wartości nie może ustalić z kontekstu — eliminując klasę wypadków typu rm -rf $DIR przy nieznanej wartości $DIR; ponadto powiadomienia o zadaniach działających w tle informują teraz wprost, że nie nastąpiła żadna interakcja z człowiekiem, dzięki czemu sfabrykowanego wpisu „user approved” w transkrypcji nie można przedstawić jako autentycznej zgody i na tej podstawie wykonać działania.¹⁸³ Trzeci mechanizm to ważna ochrona przed wstrzykiwaniem promptów: zatwierdzenie musi nadejść przez kanał zatwierdzania, a środowisko wykonawcze jednoznacznie wskazuje teraz to założenie.

Podstawienie polecenia nie ukryje katastrofy (v2.1.208). Katastrofalne operacje usuwania, takie jak rm -rf ~, powodują teraz wyświetlenie monitu nawet wtedy, gdy zostały ukryte wewnątrz $(...), znaków backtick lub podstawienia procesu (<(...)) — monit pojawia się nawet w trybach --dangerously-skip-permissions i auto. Opakowanie destrukcyjnego polecenia w podstawienie nie pozwala już przemycić go poza mechanizm zabezpieczający.¹⁸⁶

Resetowanie stanu trybu auto: claude auto-mode reset (v2.1.212). Nowe podpolecenie umożliwia zresetowanie stanu trybu auto z terminala; przekazanie --yes pomija monit o potwierdzenie:¹⁸⁹

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

Mniej okien dialogowych, ta sama kontrola (v2.1.218). Trzy kontrole, które wcześniej przerywały tryb auto oknem dialogowym uprawnień — niebezpieczne użycie rm, działanie w tle z & oraz podejrzane ścieżki Windows — już tego nie robią. Zamiast tego rozstrzyga je klasyfikator trybu auto, więc kontrola bezpieczeństwa nadal się odbywa, ale nie wymaga angażowania użytkownika przy każdym wykryciu. Ta sama wersja rozszerza to zachowanie na tryb planowania z auto: polecenia Bash, których analizator statyczny nie potrafi jednoznacznie uznać za przeznaczone wyłącznie do odczytu, nie powodują już wyświetlenia monitu — zamiast okna dialogowego ocenia je klasyfikator.¹⁹⁵

Reguła ucieczki 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, omijanie ograniczeń wychodzącego ruchu sieciowego i dostęp między dzierżawcami nie są już automatycznie zatwierdzane, chyba że środowisko oznacza je jako oczekiwane. Należy interpretować to zgodnie z przedstawionym wyżej zastrzeżeniem: jest to dalsze wzmacnianie klasyfikatora — kolejna udokumentowana klasa odmów, a nie zmiana istoty trybu auto.²¹¹

Jednorazowy monit przy odczycie spoza katalogów roboczych (v2.1.257). Tryb auto pyta teraz raz, zanim podczas sesji nastąpi pierwszy odczyt pliku spoza katalogów roboczych; od wersji v2.1.284 monit zawiera również opcję Yes, but ask again next time.²²⁸ Powiązane ustawienie permissions.blockReadsOutsideWorkingDirectories zastępuje monit odmową — takie operacje odczytu są całkowicie blokowane.²¹¹ v2.1.273 rozszerza oba zachowania na działania niewidoczne dla mechanizmu sprawdzającego: polecenie Bash, którego nie można w pełni przeanalizować, powoduje wyświetlenie monitu zamiast pominięcia kontroli, a katalog pamięci wybrany w ustawieniach repozytorium nie jest już wczytywany do promptu, przywoływany, indeksowany ani wykorzystywany podczas wyodrębniania pamięci, gdy aktywne jest ustawienie blokujące.²¹⁷

Adresy URL mechanizmów renderowania diagramów są traktowane jak przesyłanie danych (v2.1.261). Link zawierający dane umieszczone w adresie URL publicznego mechanizmu renderowania diagramów — w stylu mermaid.live, gdzie dane są zakodowane bezpośrednio w adresie URL — nie jest już automatycznie zatwierdzany, o ile nie zażądano tego wprost. Klasyfikator traktuje taki link jak przesyłanie danych: osadzone dane są przekazywane w samym adresie URL, skąd po otwarciu strony mogą je odczytać jej własne skrypty — w linkach w stylu mermaid.live ładunek znajduje się we fragmencie adresu URL, który przeglądarka udostępnia JavaScript strony, zamiast przesyłać go w żądaniu sieciowym. Obowiązują te same ramy co w powyższym zastrzeżeniu: jest to zamknięcie kolejnego kanału eksfiltracji w klasyfikatorze służącym wzmacnianiu zabezpieczeń, a nie ustanowienie nowej granicy bezpieczeństwa.²¹⁴

Dwa tryby awarii klasyfikatora otrzymują warunki zatrzymania (v2.1.280). Do tej wersji tryb auto nie potrafił poradzić sobie z kontrolą bezpieczeństwa, która nie zwróciła użytecznego werdyktu, a z perspektywy operatora obie luki wyglądały tak samo: tura trwała bez końca, zużywając tokeny na działanie, które i tak nie miało zostać zatwierdzone. v2.1.280 nadaje każdemu z tych przypadków stan końcowy.

Przegląd po stronie serwera obejmuje więcej poleceń (v2.1.281). Tam, gdzie przegląd klasyfikatora odbywa się po stronie serwera, polecenia powłoki przeznaczone tylko do odczytu oraz uruchamiane w sandboxie również czekają teraz na ten przegląd i są blokowane, jeśli zostaną przez niego oznaczone. Zmieniono także komunikat odmowy, aby Claude traktował ją jako obejmującą rezultat, a nie tylko dokładne polecenie. Po wznowieniu sesji w nowym procesie klasyfikator może ponownie wykorzystać wcześniejszą pamięć podręczną promptu, zamiast tworzyć go od nowa. Ponadto /insights otrzymuje rekomendację dotyczącą trybu automatycznego, która szacuje, ile monitów o uprawnienia tryb ten mógłby obsłużyć podczas ostatnich sesji.²²⁴

Sesje bez nadzoru przestają czekać na monity rm (v2.1.281). W trybie automatycznym oraz przy użyciu --dangerously-skip-permissions monit dotyczący niebezpiecznego polecenia rm czeka teraz 2 minuty na odpowiedź, po czym odrzuca polecenie i podpowiada jego przeformułowanie, dzięki czemu sesja bez nadzoru może działać dalej; CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1 wyłącza ten limit czasu. Rekurencyjne polecenie rm, którego cel stanowi wyłącznie wynik podstawienia polecenia, takie jak rm -rf "$(pwd)", było wcześniej wykonywane bez monitu w obu trybach; teraz wymaga potwierdzenia nawet wtedy, gdy pasuje do reguły zezwalającej dla Bash, chyba że ustawiono CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1. Kontrola niebezpiecznych poleceń rm oznacza również usuwanie celu wskazanego przez zmienną powłoki, po której występuje nazwa katalogu najwyższego poziomu, przez zmienną wyprowadzoną z katalogu roboczego albo przez cel składający się wyłącznie z ukośnika odwrotnego.²²⁴

Wbudowana powłoka ! opuszcza klasyfikator, a przekazywanie wyników przez subagents zaczyna mu podlegać (v2.1.271). Są to dwie zmiany mechaniki, a nie nowe kategorie odmowy. Wbudowane polecenia powłoki ! należące do skills lub poleceń slash podlegają teraz regułom uprawnień trybu domyślnego zamiast klasyfikatorowi — polecenie, którego nie rozstrzyga żadna reguła, jest wykonywane jako przeglądane wywołanie narzędzia. Ponadto subagent przekazuje teraz wynik wywołującemu za pośrednictwem specjalnego wywołania zwrotnego sprawdzanego przez klasyfikator bezpieczeństwa, zamiast poddawać przeglądowi jego ostatnią wiadomość już po fakcie — punkt kontrolny przeniesiono z etapu po przekazaniu na samo przekazanie.²¹⁶

Co nowego w wersjach v2.1.293–v2.1.296

Między 7 a 9 października 2026 ukazały się cztery wersje. W npm latest i next wskazują wersję 2.1.296; stable przechodzi z 2.1.285 na 2.1.287.²³⁸ Najważniejszą zmianą jest nowy model: Claude Haiku 5.5 pojawia się w v2.1.293 jako model wybierany przez haiku w Anthropic API (zob. Dostępne modele). Warto przejść na v2.1.296, jeśli logowanie do bramy aplikacji Claude odbywa się za pomocą ustawień zarządzanych: ta wersja naprawia regresję z v2.1.295, która ignorowała zapisane dane logowania do bramy, gdy forceLoginMethod miało wartość gateway, a forceLoginGatewayUrl nie było ustawione.

v2.1.296 (9 października). Odczyty z pamięci podręcznej Sonnet 5.5 są wyceniane na 0,10 USD za milion tokenów w /cost, wierszu stanu, --max-budget-usd oraz danych kosztowych SDK, gdzie wcześniej używano stawki 0,20 USD. Domyślny limit opisów narzędzi MCP wysyłanych z góry oraz instrukcji serwera MCP wzrasta z 2 048 do 4 096 znaków. Frontmatter subagents i definicje --agents obsługują autoCompactWindow, dzięki czemu subagent może przeprowadzać automatyczną kompaktację wcześniej niż główna konwersacja. CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL uruchamia każdego agenta przepływu pracy na jednym modelu, podczas gdy pozostałe subagents zachowują swoje modele, a CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS ustawia dłuższe maksymalne opóźnienie wycofania dla błędu 529. Narzędzie Read obsługuje allow_large, dzięki czemu Claude może odczytać w jednym wywołaniu plik tekstowy przekraczający zwykły limit rozmiaru, jeśli w kontekście jest wystarczająco dużo miejsca. Hooks PreToolUse z ustawień zarządzanych, które odrzucają wywołanie narzędzia za pomocą "continue": false, oraz zarządzane hooks typu prompt, które je blokują, kończą teraz również turę, a nie tylko odmawiają wykonania wywołania. --debug wskazuje nierozpoznane pola frontmatter w plikach niestandardowych agentów oraz rejestruje polecenie, plugin, wynik i czas działania każdego hooka polecenia. Brama aplikacji Claude otrzymuje klucz code w managed.policies[] — z tymi samymi ustawieniami co cli — stosowany również na karcie Code w Claude Desktop. Tura lub polecenie ! rozpoczęte w czasie, gdy ← przenosi sesję do tła, jest teraz zatrzymywane zamiast kończyć się poza zasięgiem wzroku. Dokumentacja uwzględnia już dwie z tych zmian: dokumentacja hooks datuje wiersze --debug dotyczące poszczególnych hooks na v2.1.296, a dokumentacja bramy aplikacji Claude opisuje klucz zasad code; według stanu na 13 października 2026 autoCompactWindow, CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL i CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS nadal są opisane wyłącznie w informacjach o wydaniu.^238240270

v2.1.295 (8 października). Hooks poleceń i HTTP obsługują onFailure: "block": hook, którego nie można uruchomić, który przekroczy limit czasu lub zakończy się nieoczekiwanym kodem, blokuje działanie zamiast je przepuszczać (zob. Protokół wejścia/wyjścia hooks). CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS ogranicza czas, przez jaki tryb ponawiania bez nadzoru oczekuje na ustąpienie błędów 429 i 529. Subagents wstępnie wczytują maksymalnie 32 skills z pola skills, a opisy narzędzi MCP wczytane przez wyszukiwanie narzędzi są skracane do 16 384 znaków zamiast 2 048. forceLoginMethod: "gateway" i forceLoginGatewayUrl działają teraz we własnych ustawieniach użytkownika na komputerze bez ustawień zarządzanych, dzięki czemu /login otwiera wskazaną bramę — konfigurację tę opisuje już dokumentacja bramy; każde połączenie upstream bramy przyjmuje opcjonalną listę models, w której * pełni rolę symbolu wieloznacznego, a połączenia upstream z chmurą respektują timeouts.upstream_ttfb_ms. Terminale implementujące Program Status Protocol (OSC 7501) mogą pokazywać, czy Claude Code pracuje, czeka na użytkownika, czy zakończył działanie. Żądania działające w tle za bramą aplikacji Claude korzystają z Haiku 4.5 zamiast modelu sesji, jeśli brama udostępnia ten model. Model [1m], którego wersja beta context-1m zostanie odrzucona przez bramę, Bedrock, Vertex lub Foundry, jest ponownie wysyłany bez niej, zamiast kończyć się błędem. Ctrl+C użyte na bezczynnym monicie dołączonej sesji działającej w tle nie anuluje oczekującego wybudzenia /loop, dzięki czemu dwukrotne naciśnięcie odłącza sesję, a pętla działa dalej; Esc ją zatrzymuje. Connectors claude.ai domyślnie negocjują protokół MCP 2026-07-28 w instalacjach, które nie pobierają żadnych flags. /copy udostępnia tekst w cudzysłowie, claude -p informuje na stderr, na co czeka po ostatniej turze, a mods otrzymują $.ui.notify. Wyszukiwania internetowe i oceny hooków agent nie trwają już znacznie dłużej przy poziomach wysiłku xhigh i max.²³⁸²⁴⁰

v2.1.294 (8 października). Dwie poprawki dotyczące hooks prompt i agent zapisanych jako instrukcje: hook taki jak „Blokuj polecenia, które…” nie zezwala już na działania, które powinien blokować, a hooks Stop i SubagentStop, takie jak „Kontynuuj, jeśli kompilacja jest uszkodzona”, są oceniane w sposób zmniejszający prawdopodobieństwo, że Claude zakończy pracę zbyt wcześnie.²³⁸

v2.1.293 (7 października). Claude Haiku 5.5 (claude-haiku-5-5) jest domyślnym modelem Haiku w Anthropic API: kontekst 1M, 0,10/0,50 USD za milion tokenów oraz 0,50/2,50 USD dla promptów przekraczających 100K. Ładunek subagentStatusLine otrzymuje agentType, dzięki czemu skrypt wiersza stanu może rozróżniać niestandardowe typy subagents; mods otrzymują isDeferred w $.tool.register. Wycofano dwie zmiany: komunikat odmowy trybu automatycznego z v2.1.281, który informował Claude, że odmowa obejmuje rezultat, a nie tylko dokładne polecenie, oraz poprawkę sesji w chmurze z v2.1.290 dotyczącą utraconego wybudzenia /loop po ponownym uruchomieniu kontenera, wskutek czego taka sesja ponownie pozostaje uśpiona. Ponadto: Claude nie uznaje już po kompaktacji swoich ostatnich działań sprzed niej za ukończone, połączenie HTTP MCP nie przechowuje już każdego wysłanego żądania aż do zamknięcia, claude purge wyświetla elementy, których nie udało się usunąć, i kończy działanie kodem 1 zamiast zatrzymywać się bez komunikatu, synchronizacja skills z claude.ai sprawdza zmiany co 40 minut zamiast co 10, gdy żadna sesja nie jest używana, a podczas uruchamiania planów Team i Enterprise zasady oraz ustawienia zarządzane są pobierane wcześniej, przy czym zablokowane żądanie jest ponawiane po 3 sekundach.²³⁸²⁴⁰

Co nowego w wersjach v2.1.288–v2.1.292

Między 2 a 6 października 2026 ukazało się pięć wersji. W npm latest i next wskazują wersję 2.1.292; stable pozostaje przy 2.1.285.²³⁴ Warto przeprowadzić aktualizację w przypadku korzystania z wersji 2.1.288, 2.1.289 lub 2.1.290: v2.1.291 naprawia regresję z 2.1.288, przez którą ostatnie wiadomości sesji mogły zostać utracone podczas kończenia programu, oraz regresję z 2.1.290, przez którą sesje w chmurze mogły gubić odpowiedzi na monity o uprawnienia.²³⁵ v2.1.292 (6 października). Ustawienie CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS wydłuża bazowe opóźnienie mechanizmu wycofywania przy ponawianiu przeciążonego żądania (529); dokumentacja zmiennych środowiskowych podaje teraz wartość domyślną 500 ms oraz dopuszczalny zakres od 500 do 32000. Narzędzie Agent przyjmuje parametr effort, dzięki czemu Claude może uruchomić subagenta z określonym poziomem nakładu pracy; dokumentacja subagents opisuje teraz parametr ustawiany osobno dla każdego wywołania, który zastępuje pole frontmatter i pozostaje aktywny po wznowieniu subagenta, przy czym CLAUDE_CODE_EFFORT_LEVEL ma pierwszeństwo przed oboma ustawieniami. claude plugin install --marketplace <source> dodaje marketplace i instaluje z niego za pomocą jednego polecenia powłoki. Lokalne serwery MCP (stdio) domyślnie negocjują teraz protokół 2026-07-28 przy każdej instalacji, również w Bedrock, Vertex i Foundry; aby z tego zrezygnować, należy ustawić MCP_PROTOCOL_NEGOTIATION=legacy. Dokumentacja MCP informuje teraz, że serwery stdio są domyślnie proszone o użycie tej rewizji. Nazwy Agent są ograniczone do 256 znaków: dłuższa nazwa jest odrzucana, dłuższe pole name w pliku skill lub plugin jest ignorowane, a dokumentacja subagents określa teraz limit pola name; plik subagenta o dłuższej nazwie jest pomijany, a błąd trafia do dziennika debugowania. Poprawka zabezpieczeń uniemożliwia zatwierdzeniom hooks PreToolUse i trybowi automatycznemu pomijanie monitu przy odczycie plików ze ścieżek sieciowych (UNC). Mods zyskują prompt.autocomplete, buforowanie promptów w $.model.complete oraz agentów workflow w agent.spawn, a claude plugin test kończy się teraz niepowodzeniem, gdy odpowiedź atrapowa zostanie odrzucona. Według stanu na 2026-10-06 pozostałe pozycje występowały wyłącznie w informacjach o wydaniu.^236237240

v2.1.290 (5 października). Interaktywny limit WebSearch odnawia się o 100 wywołań na godzinę (CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR; 0 wyłącza tę funkcję), zamiast wyczerpywać się po 200 wywołaniach. claude attach i claude logs przyjmują fragment nazwy sesji. /claude-api managed-agents-onboard <url> przekształca stronę opisującą wzorzec Managed Agents w pliki ant apply, natomiast /claude-api managed-agents-onboard <quickstart-name> tworzy szablon szybkiego startu Console, taki jak deep-researcher, za pomocą CLI ant. Zaostrzono kilka ustawień domyślnych: ustawienia projektu nie mogą już włączać Claude w Chrome, pliki .claude/settings.json i .claude/settings.local.json repozytorium nie mogą już ustawiać CLAUDE_CODE_DISABLE_ATTACHMENTS, pyright i kolejne warianty ps wymagają potwierdzenia przed uruchomieniem, a zarządzany plik ustawień zawierający łącze prowadzące poza folder zarządzanych ustawień wywołuje ostrzeżenie. WebFetch informuje teraz, jaka część strony przekraczająca 100 000 znaków nie została odczytana, i przyjmuje parametr offset, aby kontynuować odczyt; wcześniej tekst ten był bez powiadomienia pomijany. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC pomija również wstępne rozgrzewanie połączenia, a CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS=5m nie jest już interpretowane jako 5 ms: wartości z przyrostkiem jednostki korzystają zastępczo z ustawienia dialogExpiry.²³⁵²³⁷

v2.1.290, teams i bramy. Strona zatwierdzania logowania w bramie apps Claude zyskuje przycisk Odmów, a minimalna obsługiwana wersja PostgreSQL zostaje obniżona z 14 do 11. Na samodzielnie hostowanych runnerach claude --environment <id> tworzy sesję za pośrednictwem bieżącego Sessions API. claude --teleport i /teleport odrzucają stash, który usunąłby pliki z folderu zastępującego śledzony plik o tej samej nazwie, a przekaźnik --channels ignoruje powtórzony identyfikator odpowiedzi, zamiast zatwierdzać inny prompt. W Slack !fast przełącza wątek w tryb szybki, a !fast off przywraca poprzedni tryb. VS Code domyślnie wyświetla znaczniki czasu wiadomości (ustawienie Claude Code: Show Message Timestamps je wyłącza).²³⁵

v2.1.289 (3 października). Mods zyskują agent.spawn dla członków zespołu, jeden identyfikator agenta wspólny dla zdarzeń hooks pluginu oraz stany bezczynności i oczekiwania w $.agent.list(); claude plugin validate nie pomija już pluginu, którego folder zawiera również manifest marketplace; usunięto też dwie luki w regułach odmowy Bash przy automatycznym zezwalaniu w sandbox.²³⁵²³⁷

v2.1.288 (2 października). claude project purge ma teraz postać claude purge; stara nazwa nadal działa i wyświetla powiadomienie. Limit czasu poleceń działających w tle obowiązuje wyłącznie w sesjach bez nadzoru (-p, Agent SDK, CI, chmura). /code-review --max-findings <n>|all zmienia limit ustaleń do czasu przekazania --max-findings default. /autocompact zapisuje swoje okno osobno dla każdego modelu. CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS wyłącza ustrukturyzowane dane wyjściowe w przypadku Mantle lub bram, które je odrzucają. Reguły ograniczone do określonych ścieżek i zagnieżdżone pliki CLAUDE.md są wczytywane podczas operacji Write i Edit, a nie tylko Read. Serwery językowe przekraczają limit czasu po 60 sekundach (parametr requestTimeout dla poszczególnych serwerów), zamiast zawieszać działanie. W trybie automatycznym konwersacja zbyt długa dla klasyfikatora po stronie klienta jest kompresowana, zamiast wyświetlać monit przy każdym wywołaniu narzędzia, a klasyfikator po stronie klienta ignoruje przypięcie ANTHROPIC_DEFAULT_SONNET_MODEL wskazujące Claude Sonnet 5.5 lub Opus 5.5 i używa zamiast tego Claude Sonnet 5. Mods zyskują $.ui.selection(), sesje w chmurze bez CLI GitHub otrzymują wbudowane gh api, a naciśnięcie strzałki w górę przy pustym prompcie przywraca wersję roboczą wyczyszczoną przez Ctrl+C.²³⁴²³⁷

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 pomocą nowego narzędzia do powiadomień push. Funkcja ta współpracuje z istniejącym interfejsem mobilnym/internetowym Remote Control.¹⁴⁶ /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 wdraża natywne narzędzie Windows PowerShell. W systemach Linux/macOS można je włączyć za pomocą CLAUDE_CODE_USE_POWERSHELL_TOOL=1 (wymaga pwsh w PATH). W systemie Windows ta sama zmienna kontroluje włączenie lub wyłączenie funkcji w okresie wdrażania.¹⁴⁶

Automatyczne zatwierdzanie w trybie uprawnień (v2.1.119+). Polecenia narzędzia PowerShell mogą teraz otrzymywać automatyczne zatwierdzenie 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ć monit w przypadku operacji tylko do odczytu, zapewniając ergonomię pracy znaną już zespołom korzystającym z Linux/macOS.¹⁵²

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

Wzorce Bash przeznaczone 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 wywołują już monitu o uprawnienia.¹⁴⁶ W połączeniu z /less-permission-prompts oznacza to znacznie mniej przerw w codziennej pracy.

Śledzenie rozproszone (v2.1.110+)

SDK i sesje headless odczytują teraz TRACEPARENT oraz TRACESTATE ze środowiska, łącząc uruchomienia Claude Code z rozproszonymi śladami. 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: claude uruchamia teraz natywny plik binarny Claude Code za pośrednictwem opcjonalnej zależności właściwej dla danej platformy, zamiast korzystać z dołączonego 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 widoku w trybie pełnoekranowym:

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

Subagents, które przestaną odpowiadać w trakcie przesyłania strumieniowego, po 10 minutach kończą teraz działanie z wyraźnym błędem, zamiast zawieszać się bez komunikatu. Warto połączyć tę funkcję z CLAUDE_STREAM_IDLE_TIMEOUT_MS (v2.1.84+), aby zapewnić szerszą ochronę przed zablokowanymi procesami podczas strumieniowego działania API.

Poprawka stabilności w v2.1.114¹⁵⁰

Wersja v2.1.114 (18 kwietnia 2026) zawiera jedną poprawkę: okno dialogowe uprawnień mogło ulec awarii, gdy członek zespołu agentów prosił o uprawnienie do użycia narzędzia. Jeśli korzysta się z Agent Teams, należy przeprowadzić aktualizację.

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

Anthropic ogłosiło wprowadzenie oznaczeń treści wygenerowanych przez Claude, które można odczytać maszynowo. Zmiana wynika z art. 50 unijnego aktu w sprawie sztucznej inteligencji (egzekwowanego od 2 sierpnia 2026 w odniesieniu do nowo wprowadzanych systemów AI). System składa się z dwóch elementów: niewidocznego statystycznego znaku wodnego w wygenerowanym tekście oraz podpisanych metadanych pochodzenia — zgodnych z otwartym standardem C2PA — w wygenerowanych plikach, takich jak .svg, .png i .jpg.²⁵²²⁰⁴ Szczegół pomijany w nagłówkach: oba elementy podlegają temu samemu harmonogramowi dotyczącym modeli. Zgodnie ze stroną pomocy „modele Claude wprowadzone 2 sierpnia 2026 lub później będą obsługiwać oznaczenia możliwe do odczytu maszynowego już w dniu premiery” — modele wprowadzone przed tą datą, czyli cała obecna oferta (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”.²⁰⁴

Lista ta pochodzi z sierpnia. Fable 5.1 (1 września), Opus 5.5 (22 września) i Sonnet 5.5 (28 września) wprowadzono po dacie granicznej, więc zgodnie z tą zasadą powinny obsługiwać oznaczenia od dnia premiery; w informacjach o premierze Fable 5.1 wymieniono pochodzenie treści wśród nowych funkcji, natomiast strona modelu i przewodnik po migracji dotyczące Opus 5.5 oraz strona modelu i strona z nowościami dotyczące Sonnet 5.5 nie wspominają o oznaczeniach.^241222230 Dane wyjściowe modeli sprzed sierpnia nie zawierają żadnych oznaczeń — ani w tekście, ani w plikach; dane wyjściowe nowszych modeli będą je zawierać we wszystkich kanałach — Claude Platform (API), claude.ai, Claude Code, Claude Cowork, Claude Tag oraz 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 dostrzeżona zmiana stylu ani zachowania jednego z modeli sprzed sierpnia nie może wynikać ze stosowania znaku wodnego, ponieważ oznaczanie nie jest w nich aktywne.

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 słów”, gdy Claude wybiera spośród semantycznie równoważnych możliwości — bez dodawania znaków i bez przetwarzania końcowego, a zgodnie z wewnętrznymi testami Anthropic znak wodny „nie wpływa na treść, poziom kreatywności ani czytelność”.²⁵²

Co będzie istotne dla użytkowników Claude Code: kod zawiera rzadko rozmieszczony znak wodny. Działający kod pozostawia niewiele miejsca na dowolność, dlatego oznaczenie koncentruje się tam, gdzie taka swoboda istnieje — w komentarzach i nazewnictwie — wywierając, według Anthropic, „pomijalny wpływ na faktycznie generowany kod”.²⁵² Trwałość jest probabilistyczna i różni się w zależności od elementu: w przypadku tekstu niewielkie zmiany „prawdopodobnie nie usuną całkowicie znaku wodnego”, pełne przepisanie tekstu go usunie, a tłumaczenie wygenerowane przez Claude otrzyma własne, nowe oznaczenie; w przypadku metadanych pliku konwersja formatu, ponowne zapisanie oraz wykonanie zrzutu ekranu mogą usunąć podpis C2PA.²⁰⁴ Planowane jest API do wykrywania oznaczeń; wynik pozytywny dowodzi, że „Claude prawdopodobnie uczestniczył na pewnym etapie w tworzeniu treści”, lecz wyraźnie nie pozwala rozróżnić, czy „Claude napisał tę treść”, czy „Claude gruntownie ją zredagował” — a zgodnie ze stroną pomocy brak oznaczenia również niczego nie dowodzi. Nie wspomniano o możliwości rezygnacji z tej funkcji na żadnym poziomie oferty dla klientów.²⁵²²⁰⁴

Ile kosztuje Claude Code?

Zrozumienie i kontrolowanie kosztów ma kluczowe znaczenie dla zrównoważonego korzystania z Claude Code. Warto również zapoznać się z sekcją Wybór modelu, aby poznać możliwości modeli, oraz z sekcją Ramy decyzyjne, aby dobrać odpowiedni model do danego zadania.

Wyświetlanie kosztów

> /cost

Dane wyjściowe:

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

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

Stawki umowne zamiast ceny katalogowej (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. Wówczas /cost, wiersz stanu oraz dane telemetryczne dotyczące kosztów używają tych stawek zamiast ceny katalogowej, 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 dla sesji wiersz pamięci podręcznej promptów — 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 dla skryptów wiersza stanu. Obiekt pojawia się po pierwszej odpowiedzi API w głównej konwersacji, nie uwzględnia żądań subagentów 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 pokazuje te same statystyki w wierszu Prompt cache (main).²⁰⁶²⁰⁹ Od wersji v2.1.260 wiersz /cost i obiekt prompt_cache w wierszu 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 zaburza już ich własnego prefiksu pamięci podręcznej (v2.1.265): dwie poprawki usuwają wycieki pamięci podręcznej promptów w delegowanej pracy. Wznowienie subagenta uruchomionego na pierwszym planie nie zmienia już jego listy narzędzi ani prefiksu promptu systemowego, a członkowie zespołu agentów i wznowione subagenty nie przenoszą już kontekstu hooka SubagentStart ani wstępnie załadowanych skills poza prefiks promptu w kolejnych turach. Oba błędy uniemożliwiały ponowne użycie pamięci podręcznej promptów — prefiks się zmieniał, więc wszystko po nim było ponownie wysyłane jako niebuforowane dane wejściowe — właśnie w długich sesjach agentowych, w których ekonomia pamięci podręcznej ma największe znaczenie (jest to ten sam rodzaj błędu, który v2.1.260 naprawiła w turach wywołań narzędzi Fable 5.1).²¹⁵

Pakiet stabilizujący pamięć podręczną w v2.1.267: jedno wydanie, około dziesięciu poprawek i ten sam rodzaj błędu — coś przepisywało prefiks promptu w trakcie konwersacji, przez co wszystko po nim było ponownie wysyłane jako niebuforowane dane wejściowe. Wznowione sesje nie przepisują już list narzędzi, nie renderują ponownie opisów narzędzi ani nie przepisują wcześniejszych komunikatów narzędzi MCP przed ponownym połączeniem ich konektorów; przełączanie modeli za pomocą /model nie wysyła już ponownie każdej definicji narzędzia (tekst dotyczący autorstwa commitów i PR-ów jest teraz przekazywany jako notatka w konwersacji, aktualizowana przy zmianie modelu); subagenty i sesje uruchomione z --system-prompt lub --append-system-prompt zapisują prompt systemowy oraz definicje narzędzi tylko raz; natomiast narzędzia MCP i plugins dołączane 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, przełączanie modeli i ponowne łączenie z MCP.²¹⁶

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

v2.1.277 usuwa trzy kolejne wycieki prefiksu: w sesjach kontynuowanych po /clear (ponowne uruchomienie, --continue, --resume) brakowało części pierwszej wiadomości, gdy hook SessionStart zwracał dane wyjściowe, co powodowało całkowite chybienie pamięci podręcznej promptów; wznowione subagenty i członkowie zespołu ponownie renderowali załadowane przez siebie definicje narzędzi MCP, co zaburzało pamięć podręczną promptów danego agenta; ponadto załączniki zapisane wcześniej w konwersacji były ponownie renderowane po wznowieniu lub ponownym uruchomieniu, co usuwało rozszerzone rozumowanie i powodowało chybienie pamięci podręcznej promptów. To ten sam rodzaj błędu co w pakietach v2.1.265–267 — coś przepisywało prefiks, a wszystko po nim było ponownie wysyłane bez użycia pamięci podręcznej — teraz poprawiony również w przypadku danych wyjściowych SessionStart, definicji MCP wznowionych agentów oraz zapisanych załączników.²¹⁹

v2.1.280 dodaje dwie kolejne poprawki: zmiana modelu dokonana z poziomu aplikacji hosta (Claude Desktop, VS Code, SDK) podczas pracy Claude nie powoduje już chybienia pamięci podręcznej promptów przy następnym prompcie, a wznowiony subagent odgałęzienia ponownie wysyła listę narzędzi używaną pierwotnie, zamiast tworzyć ją od nowa, co wcześniej zaburzało pamięć podręczną promptów tego agenta.²²⁰

v2.1.281 dodaje trzy kolejne poprawki: sesja wznowiona po ponownym uruchomieniu w czasie oczekiwania na potwierdzenie uprawnień nie wysyła już innej historii niż wcześniej, co od tego momentu zaburzało pamięć podręczną promptów; serwer MCP, który rozłączy się w trakcie konwersacji lub nadal łączy się po wznowieniu, nie powoduje już utraty pamięci podręcznej, gdy wyszukiwanie narzędzi jest wyłączone (na przykład za serwerem proxy lub bramą); wznowione sesje nie wysyłają też ponownie wcześniejszych tur w zmienionej postaci, co mogło sprawić, że API pomijał wcześniejsze rozumowanie z konwersacji.²²⁴

Plany subskrypcyjne

Limity szybkości (sierpień 2025): Anthropic wprowadził tygodniowe limity szybkości dla płatnych subskrybentów. Subskrybenci planu Max mogą wykupić dodatkowe użycie ponad limit szybkości według standardowych stawek API.¹⁴

Podwojenie limitów szybkości (6 maja 2026): podczas wydarzenia Code with Claude SF firma Anthropic podwoiła pięciogodzinne limity szybkości Claude Code w planach Pro, Max, Team oraz Enterprise rozliczanych według stanowisk, zniosła obniżenie limitów w godzinach szczytu na kontach Pro i Max oraz „znacznie” podniosła limity szybkości API dla modeli Claude Opus. Zabezpieczeniem tej przepustowości 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 tygodniowego limitu o 50%, obowiązujące od majowej podwyżki, kończy się 14 września. Zastąpi je stałe zwiększenie o 25% względem poziomu sprzed majowej podwyżki w planach Pro, Max, Team oraz Enterprise rozliczanych według stanowisk. Według wyliczeń samej firmy Anthropic: „W porównaniu z obecnym poziomem oznacza to obniżenie tygodniowych limitów Claude Code o 17%”. Jeśli obecny tygodniowy limit wynosi 150 jednostek, 14 września spadnie do 125. Ogłoszenie nie dotyczy limitów pięciogodzinnych; majowe podwojenie pozostaje w mocy. Jeżeli uruchamiane są długie sesje bez nadzoru, warto już teraz przygotować się na niższy limit: najważniejsze mechanizmy kontroli to przełącznik automatycznej kontynuacji po zresetowaniu limitu (v2.1.234) oraz /usage.²¹³

Ceny tokenów API (październik 2026)^1144222239

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

Cena kontekstu 1M (kwiecień 2026): Opus 4.7, Opus 4.6, Sonnet 4.6 i Mythos Preview oferują kontekst 1M w standardowych stawkach za MTok — bez dopłaty za długi kontekst.¹⁴⁸ To niedawne ujednolicenie; starsze informacje o dwukrotnie wyższej cenie danych wejściowych i półtorakrotnie wyższej cenie danych wyjściowych w Opus 4.6 lub Sonnet 4.6 po przekroczeniu 200K tokenów wejściowych nie są już aktualne. Opus 4.5 i wcześniejsze modele starszej generacji zachowują pierwotne struktury cenowe.

Cena rezydencji danych: określenie 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+).¹⁴⁸

Pamięć podręczna promptów znacznie obniża koszty powtarzających się danych wejściowych: zapis w pamięci podręcznej kosztuje 1,25× ceny bazowej (pamięć podręczna na 5 minut) lub 2× (pamięć podręczna na 1 godzinę), ale odczyt kosztuje tylko 0,1×, co daje 90% oszczędności. W dwóch przypadkach stawki są jeszcze niższe: odczyty Claude Opus 5.5 kosztują 0,05× ($0.20/MTok, czyli 95% oszczędności), a odczyty Claude Fable 5.1 i Mythos 5.1 — 0,025× ($0.25/MTok w przypadku Fable 5.1, czyli 97,5% oszczędności).²⁴¹²²² W systemach RAG i asystentach programistycznych korzystających z powtarzalnego kontekstu pamięć podręczna może obniżyć koszty o 88–95%.

Wsadowe API oferuje 50% rabatu 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, w uzasadnionych przypadkach. Anthropic wyraźnie zezwala na wiele kont, jeśli służą różnym celom.

Co jest dozwolone:

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

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

Przykład z praktyki: w styczniu 2026 zaawansowany użytkownik Jeffrey Emanuel (@doodlestein) miał 22 konta Max, które zostały automatycznie oznaczone i tymczasowo zablokowane. Pracownik Anthropic, Thariq (@trq212), rozwiązał problem w ciągu 4 godzin po potwierdzeniu zgodnego z zasadami sposobu korzystania. Jeśli Claude Code jest intensywnie używany zarówno do projektów służbowych, jak i osobistych na wielu kontach, usługa została zaprojektowana właśnie z myślą o takim zastosowaniu — nie należy jednak próbować manipulować systemem.

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

Czynniki wpływające na koszty

Przykładowe koszty w praktyce

Koszty według cen katalogowych ($0.10/$0.50 za Haiku 5.5 dla promptów do 100K tokenów, $2/$10 za Sonnet 5.5, $4/$20 za Opus 5.5 na MTok), przed uwzględnieniem rabatów wynikających z pamięci podręcznej promptów.

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

Zarządzanie kosztami zespołu

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

Ukryte opłaty za narzędzia

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

Opłaty te kumulują się w pętlach agentów. Cykl debugowania obejmujący 100 iteracji z Bash kosztuje około 24 500 dodatkowych tokenów wejściowych wynikających wyłącznie z narzutu.

Strategie obniżania kosztów

1. Używać Haiku dla subagentów: większość eksploracji nie wymaga Sonnet
2. Włączyć pamięć podręczną promptów: jest domyślnie włączona, ale warto sprawdzić, czy nie została wyłączona
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ż subagenty działające w tle — po jego osiągnięciu uruchamianie nowych subagentów jest blokowane, a działające w tle agenty są zatrzymywane (wcześniej limit budżetu nie obejmował agentów działających w tle)¹⁹⁴
5. Używać trybu planowania do eksploracji: brak wykonywania oznacza brak przypadkowych, kosztownych operacji
6. Proaktywnie kompaktować kontekst: mniejszy kontekst = mniej tokenów
7. Ograniczyć dane wyjściowe: export CLAUDE_CODE_MAX_OUTPUT_TOKENS=2000
8. Używać wsadowego API do niepilnych zadań: 50% rabatu na tokeny wejściowe i wyjściowe
9. Profilować wydatki projektu na API Claude: /claude-api cost-optimize (v2.1.247+) profiluje wydatki istniejącego projektu na API Claude i kolejno analizuje mechanizmy optymalizacji kosztów (pamięć podręczną, gospodarowanie tokenami, przetwarzanie wsadowe, poziom wysiłku i wybór modelu), wprowadzając po jednej mierzalnej zmianie — dotyczy to aplikacji tworzonych za pomocą API, a nie samej sesji Claude Code²⁴⁵

Monitorowanie użycia

• Konsola Claude: platform.claude.com (wymaga roli Admin lub Billing)
• Limity obszaru roboczego: można ustawić limity wydatków dla poszczególnych obszarów roboczych
• Bedrock/Vertex: używać natywnych narzędzi chmurowych do monitorowania kosztów
• LiteLLM: szczegółowe śledzenie poszczególnych użytkowników u zewnętrznych dostawców

Zużycie tokenów w tle

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

Zwykle poniżej $0.04 na sesję.

Analityczne API Claude Code (Team/Enterprise)⁴⁶

Admin API umożliwia programowy 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"

Zastosowania: - Analiza produktywności programistów (sesje, commity, PR-y) - Wskaźniki użycia narzędzi (współczynniki akceptacji/odrzucenia dla Edit, Write itp.) - Śledzenie 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. Aby zapewnić spójność, odpowiedzi obejmują wyłącznie dane starsze niż 1 godzina.

Ramy decyzyjne

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

Którego modelu użyć?

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

Praktyczna zasada: od wersji v2.1.280 model domyślny nie zależy już od planu — każda sesja rozpoczyna się z modelem Opus 5.5, z wyjątkiem Microsoft Foundry — dlatego zamiast dotychczasowego „przejścia na Opus” należy teraz postępować odwrotnie: /model sonnet obniża koszt tokenów o połowę, gdy zadanie nie wymaga zaawansowanego rozumowania.^{181197207220221} W przypadku subagents warto przejść na Haiku. Przy Opus należy pozostać, jeśli odpowiedź po zmianie na słabszy model wydaje się powierzchowna. W agent teams (v2.1.32+) Opus może koordynować wiele agentów pracujących równolegle nad różnymi podzadaniami.⁷⁹

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 wiąże się z wyższymi kosztami; 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 przypadku Sonnet, gdy potrzebna jest bardziej dogłębna analiza.

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

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

Którego typu hook użyć?

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

Kiedy używać /fast?

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

/fast przełącza tryb szybki w bieżącej sesji. Zachowuje ten sam model — Opus 5.5 (domyślny model trybu szybkiego od wersji v2.1.280), Opus 5 lub Opus 4.8 — przy zoptymalizowanej szybkości generowania odpowiedzi. Nie przełącza na tańszy model i przy cenie 8/40 USD za MTok dla Opus 5.5 (10/50 USD dla Opus 5 i 4.8) również nie jest tańszy.^196198223

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 sprawnego przebiegu pracy. Warto również zapoznać się z sekcją Wdrożenie w przedsiębiorstwie, która opisuje zarządzane ustawienia wymuszające uprawnienia w całej organizacji.

Poziomy uprawnień

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

Możliwości narzędzia LSP (v2.0.74+): Narzędzie LSP zapewnia inteligentną analizę kodu podobną do tej dostępnej w IDE: - Przechodzenie do definicji: przejście do miejsca, w którym zdefiniowano symbol - Wyszukiwanie odwołań: wyświetlenie wszystkich użyć symbolu w całej bazie kodu - Dokumentacja po najechaniu 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ępności serwera językowego (zazwyczaj instalowanego wraz z zestawem narzędzi)

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

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

Narzędzie EndConversation (v2.1.214). Claude Code ma teraz tę samą możliwość kończenia rozmowy, którą Claude oferuje w serwisie claude.ai od 2025 roku: w rzadkich przypadkach skrajnie obraźliwych treści lub uporczywych prób jailbreaku Claude może bezpośrednio zakończyć sesję za pomocą wbudowanego narzędzia EndConversation. Jest to mechanizm zwiększający odporność na nadużycia i dbający o dobrostan modelu, a nie funkcja związana z przebiegiem pracy — podczas zwykłych sesji programistycznych nigdy nie jest uruchamiany.¹⁹⁰¹⁹³

Tryby uprawnień

v2.1.285 obejmuje również sesje nieinteraktywne. Sesje claude -p i Python Agent SDK u zewnętrznych dostawców lub przy wyłączonej telemetrii uruchamiają się teraz w trybie auto, jeśli nie skonfigurowano trybu uprawnień — „tak jak sesje interaktywne”; --permission-mode nadal ma pierwszeństwo. Jednorazowa propozycja ustawienia trybu auto jako domyślnego trybu uprawnień pojawia się teraz także u zewnętrznych dostawców i przy wyłączonej telemetrii, jeśli w ustawieniach użytkownika domyślnie wybrano inny tryb. Dokumentacja trybów uprawnień, pobrana 1 października, jest już z tym zgodna: sesja -p lub Agent SDK, która nie pobiera flag funkcji — na przykład u zewnętrznego dostawcy albo przy wyłączonej telemetrii — rozpoczyna się w trybie auto w v2.1.285 lub nowszej; sesja pobierająca te flagi rozpoczyna się w trybie default (Manual), podobnie jak sesja w organizacji, której zasady nie udostępniają domyślnego trybu auto.²²⁹²³³

v2.1.283 i v2.1.284 rozszerzają interaktywny tryb domyślny na wszystkie plany i wszystkich dostawców. Tryb auto jest teraz wbudowanym trybem początkowym interaktywnych sesji terminala i VS Code także w planie Enterprise, w Claude API oraz u zewnętrznych dostawców. Aby zachować tryb Manual, należy ustawić permissions.defaultMode na "default" w ~/.claude/settings.json, pliku .claude/settings.json projektu lub ustawieniach zarządzanych; wartość "auto" w plikach ustawień projektu nie jest uwzględniana.²²⁶²²⁷ Informacja o wydaniu v2.1.283 wymienia zewnętrznych dostawców i sesje z wyłączoną telemetrią; informacja o v2.1.284 wskazuje, że tryb ten jest domyślny „we wszystkich planach i u wszystkich dostawców”; dokumentacja trybów uprawnień datuje wprowadzenie tego ustawienia domyślnego na v2.1.283.²²⁷²²⁸ Ponadto w v2.1.284 monit trybu auto wyświetlany przed odczytem spoza katalogów roboczych zawiera opcję Tak, ale zapytaj ponownie następnym razem, która zezwala na ten jeden odczyt, zachowując monity przy kolejnych próbach.²²⁸

14 sierpnia 2026 roku tryb auto stał się domyślnym ustawieniem fabrycznym w planach Pro, Max i Team — zapowiedziano to 7 sierpnia, a w dniu zmiany potwierdziła ten fakt oficjalna dokumentacja trybów uprawnień. Jej obecne brzmienie dodaje 2 istotne szczegóły dotyczące zakresu: ustawienie domyślne dotyczy nowych sesji, a „domyślne ustawienie wybrane samodzielnie pozostaje bez zmian, chyba że zostanie zaakceptowany jednorazowy monit o przełączenie; domyślne ustawienie zarządzane 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 operacji nieodwracalnych, destrukcyjnych lub wymierzonych poza środowisko użytkownika”. Argument Anthropic za tą zmianą: w badaniu obejmującym 1 053 testerów tryb auto wykrył 89% niebezpiecznych poleceń, podczas gdy kontrola człowieka wykryła 13,6% — użytkownicy i tak zatwierdzają 97% monitów o uprawnienia, co w praktyce osłabia skuteczność ręcznej weryfikacji. Narzut tokenów klasyfikatora nie jest już naliczany w planach Pro/Max/Team (od momentu ogłoszenia). Powrót do poprzedniego trybu wymaga jednego użycia Shift+Tab (lub wybrania opcji z menu trybów w aplikacji komputerowej); inny tryb domyślny można przypiąć za pomocą defaultMode w ustawieniach; administratorzy organizacji mogą całkowicie wyłączyć tryb auto za pomocą zarządzanego ustawienia disableAutoMode. W chwili wprowadzenia zmiany Enterprise, Claude API, Claude Platform on AWS, Bedrock, Google Cloud’s Agent Platform i Foundry nadal wymagały samodzielnego włączenia, a Anthropic planował rozszerzyć na nie ustawienie domyślne „w nadchodzącym miesiącu”.²⁰³ Informacje o tym, czego tryb auto nie gwarantuje — oraz o zademonstrowanym przez badacza obejściu, które skłoniło Anthropic do takiego zastrzeżenia — znajdują się w sekcji Tryb auto w planie Max.

Pliki konfiguracyjne wykonujące kod wymagają teraz zatwierdzenia nawet w trybie acceptEdits (v2.1.160). Tryb acceptEdits automatycznie zatwierdza zwykłe edycje, ale od v2.1.160 zatrzymuje operację i wyświetla monit przed zapisem plików, które mogą umożliwić niejawne 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). Powodem jest to, że edycja dowolnego z tych plików może sprawić, iż następne uruchomienie powłoki, instalacja lub commit staną się wektorem wykonania kodu — dlatego nawet w trybie zaufanego projektu, który zwykle przepuszcza edycje bez pytania, wymagają one świadomego zatwierdzenia. Jest to ten sam model zagrożeń, na którym opierają się istniejące zabezpieczenia zapisu do .claude/, .git/ i .vscode/, rozszerzony na szerszą klasę plików, w których „edycja prowadzi do wykonania kodu”.²⁶⁵

Tryb auto (v2.1.85+): Bezpieczniejszy zamiennik --dangerously-skip-permissions. Oddzielny model klasyfikatora — Claude Sonnet 5 od v2.1.210 (pierwotnie Sonnet 4.6) — sprawdza każdą operację przed wykonaniem, weryfikując, czy odpowiada ona intencji użytkownika i jest bezpieczna.¹²⁴¹⁸⁷

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

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

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

# 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ż samodzielnego włączenia (v2.1.152), działa w Bedrock/Vertex/Foundry bez flagi środowiskowej (v2.1.207), 14 sierpnia 2026 roku stał się domyślnym ustawieniem fabrycznym w planach Pro/Max/Team, a od v2.1.283-284 jest wbudowanym trybem początkowym interaktywnych sesji we wszystkich planach i u wszystkich dostawców.^{267185203226228} Tryb YOLO (v2.0.68+): Aby korzystać z w pełni autonomicznego działania bez żadnego klasyfikatora bezpieczeństwa, należy użyć flagi --dangerously-skip-permissions. Flaga zatwierdza wszystko: edycje plików, polecenia bash oraz wszystkie wywołania narzędzi. Słowo „dangerous” użyte jest celowo. W większości przypadków zalecaną alternatywą jest tryb Auto.⁵⁴

claude --dangerously-skip-permissions

Ustawianie trybu za pomocą CLI:

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

Przełączanie w trakcie sesji:

Shift+Tab  # Cycles through modes

W pliku settings.json:

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

Ograniczenie zakresu dla defaultMode (v2.1.257): pliki .claude/settings.json i .claude/settings.local.json projektu nie mogą już ustawiać defaultMode: "bypassPermissions" — wartość ta jest w nich ignorowana, podobnie jak wcześniej "auto". Dokumentacja określa teraz tę regułę wprost: wartości auto i bypassPermissions opcji permissions.defaultMode „nie działają w ustawieniach projektu ani ustawieniach lokalnych” — należy ustawić je w ustawieniach użytkownika lub zarządzanych albo dla konkretnej sesji za pomocą --permission-mode. Sklonowane repozytorium nie może więc zawierać pliku ustawień uruchamiającego sesje z pominięciem uprawnień. (Powyższy przykład korzysta z acceptEdits, które można ustawić w dowolnym zakresie; ten przewodnik nie odnotowywał też istniejącego wcześniej ograniczenia dotyczącego auto — teraz uwzględnia oba.)²¹¹²⁴³