Ś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.
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_msw danych wejściowych hookówPostToolUse/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 hookaUserPromptSubmit.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
oncejednego skilla nie usuwa już identycznego hooka innego skilla. continueOnBlockw hookachPostToolUse(v2.1.139+) — przekazuje powód blokady z powrotem do Claude i kontynuuje turę.subagent_typew danych wejściowych hooków agentów (v2.1.140+) — wskazuje, który typ agenta jest uruchomiony.terminalSequencew 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 przypadkuPermissionRequest). Domyślnie"continue"; ignorowane w hookachStop,SubagentStop,TaskCompleted,TeammateIdleoraz 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.
-
Dokumentacja trybu Auto Mode Claude Code firmy Anthropic (v2.1.85) ↩
-
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. ↩ -
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 ↩↩↩↩↩↩↩↩↩↩
-
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. ↩↩
-
Informacje o wydaniu Claude Code v2.1.287 oraz przegląd Mods, październik 2026. ↩
-
CHANGELOG Claude Code, od v2.1.288 do v2.1.292, dokumentacja referencyjna CLI oraz dokumentacja referencyjna zmiennych środowiskowych, październik 2026. ↩
-
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. ↩↩
-
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-toolsoraz zmiana reguły MCP dotyczącej pełnej nazwy występują na ten dzień wyłącznie w informacjach o wydaniu. ↩ -
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. ↩ -
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-pi trybu fork sprzed wersji 2.1.302, aCLAUDE_CODE_AUTO_MODE_MODEL,CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MSoraz wiersz/configwystępują na ten dzień wyłącznie w informacjach o wydaniu. ↩↩↩↩ -
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 as200krequire 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 („Thefshortcut 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. ↩↩ -
Korzystanie z Claude Code w chmurze („The older
--remotespelling still works as a deprecated alias for--cloud”), Automatyzacja pracy za pomocą zaplanowanych zadań („Create scheduled tasks, formerly routines”; „the/routinesalias 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_WORKFLOWSnie 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 --helpw wersji 2.1.310 wymienia--cloud [description|session_id|url]. ↩ -
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
xhigheffort”; „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. ↩