SpyBara
Go Premium

cli-reference.md 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

68 added, 68 removed.

2026
Mon 10 20:01 Sun 9 04:02 Sat 8 04:59 Fri 7 23:57 Thu 6 15:02 Wed 5 22:02 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

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 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 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 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. La trascrizione della conversazione rimane sul tuo computer locale, disponibile tramite claude --resume claude rm 7c5dcf5d
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 30 minuti 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; la maggior parte della configurazione .claude/ non viene scoperta da queste directory. Convalida che ogni percorso esista come directory. 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: opus, sonnet o fable (v2.1.170+), o un ID modello completo. Ha la precedenza sull'impostazione advisorModel per la sessione 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. Utilizza gli stessi nomi di campo del frontmatter dei subagents, più un campo prompt per le istruzioni dell'agent 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 "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. 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-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
--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, plugins, server MCP, memoria automatica e CLAUDE.md in modo che le chiamate con script si avviino più velocemente. 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 Claude.ai claude --channels plugin:my-notifier@my-marketplace
--chrome Abilita integrazione browser Chrome per l'automazione web e i test claude --chrome
--cloud Crea una nuova sessione web su claude.ai con la descrizione dell'attività fornita claude --cloud "Fix the login bug"
--continue, -c Carica la conversazione più recente nella directory corrente. 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 claude --dangerously-skip-permissions
--debug Abilita la modalità debug con filtro di categoria opzionale (ad esempio, "api,hooks" o "!statsig,!file") claude --debug "api,mcp"
--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 del modello: "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 "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 avvia la sessione a livello di sforzo xhigh con ultracode attivato e richiede Claude Code v2.1.203 o successivo. Sostituisce l'impostazione 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
--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
--from-pr Riprendi 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 da ogni evento hook nel flusso di output. Gli eventi hook SessionStart e Setup sono sempre inclusi e non hanno bisogno di questo flag. 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. Prima di v2.1.205, uno schema non valido produceva output non strutturato senza errore e gli schemi che utilizzavano format erano trattati come non validi 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) 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 inviato mentre Claude sta lavorando rimane in coda e viene eseguito come il suo turno, con il suo limite, quando il limite termina quello corrente. Prima di v2.1.205, Claude Code scartava quel messaggio claude -p --max-turns 3 "query"
--mcp-config Carica server MCP da file JSON o stringhe (separati da spazi) claude --mcp-config ./mcp.json
--model Imposta il modello per la sessione corrente con un alias per il modello più recente (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 durante la sessione e lo mostra anche nella 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à che l'interfaccia utente etichetta come Manuale 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 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 di 30 secondi. Prima di v2.1.206, un server che si avvia lentamente potrebbe far uscire con un errore che lo strumento MCP non è stato trovato.

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"
--plugin-dir Carica un plugin da una directory o da un archivio .zip per questa sessione solo. Ogni flag accetta un percorso. Ripeti il flag per più plugin: --plugin-dir A --plugin-dir B.zip claude --plugin-dir ./my-plugin
--plugin-url Recupera un archivio plugin .zip da un URL per questa sessione solo. 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 documentazione Agent SDK per i dettagli di utilizzo programmatico) claude -p "query"
--prompt-suggestions Emetti un messaggio prompt_suggestion dopo ogni turno con un prompt utente successivo previsto. Richiede --print, --output-format stream-json e --verbose. Vedi Suggerimenti di prompt claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--remote Alias deprecato per --cloud 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
--resume, -r Riprendi una sessione specifica per ID o nome, o mostra un selettore interattivo per scegliere una sessione. Il selettore e la ricerca per nome includono sessioni che hanno aggiunto questa directory con /add-dir; passare un ID di sessione cerca solo nella directory del progetto corrente e nei suoi git worktrees. A partire da v2.1.144, 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 da Fable 5. 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. Vedi precedenza delle impostazioni claude --settings ./settings.json
--strict-mcp-config Usa solo server MCP da --mcp-config, ignorando tutte le altre configurazioni MCP 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
--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). L'impostazione predefinita è cambiata da auto in v2.1.179. 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 tutti, o nomi di strumenti come "Bash,Edit,Read". Gli strumenti MCP non sono interessati; per negarli anche, usa --disallowedTools "mcp__*" o passa --strict-mcp-config senza --mcp-config in modo che nessun server MCP si carichi 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, uno viene generato automaticamente. Passa #<number> o un URL di pull request di GitHub per recuperare quella PR da origin e creare un branch del worktree da essa claude -w feature-auth

Flag del prompt di sistema

Claude Code fornisce quattro flag per personalizzare il prompt di sistema. Tutti e quattro 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 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.

Questi flag si applicano solo all'invocazione corrente. 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à.

Vedi anche