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. Disponibile in Claude Code v2.1.195 e successivo. |
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 |
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> |
Collegati a una sessione in background in questo terminale | claude attach 7c5dcf5d |
claude auto-mode defaults |
Stampa le regole del classificatore auto mode 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 di auto mode 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 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à al Controllo Remoto. 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> |
Stampa l'output recente da una sessione in background | 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, quindi incolla l'URL di reindirizzamento al prompt. Richiede Claude Code v2.1.186 o successivo. Vedi Autentica dalla riga di comando |
claude mcp login sentry |
claude mcp logout <name> |
Cancella le credenziali OAuth archiviate per un server MCP. Richiede Claude Code v2.1.186 o successivo | claude mcp logout sentry |
claude plugin |
Gestisci i plugins di Claude Code. Alias: claude plugins. Vedi il riferimento plugin per i sottocomandi |
claude plugin install code-review@claude-plugins-official |
claude project 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 project 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 nel 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 nel 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?.
A partire da v2.1.199, claude --dangerously-skip-permissions daemon <subcommand> esegue il sottocomando daemon. Le versioni precedenti trattavano daemon <subcommand> come il prompt per una nuova sessione interattiva, quindi il sottocomando non veniva mai eseguito quando il flag veniva per primo, una configurazione comune quando claude è aliasato per includere il flag. Solo un --dangerously-skip-permissions o --allow-dangerously-skip-permissions iniziale instrada a daemon in questo modo; qualsiasi altro flag iniziale avvia comunque una sessione interattiva.
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 Claude per 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 persistere 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 agent per la sessione corrente (sostituisce l'impostazione agent) |
claude --agent my-custom-agent |
--agents |
Definisci subagents personalizzati dinamicamente tramite JSON. Accetta i campi elencati per i subagents definiti da CLI. Claude Code convalida il JSON all'avvio e esce su 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 autorizzazione |
claude --permission-mode plan --allow-dangerously-skip-permissions |
--allowedTools, --allowed-tools |
Strumenti che si eseguono senza richiedere l'autorizzazione. Vedi sintassi delle regole di autorizzazione per la corrispondenza dei pattern. Per limitare quali strumenti sono disponibili, usa --tools invece. Se nomini uno dei task-tracking tools 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 subagent, inclusi i subagents annidati, a parte un subagent forkato, 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 testo da un file e aggiungilo ai prompt di sistema dei subagents. Un'alternativa a --append-subagent-system-prompt per 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 output compatibile con lettore di schermo: testo piatto senza bordi decorativi o animazioni. Forza il renderer classico, quindi l'impostazione tui non ha effetto; le sessioni in background allegate si rendono comunque 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-discovery di hooks, skills, comandi personalizzati, subagents, plugins, server MCP, memoria automatica e CLAUDE.md in modo che le chiamate con script si avviino più velocemente. Skills in una directory che passi con --add-dir si caricano comunque. Claude ha accesso a 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 un agent in background e ritorna immediatamente. Stampa l'ID della sessione e i comandi di gestione. Combina con --exec per eseguire un comando shell come un job in background invece di una sessione Claude, o con --agent per eseguire uno specifico subagent. 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 channel Claude dovrebbe ascoltare in questa sessione. Elenco separato da spazi di voci plugin:<name>@<marketplace>. Richiede autenticazione Anthropic tramite claude.ai o una chiave API Console |
claude --channels plugin:my-notifier@my-marketplace |
--chrome |
Abilita integrazione browser Chrome per l'automazione web e i test | claude --chrome |
--cloud |
Con una descrizione di attività, crea una nuova sessione web su claude.ai. 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 sessioni che hanno aggiunto questa directory con /add-dir |
claude --continue |
--dangerously-load-development-channels |
Abilita channels che non sono nell'elenco di approvazione, per lo sviluppo locale. Accetta voci plugin:<name>@<marketplace> e server:<name>. Richiede conferma |
claude --dangerously-load-development-channels server:webhook |
--dangerously-skip-permissions |
Salta i prompt di autorizzazione. Equivalente a --permission-mode bypassPermissions. Vedi modalità di autorizzazione per quello che questo fa e non fa saltare. Per le sessioni avviate con --bg, la modalità persiste quando il supervisor riavvia la sessione |
claude --dangerously-skip-permissions |
--debug |
Abilita la modalità debug con filtro di categoria opzionale, come --debug='mcp,startup' o --debug='!1p'. 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 file specifico. Abilita implicitamente la modalità debug. Ha la precedenza su CLAUDE_CODE_DEBUG_LOGS_DIR |
claude --debug-file /tmp/claude-debug.log |
--disable-slash-commands |
Disabilita tutti gli 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 corrispondenti come scritto](/it/permissions#bash-rule-limits). Una regola che nomina EndConversation non può rimuoverlo 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 xhigh effort 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. Auto mode è ora nel ciclo Shift+Tab per impostazione predefinita; usa --permission-mode auto per iniziare in esso |
claude --permission-mode auto |
--environment <environment-id> |
Crea una nuova sessione cloud che viene eseguita sull'ambiente self-hosted 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 le sezioni per macchina dal prompt di sistema (directory di lavoro, informazioni sull'ambiente, percorsi di memoria, flag git-repo) nel primo messaggio dell'utente. Migliora il riutilizzo della prompt-cache 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 e multi-utente |
claude -p --exclude-dynamic-system-prompt-sections "query" |
--exec |
Esegui un comando shell come un job in background supportato da PTY invece di avviare una sessione Claude. Usa con --bg per avviare 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 persistere 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 blocchi di testo e thinking dei subagents 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 il testo e i blocchi di thinking di un subagent che viene eseguito in foreground. Richiede --print e --output-format stream-json. Claude Code inoltra anche i messaggi dai subagents annidati, impostando parent_tool_use_id all'ID della chiamata dello strumento Agent che ha generato ognuno; questo richiede Claude Code v2.1.219 o successivo. La variabile di 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 specifica pull request. Accetta un numero di PR, un URL di GitHub o GitHub Enterprise PR, un URL di merge request di GitLab o un URL di pull request di Bitbucket. Le sessioni vengono collegate automaticamente quando Claude crea la pull request | claude --from-pr 123 |
--ide |
Connettiti automaticamente all'IDE all'avvio se esattamente un IDE valido è disponibile | claude --ide |
--init |
Esegui hook di Setup con il matcher init prima della sessione (solo modalità print) |
claude -p --init "query" |
--init-only |
Esegui hook di 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 hook SessionStart e Setup sono sempre inclusi e non hanno bisogno di questo flag. Alcuni eventi hook, come Notification, SessionEnd, PreCompact e PostCompact, non producono mai un evento hook_started, anche con questo flag. Per questi eventi, 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 termina. Richiede --output-format stream-json |
claude -p --output-format stream-json --verbose --include-hook-events "query" |
--include-partial-messages |
Includi eventi di streaming parziali 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'agent completa il suo flusso di lavoro (solo modalità print). Vedi structured outputs. 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 hook di Setup con il matcher maintenance prima della sessione (solo modalità print) |
claude -p --maintenance "query" |
--max-budget-usd |
Importo massimo in dollari da spendere nelle chiamate API prima di fermarsi (solo modalità print). La spesa dai subagents conta verso il limite. Una volta che la spesa raggiunge il limite, generare un altro subagent fallisce con Budget limit reached, e Claude Code arresta i subagents 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 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 una lista di strumenti memorizzata nella cache salta l'attesa e si connette al primo utilizzo. 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>. In una sessione interattiva, se un'altra sessione live su questa macchina usa già il nome, Claude Code applica una variante di esso invece. /rename cambia il nome durante la sessione e lo mostra anche sulla barra del prompt |
claude -n "my-feature-work" |
--no-chrome |
Disabilita integrazione browser Chrome per questa sessione | claude --no-chrome |
--no-session-persistence |
Disabilita la persistenza della sessione in modo che le sessioni non vengano salvate su disco e non possano 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 autorizzazione specificata. Accetta default, acceptEdits, plan, auto, dontAsk, bypassPermissions, o manual come alias per default. L'alias manual seleziona la modalità di autorizzazione che l'interfaccia utente etichetta come 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 autorizzazione descritta in quale modalità di autorizzazione una sessione inizia in. Per -p, è default quando nulla è configurato |
claude --permission-mode plan |
--permission-prompt-tool |
Specifica uno strumento MCP per gestire i prompt di autorizzazione in modalità non interattiva. 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 un deny. Questa restrizione richiede Claude Code v2.1.199 o successivo |
claude -p --permission-prompt-tool mcp_auth_tool "query" |
--permission-prompts |
Imposta chi risponde ai prompt di autorizzazione in modalità print. Con il valore predefinito 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 autorizzazione 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 da un archivio .zip, o diversi da una cartella di plugins, per questa sessione solo. Ogni flag accetta un percorso. Ripeti il flag per più percorsi: --plugin-dir A --plugin-dir B.zip. Passare una cartella di plugins richiede Claude Code v2.1.265 o successivo |
claude --plugin-dir ./my-plugin |
--plugin-url |
Recupera un archivio plugin .zip da un URL per questa sessione solo. Ripeti il flag per più plugins, 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 documentazione Agent SDK per i dettagli di utilizzo programmatico) | 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 alcuno. 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 non è impostato alcun nome esplicito. 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](/it/sessions#where-transcripts-are-stored). Il selettore e la ricerca per nome includono 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 |
claude --resume auth-refactor |
--safe-mode |
Avvia con tutte le personalizzazioni disabilitate per risolvere i problemi di una configurazione interrotta: CLAUDE.md, skills, plugins, hooks, server MCP, comandi e agent personalizzati, stili di output, flussi di lavoro, temi personalizzati, scorciatoie da tastiera personalizzate, comandi della barra di stato e dei suggerimenti di file, server LSP e memoria automatica non si caricano. L'autenticazione, la selezione del modello, gli strumenti integrati e le autorizzazioni funzionano normalmente, il che differisce da --bare. La politica delle impostazioni gestite si applica comunque, inclusi hook configurati da politica, barra di stato e comandi dei suggerimenti di file; plugin gestiti, skills gestiti, CLAUDE.md gestito e server MCP configurati da politica non lo fanno. Utile per verificare se una personalizzazione è ciò che attiva il fallback automatico del modello. Imposta CLAUDE_CODE_SAFE_MODE |
claude --safe-mode |
--session-id |
Usa uno specifico ID di sessione 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 impostazioni da caricare (user, project, local) |
claude --setting-sources user,project |
--settings |
Percorso di 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 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 esecuzioni --continue. Richiede Claude Code v2.1.257 o successivo |
claude --system-prompt-snapshot off |
--teleport |
Riprendi una sessione web nel tuo terminale locale | claude --teleport |
--teammate-mode |
Imposta come i compagni di squadra del team di agent vengono visualizzati: in-process (predefinito), auto, tmux, o iterm2 (aggiunto in v2.1.186). 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. Utilizza 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ò utilizzare. 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 esclude Glob e Grep, come descritto in Comportamento dello strumento Glob. Se nomini uno dei task-tracking tools qui, Claude Code opta anche la sessione in. Il flag non influisce sugli strumenti MCP; per negarli anche, usa --disallowedTools "mcp__*". Un elenco che omette EndConversation non lo rimuove; "" lo rimuove solo quando nessuno strumento MCP rimane |
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 |
Restituisce il numero di versione | claude -v |
--worktree, -w |
Avvia Claude in un git worktree isolato in <repo>/.claude/worktrees/<name>. Se non viene fornito alcun nome, Claude Code ne genera uno. Passa #<number>, un URL di pull request di GitHub o un URL di merge request di GitLab per recuperare quella PR o MR da origin e creare un branch del worktree da essa. Il branching da una merge request di 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 valore predefinito, riutilizza un prompt registrato dove la registrazione si applica |
claude --append-system-prompt "Draft rules" --system-prompt-snapshot off |
--system-prompt e --system-prompt-file si escludono a vicenda. I flag di aggiunta possono essere combinati con uno qualsiasi dei flag di sostituzione.
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 aggiuntive: istruzioni per invocazione, formattazione dell'output o contesto di dominio per uno script -p. L'aggiunta preserva la guida predefinita degli strumenti, le istruzioni di sicurezza e le convenzioni di codifica, quindi fornisci solo ciò che differisce. Usa un flag di sostituzione quando la superficie, l'identità o il modello di autorizzazione differisce da quello di Claude Code, come un agent non di codifica in una pipeline che nessun umano osserva. La sostituzione elimina l'intero prompt predefinito, inclusa la guida degli strumenti e le istruzioni di sicurezza, quindi assumi la responsabilità di qualunque cosa il tuo compito abbia ancora bisogno.
Per persone persistenti che puoi alternare e condividere in un progetto, usa output styles. Per convenzioni di progetto che Claude dovrebbe sempre seguire, usa CLAUDE.md. La guida 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 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.
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 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 itteri sulla sua formulazione tra 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
- Estensione Chrome - Automazione del browser e test web
- Modalità interattiva - Scorciatoie, modalità di input e funzionalità interattive
- Guida di avvio rapido - Introduzione a Claude Code
- Flussi di lavoro comuni - Flussi di lavoro e pattern avanzati
- Impostazioni - Opzioni di configurazione
- Documentazione Agent SDK - Utilizzo programmatico e integrazioni