Opțiunile comenzii claude în Claude Code CLI

claude [opțiuni] [prompt]

Ce face Opțiunile comenzii claude

Comanda claude acceptă flag-uri care schimbă comportamentul unei singure rulări, fără să modifice setările salvate. Tabelul de mai jos le cuprinde pe toate din referința oficială CLI, grupate după rol. claude --help nu le listează pe toate, deci lipsa unui flag din --help nu înseamnă că nu există. Unde documentația precizează o versiune minimă, ea apare în descriere.

Sesiuni și reluare: --continue, --resume, --name, --worktree, --bg și --exec aleg sau creează sesiunea. Cloud și alte suprafețe: --cloud, --teleport, --environment, --desktop, --remote-control, --chrome și --ide leagă sesiunea de cloud, de aplicații sau de IDE. Model: --model, --effort, --fallback-model, --advisor și --autocompact. Permisiuni și unelte: --permission-mode, --allowedTools, --disallowedTools, --tools, --restricted și --add-dir.

Prompt de sistem: --system-prompt și --system-prompt-file înlocuiesc promptul implicit, iar --append-system-prompt și --append-system-prompt-file adaugă text la final. Variantele append păstrează ghidajul pentru unelte și instrucțiunile de siguranță; cele de înlocuire le elimină. Mod non-interactiv: --output-format, --input-format, --json-schema, --max-turns, --max-budget-usd și flag-urile de streaming funcționează împreună cu -p.

Configurare și extensii: --settings, --setting-sources, --mcp-config, --plugin-dir, --agents, --bare și --safe-mode controlează ce se încarcă la pornire. Depanare și interfață: --debug, --debug-file, --verbose, --ax-screen-reader și --version.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
-c, --continue	Încarcă cea mai recentă conversație din directorul curent, inclusiv o sesiune în fundal terminată (v2.1.257+). Sare peste sesiunile pornite cu -p, SDK sau /loop; claude -p --continue le include.
-r, --resume [sesiune]	Reia o sesiune după ID sau nume, ori deschide selectorul. Acceptă și calea absolută a fișierului .jsonl al transcriptului. O sesiune în fundal care încă rulează se deschide prin claude attach.
-n, --name <nume>	Numele afișat al sesiunii, vizibil în /resume și în titlul terminalului; reiei apoi cu claude --resume <nume>.
--fork-session	La reluare, cu --resume sau --continue, creează un ID de sesiune nou în loc să-l refolosească pe cel original.
--session-id <uuid>	Folosește un ID de sesiune anume; trebuie să fie un UUID valid.
--from-pr <PR>	Deschide selectorul filtrat pe sesiunile legate de un pull request: număr, URL GitHub sau GitHub Enterprise, merge request GitLab sau pull request Bitbucket.
-w, --worktree [nume]	Pornește Claude într-un worktree git izolat, în <repo>/.claude/worktrees/<nume>. Acceptă și #<număr> sau URL-ul unui PR GitHub ori al unui MR GitLab (v2.1.233+).
--tmux	Creează o sesiune tmux pentru worktree; cere --worktree. Folosește panourile native iTerm2 când există; --tmux=classic pentru tmux clasic.
--bg, --background	Pornește sesiunea ca agent în fundal și revine imediat, afișând ID-ul și comenzile de gestionare. Nu se combină cu -p.
--exec	Rulează o comandă shell ca job în fundal (cu PTY), în locul unei sesiuni Claude; se folosește cu --bg.
--cloud	Cu o descriere de sarcină, creează o sesiune cloud nouă. Cu un ID de sesiune (session_... sau cse_...) sau un URL claude.ai/code, plus -p, trimite un mesaj în sesiunea existentă.
--remote	Alias depreciat pentru --cloud.
--teleport	Reia o sesiune cloud în terminalul local.
--environment <id>	Creează o sesiune cloud nouă pe mediul self-hosted cu ID-ul dat (începe cu ccpool_). Din v2.1.224.
--ref <ramură>	Cu --environment, bazează checkout-ul sesiunii pe un ref numit, nu pe HEAD local.
--desktop	Deschide aplicația Claude Desktop pe directorul curent și iese. Cu --continue sau --resume <ID> deschide acea sesiune în Desktop. macOS și Windows x64, cu abonament Claude; din v2.1.285.
--remote-control, --rc [nume]	Pornește o sesiune interactivă cu Remote Control activ, controlabilă și din claude.ai sau din aplicația Claude.
--remote-control-session-name-prefix <prefix>	Prefixul numelor generate automat pentru sesiunile Remote Control; implicit numele mașinii.
--chrome	Activează integrarea cu browserul Chrome pentru automatizare și testare web.
--no-chrome	Dezactivează integrarea Chrome pentru această sesiune.
--ide	Se conectează automat la IDE la pornire, dacă există exact un IDE valid disponibil.
--model <model>	Modelul sesiunii: un alias (sonnet, opus, haiku, fable) sau numele complet. Are prioritate față de setarea model și de ANTHROPIC_MODEL.
--effort <nivel>	Nivelul de efort: low, medium, high, xhigh, max sau ultracode (v2.1.203+). Nivelurile depind de model; valoarea nu se salvează.
--fallback-model <modele>	Modele de rezervă, separate prin virgulă, încercate în ordine când modelul principal e supraîncărcat sau indisponibil.
--advisor <model>	Activează advisor tool pe server cu un alias (fable, opus, sonnet) sau un ID complet; are prioritate față de setarea advisorModel.
--autocompact <auto|tokeni>	Fereastra de compactare automată pentru sesiune, fără a schimba setările salvate; aceleași valori ca /autocompact. Din v2.1.221.
--betas <antete>	Antete beta incluse în cererile API (doar pentru utilizatorii cu cheie API).
--permission-mode <mod>	Modul de permisiuni la pornire: default (alias manual), acceptEdits, plan, auto, dontAsk sau bypassPermissions. Are prioritate față de defaultMode.
--dangerously-skip-permissions	Sare peste prompturile de permisiune; echivalent cu --permission-mode bypassPermissions.
--allow-dangerously-skip-permissions	Adaugă bypassPermissions în ciclul Shift+Tab fără să pornești în acest mod.
--enable-auto-mode	Eliminat în v2.1.111. Auto mode este implicit în ciclul Shift+Tab; pornești direct în el cu --permission-mode auto.
--allowedTools, --allowed-tools	Unelte care rulează fără prompt de permisiune, cu sintaxa regulilor de permisiune, de exemplu "Bash(git log *)". Pentru a restrânge uneltele disponibile folosește --tools.
--disallowedTools, --disallowed-tools	Reguli de interzicere. Un nume simplu scoate unealta din context ("mcp__*" scoate toate uneltele MCP); o regulă cu domeniu, ca Bash(rm *), blochează doar apelurile potrivite.
--tools <listă>	Restrânge uneltele încorporate: "" le dezactivează pe toate, "default" păstrează setul implicit, iar "Bash,Edit,Read" le numește. Nu afectează uneltele MCP.
--restricted	Mod restricționat pentru harness-uri de evaluare pe mașini partajate: elimină uneltele care rulează comenzi sau cod și WebFetch, limitează uneltele de fișiere la directoarele de lucru și încarcă doar managed settings și --settings. Din v2.1.248.
--permission-prompt-tool <unealtă>	O unealtă MCP, numită complet (mcp__<server>__<tool>), care răspunde la prompturile de permisiune în modul non-interactiv.
--permission-prompts <host|none>	Cine răspunde la prompturile de permisiune în print mode: host (implicit) sau none, caz în care sunt refuzate. Din v2.1.259.
--add-dir <căi>	Directoare de lucru suplimentare, în care Claude poate citi și edita fișiere. Dă acces la fișiere, dar majoritatea configurației .claude/ din ele nu se încarcă.
--system-prompt <text>	Înlocuiește complet promptul de sistem implicit.
--system-prompt-file <fișier>	Înlocuiește promptul implicit cu conținutul unui fișier.
--append-system-prompt <text>	Adaugă text la finalul promptului de sistem implicit.
--append-system-prompt-file <fișier>	Adaugă conținutul unui fișier la finalul promptului implicit.
--system-prompt-snapshot <on|off>	Cu off, reconstruiește promptul de sistem la fiecare cerere, în loc să-l refolosească pe cel înregistrat la prima cerere a conversației. Din v2.1.257.
--append-subagent-system-prompt <text>	Adaugă text la promptul de sistem al fiecărui subagent, cu excepția celor de tip fork. Doar cu -p; din v2.1.205.
--append-subagent-system-prompt-file <fișier>	Varianta din fișier a flag-ului anterior; cele două nu se combină. Doar cu -p; din v2.1.261.
--exclude-dynamic-system-prompt-sections	Mută contextul per utilizator (de exemplu locația memoriei automate) din promptul de sistem în primul mesaj, pentru reutilizarea cache-ului între utilizatori și mașini. Doar cu promptul implicit.
-p, --print	Afișează răspunsul fără modul interactiv și iese. Pentru utilizare programatică vezi Agent SDK.
--output-format <format>	Formatul ieșirii în print mode: text, json sau stream-json.
--input-format <format>	Formatul intrării în print mode: text sau stream-json.
--json-schema <schemă>	Ieșire JSON validată după o schemă JSON, după ce agentul își termină lucrul (doar print mode).
--max-turns <N>	Limitează numărul de ture agentice (doar print mode) și iese cu eroare la atingerea limitei. Implicit fără limită.
--max-budget-usd <sumă>	Oprește rularea când costul estimat al apelurilor API atinge suma (doar print mode). Estimarea este locală și poate diferi de factură; costul subagenților intră în calcul.
--no-session-persistence	Sesiunea nu se salvează pe disc și nu poate fi reluată. Doar print mode.
--include-partial-messages	Include evenimentele de streaming parțiale; cere --print și --output-format stream-json.
--include-hook-events	Include evenimentele ciclului de viață al hook-urilor în fluxul de ieșire; cere --output-format stream-json.
--replay-user-messages	Retrimite pe stdout mesajele utilizatorului primite pe stdin, drept confirmare; cere intrare și ieșire stream-json.
--prompt-suggestions	Emite un mesaj prompt_suggestion cu următorul prompt prezis, după fiecare tură care generează unul. Cere --print, --output-format stream-json și --verbose.
--forward-subagent-text	Emite textul și blocurile de gândire ale subagenților în fluxul de ieșire, ca să le poți reconstrui transcriptul. Cere --print și --output-format stream-json; din v2.1.211.
--init	Rulează hook-urile Setup cu matcher-ul init înainte de sesiune (doar print mode).
--maintenance	Rulează hook-urile Setup cu matcher-ul maintenance înainte de sesiune (doar print mode).
--init-only	Rulează hook-urile Setup și SessionStart, apoi iese fără să pornească o conversație.
--settings <fișier|json>	Fișier de setări JSON sau șir JSON inline; valorile suprascriu aceleași chei din settings.json pentru această sesiune. Fișierul are cel mult 2 MiB.
--setting-sources <surse>	Sursele de setări încărcate, separate prin virgulă: user, project, local.
--mcp-config <fișiere>	Încarcă servere MCP din fișiere sau șiruri JSON, separate prin spațiu. Cu -p, așteaptă conectarea serverelor până la timeout-ul MCP_TIMEOUT (implicit 30 de secunde).
--strict-mcp-config	Folosește doar serverele MCP din --mcp-config și ignoră restul configurației MCP.
--plugin-dir <cale>	Încarcă un plugin dintr-un director sau dintr-o arhivă .zip doar pentru această sesiune; repetă flag-ul pentru mai multe căi.
--plugin-url <url>	Descarcă o arhivă .zip de plugin de la un URL, doar pentru această sesiune.
--agent <nume>	Agentul folosit în sesiune; suprascrie setarea agent.
--agents <json>	Definește subagenți dinamic, prin JSON. Cu --print, valoarea poate fi și calea unui fișier JSON (v2.1.281+). Valoarea se validează la pornire.
--bare	Mod minimal: nu descoperă automat hook-uri, skill-uri, comenzi, subagenți, plugin-uri, servere MCP, memoria automată și CLAUDE.md, ca rulările din scripturi să pornească mai repede.
--safe-mode	Pornește cu toate personalizările dezactivate (CLAUDE.md, skill-uri, plugin-uri, hook-uri, servere MCP și altele), pentru depanarea unei configurații stricate. Autentificarea, modelul și uneltele încorporate merg normal.
--disable-slash-commands	Dezactivează toate skill-urile și comenzile pentru sesiune.
--channels <intrări>	(Research preview) Serverele MCP ale căror notificări de canal le ascultă Claude, în forma plugin:<nume>@<marketplace>.
--dangerously-load-development-channels <intrări>	Activează canale care nu sunt pe lista aprobată, pentru dezvoltare locală. Cere confirmare, deci are efect doar interactiv; cu -p este ignorat.
--teammate-mode <mod>	Cum se afișează colegii dintr-o echipă de agenți: in-process (implicit), auto, tmux sau iterm2.
--debug[=<categorii>]	Mod de depanare, opțional filtrat pe categorii, de exemplu --debug='mcp,startup' sau --debug='!mcp'. Filtrul se aplică doar în forma cu =.
--debug-file <cale>	Scrie jurnalele de depanare într-un fișier și activează implicit modul de depanare.
--verbose	Jurnalizare detaliată, cu output complet tură cu tură; suprascrie setarea viewMode pentru sesiune.
--ax-screen-reader	Ieșire potrivită pentru cititoare de ecran: text simplu, fără chenare decorative și fără animații. Din v2.1.181.
-v, --version	Afișează numărul versiunii.

Exemple practice de terminal

Exemplul 1: Model și efort doar pentru această sesiune

claude --model opus --effort high

Exemplul 2: Rulare dintr-un script, cu limite de ture și de cost

claude -p --output-format json --max-turns 3 --max-budget-usd 5.00 "rulează testele și rezumă erorile"

Exemplul 3: Reguli suplimentare în promptul de sistem

Claude primește promptul implicit, apoi conținutul style.md, o linie goală și textul adăugat. Conținutul fișierului vine primul, indiferent de ordinea flag-urilor.

claude -p --append-system-prompt-file ./style.md --append-system-prompt "Răspunde mereu în română" "Rezumă README.md"

Greșeli frecvente și bune practici

• Cauți un flag în claude --help și concluzionezi că nu există. Lista din --help nu este completă.
• Folosești --system-prompt când vrei doar reguli în plus. Înlocuirea elimină ghidajul pentru unelte și instrucțiunile de siguranță; folosește --append-system-prompt.
• Schimbi textul promptului de sistem la o rulare cu --continue și nu vezi efectul. Promptul înregistrat la prima cerere rămâne până la compactare sau până la o conversație nouă; pentru iterații rapide adaugă --system-prompt-snapshot off.

Comenzi înrudite

• claude
• claude-prompt
• claude-headless-ci
• claude-permission-mode