> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# 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 "" "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](/it/claude-apps-gateway) auto-ospitato, per gli amministratori che distribuiscono SSO e policy davanti a Claude Code su Bedrock, Vertex AI o Foundry. Richiede `--config` che punta a un [`gateway.yaml`](/it/claude-apps-gateway-config). 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](/it/setup#install-a-specific-version) | `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](/it/agent-view) per monitorare e inviare sessioni parallele in background. Usa `--cwd ` 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](/it/agent-view#permission-mode-model-and-effort). 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 ` | Collegati a una [sessione in background](/it/agent-view#manage-sessions-from-the-shell) in questo terminale | `claude attach 7c5dcf5d` |
| `claude auto-mode defaults` | Stampa le regole del classificatore [auto mode](/it/permission-modes#eliminate-prompts-with-auto-mode) integrate come JSON. Usa `claude auto-mode config` per visualizzare la tua configurazione effettiva con le impostazioni applicate | `claude auto-mode defaults > rules.json` |
| `claude daemon status` | Stampa lo stato del [supervisore](/it/agent-view#the-supervisor-process) 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](/it/agent-view#the-supervisor-process) 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](/it/agent-view#agent-view-says-the-background-service-did-not-respond) | `claude daemon stop --any --keep-workers` |
| `claude logs ` | Stampa l'output recente da una [sessione in background](/it/agent-view#manage-sessions-from-the-shell) | `claude logs 7c5dcf5d` |
| `claude mcp` | Configura server Model Context Protocol (MCP) | Vedi la [documentazione MCP di Claude Code](/it/mcp). |
| `claude mcp login ` | {/* min-version: 2.1.186 */}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](/it/mcp#authenticate-from-the-command-line) | `claude mcp login sentry` |
| `claude mcp logout ` | {/* min-version: 2.1.186 */}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](/it/plugins) di Claude Code. Alias: `claude plugins`. Vedi il [riferimento plugin](/it/plugins-reference#cli-commands-reference) 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](/it/claude-directory#clear-local-data) | `claude project purge ~/work/repo --dry-run` |
| `claude remote-control` | Avvia un server [Remote Control](/it/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](/it/remote-control#start-a-remote-control-session) | `claude remote-control --name "My Project"` |
| `claude respawn ` | Riavvia una [sessione in background](/it/agent-view#manage-sessions-from-the-shell), 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 ` | Rimuovi una [sessione in background](/it/agent-view#manage-sessions-from-the-shell) 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](/it/authentication#generate-a-long-lived-token) | `claude setup-token` |
| `claude stop ` | Interrompi una [sessione in background](/it/agent-view#manage-sessions-from-the-shell). Accetta anche `claude kill` | `claude stop 7c5dcf5d` |
| `claude ultrareview [target]` | Esegui [ultrareview](/it/ultrareview#run-ultrareview-non-interactively) 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 ` 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?`.
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](/it/permissions#additional-directories-grant-file-access-not-configuration) da queste directory. Convalida che ogni percorso esista come directory. Per persistere queste directory tra le sessioni, imposta [`permissions.additionalDirectories`](/it/settings#permission-settings) nelle impostazioni | `claude --add-dir ../apps ../lib` |
| `--advisor ` | {/* min-version: 2.1.98 */}Abilita lo [strumento advisor](/it/advisor) lato server per questa sessione con un alias di modello: `opus`, `sonnet` o `fable` ({/* min-version: 2.1.170 */}v2.1.170+), o un ID modello completo. Ha la precedenza sull'impostazione `advisorModel` per la sessione. Richiede Claude Code v2.1.98 o successivo | `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](/it/sub-agents#supported-frontmatter-fields) 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](/it/permission-modes#skip-all-checks-with-bypasspermissions-mode) | `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](/it/settings#permission-rule-syntax) 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` |
| `--ax-screen-reader` | {/* min-version: 2.1.181 */}Renderizza output compatibile con lettore di schermo: testo piatto senza bordi decorativi o animazioni. Forza il renderer classico, quindi l'impostazione [`tui`](/it/settings#available-settings) non ha effetto per la sessione. Ha la precedenza su [`CLAUDE_AX_SCREEN_READER`](/it/env-vars) e l'impostazione [`axScreenReader`](/it/settings#available-settings). 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`](/it/env-vars). Vedi [modalità bare](/it/headless#start-faster-with-bare-mode) | `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](/it/agent-view) 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 | `claude --bg "investigate the flaky test"` |
| `--channels` | (Anteprima di ricerca) Server MCP le cui notifiche di [channel](/it/channels) Claude dovrebbe ascoltare in questa sessione. Elenco separato da spazi di voci `plugin:@`. Richiede autenticazione Claude.ai | `claude --channels plugin:my-notifier@my-marketplace` |
| `--chrome` | Abilita [integrazione browser Chrome](/it/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](/it/channels-reference#test-during-the-research-preview) che non sono nell'elenco di approvazione, per lo sviluppo locale. Accetta voci `plugin:@` e `server:`. 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](/it/permission-modes#skip-all-checks-with-bypasspermissions-mode) 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 ` | 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](/it/model-config#adjust-effort-level) per la sessione corrente. Opzioni: `low`, `medium`, `high`, `xhigh`, `max`; i livelli disponibili dipendono dal modello. Sostituisce l'impostazione [`effortLevel`](/it/settings#available-settings) per questa sessione e non persiste | `claude --effort high` |
| `--enable-auto-mode` | {/* max-version: 2.1.110 */}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](/it/model-config#fallback-model-chains). Per persistere una catena tra le sessioni, usa l'impostazione [`fallbackModel`](/it/settings#available-settings), 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](/it/hooks#setup) con il matcher `init` prima della sessione (solo modalità print) | `claude -p --init "query"` |
| `--init-only` | Esegui hook di [Setup](/it/hooks#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 --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](/it/agent-sdk/structured-outputs)) | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |
| `--maintenance` | Esegui hook di [Setup](/it/hooks#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`, `opus`, `haiku` o `fable`) o il nome completo di un modello. Sostituisce l'impostazione [`model`](/it/settings#available-settings) e [`ANTHROPIC_MODEL`](/it/model-config#environment-variables) | `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 `.
[`/rename`](/it/commands) 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](/it/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`](/it/env-vars) 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](/it/permission-modes) 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](/it/agent-sdk/overview) 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](/it/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |
| `--remote` | Crea una nuova [sessione web](/it/claude-code-on-the-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](/it/remote-control#start-a-remote-control-session) 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 ` | Prefisso per i nomi di sessione [Remote Control](/it/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](/it/agent-view) appaiono nel selettore contrassegnate con `bg` | `claude --resume auth-refactor` |
| `--safe-mode` | {/* min-version: 2.1.169 */}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`](/it/headless#start-faster-with-bare-mode). 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](/it/model-config#automatic-model-fallback). Imposta [`CLAUDE_CODE_SAFE_MODE`](/it/env-vars) | `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](/it/settings#settings-precedence) | `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](/it/claude-code-on-the-web) nel tuo terminale locale | `claude --teleport` |
| `--teammate-mode` | Imposta come i compagni di squadra del [team di agent](/it/agent-teams) vengono visualizzati: `in-process` (predefinito), `auto`, `tmux` o {/* min-version: 2.1.186 */}`iterm2` (aggiunto in v2.1.186). L'impostazione predefinita è cambiata da `auto` in v2.1.179. Sostituisce l'impostazione [`teammateMode`](/it/settings#available-settings) per questa sessione. Vedi [Scegli una modalità di visualizzazione](/it/agent-teams#choose-a-display-mode) | `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`](/it/settings#available-settings) per questa sessione | `claude --verbose` |
| `--version`, `-v` | Restituisce il numero di versione | `claude -v` |
| `--worktree`, `-w` | Avvia Claude in un [git worktree](/it/worktrees) isolato in `/.claude/worktrees/`. Se non viene fornito alcun nome, uno viene generato automaticamente. Passa `#` 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](/it/output-styles). Per convenzioni di progetto che Claude dovrebbe sempre seguire, usa [CLAUDE.md](/it/memory). La [guida Agent SDK sui prompt di sistema](/it/agent-sdk/modifying-system-prompts#decide-on-a-starting-point) copre la stessa decisione in maggiore profondità.
Vedi anche
* [Estensione Chrome](/it/chrome) - Automazione del browser e test web
* [Modalità interattiva](/it/interactive-mode) - Scorciatoie, modalità di input e funzionalità interattive
* [Guida di avvio rapido](/it/quickstart) - Introduzione a Claude Code
* [Flussi di lavoro comuni](/it/common-workflows) - Flussi di lavoro e pattern avanzati
* [Impostazioni](/it/settings) - Opzioni di configurazione
* [Documentazione Agent SDK](/it/agent-sdk/overview) - Utilizzo programmatico e integrazioni