--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 |
