Komendy i flagi CLI Claude Code

Q: Jak uruchomić Claude Code bez interaktywnej sesji?

Flagą --print (skrótowo -p). Claude wykona zadanie, wypisze wynik i zakończy działanie. To podstawa użycia w skryptach, potokach i CI.

Q: Jak wrócić do poprzedniej rozmowy?

Flagą --continue (-c) wczytasz ostatnią rozmowę z bieżącego katalogu. Flagą --resume (-r) wznowisz konkretną sesję po jej identyfikatorze lub nazwie, a bez argumentu dostaniesz listę do wyboru.

Q: Nie widzę flagi w "claude --help". Czy ona istnieje?

Możliwe, że tak. Wyjście --help nie zawiera wszystkich flag. Kanonicznym źródłem jest CLI reference w dokumentacji Anthropic, nie pomoc w terminalu.

To najbardziej referencyjna strona w tej sekcji. Nie ucz się jej na pamięć - wracaj do niej, gdy będziesz czegoś szukać.

Podstawowe komendy

claude                              # sesja interaktywna
claude "explain this project"       # sesja z promptem początkowym
claude -p "explain this function"   # tryb print (non-interactive), potem wyjście
cat logs.txt | claude -p "explain"  # potokowanie treści
claude -c                           # kontynuuj ostatnią rozmowę w tym katalogu
claude -c -p "Check for type errors" # kontynuacja przez SDK
claude -r "auth-refactor" "Finish this PR"  # wznów sesję po ID lub nazwie

Podkomendy CLI

claude update, claude install [version], claude auth login|logout|status, claude doctor, claude mcp ..., claude mcp login|logout <name>, claude plugin ..., claude agents, claude attach <id>, claude logs <id>, claude stop <id>, claude respawn <id>, claude rm <id>, claude setup-token, claude project purge [path], claude gateway, claude ultrareview [target], NOWE: claude rc (Remote Control - patrz lekcja o terminalu, IDE i urządzeniach).

Literówka w podkomendzie nie kończy się błędem bez wyjaśnienia - Claude Code podpowiada najbliższą, na przykład claude udpate → “Did you mean claude update?”.

Pełna tabela flag CLI

Flaga	Opis
`--print`, `-p`	tryb print (bez interaktywności), do skryptów i SDK
`--continue`, `-c`	wczytaj ostatnią rozmowę w bieżącym katalogu
`--resume`, `-r`	wznów sesję po ID lub nazwie, albo pokaż picker
`--fork-session`	przy wznawianiu utwórz nowe ID zamiast reużyć oryginalne
`--model`	model sesji (alias lub pełne ID)
`--fallback-model`	model zapasowy przy przeciążeniu lub niedostępności
`--effort`	poziom rozumowania: `low`, `medium`, `high`, `xhigh`, `max`, `ultracode`
`--output-format`	`text` (domyślnie), `json`, `stream-json` (print mode)
`--input-format`	`text`, `stream-json` (print mode)
`--include-partial-messages`	częściowe zdarzenia streamu (wymaga `--print` i `stream-json`)
`--verbose`	pełne wyjście turn-by-turn
`--max-turns`	limit tur agentowych (print mode)
`--max-budget-usd`	limit wydatków USD na wywołania API (print mode)
`--permission-mode`	`default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions` (`manual` = alias `default`)
`--dangerously-skip-permissions`	pomiń prompty uprawnień (odpowiednik `bypassPermissions`)
`--allow-dangerously-skip-permissions`	dodaj `bypassPermissions` do cyklu Shift+Tab bez startu w nim
`--allowedTools`, `--allowed-tools`	narzędzia bez promptu (reguły w składni permission)
`--disallowedTools`, `--disallowed-tools`	reguły deny
`--tools`	ogranicz dostępne wbudowane narzędzia (`""`, `"default"`, `"Bash,Edit,Read"`)
`--add-dir`	dodatkowe katalogi robocze do odczytu i edycji
`--mcp-config`	wczytaj serwery MCP z plików lub stringów JSON
`--strict-mcp-config`	używaj wyłącznie serwerów z `--mcp-config`
`--agents`	zdefiniuj subagentów w JSON na czas sesji
`--agent`	uruchom całą sesję jako dany subagent
`--append-system-prompt`	dopisz tekst do domyślnego system promptu
`--append-system-prompt-file`	dopisz zawartość pliku do system promptu
`--system-prompt`	zastąp cały system prompt tekstem
`--system-prompt-file`	zastąp system prompt zawartością pliku
`--append-subagent-system-prompt`	dopisz tekst do promptu każdego subagenta (print mode)
`--settings`	ścieżka do pliku settings JSON lub inline JSON (nadpisuje klucze)
`--setting-sources`	źródła settings do wczytania: `user,project,local`
`--session-id`	użyj konkretnego UUID sesji
`--name`, `-n`	nazwa sesji (widoczna w `/resume`)
`--worktree`, `-w`	start w izolowanym git worktree
`--tmux`	utwórz sesję tmux dla worktree (wymaga `--worktree`)
`--bg`, `--background`	start jako background agent
`--exec`	uruchom komendę shell jako background job (z `--bg`)
`--ide`	połącz automatycznie z IDE przy starcie
`--chrome`, `--no-chrome`	integracja Chrome (automatyzacja przeglądarki)
`--bare`	tryb minimalny: pomija auto-discovery hooks, skills, pluginów, MCP i CLAUDE.md
`--safe-mode`	wyłącz wszystkie customizacje (diagnostyka zepsutej konfiguracji)
`--restricted`	tryb ograniczony - patrz niżej
`--debug`, `--debug-file <path>`	tryb debug, zapis logów debug do pliku
`--json-schema`	walidowane wyjście JSON wg schematu (print mode)
`--replay-user-messages`	re-emisja wiadomości użytkownika ze stdin na stdout
`--disable-slash-commands`	wyłącz wszystkie skills i komendy dla sesji
`--version`, `-v`	wersja

Tryb restricted w szczegółach

NOWE v2.1.248. Po starcie claude --restricted Claude nie może uruchamiać komend, wykonywać kodu ani pobierać treści z sieci. Narzędzia plikowe działają wyłącznie w katalogu roboczym, a settings użytkownika i projektu są ignorowane.

To tryb pod współdzielone maszyny i harnessy ewaluacyjne - wszędzie tam, gdzie chcesz pokazać komuś narzędzie bez oddawania mu maszyny.

Ćwiczenie: 5 minut

Uruchom claude -p "wypisz nazwy funkcji w tym pliku" --output-format json < ścieżka/do/pliku.
Obejrzyj strukturę JSON w odpowiedzi.
Znajdź pola session_id, koszt i wynik.

Zaliczenie: masz w terminalu JSON, w którym potrafisz wskazać identyfikator sesji i koszt. To jest dokładnie to, co Twój skrypt albo pipeline CI będzie parsował.

Jeśli nic nie zgrzyta i zostaje czas: powtórz to samo z --max-turns 1 i porównaj wynik. Zobaczysz, gdzie kończy się jedna tura agenta.

Teraz wiesz

-p zamienia Claude Code w narzędzie skryptowalne, -c i -r wracają do rozmowy.
Flagi dzielą się na trzy rodziny: model i rozumowanie, uprawnienia, format wejścia i wyjścia.
--help bywa niepełne, więc kanonem jest dokumentacja, nie terminal.

Następny krok: Interfejs i skróty klawiszowe - to, co dzieje się już w środku sesji, od Esc po wklejanie obrazów.

Częste pytania

Jak uruchomić Claude Code bez interaktywnej sesji?