agent:~/.claude$ cat claude-code-cheatsheet.md

Ściąga Claude Code: polecenia, konfiguracja i skróty

# Ściąga Claude Code dla v2.1.317: flagi CLI, polecenia slash, skróty klawiszowe, tryby uprawnień, modele (Opus 5.5 domyślnie w każdym planie), hooki, wtyczki, Workflow i zmienne środowiskowe.

author: words: 12020 read_time: 46m updated: 2026-11-03 19:36

Part 2 of New to Claude Code

$ less claude-code-cheatsheet.md

Każda flaga CLI, polecenie slash, skrót klawiszowy, klucz konfiguracyjny, zdarzenie hook i zmienna środowiskowa w jednym miejscu. Szczegółowe wyjaśnienia znajdują się w pełnym przewodniku Claude Code. Informacje o pierwszej konfiguracji znajdują się w przewodniku szybkiego startu.

1. Instalacja

Trzy metody instalacji, w kolejności preferencji.

# Native binary (recommended)
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew (macOS)
brew install --cask claude-code

# NPM (deprecated — migrate with `claude install`)
npm install -g @anthropic-ai/claude-code

Instalacja konkretnej wersji:

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Weryfikacja instalacji:

claude doctor
claude --version

W wersjach od 2.1.288 do 2.1.290 należy zaktualizować do 2.1.291 lub nowszej: poprawka usuwa regresję z 2.1.288, przez którą ostatnie wiadomości sesji mogły zostać utracone przy wyjściu, oraz regresję z 2.1.290, przez którą sesje w chmurze mogły gubić odpowiedzi na monity o uprawnienia.

Uwierzytelnianie:

claude auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. Flagi CLI

Flaga Opis Przykład
-p Tryb print — jedno zapytanie, a następnie zakończenie claude -p "list TODOs"
-c Kontynuacja ostatniej sesji claude -c
-r, --resume Wznowienie sesji o podanej nazwie lub numerze claude -r "auth-refactor"
-n, --name Ustawienie wyświetlanej nazwy sesji przy uruchomieniu claude -n "feature-x"
--model Nadpisanie modelu dla tej sesji claude --model opus
--advisor <model> Włączenie narzędzia doradcy (advisor) po stronie serwera na jedną sesję (fable, opus, sonnet lub pełny identyfikator); nie figuruje w --help; ma pierwszeństwo przed ustawieniem advisorModel claude --advisor opus
--max-turns Ograniczenie liczby autonomicznych tur claude -p "fix lint" --max-turns 10
--output-format Wyjście jako text, json lub stream-json claude -p "count files" --output-format json
--allowedTools Ograniczenie dostępnych narzędzi claude -p "fix" --allowedTools "Edit,Bash(npm:*)"
--permission-mode Ustawienie trybu uprawnień claude --permission-mode auto
--permission-mode auto Uruchomienie z włączonym trybem Auto (zastąpiła --enable-auto-mode, usuniętą w v2.1.111); od v2.1.302 sesja claude -p lub sesja Agent SDK startuje w trybie Manual, chyba że flaga zostanie przekazana claude --permission-mode auto
--dangerously-skip-permissions Tryb YOLO — pominięcie wszystkich monitów claude --dangerously-skip-permissions
--from-pr Uruchomienie sesji powiązanej z PR-em (v2.1.27+); przyjmuje adresy URL GitHub, GHE, GitLab MR i Bitbucket PR (v2.1.119+) claude --from-pr 123
--fork-session Rozgałęzienie (fork) wznowionej sesji claude -r base --fork-session
-w Uruchomienie w izolowanym git worktree claude -w
--bare Tryb skryptowy — pomija hooks, LSP i plugins; od v2.1.286 łączy się wyłącznie z serwerami MCP wskazanymi w wierszu poleceń, nie wysyła przypomnień systemowych i nie uruchamia zadań w tle claude -p "count files" --bare
--plugin-url <url> Pobranie archiwum .zip z pluginem na bieżącą sesję (v2.1.129+) claude --plugin-url https://example.com/plugin.zip
--plugin-dir <path> Załadowanie katalogu pluginu, archiwum .zip lub folderu z pluginami – ładowany jest każdy podfolder z manifestem, a zmiany są wychwytywane na bieżąco (.zip od v2.1.128+, tryb folderu od v2.1.265+) claude --plugin-dir ./my-plugin.zip
--channels Przekazywanie monitów o zatwierdzenie do Telegrama/Discorda claude --channels
--forward-subagent-text Dołączenie tekstu i myślenia subagentów do wyjścia stream-json (v2.1.211+); zmienna środowiskowa: CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1 claude -p "audit" --output-format stream-json --forward-subagent-text
--ax-screen-reader Włączenie trybu czytnika ekranu (v2.1.208+); także CLAUDE_AX_SCREEN_READER=1 lub "axScreenReader": true claude --ax-screen-reader
--desktop Otwarcie aplikacji desktopowej Claude w bieżącym katalogu albo na sesji wskazanej przez --continue / --resume <id> (v2.1.285+) claude --desktop --continue
--cloud Uruchomienie z terminala sesji w chmurze dla bieżącego repozytorium (--remote to przestarzały alias); z -p oraz identyfikatorem sesji lub adresem URL claude.ai/code dodaje jedną wiadomość do kolejki działającej sesji w chmurze i kończy działanie claude --cloud "Fix the flaky login test"
--debug Włączenie logowania debugowania claude --debug
--init Inicjalizacja projektu z plikiem CLAUDE.md claude --init

Podpolecenie dodane w v2.1.212: claude auto-mode reset resetuje stan trybu auto z poziomu terminala; flaga --yes pomija monit o potwierdzenie.7

Podpolecenia sesji i danych: claude attach <name> i claude logs <name> przyjmują fragment nazwy sesji w tle zamiast jej identyfikatora (v2.1.290+). claude purge [path] usuwa lokalny stan Claude Code projektu (--dry-run pokazuje podgląd); przed v2.1.288 polecenie nazywało się claude project purge, a stara nazwa nadal działa, wyświetlając powiadomienie. Od v2.1.300 claude remote-control nie przyjmuje już --sandbox ani --no-sandbox (nie miały żadnego efektu; należy ustawić sandbox.enabled w ustawieniach). Od v2.1.309 claude ultrareview wymaga zaufania do obszaru roboczego: w terminalu pyta o nie, a w innych przypadkach odmawia; skrypty przekazują --trust-workspace (bez wartości; numer PR lub gałąź bazową należy podać przed nią) albo ustawiają CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1.14 claude self-hosted-runner --hold-idle-file <path> --max-hold-min <n> utrzymuje bezczynną sesję, dopóki host zmienia wskazany plik, a po n minutach zwalnia ją niezależnie od tego (domyślnie 1440; v2.1.311+).


3. Polecenia slash

Polecenie Działanie
/init Inicjalizuje projekt z plikiem CLAUDE.md
/compact Kondensuje historię rozmowy. Można dodać ukierunkowanie: /compact focus on tests
/autocompact Określa, jak bardzo zapełnione musi być okno kontekstu, zanim nastąpi automatyczna kompaktacja: /autocompact 500k lub auto dla dostrojonej wartości domyślnej. Od v2.1.288 ustawienie jest zapisywane osobno dla każdego modelu, więc każdy model zachowuje własne okno
/context Pokazuje wykorzystanie okna kontekstu wraz z konkretnymi sugestiami działań
/diff Pełnoekranowy panel diff obok rozmowy, pokazujący na żywo niezatwierdzone zmiany w miarę jak Claude edytuje pliki; przełączanie poleceniem /diff (v2.1.260)
/usage Zużycie tokenów, koszt, wykorzystanie planu; scalone okno dialogowe (od v2.1.118: /cost i /stats to skróty wpisywane z klawiatury, które otwierają zakładki /usage); od v2.1.149 dochodzi wykorzystanie limitów w podziale na kategorie: skills, subagents, plugins, a także koszt w rozbiciu na serwery MCP; v2.1.299 dodaje ostrzeżenia dotyczące poziomu effort max, workflows, stale aktywnego kontekstu i dużych wyników narzędzi; v2.1.305 zamienia każde ostrzeżenie w jednowierszową poprawkę wskazującą jej źródło, a klawisz f stosuje poprawki (także w VS Code i w /doctor)
/cost Skrót wpisywany z klawiatury → otwiera zakładkę kosztów w /usage (od v2.1.118)
/model Zmienia model. /model opus, /model sonnet; nazwy nie zawierają już sufiksu [1m] tam, gdzie nie ma on żadnego efektu, a sam sufiks jest nadal akceptowany (od v2.1.311)
/advisor Ustawia, pokazuje lub wyłącza model doradczy, z którym Claude konsultuje się w punktach decyzyjnych (eksperymentalne narzędzie serwerowe). /advisor opus, /advisor off; forma tekstowa w sesjach headless i desktopowych od v2.1.260; na Claude Platform w AWS od v2.1.300
/fast Przełącza tryb szybkiego generowania (fast mode) – Opus 5.5 (domyślny od v2.1.280, $8/$40 za MTok), Opus 5 lub Opus 4.8 ($10/$50; tryb fast dla Opus 4.8 jest przestarzały od 30 października 2026, a 30 listopada zostanie usunięty); v2.1.219 usunęła Opus 4.7; ok. 2,5× szybsze generowanie; od v2.1.271 działa w sesjach Remote (runnery w chmurze i hostowane samodzielnie); wysłane z widoku agenta ustawia tryb, z którym startują nowe sesje, a samo /fast otwiera tam selektor (od v2.1.299)
/effort Ustawia poziom effort: low, medium, high, xhigh, max (domyślnie medium na Opus 5.5 i Sonnet 5.5, high na większości pozostałych modeli). Od v2.1.284 Ultracode ma własny przełącznik: Tab na suwaku albo /effort ultracode on / /effort ultracode off; nie wymusza już xhigh i pozostaje włączony na każdym poziomie; w widoku agenta samo /effort otwiera selektor, a wybrany poziom obowiązuje w nowych sesjach (od v2.1.299). Wpisanie ultrathink w prompcie terminala uruchamia daną turę na poziomie xhigh na Opus 5.5, Sonnet 5.5, Haiku 5.5 i Fable 5.1 (od v2.1.311; CLAUDE_CODE_DISABLE_ULTRATHINK=1 wyłącza tę funkcję)
/status Pokazuje stan sesji, model i ustawienia
/permissions Interaktywnie zarządza ustawieniami uprawnień
/auto-mode-setup Konfiguracja krok po kroku, która na podstawie projektu i ostatnich sesji przygotowuje szkic wpisów autoMode.environment (pola zaufania i wrażliwości); dostępna także na Bedrock, Vertex, Foundry, bramkach oraz przy wyłączonej telemetrii (od v2.1.304)
/config Otwiera pełny interfejs ustawień; wiersz Idle compaction wyłącza lub ponownie włącza kompaktację podczas bezczynności (od v2.1.302)
/mcp Konfiguruje serwery MCP. /mcp enable, /mcp disable; /mcp reconnect all ponawia połączenie z każdym serwerem, który nie zdołał się połączyć lub wymaga uwierzytelnienia (od v2.1.284)
/hooks Pokazuje konfigurację hooks; otwiera się na jednej liście skonfigurowanych hooks, pogrupowanych według zdarzenia (od v2.1.286)
/memory Przegląda pliki pamięci automatycznej (auto-memory) i zarządza nimi
/copy Kopiuje bloki kodu. /copy N dla N-tej odpowiedzi od końca; cytowany tekst kopiuje się bez znaczników > (od v2.1.295)
/resume Wznawia sesję o podanej nazwie. /resume 1 lub /resume name; w planach Pro i Max pojawia się ostrzeżenie, gdy wznowienie nieaktywnej rozmowy zużyłoby zauważalną część limitu 5-godzinnego (od v2.1.304)
/rename Nadaje nazwę bieżącej sesji. /rename feature-auth
/branch Rozgałęzia rozmowę na potrzeby równoległej eksploracji
/fork Kopiuje rozmowę do nowej sesji w tle — z własnym wierszem w claude agents (nowe przeznaczenie od v2.1.212); od v2.1.221 kopia dostaje własny worktree
/subtask Rozwidlenie w obrębie sesji — dawne zachowanie /fork pod nową nazwą (v2.1.212)
/list-agents Wyświetla listę wszystkich agentów, do których Claude może wysyłać wiadomości: subagents, pozostałe sesje lokalne oraz (z Remote Control) sesje na innych maszynach (v2.1.224)
/peers Alias polecenia /list-agents (v2.1.224)
/clear Czyści historię rozmowy
/plan Przechodzi w tryb planowania. /plan refactor the auth module
/powerup Interaktywne lekcje funkcji z animowanymi pokazami (od v2.1.90)
/voice Przełącza tryb głosowy push-to-talk
/loop Zadania cykliczne. /loop 5m /foo uruchamia się co 5 min
/schedule Tworzy zaplanowane zadanie w chmurze (dawniej „routine”): w formie rozmowy albo poleceniem /schedule daily PR review at 9am; alias /routines; wymaga zalogowania do claude.ai z włączonymi sesjami w chmurze
/slides Tworzy prezentację Claude Slides jako artefakt na podstawie briefu; beta szablonów jest domyślnie włączona w planach Pro, Max i Team
/rewind Powrót do punktu kontrolnego (lub dwukrotne naciśnięcie Esc)
/export Eksportuje transkrypcję rozmowy
/add-dir Dodaje katalogi robocze, rozszerzając dostęp do plików
/agents Usunięte w v2.1.198 – o utworzenie subagents lub zarządzanie nimi należy poprosić Claude albo bezpośrednio edytować .claude/agents/; wpisanie /agents wyjaśnia, gdzie podział się kreator
/goal Ustawia warunek ukończenia; Claude kontynuuje pracę, aż cel zostanie osiągnięty (od v2.1.139)
/skills Wyświetla listę zainstalowanych skills; pole wyszukiwania filtrujące w trakcie pisania (od v2.1.121)
/skill-doctor Pokazuje, które załadowane skills pozostają nieużywane i ile kosztują w kontekście (od v2.1.261)
/bashes Wyświetla listę zadań bash działających w tle
/tasks Wyświetla listę agentów działających w tle
/theme Zarządza nazwanymi motywami (od v2.1.118); plugins dostarczają katalog themes/
/output-style [name] Wyświetla listę stylów wyjścia i przełącza między nimi; wycofane w wersjach v2.1.73-v2.1.268 na rzecz /config, przywrócone w v2.1.269 – działa przez Remote Control oraz w sesjach chmurowych i headless
/color Ustawia kolor paska promptu. /color default przywraca domyślny
/code-review [effort] Wyszukuje błędy poprawności działania na opcjonalnym poziomie effort; --comment publikuje komentarze inline do PR w serwisie GitHub (zmiana nazwy z /simplify w v2.1.147). Od v2.1.218 działa jako subagent w tle. Od v2.1.223 /review jest aliasem tego polecenia, samo /code-review ponownie używa ostatnio wpisanego poziomu effort, a /code-review ultra to dogłębny przegląd w chmurze. --max-findings <n> lub --max-findings all zgłasza więcej lub mniej ustaleń niż zwykły limit i jest zapamiętywane do czasu wpisania --max-findings default (od v2.1.288)
/batch Operacje wsadowe
/security-review Przegląda kod pod kątem luk w zabezpieczeniach
/claude-api Tworzenie aplikacji z użyciem Claude API/Anthropic SDK. /claude-api managed-agents-onboard <url> zamienia wzorzec Managed Agents ze wskazanej strony w pliki ant apply; zamiast tego można podać nazwę szybkiego startu z Console, np. deep-researcher, aby zbudować ten szablon za pomocą CLI ant (od v2.1.290); /claude-api api-version migruje kod API do wersji API 2026-10-21 (od v2.1.307); managed-agents-secure [<agent-id>] sprawdza ustawienia Managed Agent pod kątem zgodności z przewodnikiem bezpiecznego wdrażania (od v2.1.304)
/doctor Pełny przegląd konfiguracji — diagnozuje i naprawia problemy (v2.1.205; /checkup jest aliasem). /doctor prompt-audit (od v2.1.283) audytuje pliki CLAUDE.md, skills, agentów i polecenia pod kątem wzorców promptowania pisanych z myślą o starszych modelach
/bug Zgłasza błąd do Anthropic
/release-notes Interaktywny selektor wersji z listami zmian (od v2.1.92)
/buddy Terminalowy zwierzak-towarzysz — 18 gatunków, 5 poziomów rzadkości, wyznaczany deterministycznie na podstawie ID konta
/login / /logout Logowanie lub wylogowanie w trakcie sesji

Polecenia niestandardowe: Wystarczy utworzyć plik .claude/commands/my-command.md (projektowy) lub ~/.claude/commands/my-command.md (osobisty) i wywołać go poleceniem /my-command. Polecenia obsługują frontmatter YAML z opisem, dozwolonymi narzędziami, nadpisaniem modelu oraz interpolacją argumentów przez $ARGUMENTS lub pozycyjne $1, $2.

---
description: Fix a GitHub issue
allowed-tools: Read, Edit, Bash(git:*)
model: opus
argument-hint: [issue-number]
---

Fix GitHub issue #$ARGUMENTS following our coding standards.

Użycie: /fix-issue 123

4. Skróty klawiaturowe

Sterowanie ogólne

Skrót Działanie
Ctrl+C Anulowanie bieżącej operacji lub wyczyszczenie promptu; Up na pustym prompcie przywraca szkic, łącznie z wklejonymi treściami i obrazami (v2.1.288+), nawet po poleceniu ukośnikowym lub wysłanej wiadomości (v2.1.292+)
Ctrl+D Zakończenie sesji (EOF)
Ctrl+L Wyczyszczenie ekranu (historia zostaje zachowana)
Ctrl+O Przełączanie szczegółowego wyjścia
Ctrl+R Przeszukiwanie historii poleceń
Ctrl+V Wklejenie obrazu ze schowka
Ctrl+B Przeniesienie bieżącej operacji w tło
Ctrl+Enter (lub Ctrl+X Ctrl+S) Wyślij teraz: wysłanie wszystkich wiadomości z kolejki naraz; tekst w kolejce wyświetla się na szaro do chwili odebrania (v2.1.275+). Od v2.1.281 działające narzędzia przechodzą w tło zamiast anulowania tury
Ctrl+X Ctrl+K Zatrzymanie wszystkich agentów (zmienione z Ctrl+F w v2.1.83; na drugi klawisz przewidziano 3-sekundowe okno z komunikatem o limicie czasu, v2.1.265+)
Ctrl+S Odłożenie szkicu promptu
Ctrl+G Otwarcie zewnętrznego edytora; edytory przyjmujące numer wiersza otwierają się w wierszu, w którym stoi kursor (v2.1.286+)
Esc Esc Cofnięcie ostatniej zmiany
Tab Zaakceptowanie podpowiedzi promptu
! Tab Autouzupełnianie z historii Bash
Shift+Tab Przełączanie trybów uprawnień
Alt+P / Option+P Zmiana modelu podczas pisania
Alt+T Przełączanie trybu myślenia
Ctrl+T Przełączanie podświetlania składni
Shift+Down Przełączanie między członkami zespołu agentów
Up/Down Nawigacja po historii poleceń
v Tryb wizualny Vim — zaznaczanie znaków (v2.1.118+; tylko w trybie vim)
V Tryb wizualny liniowy Vim (v2.1.118+; tylko w trybie vim)
% Vim: skok do pasującego nawiasu (), [] lub {}; d%, c%, y% działają z jego użyciem (v2.1.301+; tylko w trybie vim)
? Wyświetlenie skrótów

Szybkie prefiksy

Prefiks Działanie Przykład
# Dodanie do pamięci trwałej # Always use TypeScript
/ Polecenie ukośnikowe /review
! Bezpośrednie wykonanie polecenia bash ! git status
@ Odwołanie do pliku @src/index.ts
& Wysłanie zadania do chmury & Build the API

Wprowadzanie wielowierszowe

Metoda Klawisze
Nowa linia ze znakiem ucieczki \, a następnie Enter
macOS Option+Enter
iTerm2/WezTerm/Ghostty/Kitty Shift+Enter
Inne terminale Shift+Enter (najpierw należy uruchomić /terminal-setup)
Znak sterujący Ctrl+J

Skróty klawiszowe można dostosować za pomocą /keybindings (zapisywane w ~/.claude/keybindings.json). Od v2.1.284 akcje effortSlider:decreaseEffort, increaseEffort i toggleUltracode pozwalają na nowo przypisać klawisze strzałek i Tab suwaka /effort.


5. Pliki konfiguracyjne

Hierarchia pierwszeństwa (od najwyższego do najniższego)

Poziom Lokalizacja Zakres
Enterprise (zablokowane) /Library/Application Support/ClaudeCode/managed-settings.json (macOS) Wszyscy użytkownicy, bez możliwości nadpisania
Flagi CLI Argumenty wiersza poleceń Bieżąca sesja
Projekt lokalny .claude/settings.local.json Osobiste, bieżący projekt (ignorowane przez git)
Projekt współdzielony .claude/settings.json Zespołowe, wersjonowane w git
Globalne użytkownika ~/.claude/settings.json Wszystkie projekty użytkownika
Stan środowiska uruchomieniowego ~/.claude.json Tokeny OAuth, konfiguracja MCP

Pierwsze dopasowanie wygrywa. Ustawień Enterprise nie można obejść.


6. Settings.json — przegląd

Kluczowe ustawienia wraz z typami i przykładami. Można je umieścić w dowolnym pliku ustawień z powyższej hierarchii.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Read", "Glob", "Grep", "Bash(npm run:*)", "Bash(git:*)", "Edit(src/**)"],
    "deny": ["Read(.env*)", "Bash(rm -rf:*)", "Bash(sudo:*)"],
    "ask": ["WebFetch", "Bash(docker:*)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared-lib"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "hooks": {},
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true
  },
  "cleanupPeriodDays": 30,
  "respectGitignore": true,
  "showTurnDuration": true,
  "language": "en",
  "autoMemoryDirectory": ".claude/memory",
  "plansDirectory": ".claude/plans"
}

Składnia reguł uprawnień: Tool(pattern:*) zapewnia dopasowanie po prefiksie. Bash(npm run test:*) zezwala na npm run test, npm run test:unit itd. Wzorce plików używają składni glob: Edit(src/**). Od v2.1.214 jednosegmentowa reguła allow dir/** pasuje wyłącznie do <cwd>/dir — a nie, jak wcześniej, do dowolnego dir/ w całym drzewie; aby dopasować na dowolnej głębokości, należy zapisać Edit(**/src/**). Reguły deny/ask zachowują dopasowanie na dowolnej głębokości, a warunki if: hooków podlegają takiemu samemu ograniczeniu do cwd. Od v2.1.299 reguła allow dla MCP obejmuje tylko serwer, który wskazuje: mcp__a nie obejmuje już serwera o nazwie a__b ani a_; należy zapisać mcp__<server>__* z pełną znormalizowaną nazwą.

Nowe klucze (v2.1.118+):

Klucz Działanie
autoMode.allow $defaults Wartość specjalna (sentinel), która dodaje własne reguły obok wbudowanej listy (także dla soft_deny, environment) — v2.1.118+
prUrlTemplate Szablon adresu URL plakietki PR w stopce — v2.1.119+
wslInheritsWindowsSettings WSL dziedziczy ustawienia zarządzane po stronie Windows — v2.1.118+
skillOverrides Ukrywanie lub zwijanie skills: off, user-invocable-only lub name-only — v2.1.129+
allowAllClaudeAiMcps Ustawienie zarządzane Enterprise, które ładuje chmurowe konektory MCP z claude.ai obok managed-mcp.json — v2.1.149+
allowClaudeInChromeWithManagedMcp Ustawienie zarządzane, które pozwala uruchamiać claude --chrome obok wyłącznego managed-mcp.json – v2.1.282+
sandbox.filesystem.disabled Pominięcie izolacji systemu plików przy zachowaniu kontroli ruchu wychodzącego — v2.1.216+
emojiCompletionEnabled Autouzupełnianie skrótów emoji w polu promptu (:heart: → ❤️); wartość false wyłącza funkcję — v2.1.217+
sandbox.network.strictAllowlist Odrzucanie hostów spoza listy dozwolonych dla poleceń w sandboksie bez pytania — v2.1.219+
sandbox.allowNestedUserNamespaces Zezwolenie poleceniom w sandboksie na Linuksie i WSL2 na tworzenie przestrzeni nazw użytkownika (Chromium, rootless podman); pozwala im to również ominąć zabezpieczenia plików sandboksa – ustawienia użytkownika lub zarządzane, v2.1.305+
workflowSizeGuideline Ustawienie orientacyjnej wytycznej rozmiaru Dynamic workflow z dowolnego pliku ustawień; domyślnie medium („należy dążyć do mniej niż 15 agentów”), a wiersz w /config pozostaje ukryty, dopóki wytyczna jest ustawiona — v2.1.219+
enableWorkflows / disableWorkflows enableWorkflows włącza lub wyłącza dynamiczne workflow dla bieżącego użytkownika (zapisuje je przełącznik Dynamic workflows w /config; domyślnie włączone, z wyjątkiem planu Pro); disableWorkflows: true wyłącza je dla wszystkich, do których docierają dane ustawienia, np. ustawienia zarządzane
syncClaudeAiSkills / syncClaudeAiPlugins Skills i plugins z konta claude.ai synchronizują się z sesjami terminala zalogowanymi na to konto; wartość false wyłącza synchronizację – v2.1.275+
attribution Atrybucja commitów i PR; zastępuje przestarzałe includeCoAuthoredBy. "attribution": false ukrywa ją w całości (v2.1.281+), ale starsze wersje CLI pomijają plik ustawień, który ją zawiera, dlatego w plikach współdzielonych między wersjami warto zachować formę obiektową (commit, pr, sessionUrl)
maxProseWidth Ograniczenie szerokości tekstu Claude w szerokich terminalach (liczba całkowita kolumn, minimum 40); tabele i bloki kodu zachowują pełną szerokość – v2.1.282+
deniedModels Zarządzane: blokowanie konkretnych modeli nawet wtedy, gdy availableModels na nie zezwala; alias rodziny, np. "opus", blokuje całą rodzinę – v2.1.283+
availableModelsMatch Zarządzane: "exact" sprawia, że każdy wpis availableModels zezwala wyłącznie na wskazaną w nim wersję, więc nowe wydania pozostają zablokowane do czasu dodania ich do listy (domyślnie "prefix") – v2.1.283+
allowedProviders Zarządzane: ograniczenie, z których dostawców API może korzystać dana maszyna (Anthropic API, własny endpoint, Bedrock, Mantle, Vertex AI, Foundry, Claude Platform na AWS lub brama Cloud) – v2.1.285+
idleCompaction false wyłącza kompaktowanie w bezczynności, które kompaktuje rozmowę o 200K+ tokenów pozostawioną bezczynnie przez około 54 minuty, zanim wygaśnie jej godzinna pamięć podręczna promptu (CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS przesuwa próg); od v2.1.314 działa także w VS Code i na karcie Code aplikacji desktopowej, przy wyłączonej telemetrii, a także na Bedrock, Vertex, Foundry i bramach, gdy włączona jest godzinna pamięć podręczna promptu – dostarczone w v2.1.299; dokumentacja datuje ten klucz na v2.1.290+
advisorModel Zapisany model doradcy (fable, opus, sonnet lub pełny identyfikator); /advisor zapisuje go w ustawieniach użytkownika, --advisor nadpisuje go na czas sesji, a CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 wyłącza narzędzie
permissions.blockWritesOutsideWorkingDirectories Write, Edit i NotebookEdit odrzucają ścieżki spoza katalogów roboczych w każdym trybie uprawnień, łącznie z bypassPermissions; polecenia powłoki, narzędzia MCP i hooks nie podlegają temu ograniczeniu, a narzędzia EnterWorktree i ExitWorktree znikają na czas jego włączenia. Włączyć je może dowolny plik ustawień; żaden nie może go znieść – v2.1.314+
disableRemoteControl Odrzucanie claude remote-control, --remote-control, automatycznego startu i przełącznika w sesji; dowolny plik ustawień, a do wymuszania przez MDM ustawienia zarządzane. /remote-control wskazuje to ustawienie, gdy jest ono ustawione (v2.1.317+)

Pełny schemat ustawień znajduje się w sekcji Szczegółowe omówienie konfiguracji pełnego przewodnika.


7. Skrócony przewodnik po CLAUDE.md

CLAUDE.md to plik instrukcji projektu. Claude odczytuje go na początku każdej sesji.

Gdzie się znajduje:

Lokalizacja Zakres
CLAUDE.md (katalog główny projektu) Wszyscy użytkownicy, wszystkie sesje w tym projekcie
.claude/CLAUDE.md To samo, lokalizacja alternatywna
~/.claude/CLAUDE.md Osobisty, wszystkie projekty

AGENTS.md (v2.1.277+): w projekcie bez pliku CLAUDE.md Claude Code odczytuje zamiast niego AGENTS.md – to zachowanie można zmienić w sekcji „Project instructions” w /config (jeszcze niedostępne na Bedrock/Vertex/Foundry).

Co warto uwzględnić:

# Project Name

## Stack
- Backend: FastAPI, Python 3.11+
- Frontend: HTMX + Alpine.js + Bootstrap 5

## Commands
- Dev: `uvicorn app.main:app --reload --port 8000`
- Test: `python -m pytest -v`
- Lint: `ruff check .`

## Conventions
- Conventional commits: feat:, fix:, docs:, refactor:
- Never force push to main
- Always activate venv before Python commands

## Key Files
- app/main.py — FastAPI app and routes
- app/models.py — SQLAlchemy models

Plik powinien dać się szybko przejrzeć. Gęsta proza marnuje tokeny kontekstu w każdej sesji. Warto używać punktów, tabel i krótkich bloków kodu. Należy unikać długich akapitów — Claude odczytuje CLAUDE.md na początku każdej sesji, więc każde słowo kosztuje kontekst.

Wskazówki dla zaawansowanych: - Prefiks # w REPL pozwala dodawać wpisy do pamięci automatycznej bez edytowania CLAUDE.md: # Always use TypeScript strict mode - CLAUDE.md w podkatalogach jest wczytywany, gdy Claude odczytuje pliki w danym katalogu - Reguły wspólne dla zespołu trafiają do .claude/rules/*.md, co zapewnia modułową organizację


8. Tryby uprawnień

Tryb Zachowanie Zastosowanie
default / manual — oznaczony jako „Manual” (v2.1.200+) Pyta przy pierwszym użyciu każdego narzędzia Zwykła praca programistyczna
acceptEdits Automatycznie zatwierdza edycje plików, pyta o polecenia bash Zaufane projekty
auto Klasyfikator (Sonnet 5 od v2.1.210, pierwotnie Sonnet 4.6) sprawdza bezpieczeństwo każdej akcji Praca autonomiczna z zabezpieczeniami
plan Tylko do odczytu — bez edycji i wykonywania poleceń Wyłącznie analiza i planowanie
bypassPermissions Pomija wszystkie pytania Automatyzacja CI/CD

Tryb Auto (v2.1.85+) to wbudowany tryb startowy interaktywnych sesji w terminalu i VS Code na każdym planie i u każdego dostawcy: wersja v2.1.283 rozszerzyła go na dostawców zewnętrznych i sesje z wyłączoną telemetrią, a v2.1.284 na każdy plan i każdego dostawcę; wcześniej był domyślny tylko na planach Pro, Max i Team (od 14 sierpnia 2026). Od v2.1.285 do v2.1.301 sesje claude -p oraz sesje Python Agent SDK u dostawców zewnętrznych lub z wyłączoną telemetrią również startowały w trybie auto, gdy nie skonfigurowano żadnego trybu uprawnień; v2.1.302 to odwraca: sesja claude -p lub Agent SDK bez ustawionego trybu uprawnień startuje w trybie Manual u dostawców zewnętrznych, z wyłączoną telemetrią oraz na świeżej instalacji, tak jak zawsze działo się tam, gdzie pobierane są flagi funkcji, a --permission-mode auto zachowuje tryb auto.13 permissions.defaultMode nadpisuje wbudowane ustawienie domyślne ("default" przypina tryb Manual), a disableAutoMode wyłącza go w całej organizacji. Jest to zalecany zamiennik --dangerously-skip-permissions. Operacje tylko do odczytu i edycje plików są zatwierdzane automatycznie; od v2.1.281, tam gdzie przegląd klasyfikatora odbywa się po stronie serwera, polecenia powłoki tylko do odczytu i uruchamiane w piaskownicy również na niego czekają i są blokowane, gdy je oflaguje. Własne reguły allow/deny rozstrzygane są w pierwszej kolejności. Wszystko inne trafia do klasyfikatora bezpieczeństwa. Domyślnie blokowane automatycznie: curl | bash, wymuszony push na main, wdrożenia produkcyjne, masowe usuwanie zasobów w chmurze, zmiany IAM, wysyłanie danych wrażliwych na zewnątrz.1

Bezpiecznik: 3 kolejne blokady lub 20 łącznie w jednej sesji powodują powrót do ręcznego pytania o zgodę.

Pytanie trybu auto przed odczytem poza katalogami roboczymi oferuje opcję Yes, but ask again next time (v2.1.284+): zezwala na ten jeden odczyt, a o kolejne nadal pyta.

Niebezpieczne rm w trybach bez nadzoru (v2.1.281): w trybie auto i z --dangerously-skip-permissions pytanie o niebezpieczne rm czeka 2 minuty, a następnie odrzuca polecenie z podpowiedzią, jak je przepisać, dzięki czemu sesja toczy się dalej. Rekurencyjne rm, którego celem jest wyłącznie wynik podstawienia polecenia, na przykład rm -rf "$(pwd)", pyta teraz nawet przy regule allow dla Bash.

# Enable at startup (--enable-auto-mode was removed in v2.1.111)
claude --permission-mode auto

# Cycle during session
Shift+Tab    # Manual (aka default) -> acceptEdits -> auto -> plan

Zmiany w uprawnieniach (v2.1.288-290): pyright nie jest już traktowany jako narzędzie tylko do odczytu i najpierw pyta, podobnie jak więcej form ps (v2.1.290). Pliki ustawień projektu nie mogą już włączać Claude in Chrome; należy użyć --chrome, /chrome lub ustawień użytkownika (v2.1.290). Klasyfikator trybu auto po stronie klienta ignoruje przypięcie ANTHROPIC_DEFAULT_SONNET_MODEL wskazujące Sonnet 5.5 lub Opus 5.5 i używa Claude Sonnet 5 (v2.1.288).

Automatyczne zatwierdzanie PowerShell (v2.1.119+): polecenia narzędzia PowerShell są w trybie uprawnień zatwierdzane automatycznie tak samo jak polecenia Bash. Reguły allow w rodzaju PowerShell(Get-*:*) pomijają pytania przy operacjach tylko do odczytu. W przepływach pracy opartych mocno na PowerShell warto używać v2.1.149+; ta wersja naprawia obejścia uprawnień przez wbudowane cd, dopasowywanie reguł allow z prefiksem/symbolem wieloznacznym oraz nieaktualne śledzenie zmiennych katalogu.


9. Zdarzenia hooków

Zdarzenie Kiedy się uruchamia Może blokować?
PreToolUse Przed wykonaniem narzędzia Tak
PostToolUse Po zakończeniu pracy narzędzia Nie
PostToolUseFailure Po błędzie narzędzia Nie
UserPromptSubmit Użytkownik wysyła prompt Tak
Stop Claude kończy odpowiedź Tak
SubagentStart Uruchamia się subagent Nie
SubagentStop Subagent kończy pracę Tak
SessionStart Rozpoczyna się sesja Nie
SessionEnd Sesja się kończy Nie
Notification Wyzwolono alert Nie

| InstructionsLoaded | Wczytano CLAUDE.md | Nie | | ConfigChange | Plik konfiguracji zmienia się w trakcie sesji | Tak | | DirectoryAdded | /add-dir lub register_repo_root z SDK dodaje katalog roboczy w trakcie sesji (v2.1.219+) | Nie | | WorktreeCreate | Tworzenie worktree | Tak | | WorktreeRemove | Usuwanie worktree | Nie | | PreCompact | Przed kompaktowaniem kontekstu | Nie | | PostCompact | Po kompaktowaniu kontekstu | Nie | | Elicitation | MCP prosi o ustrukturyzowane dane wejściowe | Tak | | ElicitationResult | Użytkownik odpowiada na okno dialogowe MCP | Tak | | StopFailure | Tura kończy się z powodu błędu API | Nie | | PermissionRequest | Wyświetlono okno dialogowe uprawnień | Tak | | PermissionDenied | Tryb auto odrzuca akcję (v2.1.88+) | Nie | | CwdChanged | Zmienia się katalog roboczy (v2.1.83+) | Nie | | FileChanged | Obserwowany plik zmodyfikowano z zewnątrz (v2.1.83+) | Nie | | TaskCreated | Utworzono nowe zadanie (v2.1.84+) | Nie | | TeammateIdle | Członek zespołu agentów jest bezczynny | Tak | | TaskCompleted | Zadanie oznaczono jako ukończone | Tak |

Pełny protokół hooków (wejściowy/wyjściowy JSON, matchery, kody wyjścia) opisano w sekcji Dogłębne omówienie hooków pełnego przewodnika.


10. Konfiguracja hooków

Hooki znajdują się w settings.json lub w dedykowanym pliku hooks.json. Minimalny przykład:

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

Składnia matcherów:

Wzorzec Dopasowuje
* Wszystkie narzędzia
Bash Tylko Bash
Edit\|Write Edit lub Write
mcp__github Narzędzia serwera MCP
"" (pusty) Zdarzenia bez narzędzi (np. UserPromptSubmit)

Kody wyjścia:

Kod Znaczenie
0 Sukces — operacja jest kontynuowana
2 Blokada — operacja zostaje zatrzymana, stderr trafia do Claude
1, 3+ Ostrzeżenie bez blokowania; hook z "onFailure": "block" (v2.1.295+) zamiast tego blokuje, tak jak kod wyjścia 2

Hooki asynchroniczne działają w tle bez blokowania: wystarczy dodać "async": true do obiektu hooka.2 Od v2.1.302 hooki typu prompt i agent uruchamiają jednocześnie najwyżej 12 instancji jednego zdarzenia; pozostałe czekają na swoją kolej.13

Pola wyjścia / wejścia hooków:

  • duration_ms w danych wejściowych hooków PostToolUse / PostToolUseFailure (v2.1.119+) — czas wykonania narzędzia bez pytań o uprawnienia i hooków PreToolUse.
  • hookSpecificOutput.updatedToolOutput (v2.1.121+) — zastępuje wynik dowolnego narzędzia (v2.1.118 wprowadziła to tylko dla MCP; v2.1.121 rozszerza na wszystkie narzędzia).
  • hookSpecificOutput.sessionTitle (v2.1.96+) — ustawia tytuł sesji z hooka UserPromptSubmit.
  • args: string[] w hookach poleceń (v2.1.139+) — przekazuje ustrukturyzowane argv bez cytowania powłoki.
  • Limity hooków skills (v2.1.304+): skills z jednego źródła (repozytorium, własnego folderu lub pluginu) mogą zarejestrować najwyżej 1 024 hooki i 16 384 znaki matcherów na sesję; hook once jednego skilla nie usuwa już identycznego hooka innego skilla.
  • continueOnBlock w hookach PostToolUse (v2.1.139+) — przekazuje powód blokady z powrotem do Claude i kontynuuje turę.
  • subagent_type w danych wejściowych hooków agentów (v2.1.140+) — wskazuje, który typ agenta jest uruchomiony.
  • terminalSequence w wyjściowym JSON hooka (v2.1.141+) — emituje sekwencje sterujące terminala dla powiadomień, tytułów okien i sygnałów dźwiękowych.
  • onFailure: "block" w hookach poleceń i HTTP (v2.1.295+) – hook, który nie może wystartować, przekracza limit czasu, kończy się kodem innym niż 0 lub 2, otrzymuje błąd HTTP albo wypisuje nieprawidłowy JSON, blokuje akcję (to samo, co robi kod wyjścia 2 dla danego zdarzenia; odmowa w przypadku PermissionRequest). Domyślnie "continue"; ignorowane w hookach Stop, SubagentStop, TaskCompleted, TeammateIdle oraz asynchronicznych.

11. Szybka konfiguracja MCP

Dodanie serwera MCP jednym poleceniem:

# Remote HTTP server (recommended)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Remote with auth header
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer $TOKEN"

# Local stdio server
claude mcp add --transport stdio postgres \
  --env "DATABASE_URL=postgresql://user:pass@localhost/db" \
  -- npx -y @anthropic-ai/mcp-server-postgres

Kontrola zakresu:

claude mcp add --scope project ...   # Team-shared (.mcp.json)
claude mcp add --scope user ...      # Personal (~/.claude.json)

Przykład projektowego pliku .mcp.json:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

MCP ma już 100 milionów pobrań miesięcznie i ponad 3 000 zindeksowanych serwerów.3 Typy transportu, pozyskiwanie danych od użytkownika i konfigurację wyszukiwania narzędzi opisano w sekcji MCP w pełnym przewodniku.

alwaysLoad (v2.1.121+): Wyłącza odroczone ładowanie przez Tool Search dla zaufanego serwera. Wszystkie jego narzędzia są ładowane na początku sesji, bez dodatkowego wywołania ToolSearch:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "alwaysLoad": true
    }
  }
}

alwaysLoad: false (v2.1.287+) działa odwrotnie: wszystkie narzędzia tego serwera czekają na wyszukanie.

Automatyczne ponawianie (v2.1.121+): W przypadku serwerów MCP, które zgłoszą błąd podczas uruchamiania, podejmowane są maksymalnie 3 ponowne próby przed oznaczeniem ich jako rozłączonych.

Monity z adresem URL (v2.1.287+): Serwery MCP korzystające z protokołu w wersji 2025-11-25 mogą otwierać monity z adresem URL, na przykład w celu zalogowania. Jeśli po aktualizacji serwer przestanie się łączyć, należy dodać "bareElicitationCapability": true do jego wpisu w konfiguracji MCP.

SDK mcp_authenticate redirectUri (v2.1.121+): Wymagane do ukończenia procesu OAuth przy użyciu niestandardowych schematów URI — w aplikacjach komputerowych i procesach obsługiwanych przez konektory claude.ai.


11.5. Polecenia CLI do obsługi plugins

Polecenie Działanie
claude --plugin-url <url> Pobiera archiwum .zip z plugin na potrzeby bieżącej sesji (v2.1.129+)
claude --plugin-dir <path> Ładuje katalog plugin, archiwum .zip lub folder z plugins – ładowany jest każdy folder podrzędny zawierający manifest (.zip od v2.1.128+, tryb folderu od v2.1.265+)
claude plugin prune Usuwa automatycznie zainstalowane plugins, których element nadrzędny już nie istnieje (v2.1.121+)
claude plugin uninstall <name> --prune Odinstalowuje i kaskadowo usuwa osierocone zależności zainstalowane automatycznie (v2.1.121+)
claude plugin tag Tworzy tagi wydań w Git z walidacją wersji (v2.1.118+)
claude plugin eval Uruchamia zestaw testów ewaluacyjnych plugin: punktowane, powtarzalne wyniki oraz raport JSON + HTML (v2.1.269+)
claude plugin eval --disallow-tools <names> Wyklucza wskazane narzędzia wbudowane, takie jak Agent, z przebiegów ewaluacji (także przez disallowed_tools w przypadku testowym); przebieg zakończony błędem API otrzymuje 0 punktów i powoduje niezaliczenie całego zestawu (v2.1.299+)
claude plugin configure <plugin> Wyświetla opcje plugin i wskazuje te, których nie ustawiono; --values-stdin zapisuje nowe wartości odczytane ze standardowego wejścia (v2.1.285+)
claude plugin install <plugin> --config <server>.<key>=<value> Określa własne ustawienia dołączonego serwera MCP w pakiecie .mcpb podczas instalacji, dzięki czemu uruchamia się on bez przechodzenia do /plugin → Configure (v2.1.285+)
claude plugin install <plugin> --marketplace <source> W razie potrzeby dodaje katalog plugins z zastosowaniem tych samych kontroli zasad co claude plugin marketplace add, a następnie instaluje z niego plugin (v2.1.292+)
claude plugin validate Sprawdza poprawność plugin przed publikacją; v2.1.281 dodaje kontrole MCP (wpisy .mcp.json, które zostałyby pominięte bez ostrzeżenia podczas ładowania, niezadeklarowane odwołania ${user_config.*}, niezabezpieczone adresy URL) oraz ostrzeżenie o ${CLAUDE_PLUGIN_ROOT} bez cudzysłowów w hook zapisanym w formie polecenia powłoki
/plugin install <plugin> --marketplace <source> Instaluje w trakcie sesji z katalogu plugins, którego jeszcze nie dodano – najpierw proponuje jego dodanie (v2.1.275+)
/plugin enable cc-plugin-you-should-know@builtin Włącza You should know, wbudowany mod, którego agent pomocniczy wskazuje rzeczy mogące umknąć użytkownikowi lub Claude (v2.1.287+; sesje dostawcy z włączoną telemetrią)

Mody (v2.1.287+): mod to plugin, którego procedury obsługi JavaScript lub TypeScript działają wewnątrz Claude Code: może wyświetlać panele, dodawać polecenia oraz obserwować lub zmieniać wywołania narzędzi. Mody są domyślnie włączone; --safe-mode wyłącza je na jedną sesję, a "disableAllHooks": true na wszystkie sesje; żadna z tych opcji nie wyłącza wbudowanych modów.8

Serwery LSP (v2.1.288+): wpis serwera LSP przyjmuje requestTimeout w milisekundach (domyślnie 60000), więc jeśli serwer nie odpowiada, żądanie kończy się błędem po 60 sekundach zamiast pozostawać w zawieszeniu.


12. Typy subagents

Typ Domyślny model Tryb Zastosowanie
Explore Dziedziczy model sesji, maksymalnie Opus (v2.1.198+; wcześniej Haiku) Tylko odczyt Przeszukiwanie bazy kodu, znajdowanie plików, poznawanie struktury
General-purpose Dziedziczy model główny Pełny odczyt i zapis Złożone zadania badawcze i modyfikacje
Plan Dziedziczy model główny Tylko odczyt Planowanie implementacji przed wykonaniem
Custom Konfigurowalny Konfigurowalny Praca w określonej dziedzinie (przegląd bezpieczeństwa, testowanie itp.)

Claude automatycznie deleguje zadania do subagents. Można też wyraźnie poprosić o ich użycie:

> Use the explore agent to find all auth-related files
> Have a subagent analyze the database schema

Własne subagents definiuje się w .claude/agents/ (projektowe) lub ~/.claude/agents/ (osobiste) jako pliki Markdown z metadanymi frontmatter w formacie YAML. Domyślnie jednocześnie działa do 20 subagents; limit można zmienić za pomocą CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS.4 Od v2.1.292 narzędzie Agent przyjmuje parametr effort, więc można poprosić Claude o uruchomienie subagent z określonym poziomem wysiłku, a nazwy agentów są ograniczone do 256 znaków (dłuższa wartość name w pliku skill lub plugin jest ignorowana). Od v2.1.302 subagents typu fork (subagent_type: "fork") są domyślnie włączone w claude -p, SDK narzędzia Agent, aplikacji komputerowej i VS Code, a także w terminalu (CLAUDE_CODE_FORK_SUBAGENT=0 je wyłącza; claude mcp serve nigdy ich nie udostępnia), natomiast aplikacja komputerowa i VS Code zawsze uruchamiają subagents głównej rozmowy w tle.13

W obecnych wydaniach claude agents otwiera Agent View: eksperymentalny ekran zarządzania działającymi, zablokowanymi i zakończonymi sesjami Claude Code. claude agents --cwd <path> ogranicza widok do jednego katalogu (v2.1.141+), v2.1.142 dodaje flagi uruchamiania sesji w tle, a v2.1.143 stosuje te flagi spójnie w panelu i sesjach w tle: --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort i --dangerously-skip-permissions. v2.1.144 dodaje obsługę /resume dla sesji w tle i oznacza je jako bg; v2.1.145 dodaje claude agents --json, liczniki na karcie sesji oczekujących na dane wejściowe oraz poprawki panelu odpowiedzi w Agent View; v2.1.147 dodaje przypięte sesje w tle, które pozostają aktywne podczas bezczynności i uruchamiają się ponownie w tym samym miejscu w celu zastosowania aktualizacji; v2.1.287 dodaje filtr n:<text> dopasowujący nazwy sesji i zadania; v2.1.288 dodaje Ctrl+F do wyszukiwania sesji po nazwie oraz Alt+Up / Alt+Down do przechodzenia między grupami — oba skróty można zmienić w keybindings.json (agents:find dla Ctrl+F). Agent View należy używać do monitorowania, a nie jako dowodu, że praca przeszła kontrole jakości.6

Pola frontmatter własnego agenta:

Pole Przeznaczenie
name Unikatowy identyfikator (małe litery, łączniki)
description Kiedy wywoływać (należy uwzględnić „PROACTIVELY”, aby włączyć automatyczne delegowanie)
tools Lista narzędzi rozdzielonych przecinkami. Obsługuje Agent(Explore), aby ograniczyć typy, które można uruchamiać
disallowedTools Narzędzia do zablokowania z odziedziczonego zestawu
model opus, sonnet, haiku lub inherit (domyślnie)
permissionMode default/manual, acceptEdits, plan, bypassPermissions itp.
maxTurns Maksymalna liczba tur agenta
background true, aby zawsze uruchamiać jako zadanie w tle
isolation worktree, aby używać odizolowanej kopii drzewa roboczego Git
skills Skills ładowane do kontekstu przy uruchomieniu; pierwsze 32 różne nazwy (v2.1.295+)
autoCompactWindow Próg automatycznej kompakcji kontekstu tego subagent, w tokenach, niższy niż okno głównej rozmowy (v2.1.296+)

Przykład własnego agenta (.claude/agents/security-reviewer.md):

---
name: security-reviewer
description: Expert security code reviewer. Use PROACTIVELY after code changes to auth or data handling.
tools: Read, Grep, Glob, Bash
model: opus
permissionMode: plan
---

You are a senior security engineer. Analyze for OWASP Top 10 vulnerabilities,
secrets, hardcoded credentials, and SQL injection. Report findings with severity
levels and remediation steps.

13. Zmienne środowiskowe

Uwierzytelnianie i API

Zmienna Przeznaczenie
ANTHROPIC_API_KEY Bezpośrednie uwierzytelnianie API
ANTHROPIC_AUTH_TOKEN Niestandardowy nagłówek autoryzacji
ANTHROPIC_CUSTOM_HEADERS Dodatkowe nagłówki żądań
### Konfiguracja modelu
Zmienna Przeznaczenie
---------- ---------
ANTHROPIC_MODEL Nadpisanie modelu domyślnego
CLAUDE_CODE_SUBAGENT_MODEL Model dla subagentów; v2.1.147 naprawia propagację do procesów członków zespołu agentów
CLAUDE_CODE_SUBAGENT_EFFORT Poziom wysiłku, z jakim działają subagenty, gdy żadne inne ustawienie go nie określa, zamiast dziedziczenia poziomu sesji (v2.1.316+); subagent działający na innym modelu używa zapisanego dla tego modelu poziomu wysiłku lub jego wartości domyślnej (v2.1.317+)
CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 Wyłącza narzędzie advisor: /advisor staje się niedostępne, advisorModel jest ignorowane, --advisor jest akceptowane, ale nic nie robi
CLAUDE_CODE_DISABLE_ULTRATHINK=1 Wyłącza słowo kluczowe ultrathink; od wersji v2.1.311 uruchamia ono turę w terminalu na poziomie xhigh (v2.1.316+)
CLAUDE_CODE_DISABLE_WORKFLOWS=1 Wyłącza dynamiczne workflow na jedną sesję; działa tak samo jak "disableWorkflows": true, a niezależnie od tego, które z tych ustawień je wyłączyło, drugie nie może ich ponownie włączyć. Workflow są domyślnie włączone z wyjątkiem planu Pro, gdzie włącza je "enableWorkflows": true (przełącznik Dynamic workflows w /config); opcja CLAUDE_CODE_WORKFLOWS=1 z wersji v2.1.147 nie figuruje już w dokumentacji zmiennych środowiskowych
MAX_THINKING_TOKENS Włącza rozszerzone myślenie (extended thinking)
CLAUDE_CODE_MAX_OUTPUT_TOKENS Ogranicza długość odpowiedzi
### Dostawcy chmury
Zmienna Przeznaczenie
---------- ---------
CLAUDE_CODE_USE_BEDROCK=1 Użycie AWS Bedrock
CLAUDE_CODE_USE_VERTEX=1 Użycie Google Vertex AI
CLAUDE_CODE_USE_FOUNDRY=1 Użycie Microsoft Foundry
VERTEX_REGION_CLAUDE_HAIKU_5_5 Region Vertex dla Claude Haiku 5.5 (v2.1.293+)
ANTHROPIC_BEDROCK_SERVICE_TIER=priority Poziom usługi Bedrock — default/flex/priority (v2.1.122+); wysyłany jako X-Amzn-Bedrock-Service-Tier
ENABLE_TOOL_SEARCH=true Włącza Tool Search w Vertex AI (v2.1.119+; tam domyślnie wyłączone). Za niestandardowym ANTHROPIC_BASE_URL Tool Search jest domyślnie włączone od v2.1.304, a po odpowiedzi 400 lub 422 od bramy żądanie jest ponawiane bez niego (v2.1.305 naprawiło regresję, przez którą każde żądanie kończyło się błędem u dostawców, którzy je odrzucają); brama odrzucająca bloki tool_reference otrzymuje żądanie ponownie bez Tool Search, a sesja to zapamiętuje (v2.1.314+)
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 Włącza wykrywanie modeli przez /v1/models bramy na potrzeby selektora /model (v2.1.129+)
CLAUDE_CODE_AUTO_MODE_SERVER=0 Rezygnacja z serwerowego klasyfikatora trybu auto (lokalny klasyfikator jest wówczas wliczany do zużycia); =1 włącza go. Wariant serwerowy jest domyślny w Bedrock/Vertex/Foundry oraz w bramkach od v2.1.278, bez naliczania narzutu klasyfikatora, a także, od v2.1.282, przy bezpośrednim połączeniu z Anthropic API z wyłączoną telemetrią; od v2.1.281 zmienna obowiązuje również przy bezpośrednim połączeniu z Anthropic API (=1 było opcją włączenia w wersjach v2.1.273-277, gdy domyślny był wariant lokalny)
CLAUDE_CODE_AUTO_MODE_MODEL Model używany przez klasyfikator trybu auto po stronie klienta; nie ma wpływu na tryb auto po stronie serwera (v2.1.302+)
CLAUDE_CODE_MODEL_CATALOG=off Zapobiega wczytywaniu przez sesje Bedrock, Mantle, Vertex AI i Foundry ustawień modeli z podpisanego pliku na downloads.claude.ai (v2.1.311+)
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0 Zachowuje pełny prompt systemowy (=1 wymusza krótszy na dowolnym modelu); od v2.1.312 Bedrock, Mantle, Vertex AI i Foundry używają krótszego promptu dla nazw modeli, których Claude Code nie rozpoznaje, nawet gdy w rzeczywistości stoi za nimi Sonnet lub Haiku
CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1 Wyłącza automatyczne przełączanie modelu po oznaczeniu żądania przez klasyfikator bezpieczeństwa (ustawienie switchModelsOnFlag); od wersji v2.1.312 obejmuje także nazwy modeli, których Claude Code nie rozpoznaje
CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1 Wstrzymuje wysyłanie ustrukturyzowanych wyników (structured outputs) na potrzeby Mantle lub bramy, która je odrzuca (wcześniej zawodziły tam tytuły sesji, przywoływanie pamięci i hooki promptów, v2.1.288+)
CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 Wysyła nagłówki podpowiedzi x-claude-code-* do bramy LLM lub dostawcy zewnętrznego (v2.1.273+; v2.1.283 dodaje x-claude-code-prompt-id, który grupuje żądania obsługujące jeden prompt). Bezpośrednie połączenie z Anthropic API wysyła je domyślnie; =0 wyłącza je wszędzie
### Kontrola zachowania
Zmienna Przeznaczenie
---------- ---------
DISABLE_AUTOUPDATER=1 Zapobiega automatycznym aktualizacjom
DISABLE_UPDATES=1 Blokuje wszystkie ścieżki aktualizacji, łącznie z ręcznym claude update (v2.1.118+, bardziej restrykcyjne niż DISABLE_AUTOUPDATER)
CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 Instalacje przez Homebrew/WinGet uruchamiają aktualizacje menedżera pakietów w tle i proszą o ponowne uruchomienie (v2.1.129+)
CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 Klonuje źródła pluginów z GitHub przez HTTPS zamiast SSH, gdy klucze SSH są niedostępne (v2.1.141+)
CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE Usunięta — bez efektu od v2.1.160. Tryb szybki włącza się teraz przez /model <model>, a następnie /fast on
CLAUDE_CODE_STOP_HOOK_BLOCK_CAP Nadpisuje wprowadzony w v2.1.143+ limit, który kończy turę ostrzeżeniem po kolejnych blokujących hookach stop
CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1 Rezygnacja z zachowania PowerShell -ExecutionPolicy Bypass wprowadzonego w v2.1.143+
CLAUDE_CODE_USE_POWERSHELL_TOOL=0 Wyłączenie narzędzia PowerShell tam, gdzie v2.1.143 włącza je domyślnie dla użytkowników Bedrock, Vertex i Foundry
DISABLE_TELEMETRY=1 Rezygnacja z telemetrii użycia
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 Wyłącza ruch nieistotny: automatyczne aktualizacje, telemetrię, raportowanie błędów, /feedback, informacje o wydaniach, pobieranie flag funkcji (co wyłącza także Remote Control); od wersji v2.1.290 pomija również wstępne nawiązywanie połączenia przy starcie. 0 lub false nadal wyłącza; aby zezwolić, należy usunąć tę zmienną
CLAUDE_CODE_ATTRIBUTION_HEADER=0 Pomija blok atrybucji w prompcie systemowym; za bramą aplikacji Claude należy ustawić tę zmienną w sekcji env polityki code lub cli (od v2.1.299)
CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH Limit obcinania atrybutów treści OTel (domyślnie 60 KB, v2.1.214+)
CLAUDE_CODE_ENABLE_TELEMETRY, zmienne eksportera OTEL_* oraz zmienne treści OTEL_LOG_* Ignorowane w ustawieniach projektu i lokalnych od v2.1.282, z wyjątkiem wartości wyłączających telemetrię; należy je ustawić w powłoce, ustawieniach użytkownika lub ustawieniach zarządzanych. /status i claude doctor wyświetlają listę ignorowanych nazw
DISABLE_COST_WARNINGS=1 Ukrywa ostrzeżenia o kosztach
DISABLE_PROMPT_CACHING=1 Globalnie wyłącza buforowanie promptów
CLAUDE_CODE_DISABLE_1M_CONTEXT=1 Ogranicza każdy model z natywnym oknem 1M do 200K za pomocą automatycznej kompaktacji (w v2.1.223 rozszerzono to poza stałą listę modeli). Od v2.1.285 sesje za niestandardowym ANTHROPIC_BASE_URL korzystają z okna 1M tych modeli, które je mają (Opus 4.7+, Sonnet 5+, Fable); jeśli bramka zatrzymuje się na 200K, należy uruchomić /autocompact 200k. Od v2.1.287 Opus 4.7+ i Fable domyślnie działają z oknem 1M także na Bedrock, Vertex, Foundry i w bramce aplikacji Claude, bez sufiksu [1m]; ta zmienna utrzymuje je na poziomie 200K
CLAUDE_CODE_AUTO_COMPACT_WINDOW Okno automatycznego kompaktowania w tokenach, od 100000 do 1000000; przyrostki k i M działają od wersji v2.1.304 (200k po cichu ustawiało okno 100K), wartości spoza zakresu wywołują ostrzeżenie
CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK=1 Pozwala uruchomić claude ultrareview w niezaufanym folderze, w którym nie może zapytać o zgodę, np. w CI; należy ustawić ją w środowisku uruchamiającym, a nie w bloku env ustawień (v2.1.309+)
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS Rozmiar kontekstu, od którego działa kompaktowanie podczas bezczynności, domyślnie 200000; wartości poniżej 100000 są podnoszone do 100000; "idleCompaction": false wyłącza tę funkcję (v2.1.299; dokumentacja podaje v2.1.290+)
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 Pozwala nierozpoznanym identyfikatorom modeli przekraczać zakładane okno kontekstu (v2.1.223)
CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=1 Usuwa wbudowane instrukcje dotyczące commitów i PR
CLAUDE_CODE_DISABLE_WEB_FETCH=1 Wyłącza narzędzie WebFetch (v2.1.285+)
CLAUDE_CODE_DISABLE_ARTIFACT=1 Wyłącza narzędzie Artifact na jedną sesję; dopóki zmienna jest ustawiona, żaden plik ustawień nie włączy go ponownie ("enableArtifact": false działa tak samo z poziomu ustawień lub wiersza Artifacts w /config)
CLAUDE_CODE_ARTIFACT_AUTO_OPEN=0 Nie otwiera przeglądarki po opublikowaniu nowego artefaktu
CLAUDE_CODE_MAX_TURNS Ogranicza liczbę tur agentowych, gdy nie przekazano --max-turns; jeśli ustawione są oba, pierwszeństwo ma flaga
CLAUDE_CODE_SKIP_PROMPT_HISTORY=1 Nie zapisuje historii promptów ani transkryptu; sesja nigdy nie pojawia się w --resume, --continue ani w historii przewijanej strzałką w górę (efemeryczne uruchomienia skryptowe)
CLAUDE_CODE_TRANSCRIPT_LOCAL_GC=1 W długiej sesji -p lub Agent SDK usuwa po każdym kompaktowaniu historię sprzed kompaktowania z transkryptu większego niż 5 MB; wznowienie nadal przywraca rozmowę; wyłącznie przez środowisko (v2.1.287+)
CLAUDE_CODE_SYNC_SKILLS=1 Sprawia, że uruchomienie -p pobiera skills włączone dla konta claude.ai i czeka na listę przed pierwszym zapytaniem; przy wyłączonym pobieraniu flag funkcji ponownie wykorzystuje listę pobraną przez inną sesję, nie starszą niż 10 minut (v2.1.311+)
CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1 Na własnym (self-hosted) runnerze pozwala, aby claude -p uruchomione wewnątrz sesji współdzieliło jej identyfikator i transkrypt, jak przed v2.1.317 (v2.1.317+)
CLAUDE_CODE_DISABLE_CFC_PROMPT=1 Zachowuje narzędzia Claude in Chrome, ale usuwa sekcję Chrome z promptu systemowego; w VS Code (v2.1.314+) również z wiadomości sesji (v2.1.257+)
FORCE_HYPERLINK 1 wymusza włączenie łączy terminalowych OSC 8 tam, gdzie detekcja ich nie wykrywa; 0, false, no lub off renderuje je jako zwykły tekst (przed v2.1.314 te trzy słowa włączały łącza)
CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES Ogranicza liczbę ponownych wysłań zapasowego żądania bez strumieniowania, które przekroczyło limit czasu (v2.1.285+)
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS Początkowe opóźnienie wycofywania (backoff) po błędzie 529 (przeciążenie), domyślnie 500 ms, przyjmuje wartości 500-32000; bez wpływu pod kontrolą watchdoga ponowień ani w trybie szybkim (v2.1.292+)
CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS Górny limit tego opóźnienia w milisekundach, domyślnie 32000 (v2.1.296+)
CLAUDE_CODE_RETRY_WATCHDOG=1 Sesje bez nadzoru: ponawia próby po błędach pojemności 429 i 529 bez ograniczeń, z wycofywaniem do 5 minut lub do zresetowania limitu (v2.1.186+)
CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS Limit na żądanie określający, jak długo watchdog przeczekuje błędy 429 i 529; brak ustawienia oznacza brak limitu (v2.1.295+)
CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS Pod kontrolą watchdoga kończy żądanie napotykające limit użycia, którego reset jest odleglejszy niż ta wartość, zamiast czekać (v2.1.301+)
CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS Minimalny odstęp między sprawdzeniami, czy limit użycia został zniesiony przed swoim resetem, podczas gdy watchdog na niego czeka (v2.1.305+)
CLAUDE_CODE_DISABLE_ATTACHMENTS=1 Wysyła wzmianki o plikach @ jako zwykły tekst zamiast je rozwijać. Od v2.1.290 pliki .claude/settings.json i .claude/settings.local.json repozytorium nie mogą już jej ustawiać; nadal mogą to robić powłoka, ustawienia użytkownika i ustawienia zarządzane
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1 Zamiast zawartości pliku przekazuje modelowi Claude ścieżkę wzmianki @, aby odczytał ją swoimi narzędziami plikowymi, dzięki czemu hooki PreToolUse widzą odczyt; tylko powłoka, ustawienia użytkownika i ustawienia zarządzane (v2.1.299+)
CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS Liczba milisekund, po których okno dialogowe przekazane do zdalnego klienta (Remote Control, host SDK) zostaje anulowane; nadpisuje dialogExpiry, 0 wyłącza. Wartość z sufiksem jednostki, np. 5m, od v2.1.290 wraca do dialogExpiry (wcześniej była odczytywana jako 5 ms)
CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT=1 Pozostawia monit o niebezpiecznym rm w oczekiwaniu w trybie auto i przy --dangerously-skip-permissions, zamiast odmawiać po 2 minutach (v2.1.281+)
CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT=1 Pomija monit dla rekurencyjnego rm, którego celem jest wyłącznie wynik podstawienia polecenia, np. rm -rf "$(pwd)" (v2.1.281+)
CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1 Nadal wyświetla monit dla rm budowanego w czasie wykonania wewnątrz skryptu powłoki -c, którego Claude Code nie może odczytać; domyślnie takie skrypty nie wywołują już monitu (v2.1.299+)
CLAUDE_CODE_HIDE_CWD=1 Ukrywa katalog roboczy w logo startowym (v2.1.119+)
CLAUDE_CODE_FORK_SUBAGENT=0 Wyłącza subagenty typu fork; domyślnie włączone w terminalu, a od v2.1.302 także w claude -p, Agent SDK, aplikacji desktopowej i VS Code (=1 było opcją włączenia w kompilacjach zewnętrznych od v2.1.117; claude mcp serve nigdy ich nie oferuje)
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 Wymusza zsynchronizowane wyjście terminala, gdy automatyczna detekcja go nie wykrywa (v2.1.129+)
CLAUDE_CODE_FORWARD_SUBAGENT_TEXT=1 Dołącza tekst i myślenie subagentów do wyjścia stream-json; działa w parze z --forward-subagent-text (v2.1.211+)
CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION Limit wywołań WebSearch na sesję (domyślnie 200, v2.1.212+). Od v2.1.290 sesje interaktywne uzupełniają swój budżet WebSearch w czasie, zamiast zatrzymywać się po 200 wywołaniach
CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR Tempo uzupełniania budżetu WebSearch sesji interaktywnej (domyślnie 100 wywołań na godzinę; 0 wyłącza uzupełnianie, v2.1.290+)
CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION Limit uruchamianych subagentów na sesję (domyślnie 200; /clear resetuje budżet, v2.1.212+)
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS Limit jednocześnie działających subagentów (domyślnie 20; niezależny od powyższego limitu łącznego na sesję, v2.1.217+)
CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS Rozłożenie w czasie rozgałęzienia (fan-out) Workflow na potrzeby ponownego użycia pamięci podręcznej promptów; 0 wyłącza (v2.1.229+)
CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL Uruchamia każdego agenta workflow na jednym modelu, podczas gdy pozostałe subagenty zachowują swoje (v2.1.296+)
CLAUDE_CODE_TOOL_MEMORY_LIMIT Opcjonalna grupa cgroup pamięci w systemie Linux (MB) dla poleceń narzędzia Bash (v2.1.233+)
CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS TTL sesyjnej pamięci podręcznej WebFetch dla poszczególnych URL, domyślnie 15 min (v2.1.233+)
CLAUDE_CODE_ENABLE_TODO_TOOLS Przywraca narzędzia todo/zadań na Opus 4.8+/Sonnet 5+/Fable 5+, domyślnie wyłączone od v2.1.233
CLAUDE_CODE_PROJECT_DIR_NAME Krótka nazwa katalogu transkryptów dla projektu na hostach z katalogami konfiguracji per sesja (v2.1.234+)
CLAUDE_CODE_GOAL_CHECKIN_MINUTES Sprawdza zadania w tle blokujące /goal przez tyle minut; 0 wyłącza (v2.1.234+, domyślnie 30)
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH Głębokość zagnieżdżonego uruchamiania subagentów — domyślnie 3 od v2.1.219; wartość 1 wyłącza zagnieżdżanie. Historia wartości domyślnych: 5 (v2.1.172–v2.1.216) → 1 (v2.1.217) → 3 (v2.1.219), dlatego warto ustawić ją jawnie
CLAUDE_AX_SCREEN_READER=1 Włącza tryb czytnika ekranu; to samo co --ax-screen-reader (v2.1.208+)
CLAUDE_AX_PREPARK_MS Liczba milisekund, przez które tryb czytnika ekranu czeka przed zapisaniem nowego lub zmienionego wiersza; domyślnie 0 od v2.1.287 (wcześniej 50), więc aby przywrócić pauzę, należy ustawić 50
### Konfiguracja narzędzi
Zmienna Przeznaczenie
---------- ---------
BASH_DEFAULT_TIMEOUT_MS Limit czasu polecenia Bash (domyślnie 30000)
BASH_MAX_TIMEOUT_MS Maksymalny limit czasu bash (domyślnie 600000)
MCP_TIMEOUT Limit czasu uruchamiania serwera MCP (domyślnie 5000)
MCP_TOOL_TIMEOUT Limit czasu wykonania narzędzia MCP (domyślnie 30000); v2.1.142 naprawia ignorowanie wyższych wartości przez zdalne wywołania HTTP/SSE
CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH Nadpisuje limit długości opisów narzędzi MCP i instrukcji serwerów, 4 096 znaków od v2.1.296 (2 048 w v2.1.280-295) – dotyczy każdego serwera MCP w sesji (v2.1.280+); własne serwery Anthropic pod api.anthropic.com nie są skracane od v2.1.299
MCP_PROTOCOL_NEGOTIATION legacy wstrzymuje sprawdzanie serwerów pod kątem protokołu MCP 2026-07-28; auto sprawdza serwery HTTP, konektorowe i stdio. Serwery lokalne (stdio) negocjują 2026-07-28 domyślnie w każdej instalacji, włącznie z Bedrock, Vertex i Foundry, od v2.1.292; konektory sesji w chmurze i Remote Control negocjują go domyślnie od v2.1.299
CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS Próg, po którym długie wywołanie narzędzia MCP automatycznie przechodzi w tło (domyślnie 2 min, v2.1.212+)
Polecenia w tle (v2.1.285+): polecenia Bash i PowerShell działające w tle zatrzymują się po upływie limitu czasu – ich timeout przy run_in_background, domyślnie 30 minut, maksymalnie 2 godziny – a Claude otrzymuje powiadomienie o zatrzymaniu. Od v2.1.288 limit obowiązuje tylko w sesjach bez nadzoru (-p, Agent SDK, CI, chmura); sesje w terminalu, aplikacji desktopowej i VS Code nie mają limitu.

Sieć i proxy

Zmienna Przeznaczenie
HTTP_PROXY / HTTPS_PROXY Konfiguracja proxy
NO_PROXY Omija proxy dla wybranych domen
CLAUDE_CODE_CLIENT_CERT Ścieżka certyfikatu mTLS
ANTHROPIC_WORKSPACE_ID Zawęża zakres tokenów federacji tożsamości obciążeń (workload identity), gdy reguła obejmuje wiele obszarów roboczych (v2.1.141+)
CLAUDE_CODE_GZIP_REQUEST_BODIES=0 Wyłącza kompresję gzip dużych treści żądań do api.anthropic.com, włączoną nawet przy wyłączonej telemetrii (v2.1.300+)
CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP=1 Zachowuje systemowe certyfikaty krzyżowe poświadczające się nawzajem w pętli, dla prywatnego CA, które takiej pętli wymaga (v2.1.316+)
OTEL_EXPORTER_OTLP_TIMEOUT Standardowy limit czasu eksportu OTel (w milisekundach); eksport OTLP za proxy, które nigdy nie odpowiada, poddaje się po 10 sekundach lub po tej wartości, maksymalnie 30 sekund (v2.1.317+)
Pełną listę zawiera sekcja Zmienne środowiskowe w pełnym przewodniku.

14. Zestawienie kosztów

Ceny za 1 milion tokenów (stan na październik 2026).510

Model Wejście Wyjście Uwagi
Sonnet 5.5 $2.00 $10.00 Domyślny model Sonnet w Anthropic API od v2.1.284 (28 września 2026) – identyfikator modelu claude-sonnet-5-5, kontekst 1M / 128K wyjścia, odczyty z pamięci podręcznej $0.10/MTok (0,05x ceny wejścia; v2.1.296 poprawia dane o kosztach w Claude Code, które wcześniej zakładały $0.20), granica wiedzy: czerwiec 2026. Codzienne kodowanie z uwagą na koszty; effort domyślnie wynosi medium w Claude Code. /model sonnet w Anthropic API (Claude Platform na AWS rozwiązuje sonnet jako Sonnet 4.6; Bedrock, Agent Platform i Foundry jako Sonnet 4.5).
Sonnet 5 (poprzedni) $2.00 $10.00 Model, który alias sonnet wybierał w Anthropic API od v2.1.197 do v2.1.283, a zarazem domyślny model planów Pro i Team Standard, dopóki v2.1.280 nie przeniosła tych planów na Opus. Natywny kontekst 1M; $2/$10 to standardowa cena cennikowa (zaplanowana na 1 września podwyżka do $3/$15 została odwołana; v2.1.243 odpowiednio zaktualizowała selektor /model). Przypięcie przez ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5.
Opus 5.5 $4.00 $20.00 Domyślny model Opus od v2.1.280 (22 września 2026) – identyfikator modelu claude-opus-5-5, kontekst 1M, odczyty z pamięci podręcznej $0.20/MTok (0,05x ceny wejścia wobec standardowych 0,1x). Tańszy od Opus 5 w każdej pozycji cennika i domyślny model w każdym planie, odkąd v2.1.280 przenosi Pro i Team Standard z Sonnet na Opus. /model opus.
Opus 5 (poprzedni) $5.00 $25.00 Poziom Opus od v2.1.219 (24 lipca 2026) do v2.1.278 — identyfikator modelu claude-opus-5, kontekst 1M / 128K wyjścia, myślenie domyślnie włączone, effort domyślnie high, granica wiedzy: maj 2026. Był domyślnym modelem planów premium – Max, Team Premium, Enterprise (stanowiska od v2.1.251) – oraz Anthropic API, dopóki v2.1.280 nie uczyniła Opus 5.5 domyślnym modelem Opus. Przypięcie przez ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5.
Opus 4.8 (starszy) $5.00 $25.00 Ta sama cena, obecnie w tabeli starszych modeli (Legacy models) w dokumentacji; domyślny model poziomu premium od v2.1.154 do v2.1.219. Tryb szybki (fast mode) został na nim wycofany 30 października 2026, a 30 listopada 2026 zostanie usunięty. Przypięcie przez ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8.
Fable 5.1 $10.00 $50.00 Poziom powyżej Opus; /model fable wybiera go od v2.1.257, pierwszego instalowalnego wydania, które go zawiera (Fable 5, v2.1.170+, przeniesiony do tabeli Legacy w dokumentacji). Identyfikator modelu claude-fable-5-1, kontekst 1M / 128K wyjścia, adaptacyjne, stale włączone myślenie, granica wiedzy: czerwiec 2026 (wspólna z Opus 5.5 i Sonnet 5.5), odczyty z pamięci podręcznej $0.25/MTok (0,025x ceny wejścia wobec standardowych 0,1x).
Haiku 5.5 $0.10 $0.50 Model, który haiku wybiera w Anthropic API od v2.1.293 (7 października 2026) – identyfikator modelu claude-haiku-5-5, kontekst 1M / 128K wyjścia, adaptacyjne myślenie, którego nie da się wyłączyć, granica wiedzy: czerwiec 2026. Prompt powyżej 100K tokenów kosztuje $0.50 / $2.50, i to za każdy token takiego żądania; odczyty z pamięci podręcznej $0.01 (standardowe 0,1x). Szybka eksploracja, proste zadania, subagents. Na Bedrock, Vertex, Foundry i Claude Platform na AWS nadal Haiku 4.5. /model haiku.
Haiku 4.5 (poprzedni) $1.00 $5.00 Model, który haiku wybierał przed v2.1.293 i nadal wybiera na Bedrock, Vertex, Foundry oraz Claude Platform na AWS. Przypięcie przez ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5-20251001.

Typowa sesja zużywa 50K-200K tokenów wejściowych i 10K-50K tokenów wyjściowych. Sesja na Haiku 5.5: około $0.01-$0.05 według stawek dla promptów do 100K tokenów. Sesja na Opus 5.5: $0.40-$1.80.

Domyślny model w Claude Code (według planu): Opus w każdym planie od v2.1.280 (22 września 2026) – Pro i Team Standard przeszły z Sonnet na Opus, tak jak Max, Team Premium i Enterprise – a domyślnym modelem Opus jest Opus 5.5 (claude-opus-5-5), na który wskazuje teraz alias opus. Podział z v2.1.251 (Opus 5 w planach premium, Sonnet 5 w Pro/Team Standard) oraz domyślny „Sonnet 5 wszędzie” z v2.1.197 należą już do historii. Administratorzy mogą ustawić domyślny model dla całej organizacji, widoczny jako „Org default” w /model (v2.1.196+). Claude Platform na AWS, Amazon Bedrock i Agent Platform od Google Cloud również domyślnie używają Opus 5.5; jedynym wyjątkiem jest Microsoft Foundry (domyślnie Sonnet 4.5 i jedyne miejsce, w którym opus rozwiązuje się jako Opus 4.6) – konkretny model można przypiąć przez ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL.

Opus 5.5, Sonnet 5.5, Haiku 5.5, Sonnet 5, Opus 5, Opus 4.8, Fable 5 i Fable 5.1 korzystają wyłącznie z adaptacyjnego rozumowania (bez stałych budżetów myślenia), z /effort xhigh do najtrudniejszych zadań programistycznych i agentowych. effort domyślnie wynosi high na wszystkich z nich z wyjątkiem Opus 5.5 i Sonnet 5.5, które domyślnie używają medium, podobnie jak Haiku 5.5 w Claude API – a od v2.1.280 poziom effort zapisany, zanim /effort stał się ustawieniem per model, nie przenosi się już na nowo wydane modele, takie jak Opus 5.5, więc model startuje z własnym ustawieniem domyślnym, dopóki nie wybierze się innego. Myślenia nie da się wyłączyć na Opus 5.5, Sonnet 5.5 ani na modelach Fable (MAX_THINKING_TOKENS=0 nie ma tam żadnego efektu). Zmiany łamiące zgodność w Opus 5 względem Opus 4.8: myślenie jest domyślnie włączone dla żądań pomijających pole thinking, a thinking: {type: "disabled"} z effort xhigh lub max zwraca błąd 400.

Tryb szybki (/fast) dotyczy Opus 5.5 i Opus 5, a także Opus 4.8 do 30 listopada 2026 (wycofany 30 października; po usunięciu żądanie w trybie szybkim na Opus 4.8 zakończy się błędem zamiast działać ze standardową prędkością), przy czym od v2.1.280 domyślny jest Opus 5.5 – $8 / $40 za MTok na Opus 5.5, $10 / $50 na Opus 5 i 4.8 (w każdym przypadku 2× cena bazowa) za maksymalnie 2,5× więcej tokenów wyjściowych na sekundę. Opus 4.7 został usunięty: claude-opus-4-7 + speed: "fast" zwraca teraz błąd zamiast wracać do standardowej prędkości. Wersja zapoznawcza (research preview), wyłącznie w Claude API i subskrypcjach (nie w Bedrock/Vertex/Foundry ani w Claude Platform na AWS); przełączanie prędkości unieważnia pamięć podręczną promptów. Od v2.1.271 tryb szybki działa też w sesjach Claude Code Remote (runnery w chmurze i self-hosted): obowiązuje ustawienie trybu szybkiego z hosta lub /fast wpisane w sesji, tam gdzie organizacja na to pozwala.

Przełączanie modeli w trakcie sesji:

/model opus       # Switch to Opus 5.5 (v2.1.280+)
/model sonnet     # Switch to Sonnet 5.5 on the Anthropic API (v2.1.284+)
/model haiku      # Switch to Haiku 5.5 on the Anthropic API (v2.1.293+)
/model fable      # Switch to Fable 5.1 (tier above Opus, v2.1.257+)
/effort xhigh     # Recommended for the hardest coding/agentic work

Reguła wyboru: Prosta eksploracja trafia do Haiku. Codzienne kodowanie z uwagą na koszty trafia do Sonnet. Trudne rozumowanie, architektura, pętle agentowe i analiza bezpieczeństwa trafiają do Opus. Do złożonych refaktoryzacji warto użyć opusplan (Opus planuje, Sonnet wykonuje).


15. Lokalizacje kluczowych plików

Ścieżka Przeznaczenie
~/.claude/settings.json Ustawienia globalne użytkownika
~/.claude/keybindings.json Własne skróty klawiszowe
~/.claude/CLAUDE.md Instrukcje osobiste (wszystkie projekty)
~/.claude/commands/ Osobiste polecenia slash
~/.claude/skills/ Osobiste skills
~/.claude/agents/ Osobiste definicje subagents
~/.claude.json Stan środowiska uruchomieniowego, tokeny OAuth, konfiguracja MCP
.claude/settings.json Ustawienia projektu (współdzielone przez git)
.claude/settings.local.json Ustawienia projektu (osobiste, ignorowane przez git)
.claude/CLAUDE.md Instrukcje projektu
.claude/commands/ Polecenia slash projektu
.claude/agents/ Definicje subagents projektu
.claude/skills/ Skills projektu
.claude/plans/ Pliki wyjściowe trybu planowania
.claude/memory/ Pliki automatycznej pamięci
.mcp.json Konfiguracja serwerów MCP projektu
CLAUDE.md Instrukcje projektu (alternatywa w katalogu głównym)
AGENTS.md Odczytywany jako instrukcje projektu, gdy projekt nie ma CLAUDE.md (v2.1.277+)

16. Dziennik zmian

Data Zmiana
2026-11-02 Punktowa synchronizacja z v2.1.311-317 (26 października – 2 listopada; npm latest i next 2.1.317, stable przechodzi na 2.1.311; 2.1.313 nigdy nie opublikowano, 2.1.315 jest na npm bez wpisu w changelogu). Tryb Fast na Opus 4.8: przestarzały od 30 października, usunięcie 30 listopada. ultrathink uruchamia turę w terminalu na poziomie xhigh. Dodane wiersze: permissions.blockWritesOutsideWorkingDirectories, disableRemoteControl, CLAUDE_CODE_SUBAGENT_EFFORT, CLAUDE_CODE_DISABLE_ULTRATHINK, CLAUDE_CODE_MODEL_CATALOG, CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT, CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK, CLAUDE_CODE_SKIP_PROMPT_HISTORY, CLAUDE_CODE_TRANSCRIPT_LOCAL_GC, CLAUDE_CODE_SYNC_SKILLS, CLAUDE_CODE_DISABLE_NESTED_SESSION_ID, CLAUDE_CODE_DISABLE_CFC_PROMPT, FORCE_HYPERLINK, CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP, OTEL_EXPORTER_OTLP_TIMEOUT. Zaktualizowane wiersze: /fast, /model ([1m] usunięte tam, gdzie nie ma żadnego efektu), /effort, idleCompaction (VS Code, aplikacja desktopowa, dostawcy zewnętrzni od v2.1.314), ENABLE_TOOL_SEARCH, tabela kosztów oraz podpolecenia runnera.16
2026-10-26 Synchronizacja dokumentacji, bez nowego wydania CLI (npm latest 2.1.310, stable 2.1.308). Dodane wiersze: --cloud (--remote to przestarzały alias; -p "msg" --cloud <session-id> dodaje wiadomość do kolejki działającej sesji w chmurze), /schedule (zaplanowane zadania w chmurze, dawniej routines; alias /routines), /slides (szablony artefaktów, beta), CLAUDE_CODE_DISABLE_ARTIFACT, CLAUDE_CODE_ARTIFACT_AUTO_OPEN, CLAUDE_CODE_MAX_TURNS, enableWorkflows / disableWorkflows. Zastąpiony wiersz: CLAUDE_CODE_WORKFLOWS=1 (opcja opt-in z v2.1.147, usunięta z referencji zmiennych środowiskowych) przez CLAUDE_CODE_DISABLE_WORKFLOWS=1; funkcja Workflow jest domyślnie włączona, z wyjątkiem planu Pro. Pełny przewodnik zyskuje sekcję Projects (publiczna beta od 17 września 2026).15
2026-10-23 Punktowa synchronizacja z v2.1.303-310 (18–23 października; npm latest i next 2.1.310, stable przechodzi na 2.1.308; 303 i 308 to jednolinijkowe wydania poprawiające niezawodność). Dodane wiersze: /auto-mode-setup, sandbox.allowNestedUserNamespaces, CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS, CLAUDE_CODE_AUTO_COMPACT_WINDOW (sufiksy k/M), CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK. Zaktualizowane wiersze: jednolinijkowe poprawki /usage z f (v2.1.305), ostrzeżenie o wznowieniu po 5 godzinach dla Pro/Max przy /resume (v2.1.304), /claude-api api-version i managed-agents-secure, wyszukiwanie narzędzi domyślnie włączone przy niestandardowym bazowym URL (v2.1.304) wraz z poprawką regresji z v2.1.305, zaufanie do obszaru roboczego w claude ultrareview (v2.1.309), limity hooków w skills (v2.1.304).14
2026-10-17 Punktowa synchronizacja z v2.1.301-302 (15–16 października; npm latest i next 2.1.302, stable pozostaje na 2.1.292; niczego nie pominięto). claude -p oraz SDK znów startują w trybie Manual u dostawców zewnętrznych, przy wyłączonej telemetrii i na nowych instalacjach (v2.1.302 odwraca v2.1.285; --permission-mode auto zachowuje tryb auto). Subagenty typu fork domyślnie włączone w -p, SDK, aplikacji desktopowej i VS Code (CLAUDE_CODE_FORK_SUBAGENT=0 je wyłącza); aplikacja desktopowa i VS Code zawsze uruchamiają subagenty głównej rozmowy w tle; hooki promptów i agentów mają limit 12 dla jednego zdarzenia. Wiersze: CLAUDE_CODE_AUTO_MODE_MODEL, CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS, % w vim, wiersz Idle compaction w /config.13
2026-10-14 Punktowa synchronizacja z v2.1.300 (14 października; npm latest i next 2.1.300, stable przechodzi na 2.1.292). Dodane wiersze narzędzia Advisor (/advisor, --advisor, advisorModel, CLAUDE_CODE_DISABLE_ADVISOR_TOOL): drugi model po stronie serwera, z którym Claude konsultuje się w punktach decyzyjnych, od tego wydania dostępny na Claude Platform w AWS. Wiersz CLAUDE_CODE_GZIP_REQUEST_BODIES; claude remote-control traci --sandbox/--no-sandbox; updatedInput z hooka jest teraz walidowane tak samo jak własne dane wejściowe modelu Claude.12
2026-10-14 Punktowa synchronizacja z v2.1.299 (14 października; npm latest 2.1.299, next 2.1.300 jeszcze bez notatek, stable pozostaje na 2.1.287; 2.1.297 i 2.1.298 nigdy nie opublikowano). Kompaktowanie w bezczynności (Idle compaction): rozmowa o długości 200K+ tokenów, bezczynna przez około 54 minuty, jest kompaktowana, zanim wygaśnie jej godzinna pamięć podręczna promptów; nowy wiersz ustawienia idleCompaction oraz wiersz zmiennej CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS. Nowe wiersze zmiennych środowiskowych CLAUDE_CODE_DISABLE_FILE_MENTIONS, CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT i CLAUDE_CODE_ATTRIBUTION_HEADER; CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS jest teraz udokumentowana (górny limit, domyślnie 32000). Reguły MCP dopasowują pełne nazwy serwerów (mcp__a nie obejmuje już a__b; należy pisać mcp__<server>__*), odnotowano w sekcji składni reguł uprawnień; serwery własne pod api.anthropic.com są zwolnione z limitu długości opisu; konektory chmury i Remote Control na protokole 2026-07-28. Ostrzeżenia /usage, /effort i /fast w widoku agenta, claude plugin eval --disallow-tools. Naprawiono dwie regresje z 2.1.296 (Edit i Retry w sesjach w chmurze; zatwierdzone wywołanie narzędzia uruchamiane dwukrotnie po restarcie).11
2026-10-11 Punktowa synchronizacja z v2.1.293-296 (7–9 października; npm latest i next 2.1.296, stable przechodzi na 2.1.287). Claude Haiku 5.5 (claude-haiku-5-5, $0.10 / $0.50 za MTok dla promptów do 100K tokenów, $0.50 / $2.50 powyżej) to model wybierany przez haiku w Anthropic API (v2.1.293): nowy wiersz w tabeli kosztów, Haiku 4.5 przeniesiony do poprzednich modeli, zaktualizowana notatka /model haiku; odczyty z pamięci podręcznej dla Sonnet 5.5 poprawione na $0.10. Hooki: onFailure: "block" (v2.1.295). Limit opisu MCP: 4 096 (v2.1.296). Nowe wiersze: skills (32 wstępnie załadowane), autoCompactWindow, CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS, CLAUDE_CODE_RETRY_WATCHDOG, CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS, CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL, VERTEX_REGION_CLAUDE_HAIKU_5_5; notatka /copy.10
2026-10-06 Punktowa synchronizacja z v2.1.288-292 (2–6 października; npm latest i next 2.1.292, stable pozostaje na 2.1.285). 2.1.291 naprawia regresje z 2.1.288 i 2.1.290, warto więc zaktualizować od razu do nowszej wersji. Budżet WebSearch odnawia się co godzinę w sesjach interaktywnych (v2.1.290); limity poleceń w tle dotyczą wyłącznie sesji bez nadzoru (v2.1.288); claude project purge to teraz claude purge. Nowe wiersze: /autocompact, plugin install --marketplace, CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS, CLAUDE_CODE_WEB_SEARCH_REFILLS_PER_HOUR, MCP_PROTOCOL_NEGOTIATION oraz cztery kolejne zmienne środowiskowe; zaktualizowane notatki o uprawnieniach, Agent View, /code-review i /claude-api.9
2026-10-01 Punktowa synchronizacja z v2.1.286-287 (30 września – 1 października; npm latest i next 2.1.287, stable przechodzi na 2.1.285; niczego nie pominięto od 2.1.285). Kontekst 1M domyślnie dla Opus 4.7+ i Fable na Bedrock, Vertex, Foundry oraz bramie aplikacji Claude (v2.1.287): zaktualizowany wiersz CLAUDE_CODE_DISABLE_1M_CONTEXT. Pojawiają się mody, w tym wbudowany mod You should know (v2.1.287). --bare łączy się wyłącznie z serwerami MCP podanymi w wierszu poleceń i nie uruchamia żadnych zadań w tle (v2.1.286). Nowe wiersze: CLAUDE_AX_PREPARK_MS (domyślnie teraz 0), /plugin enable cc-plugin-you-should-know@builtin; dodane notatki o alwaysLoad: false, promptach URL i bareElicitationCapability, filtrze agentów n:<text>, /hooks oraz Ctrl+G. Notatka o trybie auto jest teraz zgodna z dokumentacją trybów uprawnień.
2026-09-29 Punktowa synchronizacja z v2.1.284-285 (28–29 września; npm latest i next 2.1.285, stable przechodzi na 2.1.280; niczego nie pominięto od 2.1.283). Claude Sonnet 5.5 (claude-sonnet-5-5, $2/$10 za MTok) to domyślny model Sonnet w Anthropic API (v2.1.284): nowy wiersz w tabeli kosztów, wiersz Sonnet 5 przeniesiony do poprzednich, zaktualizowane notatki o parametrach effort i thinking. Tryb auto jest teraz trybem startowym sesji interaktywnych na każdym planie i u każdego dostawcy (v2.1.284) oraz sesji claude -p / Python Agent SDK u dostawców zewnętrznych lub przy wyłączonej telemetrii (v2.1.285). Ultracode ma własny przełącznik w /effort (v2.1.284). Polecenia powłoki w tle zatrzymują się po upływie swojego limitu czasu, domyślnie 30 minut (v2.1.285). Nowe wiersze: --desktop, allowedProviders, claude plugin configure, plugin install --config, CLAUDE_CODE_DISABLE_WEB_FETCH, CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES; do istniejących wierszy dodano /mcp reconnect all, skróty klawiszowe suwaka oraz okno 1M przy niestandardowym bazowym URL.
2026-09-26 Punktowa synchronizacja z v2.1.282-283 (24–25 września; npm latest i next 2.1.283, stable przechodzi na 2.1.274; niczego nie pominięto od 2.1.281). Tryb auto jest teraz wbudowanym trybem startowym sesji interaktywnych w terminalu i VS Code na każdym planie i u każdego dostawcy (v2.1.283), a przy bezpośrednim połączeniu z API i wyłączonej telemetrii domyślnie używa klasyfikatora po stronie serwera (v2.1.282). Zmienne OTel w ustawieniach projektu i lokalnych są ignorowane (v2.1.282). Nowe wiersze: maxProseWidth, deniedModels, availableModelsMatch, allowClaudeInChromeWithManagedMcp, /doctor prompt-audit oraz ignorowane zmienne OTel; wiersz nagłówków hint zyskuje x-claude-code-prompt-id i domyślne ustawienie dla bezpośredniego połączenia z API.
2026-09-24 Ukierunkowana synchronizacja z v2.1.281 (23 września; npm latest i next na 2.1.281, stable przechodzi na 2.1.273; od 2.1.280 nie pominięto żadnej wersji). Wyślij teraz (Ctrl+Enter) przenosi działające narzędzia do tła zamiast anulować turę. CLAUDE_CODE_AUTO_MODE_SERVER obowiązuje teraz także przy bezpośrednim połączeniu z Anthropic API. Tryb auto: polecenia powłoki tylko do odczytu oraz uruchamiane w piaskownicy, oceniane po stronie serwera, czekają na tę ocenę; monit o niebezpiecznym rm odrzuca po 2 minutach w trybach bezobsługowych. Nowe wiersze: attribution (false ukrywa całą atrybucję), kontrole MCP w claude plugin validate oraz dwie zmienne środowiskowe dotyczące rm. Korekta: wiersz /agents podaje teraz, że kreator został usunięty w v2.1.198.
2026-09-23 Korekty, bez nowego wydania CLI (npm latest nadal 2.1.280). Tryb szybki wymienia teraz Opus 5.5 po $8/$40 za MTok, domyślny model trybu szybkiego od v2.1.280 (Opus 5 i 4.8 pozostają przy $10/$50), w wierszu /fast i w nocie Cost Reference. Koszt sesji Opus przeliczono według stawek Opus 5.5 ($4/$20): $0.40-$1.80. Wiersz /effort podaje pełną drabinkę oraz domyślny poziom medium dla Opus 5.5; na Opus 5.5 nie da się wyłączyć myślenia.
2026-09-22 Ukierunkowana synchronizacja z v2.1.280 (22 września; npm latest 2.1.280, stable pozostaje przy 2.1.267; wersja 2.1.279 nigdy nie została opublikowana – brak wydania npm, brak sekcji w changelogu). Claude Opus 5.5 (claude-opus-5-5) to nowy domyślny model Opus – kontekst 1M, $4/$20 za MTok, odczyty z cache $0.20/MTok – a domyślny model w planach Pro i Team Standard zmienia się z Sonnet na Opus, tak jak w Max, Team Premium i Enterprise: nowy wiersz Opus 5.5 w Cost Reference, wiersze Opus 5 i Sonnet 5 przeniesione do historii, zaktualizowano notę o modelu domyślnym i komentarz przy /model. CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH – nowy wiersz zmiennej środowiskowej: nadpisuje limit 2 048 znaków dla opisów narzędzi MCP i instrukcji serwera. Również w v2.1.280, bez wpływu na żaden obszar ściągawki: poziom wysiłku zapisany, zanim /effort stało się ustawieniem per model, nie dotyczy już nowo wydanych modeli, takich jak Opus 5.5 (startują one od swojego poziomu domyślnego); zapisy przez ścieżki z dowiązaniami symbolicznymi są teraz oceniane według miejsca, w którym faktycznie lądują, więc acceptEdits/reguły allow/tryb auto nie zatwierdzają już zapisu lądującego poza drzewem projektu; tryb auto odmawia jednorazowo, gdy kontrola bezpieczeństwa odmówi oceny, a po dziesięciu kontrolach bez odpowiedzi wycofuje się i przerywa turę.
2026-09-21 Ukierunkowana synchronizacja z v2.1.277-278 (18-19 września; npm latest 2.1.278, stable pozostaje przy 2.1.267). Obsługa AGENTS.md (v2.1.277) – nowa nota w sekcji CLAUDE.md oraz wiersz w Key File Locations: w projekcie bez CLAUDE.md Claude Code czyta zamiast tego AGENTS.md; konfigurowalne w /config pod „Project instructions”; jeszcze niedostępne na Bedrock/Vertex/Foundry. Odwrócona semantyka CLAUDE_CODE_AUTO_MODE_SERVER (v2.1.278) – wiersz zaktualizowany: klasyfikator po stronie serwera jest teraz DOMYŚLNY dla użytkowników Claude API i Enterprise oraz na Bedrock/Vertex/Foundry i bramkach, narzut klasyfikatora nie jest rozliczany, a =0 oznacza tam rezygnację (wiersz z v2.1.273 dokumentował =1 jako opt-in, gdy domyślny był klasyfikator lokalny); /status zyskuje wiersz „Auto mode server”. Bez wpływu na inne obszary ściągawki (poprawka globów w złożonych poleceniach w piaskownicy z v2.1.277, zachowanie kodów wyjścia w trybie headless oraz zmienna środowiskowa dla ruchu wychodzącego przez bramkę są opisane w pełnym przewodniku).
2026-09-17 Ukierunkowana synchronizacja z v2.1.274-276 (17 września; npm latest 2.1.276, stable pozostaje przy 2.1.267; 2.1.276 naprawia regresję z 2.1.275 – każde żądanie kończy się błędem 400, gdy ANTHROPIC_BASE_URL wskazuje na proxy lub bramkę, więc nigdy nie należy przypinać 2.1.275 za którymś z nich). Klawisz „wyślij teraz” (v2.1.275) – nowy wiersz: ctrl+enter (lub ctrl+x ctrl+s) przerywa turę i wysyła wszystkie wiadomości z kolejki. syncClaudeAiSkills / syncClaudeAiPlugins (v2.1.275) – nowy wiersz ustawień: skills i plugins z konta claude.ai synchronizują się do zalogowanych sesji terminala, false wyłącza synchronizację. /plugin install <plugin> --marketplace <source> (v2.1.275) – nowy wiersz dla pluginów: najpierw proponuje dodanie marketplace. Bez wpływu na inne obszary ściągawki (zmiana nazewnictwa „cloud session” z v2.1.274 nie dotyka żadnego wiersza ściągawki, a nowe zmienne środowiskowe MCP są opisane w tabeli zmiennych środowiskowych w pełnym przewodniku).
2026-09-16 Ukierunkowana synchronizacja z v2.1.273 (15 września; npm latest, co zamyka obserwację tagu next opisaną poniżej; dist-tag stable przeszedł na 2.1.267). Dodano dwa wiersze zmiennych środowiskowych: CLAUDE_CODE_AUTO_MODE_SERVER (tryb auto przez bramkę domyślnie używa teraz LOKALNEGO klasyfikatora na Bedrock/Vertex/Foundry) oraz CLAUDE_CODE_GATEWAY_HINT_HEADERS. Uwaga dla użytkowników reguł uprawnień: v2.1.273 wąsko cofa kontrolę odmowy dla nieanalizowalnych linii z v2.1.268 (linie eval i env -C znów wywołują monit zamiast odmowy); poprawki stanu i dowiązań symbolicznych z v2.1.260 pozostają w mocy. Bez wpływu na inne obszary ściągawki.
2026-09-15 Ukierunkowana synchronizacja z v2.1.266-272 (8-14 września; npm latest 2.1.272, 2.1.273 tylko na tagu next, jeszcze bez informacji o wydaniu; 266/270 to jednolinijkowe poprawki regresji, a 272 nie wnosi żadnej treści). /output-style przywrócone (v2.1.269) – nowy wiersz: wyświetla i przełącza style wyjścia; wycofane w v2.1.73-v2.1.268 na rzecz /config, teraz działa przez Remote Control oraz w sesjach w chmurze i headless. Tryb szybki dociera do sesji Remote (v2.1.271) – zaktualizowano wiersz /fast i notę o trybie szybkim: runnery w chmurze i własne (self-hosted), ustawienie hosta lub /fast w trakcie sesji, o ile organizacja na to pozwala. claude plugin eval (v2.1.269) – nowy wiersz Plugin CLI: punktowane, powtarzalne zestawy ewaluacji z raportami JSON + HTML. Bez wpływu na inne obszary ściągawki (zweryfikowano: wiersze /diff, /skill-doctor, --plugin-dir i akordów klawiszowych nie zostały zmienione przez te wydania).
2026-09-08 Ukierunkowana synchronizacja z v2.1.265 (8 września; 2.1.262/2.1.264 nigdy nie opublikowano, 2.1.263 bez treści). Wiersze --plugin-dir: tryb folderu z pluginami – ładowany jest każdy podfolder z manifestem, a podfoldery dodane lub usunięte w trakcie działania są wychwytywane (v2.1.265+). Wiersz Ctrl+X Ctrl+K: dwuklawiszowe akordy czekają teraz 3 sekundy na drugi klawisz i po upływie limitu pokazują komunikat (wcześniej 1 sekunda i ciche anulowanie, które pochłaniało akordy wpisywane pod tmux). Bez wpływu na inne obszary ściągawki.
2026-09-05 Ukierunkowana synchronizacja z v2.1.261 (4 września). Dodano wiersz /skill-doctor: pokazuje, które załadowane skills pozostają nieużywane i ile każdy z nich kosztuje w kontekście, dzięki czemu można je przyciąć. Również z v2.1.261, bez wpływu na obszary ściągawki: ustawienie keybindingFlavor zostało wycofane (edycja słów w stylu readline jest teraz jedynym dialektem edycji promptu) – ściągawka nigdy go nie dokumentowała.
2026-09-03 Ukierunkowana synchronizacja z v2.1.260 (wydanej kilka godzin po synchronizacji z v2.1.257-259 z tego samego dnia, opisanej poniżej). Dodano wiersz /diff: pełnoekranowy panel diff obok rozmowy, pokazujący na żywo niezatwierdzone zmiany w miarę edycji przez Claude. Uwaga dla użytkowników reguł uprawnień: v2.1.260 cofa rozszerzenie z v2.1.259, które stosowało reguły odmowy Read() do wartości opcji i operandów Bash (odrzucało npm run build przy regule odmowy dla katalogu build w każdym trybie); pokrycie przekierowań wejścia i poleceń czytających z v2.1.257 pozostaje w mocy.
2026-09-03 Ukierunkowana synchronizacja z v2.1.257-259 + premiera Claude Fable 5.1 (1 września 2026). Alias fable wybiera teraz Fable 5.1 (claude-fable-5-1) – te same $10/$50 za MTok, granica wiedzy czerwiec 2026 (najnowsza spośród wszystkich obecnych modeli), odczyty z cache $0.25/MTok (0,025x wobec standardowych 0,1x); Fable 5 trafia do tabeli Legacy models w dokumentacji. v2.1.257 to pierwsze instalowalne wydanie z Fable 5.1 (2.1.253-256 nigdy nie opublikowano w npm). Zaktualizowano wiersz Cost Reference, notę o adaptacyjnym rozumowaniu i komentarz przy /model.
2026-08-30 Korekta modelu domyślnego na podstawie dokumentacji konfiguracji modeli + CLI v2.1.251: Opus 5 jest domyślny w planach premium (Max, Team Premium, Enterprise w rozliczeniu pay-as-you-go, Anthropic API, Bedrock / Agent Platform w Google Cloud / Claude Platform na AWS; Enterprise w modelu stanowiskowym dołącza od v2.1.251), a Sonnet 5 w planach Pro/Team Standard (Foundry: Sonnet 4.5). Zaktualizowano wiersze Sonnet 5, Opus 5 i Opus 4.8, notę o modelu domyślnym i komentarz przy /model; ujęcie „Sonnet 5 wszędzie” z v2.1.197 wycofano.
2026-08-26 Korekta cen: $2/$10 za MTok dla Sonnet 5 to teraz standardowa cena katalogowa – strona cennika Anthropic odwołuje zaplanowaną na 1 września podwyżkę do $3/$15, a v2.1.243 odpowiednio zaktualizowało selektor /model i skill claude-api. Zaktualizowano wiersz Cost Reference i notę o modelu domyślnym; pozostała treść bez zmian.5
2026-08-17 Ukierunkowana synchronizacja z v2.1.234. Sesje wznawiają się automatycznie po zresetowaniu limitu użycia claude.ai (/config: „Continue automatically at usage limit”). Zmienne środowiskowe: CLAUDE_CODE_PROJECT_DIR_NAME, CLAUDE_CODE_GOAL_CHECKIN_MINUTES. /permissions i /add-dir otwierają się teraz w trakcie tury. Znaczek MR z GitLab (!N) w stopce przez uwierzytelnione glab.
2026-08-15 Ukierunkowana synchronizacja z v2.1.233. Zmienne środowiskowe: CLAUDE_CODE_TOOL_MEMORY_LIMIT (cgroup dla Bash na Linuksie), CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS, CLAUDE_CODE_ENABLE_TODO_TOOLS (narzędzia todo/task są teraz domyślnie WYŁĄCZONE na Opus 4.8/Sonnet 5/Fable 5+). MR-y z GitLab działają z --worktree (!N w claude agents). Cofnięto zmiany uprawnień dla dowiązań symbolicznych Cygwin i < file z v2.1.232; naprawiono jej regresję zatwierdzania w trybie auto na Windows.
2026-08-14 Ukierunkowana synchronizacja v2.1.231–232 + zmiana ustawienia domyślnego z 14 sierpnia. Tryb auto jest teraz domyślny dla nowych sesji w planach Pro/Max/Team (odnotowano w bloku Auto Mode). v2.1.232: wzmianki @ o aktywnych sesjach (routing przez SendMessage, dokładne dopasowanie samej nazwy dostarcza wiadomość), forkowanie subagentów domyślnie włączone, wiersze /config dla wygasania okien dialogowych + wiadomości przychodzących między sesjami, marketplace’y GitLab + redakcja tokenów, aliasy ustawień additionalMarketplaces/allowedMarketplaces. v2.1.231: poprawka redirect-URI MCP OAuth.
2026-08-12 Ukierunkowana synchronizacja v2.1.228–229. Zmienne środowiskowe: dodano CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS (przesunięcie czasowe rozgałęzień workflow, 0 wyłącza). Ponadto: claude remote-control --continue wznawia najnowszą sesję Remote Control; /commit-push-pr nie zatwierdza już automatycznie niebezpiecznych flag git; narzędzie Write stosuje na nowszych modelach te same reguły nadpisywania co Edit.
2026-08-10 Naprawa przeniesionego defektu wykrytego w holistycznym audycie głównego przewodnika: wiersz klasyfikatora trybu auto nadal wskazywał Sonnet 4.6 — poprawiono na Sonnet 5 od wersji v2.1.210 (pierwotnie Sonnet 4.6).
2026-08-06 Ukierunkowana synchronizacja elementów powierzchni poleceń z v2.1.221–v2.1.223. /review jest ponownie aliasem /code-review (v2.1.223) i zapamiętuje ostatnio wpisany poziom wysiłku; kopie /fork otrzymują własne worktree (v2.1.221); VSCode dodaje widok Focus (Ctrl+Alt+F, v2.1.221); CLAUDE_CODE_DISABLE_1M_CONTEXT ogranicza teraz każdy model z natywnym kontekstem 1M do 200K przez automatyczną kompaktację, a CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT stanowi furtkę dla nieznanych modeli (v2.1.223); strictKnownMarketplaces/blockedMarketplaces akceptują symbole wieloznaczne organizacji "owner/*" (v2.1.223).
2026-07-25 Ukierunkowana synchronizacja elementów z v2.1.219–v2.1.220. Modele: Claude Opus 5 (claude-opus-5) zastępuje Opus 4.8 jako poziom Opus i model wybierany przez /model opus — te same $5/$25 za MTok, kontekst 1M / wyjście 128K, myślenie domyślnie włączone, effort domyślnie high, data graniczna wiedzy maj 2026, model domyślny w planie Claude Max; Opus 4.8 pozostawiono jako wiersz legacy. Zmiany niezgodne wstecz względem 4.8: żądania bez pola thinking teraz myślą, a thinking: {type: "disabled"} + effort xhigh/max zwraca błąd 400. Poprawiony tryb szybki: /fast obejmuje wyłącznie Opus 5 i Opus 4.8 w cenie $10/$50 za MTok (2× stawka bazowa, ~2,5× szybkość wyjścia) — Opus 4.7 został usunięty i przy speed: "fast" zwraca teraz błąd zamiast przełączać się na model zapasowy. Zmienne środowiskowe: poprawiono CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH — zagnieżdżone tworzenie subagentów jest domyślnie włączone na głębokości 3 od wersji v2.1.219 (w v2.1.217 było wyłączone); wartość 1 wyłącza. Klucze ustawień: dodano sandbox.network.strictAllowlist (odrzucanie hostów spoza listy dozwolonych bez pytania) oraz workflowSizeGuideline (orientacyjny rozmiar workflow w trybie Dynamic, domyślnie medium / mniej niż 15 agentów). Zdarzenia hooków: dodano DirectoryAdded (uruchamiane, gdy /add-dir lub register_repo_root z SDK zarejestruje katalog roboczy w trakcie sesji). v2.1.220 zawiera wyłącznie poprawki błędów i usprawnienia niezawodności.
2026-07-24 Ukierunkowana synchronizacja elementów z v2.1.218. Powierzchnia poleceń: /code-review działa teraz jako subagent w tle, więc praca nad przeglądem nie zapełnia już rozmowy. Ponadto w v2.1.218: skills z context: fork działają domyślnie w tle (rezygnacja dla pojedynczego skilla przez nowy klucz frontmatter background: false), /deep-research uruchamia się tylko po ręcznym wywołaniu, klasyfikator trybu auto rozstrzyga kontrole niebezpiecznego rm/tła &/podejrzanych ścieżek Windows zamiast otwierać okna dialogowe uprawnień, a hooki z frontmatter agenta wymagają, aby folder pliku agenta miał zaakceptowane zaufanie obszaru roboczego.
2026-07-22 Ukierunkowana synchronizacja elementów z v2.1.217. Zmienne środowiskowe: dodano CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (limit jednocześnie działających subagentów, domyślnie 20) oraz CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH (zagnieżdżone tworzenie subagentów jest od wersji v2.1.217 domyślnie wyłączone — należy ustawić tę zmienną, aby je ponownie włączyć; v2.1.172–v2.1.216 pozwalały na 5 poziomów). Klucze ustawień: dodano emojiCompletionEnabled (autouzupełnianie skrótów emoji w polu promptu, :heart: → ❤️; false wyłącza). Ponadto w v2.1.217: --max-budget-usd zatrzymuje teraz subagentów w tle po osiągnięciu limitu.
2026-07-21 Ukierunkowana synchronizacja elementów z v2.1.214–v2.1.216 (v2.1.213 nigdy nie została wydana). Składnia reguł uprawnień: jednosegmentowe reguły allow dir/** dopasowują teraz tylko <cwd>/dir (v2.1.214) — **/dir/** dla dowolnej głębokości; reguły deny/ask zachowują dopasowanie na dowolnej głębokości; warunki if: hooków otrzymują to samo zawężenie do cwd. Klucze ustawień: dodano sandbox.filesystem.disabled (pominięcie izolacji systemu plików z zachowaniem kontroli ruchu wychodzącego, v2.1.216+). Zmienne środowiskowe: dodano CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH (limit obcinania treści OTel, domyślnie 60 KB, v2.1.214+).
2026-07-17 Zsynchronizowano do Claude Code v2.1.212. Powierzchnia poleceń: /fork zmienił przeznaczenie — kopiuje rozmowę do nowej sesji w tle z własnym wierszem w claude agents; fork wewnątrz sesji to teraz /subtask; nowe podpolecenie claude auto-mode reset (--yes pomija potwierdzenie); nowe flagi --forward-subagent-text (v2.1.211) i --ax-screen-reader (v2.1.208). Dodane zmienne środowiskowe: CLAUDE_CODE_FORWARD_SUBAGENT_TEXT, CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION / CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION (domyślnie 200 na sesję, v2.1.212), CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS (wywołania MCP trwające >2 min automatycznie przechodzą w tło), CLAUDE_AX_SCREEN_READER.7
2026-07-07 Zsynchronizowano do Claude Code v2.1.202. Tryb uprawnień default → „Manual” (v2.1.200; manual akceptowane jako alias). Przebudowano tabelę modeli do aktualnej oferty — Sonnet 5 (domyślny model Claude Code od v2.1.197), Opus 4.8, Fable 5, Haiku 4.5 — zastępując nieaktualne wiersze z flagowym Opus 4.7 / Sonnet 4.6; zaktualizowano uwagi o domyślnym routingu i /effort. Subagent Explore dziedziczy teraz model sesji (z górnym limitem Opus, v2.1.198), wcześniej był to Haiku. Usunięto nieaktualne wpisy: --enable-auto-mode (usunięta w v2.1.111 → należy używać --permission-mode auto) oraz CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE (bez efektu od v2.1.160).
2026-05-24 Zsynchronizowano dowody z najnowszej linii do Claude Code v2.1.150. Dodano wykorzystanie limitów per kategoria w /usage, uwagę o przewijaniu klawiaturą w /diff na podstawie changelogu, uwagę o renderowaniu pól wyboru list zadań GFM na podstawie changelogu, Enterprise allowAllClaudeAiMcps, wskazówki dotyczące poprawki uprawnień PowerShell oraz uwagi o niezawodności Bash/git-worktree/managed-settings/OTEL/Remote Control. Sama wersja v2.1.150 nie ma ogłoszonych zmian widocznych dla użytkownika. Weryfikacja lokalna: lokalne claude --version zwróciło 2.1.144 (Claude Code), podczas gdy najnowsza wersja w npm to 2.1.150.6
2026-05-21 Zsynchronizowano dowody z najnowszej linii do Claude Code v2.1.147. Dodano domyślnie wyłączone narzędzie Workflow (CLAUDE_CODE_WORKFLOWS=1), przypinane sesje w tle w Agent View, /code-review [effort] --comment zastępujące /simplify, wzmocnione sandboxy REPL/Workflow, usprawnienia automatycznego aktualizatora i dużych diffów, tłumienie duplikatów w historii promptów oraz poprawki logowania enterprise, PowerShell, paginacji MCP, Agent View, pluginów, warunków hooków i wklejanego tekstu. Weryfikacja lokalna: lokalne claude --version zwróciło 2.1.144 (Claude Code), podczas gdy najnowsza wersja w npm to 2.1.147.6
2026-05-19 Zsynchronizowano dowody z najnowszej linii do Claude Code v2.1.145. Dodano claude agents --json, liczniki kart oczekujących na dane wejściowe w Agent View, pola JSON repozytorium/PR GitHub w linii statusu, bogatsze wykrywanie pluginów przed instalacją, dane wejściowe hooków background_tasks i session_crons dla Stop/SubagentStop, agent_id/parent_agent_id w OTEL oraz poprawki uprawnień, MCP, spinnera, Windows, Agent View, list zadań, walidacji pluginów, rekurencji skills i narzędzia Read. Weryfikacja lokalna: lokalne claude --version zwróciło 2.1.144 (Claude Code), podczas gdy najnowsza wersja w npm to 2.1.145.6
2026-05-19 Zsynchronizowano dowody z najnowszej linii do Claude Code v2.1.144. Dodano obsługę /resume dla sesji w tle, zachowanie /model dla bieżącej sesji/domyślne, /usage-credits, wyświetlanie daty ostatniej aktualizacji pluginu, powiadomienia o czasie trwania subagentów w tle oraz poprawki niezawodności terminala/sesji w tle. Weryfikacja lokalna: claude --version zwróciło 2.1.144 (Claude Code), a najnowsza wersja w npm to 2.1.144.6
2026-05-18 Zsynchronizowano dowody z najnowszej linii do Claude Code v2.1.143. Dodano spójność dyspozycji w Agent View, limit blokad stop-hooka, zmienne środowiskowe polityki PowerShell, a także odnotowano wymuszanie zależności pluginów, prognozowany koszt kontekstu pluginów, worktree.bgIsolation: "none", zachowywanie modelu/wysiłku sesji w tle oraz poprawki czasu działania ewaluatora /goal. Weryfikacja lokalna: claude --version zwróciło 2.1.142 (Claude Code), podczas gdy najnowsza wersja w npm to 2.1.143.6
2026-05-15 Zsynchronizowano dowody z najnowszej linii do Claude Code v2.1.142. Dodano terminalSequence, claude agents --cwd, flagi dyspozycji sesji w tle z v2.1.142, domyślne nadpisanie Opus 4.7 w trybie szybkim, zmienną środowiskową klonowania pluginów HTTPS, zmienną środowiskową obszaru roboczego workload-identity oraz uwagę o poprawce zdalnego HTTP/SSE w MCP_TOOL_TIMEOUT. Weryfikacja lokalna: claude --version zwróciło 2.1.141 (Claude Code), podczas gdy najnowsza wersja w npm to 2.1.142.6
2026-05-13 Zsynchronizowano dowody z najnowszej linii wydań do Claude Code v2.1.140. Dodano /goal, notatkę o Agent View, args dla hooków poleceń, continueOnBlock dla PostToolUse oraz subagent_type w danych wejściowych hooków agentów. Odnotowano, że v2.1.140 naprawia zachowanie ConfigChange, disableAllHooks i allowManagedHooksOnly. Weryfikacja lokalna: claude --version zwróciło 2.1.140 (Claude Code).6
2026-05-06 Zsynchronizowano dowody z najnowszej linii wydań do Claude Code v2.1.131. Żadne zmiany w tabelach poleceń, konfiguracji, skrótów, hooków, pluginów ani zmiennych środowiskowych nie były potrzebne, ponieważ v2.1.131 to wydanie naprawcze dotyczące aktywacji VS Code w systemie Windows oraz uwierzytelniania punktu końcowego Mantle.6
2026-05-05 Zsynchronizowano z przewodnikiem CC v2.36 (CLI v2.1.126–v2.1.129). Dodano: --plugin-url do ładowania pluginów z archiwów zip, obsługę .zip dla --plugin-dir, skillOverrides, CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY, CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE, CLAUDE_CODE_FORCE_SYNC_OUTPUT oraz wskazówki z v2.1.129 dotyczące manifestu pluginu dla eksperymentalnych themes/monitors. Zakres do v2.1.129.6
2026-04-29 Zsynchronizowano z przewodnikiem CC v2.35 (CLI v2.1.117–v2.1.123). Dodano: opcję MCP alwaysLoad + automatyczne ponawianie przy starcie; claude plugin prune i kaskadę --prune; claude plugin tag; filtrowanie przez wpisywanie w /skills; nazwane motywy w /theme; scalone okno dialogowe /usage; tryby wizualne vim (v/V); automatyczne zatwierdzanie PowerShell; duration_ms w danych wejściowych hooków + updatedToolOutput dla wszystkich narzędzi; prUrlTemplate, wslInheritsWindowsSettings, autoMode.allow $defaults; zmienne środowiskowe ANTHROPIC_BEDROCK_SERVICE_TIER, ENABLE_TOOL_SEARCH, CLAUDE_CODE_HIDE_CWD, DISABLE_UPDATES, CLAUDE_CODE_FORK_SUBAGENT; --from-pr przyjmuje adresy URL PR z GitLab/Bitbucket/GHE. Zakres do v2.1.123.
2026-04-19 Odświeżenie: kontekst 1M dla Sonnet 4.6 jest teraz wykazywany po standardowej stawce $3/$15 (bez dopłaty za długi kontekst); przypis o cenach przełączono na platform.claude.com/docs/en/about-claude/pricing. Zakres do v2.1.116.
2026-04-04 Wyprowadzono ponownie z przewodnika CC v2.26. Dodano /powerup, zaktualizowano /release-notes, usunięto /vim. Zaktualizowano skrót Ctrl+X Ctrl+K. Dodano 4 zdarzenia hooków (CwdChanged, FileChanged, TaskCreated, PermissionDenied). Zaktualizowano /cost o podział na poszczególne modele. Zakres do v2.1.92.
2026-03-28 Pierwsze wydanie ściągawki, obejmujące Claude Code CLI do v2.1.85
—

17. Źródła


Ta ściągawka to podręczne uzupełnienie pełnego przewodnika po Claude Code CLI. Instrukcje konfiguracji krok po kroku znajdą Państwo w szybkim starcie Claude Code. W przypadku projektów iOS i macOS warto sięgnąć po przewodnik po tworzeniu agentów iOS, wzorce integracji XcodeBuildMCP oraz serię Apple Ecosystem. Ostatnia aktualizacja: 6 października 2026.


  1. Dokumentacja trybu Auto Mode Claude Code firmy Anthropic (v2.1.85) ↩

  2. Dokumentacja hooks Claude Code firmy Anthropic ↩

  3. Ekosystem MCP i rejestr serwerów ↩

  4. Dokumentacja subagents Claude Code, „Concurrent subagent limit”: domyślnie 20 jednocześnie działających subagents, wartość zmieniana przez CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS. Odczytano 6 października 2026. ↩

  5. Cennik Claude API ↩↩

  6. Informacje o wydaniu Claude Code v2.1.129, informacje o wydaniu Claude Code v2.1.131, informacje o wydaniu Claude Code v2.1.139, informacje o wydaniu Claude Code v2.1.140, informacje o wydaniu Claude Code v2.1.141, informacje o wydaniu Claude Code v2.1.142, informacje o wydaniu Claude Code v2.1.143, informacje o wydaniu Claude Code v2.1.144, informacje o wydaniu Claude Code v2.1.145, informacje o wydaniu Claude Code v2.1.147, informacje o wydaniu Claude Code v2.1.148, informacje o wydaniu Claude Code v2.1.149, informacje o wydaniu Claude Code v2.1.150, dokumentacja Agent View Claude Code, dokumentacja Goal Claude Code oraz CHANGELOG Claude Code ↩↩↩↩↩↩↩↩↩↩

  7. Informacje o wydaniu Claude Code v2.1.206, v2.1.207, v2.1.208, v2.1.210, v2.1.211, v2.1.212 oraz dokumentacja dostępności Claude Code. Lipiec 2026. ↩↩

  8. Informacje o wydaniu Claude Code v2.1.287 oraz przegląd Mods, październik 2026. ↩

  9. CHANGELOG Claude Code, od v2.1.288 do v2.1.292, dokumentacja referencyjna CLI oraz dokumentacja referencyjna zmiennych środowiskowych, październik 2026. ↩

  10. CHANGELOG Claude Code, od v2.1.293 do v2.1.296, przegląd modelu Claude Haiku 5.5, strona cennika, dokumentacja referencyjna hooks, dokumentacja referencyjna sub-agents oraz dokumentacja referencyjna zmiennych środowiskowych, październik 2026. ↩↩

  11. CHANGELOG Claude Code, v2.1.299, dokumentacja referencyjna ustawień (idleCompaction, „Requires Claude Code v2.1.290 or later”) oraz strona Zmienne środowiskowe (CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS, CLAUDE_CODE_DISABLE_FILE_MENTIONS, CLAUDE_CODE_ATTRIBUTION_HEADER, CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS), pobrane 14 października 2026; dist-tagi npm odczytane tego samego dnia: latest 2.1.299 (opublikowana 14 października, 00:23 UTC), next 2.1.300 (14:27 UTC), stable 2.1.287. CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT, --disallow-tools oraz zmiana reguły MCP dotyczącej pełnej nazwy występują na ten dzień wyłącznie w informacjach o wydaniu. ↩

  12. CHANGELOG Claude Code, v2.1.300, strona narzędzia advisor, dokumentacja referencyjna CLI (--advisor <model>), dokumentacja referencyjna ustawień (advisorModel) oraz strona Zmienne środowiskowe (CLAUDE_CODE_DISABLE_ADVISOR_TOOL, CLAUDE_CODE_GZIP_REQUEST_BODIES), pobrane 14 października 2026; dist-tagi npm odczytane tego samego wieczoru: latest i next 2.1.300 (opublikowana 14:27 UTC), stable 2.1.292. ↩

  13. CHANGELOG Claude Code, v2.1.301 i v2.1.302 oraz strona Tryb interaktywny (ruch %, „Requires Claude Code v2.1.301 or later”), pobrane 17 października 2026; dist-tagi npm odczytane tego samego dnia: latest i next 2.1.302 (opublikowana 16 października, 16:48 UTC; 2.1.301 15 października, 14:34 UTC), stable 2.1.292. Strony permission-modes, env-vars i sub-agents nadal opisują reguły -p i trybu fork sprzed wersji 2.1.302, a CLAUDE_CODE_AUTO_MODE_MODEL, CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS oraz wiersz /config występują na ten dzień wyłącznie w informacjach o wydaniu. ↩↩↩↩

  14. CHANGELOG Claude Code, od v2.1.303 do v2.1.310, strona Zmienne środowiskowe (CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS, CLAUDE_CODE_DISABLE_ULTRAREVIEW_TRUST_CHECK, CLAUDE_CODE_AUTO_COMPACT_WINDOW „Suffixed values such as 200k require v2.1.304 or later”), dokumentacja referencyjna ustawień (sandbox.allowNestedUserNamespaces, ustawienie użytkownika lub zarządzane), strona konfiguracji trybu auto (/auto-mode-setup), strona kosztów („The f shortcut requires Claude Code v2.1.305 or later”) oraz strona ultrareview (--trust-workspace), pobrane 23 października 2026; dist-tagi npm odczytane tego samego dnia: latest i next 2.1.310 (opublikowana 23 października, 21:20 UTC), stable 2.1.308. Domyślne zachowanie tool-search za niestandardowym bazowym adresem URL oraz ostrzeżenie o wznawianiu dla planów Pro/Max występują na ten dzień wyłącznie w informacjach o wydaniu. ↩↩

  15. Korzystanie z Claude Code w chmurze („The older --remote spelling still works as a deprecated alias for --cloud”), Automatyzacja pracy za pomocą zaplanowanych zadań („Create scheduled tasks, formerly routines”; „the /routines alias for /schedule”), Udostępnianie wyników sesji jako artefaktów („Templates are in beta. They’re on by default on Pro, Max, and Team plans”; tabela „Disable artifacts”), strona Zmienne środowiskowe (CLAUDE_CODE_ARTIFACT_AUTO_OPEN, CLAUDE_CODE_DISABLE_WORKFLOWS, CLAUDE_CODE_MAX_TURNS; CLAUDE_CODE_WORKFLOWS nie jest już wymieniana), dokumentacja referencyjna ustawień (enableWorkflows: „workflows are on unless you’re on the Pro plan, where they’re off”) oraz Koordynowanie bieżącej pracy przez Claude z użyciem Projects, cała dokumentacja Claude Code pobrana 26 października 2026; claude --help w wersji 2.1.310 wymienia --cloud [description|session_id|url]. ↩

  16. CHANGELOG Claude Code, od v2.1.311 do v2.1.317 oraz wydania GitHub od v2.1.311 (26 października 2026) do v2.1.317 (2 listopada 2026; npm 23:57 UTC); Przyspieszanie odpowiedzi za pomocą fast mode („Fast mode for Opus 4.8 was deprecated on October 30, 2026, and will be removed on November 30, 2026”); Konfiguracja modelu („Typed in the terminal prompt, the word can also raise that turn to xhigh effort”; „Requires Claude Code v2.1.311 or later”); Wszystkie ustawienia (permissions.blockWritesOutsideWorkingDirectories, idleCompaction, disableRemoteControl); Zmienne środowiskowe (CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT, CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK, CLAUDE_CODE_SYNC_SKILLS, CLAUDE_CODE_TRANSCRIPT_LOCAL_GC, CLAUDE_CODE_SKIP_PROMPT_HISTORY, CLAUDE_CODE_DISABLE_CFC_PROMPT, FORCE_HYPERLINK); Dokumentacja referencyjna środowisk self-hosted (--hold-idle-file, --max-hold-min). Wszystko pobrane 2 listopada 2026. ↩