--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 |
--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 | 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-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 |
--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 | Avvia la sessione come un agent in background e ritorna immediatamente. Stampa l’ID della sessione e i comandi di gestione. Combina con --agent per eseguire uno specifico subagent | 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 |
--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 | Strumenti che vengono rimossi dal contesto del modello e non possono essere utilizzati | "Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort | Imposta il livello di sforzo per la sessione corrente. Opzioni: low, medium, high, xhigh, max; i livelli disponibili dipendono dal modello. 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, stato git) 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" |
--fallback-model | Abilita il fallback automatico al modello specificato quando il modello predefinito è sovraccarico (solo modalità print) | claude -p --fallback-model sonnet "query" |
--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 tutti gli eventi del ciclo di vita degli hook nel flusso di output. Richiede --output-format stream-json | claude -p --output-format stream-json --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 --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 -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 | 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 o opus) o il nome completo di un modello. Sostituisce l’impostazione model e ANTHROPIC_MODEL | claude --model claude-sonnet-4-6 |
--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 o bypassPermissions. 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 -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" |
--remote | Crea una nuova sessione web su claude.ai con la descrizione dell’attività fornita | 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 --replay-user-messages |
--resume, -r | Riprendi una sessione specifica per ID o nome, o mostra un selettore interattivo per scegliere una sessione. Include sessioni che hanno aggiunto questa directory con /add-dir | claude --resume auth-refactor |
--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: auto (predefinito), in-process o tmux. Sostituisce l’impostazione teammateMode per questa sessione. Vedi Scegli una modalità di visualizzazione | claude --teammate-mode in-process |
--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" | 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 |
