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 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 |
claude agents |
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 |
claude auto-mode defaults > rules.json |
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 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 interrotta mantenendo la sua conversazione intatta. Usa --all per riavviare ogni sessione interrotta |
claude respawn 7c5dcf5d |
claude rm <id> |
Rimuovi una sessione in background dall'elenco | 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?.
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 |
--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 |
{/* 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, 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 |
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
- Estensione Chrome - Automazione del browser e test web
- Modalità interattiva - Scorciatoie, modalità di input e funzionalità interattive
- Guida di avvio rapido - Introduzione a Claude Code
- Flussi di lavoro comuni - Flussi di lavoro e pattern avanzati
- Impostazioni - Opzioni di configurazione
- Documentazione Agent SDK - Utilizzo programmatico e integrazioni