SpyBara
Go Premium

cli-reference.md 2026-10-21 23:02 UTC to 2026-10-22 22:58 UTC

This page contains 81 additions and 81 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Tue 6 23:59 Wed 7 23:59 Fri 9 23:02 Sat 10 23:01 Sat 17 23:57 Mon 19 23:58 Tue 20 23:00 Thu 22 22:58 Fri 23 22:59 Thu 29 23:57

Riferimento CLI

Riferimento completo per l'interfaccia da riga di comando di Claude Code, inclusi comandi e flag.

Comandi CLI

Puoi avviare sessioni, inviare contenuti tramite pipe, riprendere conversazioni e gestire gli aggiornamenti con questi comandi:

Comando Descrizione Esempio
claude Avvia sessione interattiva claude
claude "query" Avvia sessione interattiva con prompt iniziale claude "explain this project"
claude -p "query" Esegui query tramite SDK, quindi esci claude -p "explain this function"
cat file | claude -p "query" Elabora contenuto inviato tramite pipe cat logs.txt | claude -p "explain"
claude -c Continua la conversazione più recente nella directory corrente claude -c
claude -c -p "query" Continua tramite SDK claude -c -p "Check for type errors"
claude -r "<session>" "query" Riprendi sessione per ID o nome claude -r "auth-refactor" "Finish this PR"
claude update Aggiorna alla versione più recente claude update
claude gateway Avvia il server gateway di app Claude auto-ospitato, per gli amministratori che distribuiscono SSO e policy davanti a Claude Code su Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. Richiede --config che punta a un gateway.yaml. claude gateway --config gateway.yaml
claude install [version] Installa o reinstalla il binario nativo. Accetta una versione come 2.1.118, oppure stable o latest. Vedi Installa una versione specifica claude install stable
claude auth login Accedi al tuo account Anthropic. Usa --email per pre-compilare il tuo indirizzo email, --sso per forzare l'autenticazione SSO e --console per accedere con Anthropic Console per la fatturazione dell'utilizzo dell'API invece di un abbonamento Claude claude auth login --console
claude auth logout Esci dal tuo account Anthropic claude auth logout
claude auth status Mostra lo stato di autenticazione come JSON. Usa --text per output leggibile dall'uomo. Esce con codice 0 se connesso, 1 se no. Il JSON include un campo configDirectory che nomina la directory di configurazione che la CLI utilizza. Il campo richiede Claude Code v2.1.268 o successivo. Il campo authMethod del JSON è uno tra none, claude.ai, oauth_token, api_key, api_key_helper o third_party claude auth status
claude agents Apri la visualizzazione agente per monitorare e inviare sessioni parallele in background. Usa --cwd <path> per mostrare solo le sessioni avviate in quella directory, oppure --json per stampare le sessioni attive come un array JSON per gli script (--json --all include anche le sessioni in background completate). Passa --permission-mode, --model, --effort o --agent per impostare i valori predefiniti per le sessioni inviate. Accetta --settings, --add-dir, --plugin-dir e --mcp-config come il comando claude di livello superiore. L'apertura della visualizzazione agente richiede un terminale interattivo claude agents --json
claude attach <id|name> Collegati a una sessione in background in questo terminale. Passare parte del nome di una sessione in esecuzione al posto dell'ID richiede Claude Code v2.1.290 o successivo claude attach 7c5dcf5d
claude auto-mode defaults Stampa le regole del classificatore della modalità auto integrate come JSON. Usa claude auto-mode config per visualizzare la tua configurazione effettiva con le impostazioni applicate. --label <prefix> stampa solo le regole la cui etichetta inizia con quel prefisso, con corrispondenza case-insensitive. Richiede Claude Code v2.1.208 o successivo claude auto-mode defaults --label 'Git Destructive'
claude auto-mode reset Ripristina la configurazione predefinita della modalità auto rimuovendo la sezione autoMode dal file di impostazioni dell'utente. Richiede conferma prima di scrivere; passa -y/--yes per saltare il prompt. Le regole dalle impostazioni gestite o dal flag --settings si applicano comunque. Richiede Claude Code v2.1.212 o successivo. Vedi Ispeziona i valori predefiniti e la tua configurazione effettiva claude auto-mode reset --yes
claude daemon logs Segui il file di log del supervisore della sessione in background, ~/.claude/daemon.log, stampando le nuove righe man mano che arrivano finché non premi Ctrl+C claude daemon logs
claude daemon run Esegui il supervisore della sessione in background in primo piano in questo terminale, stampando il suo log claude daemon run
claude daemon status Stampa lo stato del supervisore della sessione in background, versione, directory socket e numero di worker per la diagnostica. Esce con 1 se il supervisore non è in esecuzione claude daemon status
claude daemon stop --any Interrompi il supervisore della sessione in background e le sessioni che ospita. Passa --keep-workers per lasciare le sessioni in background in esecuzione in modo che il supervisore successivo si riconnetta ad esse. --any conferma l'interruzione di un supervisore su richiesta, che è l'impostazione predefinita. Usa questo per recuperare da un supervisore che non risponde claude daemon stop --any --keep-workers
claude doctor Stampa diagnostica di installazione e impostazioni di sola lettura dal terminale senza avviare una sessione, inclusa la salute dell'installazione, errori di convalida del file di impostazioni e idoneità a Remote Control. Per il controllo di configurazione in-sessione che può anche applicare correzioni, esegui /doctor claude doctor
claude import [source] Avvia una sessione interattiva che esegue /import per portare la configurazione da altri agenti di codifica in Claude Code. Accetta le stesse opzioni --dry-run e --yes del comando. Non disponibile su Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry o Claude Platform su AWS. Anche non disponibile quando disattivi il recupero dei feature flag. Richiede Claude Code v2.1.213 o successivo claude import codex --dry-run
claude logs <id|name> Stampa l'output recente da una sessione in background. Passare parte del nome di una sessione al posto dell'ID richiede Claude Code v2.1.290 o successivo claude logs 7c5dcf5d
claude mcp Configura server Model Context Protocol (MCP) Vedi la documentazione MCP di Claude Code.
claude mcp login <name> Esegui il flusso OAuth di un server MCP configurato senza aprire il pannello interattivo /mcp. Funziona per server HTTP, SSE e connettori claude.ai. Aggiungi --no-browser su SSH per stampare l'URL di autorizzazione invece di aprire un browser. Per un server HTTP o SSE, incolla l'URL di reindirizzamento al prompt. Per un connettore claude.ai, vedi Autorizza di nuovo un connettore dalla tua shell. Vedi Autentica dalla riga di comando claude mcp login sentry
claude mcp logout <name> Cancella le credenziali OAuth archiviate per un server MCP claude mcp logout sentry
claude plugin Gestisci i plugin di Claude Code. Alias: claude plugins. Vedi il riferimento plugin per i sottocomandi claude plugin install code-review@claude-plugins-official
claude purge [path] Elimina tutto lo stato locale di Claude Code per un progetto: trascrizioni, elenchi di attività, log di debug, cronologia delle modifiche ai file, righe della cronologia dei prompt e la voce del progetto in ~/.claude.json. Ometti [path] per scegliere da un elenco interattivo. Flag: --dry-run per visualizzare un'anteprima, -y/--yes per saltare la conferma, -i/--interactive per confermare ogni elemento, --all per ogni progetto. Vedi Cancella dati locali claude purge ~/work/repo --dry-run
claude remote-control Avvia un server Remote Control per controllare Claude Code da Claude.ai o dall'app Claude. Viene eseguito in modalità server (nessuna sessione interattiva locale). Vedi Flag modalità server. Dopo aver interrotto il server, puoi ripristinare le sessioni che stava servendo. Vedi Riprendi sessioni dopo aver interrotto il server claude remote-control --name "My Project"
claude respawn <id> Riavvia una sessione in background, in esecuzione o interrotta, mantenendo la sua conversazione intatta. Usa --all per riavviare ogni sessione in esecuzione, ad esempio per raccogliere un binario Claude Code aggiornato claude respawn 7c5dcf5d
claude rm <id> Rimuovi una sessione in background dall'elenco. Quando la rimozione viene rifiutata sul worktree della sessione e un secondo claude rm può risolverlo, il rifiuto stampa il flag esatto e il valore da passare: --discard-unpushed <commit>@<worktree-id> scarta un worktree che ha commit non inviati insieme a quei commit, e --force-remove-worktree <worktree-id> elimina una directory worktree che git o l'hook WorktreeRemove non potevano rimuovere. --discard-unpushed richiede Claude Code v2.1.260 o successivo, e --force-remove-worktree richiede v2.1.268 o successivo. La trascrizione della conversazione rimane sul tuo computer locale, disponibile tramite claude --resume claude rm 7c5dcf5d
claude self-hosted-runner Avvia un processo runner che registra questa macchina o contenitore con un ambiente auto-ospitato e ospita sessioni cloud di Claude Code sulla tua infrastruttura. Esegui claude self-hosted-runner setup per una procedura guidata dell'operatore, claude self-hosted-runner doctor per diagnosticare un runner distribuito e claude self-hosted-runner orchestrator per generare runner su richiesta. Richiede Claude Code v2.1.224 o successivo claude self-hosted-runner setup
claude setup-token Genera un token OAuth di lunga durata per CI e script. Stampa il token nel terminale senza salvarlo. Richiede un abbonamento Claude. Vedi Genera un token di lunga durata claude setup-token
claude stop <id> Interrompi una sessione in background. Accetta anche claude kill claude stop 7c5dcf5d
claude ultrareview [target] Esegui ultrareview in modo non interattivo. Stampa i risultati su stdout e esce con 0 in caso di successo o 1 in caso di errore. Usa --json per il payload grezzo e --timeout <minutes> per sovrascrivere il valore predefinito di 45 minuti. Usa --post su un target di pull request github.com per pubblicare i risultati finiti nella PR come un unico commento semplice dal tuo account GitHub. --no-post è l'impostazione predefinita. --post e --no-post richiedono Claude Code v2.1.227 o successivo. Vedi Pubblica i risultati nella pull request claude ultrareview 1234 --json

Se digiti male un sottocomando, Claude Code suggerisce la corrispondenza più vicina e esce senza avviare una sessione. Ad esempio, claude udpate stampa Did you mean claude update?.

claude --dangerously-skip-permissions daemon <subcommand> esegue il sottocomando daemon, quindi il sottocomando funziona quando claude è aliasato per includere il flag. Solo un --dangerously-skip-permissions o --allow-dangerously-skip-permissions iniziale instrada a daemon in questo modo; con qualsiasi altro flag prima di daemon, il sottocomando non viene eseguito.

Flag CLI

Personalizza il comportamento di Claude Code con questi flag da riga di comando. claude --help non elenca ogni flag, quindi l'assenza di un flag da --help non significa che non sia disponibile.

Flag Descrizione Esempio
--add-dir Aggiungi directory di lavoro aggiuntive per consentire a Claude di leggere e modificare file. Concede l'accesso ai file; Claude Code non scopre la maggior parte della configurazione .claude/ da queste directory. Convalida che ogni percorso esista come directory. Non puoi aggiungere la maggior parte dei percorsi di rete, come \\server\share. Per mantenere queste directory tra le sessioni, imposta permissions.additionalDirectories nelle impostazioni claude --add-dir ../apps ../lib
--advisor <model> Abilita lo strumento advisor lato server per questa sessione con un alias di modello, fable, opus, o sonnet, o un ID modello completo. Ha la precedenza sull'impostazione advisorModel per la sessione. fable richiede accesso a Fable claude --advisor opus
--agent Specifica un agente per la sessione corrente (sostituisce l'impostazione agent) claude --agent my-custom-agent
--agents Definisci subagenti personalizzati dinamicamente tramite JSON. Accetta i campi elencati per subagenti definiti da CLI. Con --print, il valore può invece essere il percorso a un file JSON che contiene l'oggetto; la forma di file richiede Claude Code v2.1.281 o successivo. Claude Code convalida il valore all'avvio e esce con un valore non valido; vedi Invalid --agents configuration per il messaggio e per i flag e la variabile di ambiente che saltano la convalida. La convalida richiede Claude Code v2.1.242 o successivo claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissions Aggiungi bypassPermissions al ciclo della modalità Shift+Tab senza iniziare in essa. Ti consente di iniziare in una modalità diversa come plan e passare a bypassPermissions in seguito. Vedi modalità di permesso claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedTools, --allowed-tools Strumenti che si eseguono senza richiedere il permesso, ad eccezione delle letture da percorsi di rete. Vedi sintassi della regola di permesso per la corrispondenza dei pattern. Per limitare quali strumenti sono disponibili, usa --tools invece. Se nomini uno degli strumenti di tracciamento delle attività qui, Claude Code opta anche la sessione in "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt Aggiungi testo personalizzato alla fine del prompt di sistema di ogni subagente, inclusi i subagenti annidati, a parte un subagente biforcato, che riutilizza il prompt della conversazione. Si applica solo in modalità non interattiva con -p. Richiede Claude Code v2.1.205 o successivo claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"
--append-subagent-system-prompt-file Carica il testo da un file e aggiungilo ai prompt di sistema dei subagenti. Un'alternativa a --append-subagent-system-prompt per il testo troppo lungo da passare sulla riga di comando. I due flag non possono essere combinati. Si applica solo in modalità non interattiva con -p. Richiede Claude Code v2.1.261 o successivo claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"
--append-system-prompt Aggiungi testo personalizzato alla fine del prompt di sistema predefinito claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Carica testo di prompt di sistema aggiuntivo da un file e aggiungi al prompt predefinito claude --append-system-prompt-file ./extra-rules.txt
--autocompact <auto|tokens> Imposta la finestra auto-compact per questa sessione senza modificare le impostazioni salvate. Accetta gli stessi valori di /autocompact; quella sezione copre i moduli di valore e cosa sostituisce il flag. Richiede Claude Code v2.1.221 o successivo claude --autocompact 500k
--ax-screen-reader Renderizza l'output compatibile con lo screen reader: testo piatto senza bordi decorativi o animazioni. Forza il renderer classico, quindi l'impostazione tui non ha effetto; le sessioni in background allegate ancora si rendono a schermo intero. Ha la precedenza su CLAUDE_AX_SCREEN_READER e l'impostazione axScreenReader. Richiede Claude Code v2.1.181 o successivo claude --ax-screen-reader
--bare Modalità minima: salta l'auto-scoperta di hooks, skills, comandi personalizzati, subagenti, plugin installati, server MCP, memoria automatica e CLAUDE.md in modo che le chiamate con script inizino più velocemente. Le skills in una directory che passi con --add-dir si caricano comunque. Claude ha accesso agli strumenti Bash, lettura file e modifica file. Imposta CLAUDE_CODE_SIMPLE. Vedi modalità bare claude --bare -p "query"
--betas Intestazioni beta da includere nelle richieste API (solo utenti con chiave API) claude --betas interleaved-thinking
--bg, --background Avvia la sessione come agente in background e ritorna immediatamente. Stampa l'ID della sessione e i comandi di gestione. Combina con --exec per eseguire un comando shell come lavoro in background invece di una sessione Claude, o con --agent per eseguire un subagente specifico. Controlla l'affidabilità dell'area di lavoro per la directory prima che inizi. Non può essere combinato con -p/--print; vedi il riferimento degli errori claude --bg "investigate the flaky test"
--channels (Anteprima di ricerca) Server MCP le cui notifiche di canale Claude dovrebbe ascoltare in questa sessione. Elenco separato da spazi di voci plugin:<name>@<marketplace>. Richiede l'autenticazione Anthropic tramite claude.ai o una chiave API Console claude --channels plugin:my-notifier@my-marketplace
--chrome Abilita l'integrazione del browser Chrome per l'automazione web e i test claude --chrome
--cloud Con una descrizione di attività, crea una nuova sessione cloud. Con un ID di sessione (session_... o cse_...) o un URL claude.ai/code, accoda un messaggio in quella sessione esistente invece, con -p. Vedi invia un messaggio di follow-up. claude --cloud "Fix the login bug"
--continue, -c Carica la conversazione più recente nella directory corrente, inclusa una sessione in background che è terminata; l'apertura di sessioni in background terminate richiede Claude Code v2.1.257 o successivo. Salta le sessioni create con claude -p o l'Agent SDK, e le sessioni il cui primo prompt era /loop. claude -p --continue include sessioni -p, SDK e /loop. Include le sessioni che hanno aggiunto questa directory con /add-dir claude --continue
--dangerously-load-development-channels Abilita i canali che non sono nell'allowlist approvata, per lo sviluppo locale. Accetta voci plugin:<name>@<marketplace> e server:<name>. Chiede una conferma, quindi ha effetto nelle sessioni interattive. Con -p, Claude Code ignora il flag claude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissions Salta i prompt di permesso. Equivalente a --permission-mode bypassPermissions. Vedi modalità di permesso per quello che questo fa e non salta. Per le sessioni avviate con --bg, la modalità persiste quando il supervisore riavvia la sessione claude --dangerously-skip-permissions
--debug Abilita la modalità debug con filtro di categoria opzionale, come --debug='mcp,startup' o --debug='!mcp'. Il filtro si lega solo nella forma =; un filtro separato da spazi abilita la modalità debug senza filtrare claude --debug='mcp,startup'
--debug-file <path> Scrivi i log di debug in un percorso di file specifico. Abilita implicitamente la modalità debug. Ha la precedenza su CLAUDE_CODE_DEBUG_LOGS_DIR claude --debug-file /tmp/claude-debug.log
--desktop Apri l'app Claude Desktop nella directory corrente e esci senza avviare una sessione nel terminale. Aggiungi --continue, o --resume con un ID di sessione, per aprire quella sessione in Desktop invece. --resume qui accetta solo un ID di sessione, non un nome o un percorso di trascrizione. Non accetta prompt e nessun altro flag tranne --verbose e i flag --debug, poiché l'app avvia la sessione stessa. Disponibile su macOS e Windows x64 quando sei connesso con un abbonamento Claude. Richiede Claude Code v2.1.285 o successivo claude --desktop
--disable-slash-commands Disabilita tutte le skills e i comandi per questa sessione claude --disable-slash-commands
--disallowedTools, --disallowed-tools Regole di negazione. Un nome di strumento nudo rimuove gli strumenti corrispondenti dal contesto di Claude: "Edit" rimuove Edit, "*" rimuove ogni strumento, e "mcp__*" rimuove ogni strumento MCP. Una regola con ambito come Bash(rm *) lascia lo strumento disponibile e nega solo le chiamate che corrispondono come scritto. Una regola che nomina EndConversation non può rimuoverla mentre rimane qualsiasi altro strumento "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort Imposta il livello di sforzo per la sessione corrente. Opzioni: low, medium, high, xhigh, max, o ultracode. I livelli disponibili dipendono dal modello. ultracode richiede uno sforzo xhigh con ultracode attivato, e richiede Claude Code v2.1.203 o successivo. Sostituisce le impostazioni modelSettings e effortLevel per questa sessione e non persiste claude --effort high
--enable-auto-mode Rimosso in v2.1.111. La modalità auto è ora nel ciclo Shift+Tab per impostazione predefinita; usa --permission-mode auto per iniziare in essa claude --permission-mode auto
--environment <environment-id> Crea una nuova sessione cloud che viene eseguita sull'ambiente auto-ospitato con l'ID fornito. Gli ID ambiente iniziano con ccpool_. Vedi il comportamento di dispatch di --environment per il comportamento di dispatch e le combinazioni di flag che rifiuta. Richiede Claude Code v2.1.224 o successivo claude -p "Fix the login bug" --environment ccpool_abc123
--exclude-dynamic-system-prompt-sections Sposta il contesto per utente, come la posizione della memoria automatica, fuori dal prompt di sistema e nel primo messaggio dell'utente. Migliora il riutilizzo della cache dei prompt tra diversi utenti e macchine che eseguono lo stesso compito. Si applica solo con il prompt di sistema predefinito; ignorato quando --system-prompt o --system-prompt-file è impostato. Usa con -p per carichi di lavoro con script, multi-utente claude -p --exclude-dynamic-system-prompt-sections "query"
--exec Esegui un comando shell come lavoro in background supportato da PTY invece di avviare una sessione Claude. Usa con --bg per lanciare dalla shell claude --bg --exec 'pytest -x'
--fallback-model Abilita il fallback automatico al modello specificato quando il modello primario è sovraccarico o non disponibile, ad esempio un modello ritirato. Accetta un elenco separato da virgole provato in ordine. Vedi Catene di modelli di fallback. Per mantenere una catena tra le sessioni, usa l'impostazione fallbackModel, che questo flag sostituisce claude --fallback-model sonnet,haiku
--fork-session Quando riprendi, crea un nuovo ID di sessione invece di riutilizzare l'originale (usa con --resume o --continue) claude --resume abc123 --fork-session
--forward-subagent-text Emetti i blocchi di testo e di ragionamento dei subagent nel flusso di output come messaggi assistant e user con parent_tool_use_id impostato, in modo da poter ricostruire la trascrizione di ogni subagent. Senza questo flag, Claude Code omette i blocchi di testo e di ragionamento di un subagent che viene eseguito in primo piano. Richiede --print e --output-format stream-json. Per i subagent annidati, le skill biforcate e la versione richiesta da ciascuno, vedi Seguire i messaggi dei subagent. La variabile d'ambiente CLAUDE_CODE_FORWARD_SUBAGENT_TEXT abilita lo stesso comportamento. Richiede Claude Code v2.1.211 o successivo claude -p --output-format stream-json --verbose --forward-subagent-text "query"
--from-pr Apri il selettore di sessione filtrato alle sessioni collegate a una richiesta pull specifica. Accetta un numero PR, un URL PR GitHub o GitHub Enterprise, un URL di richiesta di merge GitLab, o un URL di richiesta pull Bitbucket. Le sessioni vengono collegate automaticamente quando Claude crea la richiesta pull claude --from-pr 123
--ide Connettiti automaticamente all'IDE all'avvio se esattamente un IDE valido è disponibile claude --ide
--init Esegui gli hook di Setup con il matcher init prima della sessione (solo modalità print) claude -p --init "query"
--init-only Esegui gli hook Setup e SessionStart, quindi esci senza avviare una conversazione claude --init-only
--include-hook-events Includi gli eventi del ciclo di vita degli hook nel flusso di output. Gli eventi degli hook SessionStart e Setup sono sempre inclusi e non hanno bisogno di questo flag. Alcuni eventi degli hook, come Notification, SessionEnd, PreCompact, e PostCompact, non producono mai un evento hook_started, anche con questo flag. Per quelli, Claude Code emette comunque hook_progress mentre un hook di comando che viene eseguito per più di un secondo produce output, ed emette hook_response solo quando un hook che viene eseguito in background finisce. Richiede --output-format stream-json claude -p --output-format stream-json --verbose --include-hook-events "query"
--include-partial-messages Includi gli eventi di streaming parziale nell'output. Richiede --print e --output-format stream-json claude -p --output-format stream-json --verbose --include-partial-messages "query"
--input-format Specifica il formato di input per la modalità print (opzioni: text, stream-json) claude -p --output-format json --input-format stream-json
--json-schema Ottieni output JSON convalidato corrispondente a uno JSON Schema dopo che l'agente completa il suo flusso di lavoro (solo modalità print). Vedi output strutturati. Claude Code esce con un errore su uno schema non valido e accetta la parola chiave format come annotazione senza convalida lato client claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenance Esegui gli hook di Setup con il matcher maintenance prima della sessione (solo modalità print) claude -p --maintenance "query"
--max-budget-usd Ferma l'esecuzione quando la spesa stimata per le chiamate API raggiunge questo importo (solo modalità print). Claude Code confronta il limite con la sua stima dei costi lato client, che può differire dalla tua fattura. La spesa dei subagent conta verso il limite. La spesa può superare il limite, quindi lascia un margine. Quando torni a una conversazione con --continue o --resume, i totali ripristinati da esecuzioni precedenti non contano verso di esso. Una volta che la spesa raggiunge il limite, l'avvio di un altro subagent fallisce con Budget limit reached, e Claude Code ferma i subagent in background ancora in esecuzione; i comportamenti di applicazione del limite richiedono Claude Code v2.1.217 o successivo claude -p --max-budget-usd 5.00 "query"
--max-turns Limita il numero di turni agentici (solo modalità print). Esce con un errore quando il limite viene raggiunto. Nessun limite per impostazione predefinita. Con --input-format stream-json, un messaggio ancora in coda quando il limite termina un turno rimane in coda e inizia un nuovo turno con il suo proprio limite claude -p --max-turns 3 "query"
--mcp-config Carica i server MCP da file JSON o stringhe (separati da spazi). Quando passi questo flag con -p, Claude Code attende che i server ancora in sospeso si connettano prima di eseguire il primo turno, fino al timeout di avvio MCP_TIMEOUT, 30 secondi per impostazione predefinita; un server con un elenco di strumenti memorizzato nella cache salta l'attesa e si connette al primo utilizzo. In un ambiente auto-ospitato, si applica invece un'attesa più breve. L'attesa richiede Claude Code v2.1.221 o successivo claude --mcp-config ./mcp.json
--model Imposta il modello per la sessione corrente con un alias di modello come sonnet, opus, haiku, o fable, o il nome completo di un modello. Sostituisce l'impostazione model e ANTHROPIC_MODEL claude --model claude-sonnet-5
--name, -n Imposta un nome visualizzato per la sessione, mostrato in /resume e nel titolo del terminale. Puoi riprendere una sessione denominata con claude --resume <name>. /rename cambia il nome a metà sessione e lo mostra anche sulla barra del prompt claude -n "my-feature-work"
--no-chrome Disabilita l'integrazione del browser Chrome per questa sessione claude --no-chrome
--no-session-persistence Disabilita la persistenza della sessione in modo che le sessioni non vengono salvate su disco e non possono essere riprese. Solo modalità print. La variabile di ambiente CLAUDE_CODE_SKIP_PROMPT_HISTORY fa lo stesso in qualsiasi modalità claude -p --no-session-persistence "query"
--output-format Specifica il formato di output per la modalità print (opzioni: text, json, stream-json) claude -p "query" --output-format json
--permission-mode Inizia in una modalità di permesso specificata. Accetta default, acceptEdits, plan, auto, dontAsk, bypassPermissions, o manual come alias per default. L'alias manual seleziona la modalità di permesso che l'interfaccia utente etichetta Manual e richiede Claude Code v2.1.200 o successivo; claude --help la elenca al posto di default, e entrambi i valori funzionano. Sostituisce defaultMode dai file di impostazioni. Senza questo flag o --dangerously-skip-permissions, una nuova sessione inizia nella modalità di permesso descritta in quale modalità di permesso inizia una sessione, che copre anche cosa inizia una sessione -p claude --permission-mode plan
--permission-prompt-tool Specifica uno strumento MCP per gestire i prompt di permesso in modalità non interattiva. Passa il nome completo, come mcp__<server>__<tool>, di uno strumento su un server MCP che l'esecuzione carica. Claude Code attende che il server MCP di quello strumento si connetta prima di eseguire il primo turno, fino al timeout di avvio MCP_TIMEOUT, 30 secondi per impostazione predefinita. Lo strumento di prompt non può approvare uno strumento MCP contrassegnato come richiedente interazione dell'utente: Claude Code converte un risultato allow per uno in una negazione. Questa restrizione richiede Claude Code v2.1.199 o successivo claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"
--permission-prompts Imposta chi risponde ai prompt di permesso in modalità print. Con l'impostazione predefinita host, Claude Code li invia all'host dell'Agent SDK o allo strumento --permission-prompt-tool. Passa none quando nessuno può rispondere, e Claude Code li nega invece. Vedi Disattiva i prompt di permesso nelle esecuzioni incustodite. Richiede Claude Code v2.1.259 o successivo claude -p --permission-prompts none "query"
--plugin-dir Carica un plugin da una directory o un archivio .zip, o diversi da una cartella di plugin, solo per questa sessione. Ogni flag accetta un percorso. Ripeti il flag per più percorsi: --plugin-dir A --plugin-dir B.zip. Passare una cartella di plugin richiede Claude Code v2.1.265 o successivo claude --plugin-dir ./my-plugin
--plugin-url Recupera un archivio plugin .zip da un URL solo per questa sessione. Ripeti il flag per più plugin, o passa URL separati da spazi in un singolo valore tra virgolette claude --plugin-url https://example.com/plugin.zip
--print, -p Stampa la risposta senza modalità interattiva (vedi la documentazione dell'Agent SDK per i dettagli di utilizzo programmatico). Per --resume su una sessione in background ancora in esecuzione, vedi Riprendi una sessione in background in esecuzione claude -p "query"
--prompt-suggestions Emetti un messaggio prompt_suggestion con un prompt utente successivo previsto dopo ogni turno che ne genera uno; le conversazioni molto brevi possono non produrne. Richiede --print, --output-format stream-json, e --verbose. Vedi Suggerimenti di prompt claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--ref <branch> Con --environment, basa il checkout della nuova sessione su un ref denominato invece di HEAD locale claude -p "Run the smoke test" --environment ccpool_abc123 --ref main
--remote Alias deprecato per --cloud, inclusa la forma di sessione esistente claude --remote "Fix the login bug"
--remote-control, --rc Avvia una sessione interattiva con Remote Control abilitato in modo da poterla controllare anche da claude.ai o dall'app Claude. Facoltativamente passa un nome per la sessione claude --remote-control "My Project"
--remote-control-session-name-prefix <prefix> Prefisso per i nomi di sessione Remote Control generati automaticamente quando nessun nome esplicito è impostato. Per impostazione predefinita il nome host della tua macchina, producendo nomi come myhost-graceful-unicorn. Imposta CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX per lo stesso effetto claude remote-control --remote-control-session-name-prefix dev-box
--replay-user-messages Ri-emetti i messaggi dell'utente da stdin su stdout per il riconoscimento. Richiede --input-format stream-json e --output-format stream-json claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages
--restricted Inizia in modalità ristretta. Usalo quando un harness di valutazione guida claude su una macchina condivisa e Claude Code non deve eseguire comandi o leggere le impostazioni utente e progetto di quella macchina. Claude Code rimuove gli strumenti integrati che eseguono comandi o codice, e WebFetch, a meno che non li nomini individualmente in --tools, non attraverso il preset default. Confina anche gli strumenti file integrati alle directory di lavoro, carica solo impostazioni gestite e --settings, rifiuta bypassPermissions, e rifiuta di creare sessioni cloud. Richiede Claude Code v2.1.248 o successivo claude --restricted -p "query"
--resume, -r Riprendi una sessione specifica per ID o nome, o mostra un selettore interattivo per scegliere una sessione. Al posto di un ID, puoi passare il percorso assoluto al file di trascrizione .jsonl di una sessione. Il selettore e la ricerca per nome includono le sessioni che hanno aggiunto questa directory con /add-dir. Quando passi un ID di sessione, Claude Code cerca nella directory del progetto corrente e nei suoi git worktrees, quindi in ogni altro progetto su questa macchina. Prima di v2.1.223, la ricerca per ID copriva solo la directory del progetto corrente e i suoi git worktrees. Le sessioni in background appaiono nel selettore contrassegnate con bg. Riprendere una che è ancora in esecuzione apre quella sessione in questo terminale tramite claude attach, e un prompt che passi sulla riga di comando va a essa come suo turno successivo. Prima di v2.1.285, Claude Code rifiutava e stampava il comando claude attach da eseguire invece claude --resume auth-refactor
--safe-mode Inizia con tutte le personalizzazioni disabilitate per risolvere i problemi di una configurazione interrotta: CLAUDE.md, skills, plugins, hooks, server MCP, comandi e agenti personalizzati, stili di output, flussi di lavoro, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della barra di stato e suggerimento di file, server LSP, e memoria automatica non si caricano. L'autenticazione, la selezione del modello, gli strumenti integrati e i permessi funzionano normalmente, il che differisce da --bare. La politica delle impostazioni gestite si applica comunque, inclusi gli hook configurati dalla politica, la barra di stato e i comandi di suggerimento di file; i plugin gestiti, le skills gestite, CLAUDE.md gestito, e i server MCP configurati dalla politica non lo fanno. Utile per verificare se una personalizzazione è quello che attiva il fallback automatico del modello. Imposta CLAUDE_CODE_SAFE_MODE claude --safe-mode
--session-id Usa un ID di sessione specifico per la conversazione (deve essere un UUID valido) claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sources Elenco separato da virgole delle fonti di impostazione da caricare (user, project, local). Vedi agent view e agent teams per le sessioni che avvii da questa che ereditano l'elenco claude --setting-sources user,project
--settings Percorso a un file JSON di impostazioni o una stringa JSON inline. I valori che imposti qui sostituiscono le stesse chiavi nei tuoi file settings.json per questa sessione. Le chiavi che ometti mantengono i loro valori basati su file. Il file deve essere un file regolare non più grande di 2 MiB. Vedi precedenza delle impostazioni claude --settings ./settings.json
--strict-mcp-config Usa solo i server MCP da --mcp-config, ignorando tutte le altre configurazioni MCP. Vedi Controllo esclusivo con managed-mcp.json per quello che il flag fa sotto un file MCP gestito claude --strict-mcp-config --mcp-config ./mcp.json
--system-prompt Sostituisci l'intero prompt di sistema con testo personalizzato claude --system-prompt "You are a Python expert"
--system-prompt-file Carica il prompt di sistema da un file, sostituendo il prompt predefinito claude --system-prompt-file ./custom-prompt.txt
--system-prompt-snapshot Passa off per ricostruire il prompt di sistema su ogni richiesta invece di riutilizzare il prompt registrato sulla prima richiesta della conversazione, ad esempio mentre iteri sul testo --append-system-prompt tra le esecuzioni --continue. Richiede Claude Code v2.1.257 o successivo claude --system-prompt-snapshot off
--teleport Riprendi una sessione cloud nel tuo terminale locale claude --teleport
--teammate-mode Imposta come i compagni di squadra del team di agenti si visualizzano: in-process (predefinito), auto, tmux, o iterm2. Sostituisce l'impostazione teammateMode per questa sessione. Vedi Scegli una modalità di visualizzazione claude --teammate-mode auto
--tmux Crea una sessione tmux per il worktree. Richiede --worktree. Usa i riquadri nativi di iTerm2 quando disponibili; passa --tmux=classic per tmux tradizionale claude -w feature-auth --tmux
--tools Limita quali strumenti integrati Claude può usare. Usa "" per disabilitare tutti, "default" per il set predefinito, o nomi di strumenti come "Bash,Edit,Read". Su macOS, Linux e WSL, il set predefinito lascia fuori Glob e Grep, come descritto sotto Comportamento dello strumento Glob. Se nomini uno degli strumenti di tracciamento delle attività qui, Claude Code opta anche la sessione in. Il flag non influisce sugli strumenti MCP; per negare anche quelli, usa --disallowedTools "mcp__*". Un elenco che omette EndConversation non lo rimuove; "" lo rimuove solo quando non rimangono strumenti MCP claude --tools "Bash,Edit,Read"
--verbose Abilita la registrazione dettagliata, mostra l'output completo turno per turno. Sostituisce l'impostazione viewMode per questa sessione claude --verbose
--version, -v Stampa il numero di versione claude -v
--worktree, -w Avvia Claude in un git worktree isolato a <repo>/.claude/worktrees/<name>. Se non dai un nome, Claude Code ne genera uno. Passa #<number>, un URL di richiesta pull GitHub, o un URL di richiesta di merge GitLab per recuperare quella PR o MR da origin e creare un ramo del worktree da essa. La creazione di un ramo da una richiesta di merge GitLab richiede Claude Code v2.1.233 o successivo claude -w feature-auth

Flag del prompt di sistema

Claude Code fornisce cinque flag per personalizzare il prompt di sistema. Quattro impostano il suo testo, e con --system-prompt-snapshot controlli se una conversazione mantiene il testo con cui ha iniziato. Tutti e cinque funzionano sia in modalità interattiva che non interattiva.

Flag Comportamento Esempio
--system-prompt Sostituisce l'intero prompt predefinito claude --system-prompt "You are a Python expert"
--system-prompt-file Sostituisce con il contenuto del file claude --system-prompt-file ./prompts/review.txt
--append-system-prompt Aggiunge al prompt predefinito claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Aggiunge il contenuto del file al prompt predefinito claude --append-system-prompt-file ./style-rules.txt
--system-prompt-snapshot Con off, ricostruisce il prompt su ogni richiesta. Con on, il predefinito, riutilizza un prompt registrato dove la registrazione si applica claude --append-system-prompt "Draft rules" --system-prompt-snapshot off

Puoi combinare questi flag. Per sostituire il prompt predefinito e aggiungere comunque il tuo testo, passa --append-system-prompt o --append-system-prompt-file insieme a --system-prompt o --system-prompt-file. Con Claude Code v2.1.283 o successivo, puoi anche passare un flag insieme alla sua forma di file, come --append-system-prompt con --append-system-prompt-file, e Claude Code li usa entrambi.

Ad esempio, esegui quanto segue nella tua shell per aggiungere sia una guida di stile da un file sia un'istruzione aggiuntiva:

claude -p --append-system-prompt-file ./style.md --append-system-prompt "Always reply in French" "Summarize README.md"

Claude riceve il prompt di sistema predefinito seguito dal contenuto di style.md, una riga vuota, e poi Always reply in French. Il contenuto del file viene prima anche se passi --append-system-prompt prima di --append-system-prompt-file.

Quando il testo di sostituzione combina istruzioni che sono le stesse su ogni esecuzione con contesto che cambia per esecuzione, aggiungi una riga contenente solo __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ tra le istruzioni e il contesto. Claude Code divide il prompt alla prima riga di questo tipo e rimuove quella riga, quindi la parte sopra rimane memorizzata nella cache mentre la parte sotto cambia. Richiede Claude Code v2.1.275 o successivo. Memorizza nella cache la parte statica di un prompt personalizzato elenca le configurazioni dove la divisione si applica.

Scegli in base al fatto che l'identità predefinita di Claude Code si adatti ancora al tuo compito. Usa un flag di aggiunta quando Claude dovrebbe rimanere un assistente di codifica che segue anche le tue regole extra: istruzioni per invocazione, formattazione dell'output, o contesto di dominio per uno script -p. L'aggiunta preserva la guida dello strumento predefinito, le istruzioni di sicurezza e le convenzioni di codifica, quindi fornisci solo quello che differisce. Usa un flag di sostituzione quando la superficie, l'identità, o il modello di permesso differisce da quello di Claude Code, come un agente non di codifica in una pipeline che nessun umano guarda. La sostituzione elimina l'intero prompt predefinito, inclusa la guida dello strumento e le istruzioni di sicurezza, quindi assumi la responsabilità di qualsiasi cosa il tuo compito abbia ancora bisogno.

Per persone persistenti che puoi alternare e condividere tra un progetto, usa gli stili di output. Per le convenzioni di progetto che Claude dovrebbe sempre seguire, usa CLAUDE.md. La guida dell'Agent SDK sui prompt di sistema copre la stessa decisione in maggiore profondità.

Flag del prompt di sistema nelle conversazioni riprese

Per impostazione predefinita, Claude Code costruisce il prompt di sistema una volta, sulla prima richiesta di una conversazione, con il testo da qualsiasi flag di prompt di sistema applicato, e lo registra nella sessione. Fino a quando la conversazione non viene compattata, ogni richiesta successiva utilizza quel prompt registrato, incluso dopo che torni alla conversazione con --resume o --continue. Se passi un testo di flag di prompt di sistema diverso, o nessuno, su quel lancio successivo, ha effetto una volta che la conversazione viene compattata o quando inizi una nuova conversazione.

Al di fuori delle sessioni cloud, se avvii Claude Code in modalità bare passando --bare o impostando CLAUDE_CODE_SIMPLE=1, la registrazione rimane disattivata a meno che tu non passi --system-prompt-snapshot on. Prima di v2.1.268, le sessioni che non recuperano i flag di funzionalità, incluse le sessioni su Amazon Bedrock, Google Cloud's Agent Platform, e Microsoft Foundry, ricostruivano il prompt su ogni richiesta e --system-prompt-snapshot non aveva effetto.

Per ricostruire il prompt su ogni richiesta invece, ad esempio mentre iteri sulla sua formulazione tra le esecuzioni --continue, passa --system-prompt-snapshot off. Prima di v2.1.265, passare uno qualsiasi dei flag di prompt di sistema disattivava anche la registrazione a meno che tu non passassi --system-prompt-snapshot on.

Vedi anche