Vai al contenuto principale

Comandi CLI

Puoi avviare sessioni, inviare contenuti tramite pipe, riprendere conversazioni e gestire gli aggiornamenti con questi comandi:
ComandoDescrizioneEsempio
claudeAvvia sessione interattivaclaude
claude "query"Avvia sessione interattiva con prompt inizialeclaude "explain this project"
claude -p "query"Esegui query tramite SDK, quindi esciclaude -p "explain this function"
cat file | claude -p "query"Elabora contenuto inviato tramite pipecat logs.txt | claude -p "explain"
claude -cContinua la conversazione più recente nella directory correnteclaude -c
claude -c -p "query"Continua tramite SDKclaude -c -p "Check for type errors"
claude -r "<session>" "query"Riprendi sessione per ID o nomeclaude -r "auth-refactor" "Finish this PR"
claude updateAggiorna alla versione più recenteclaude update
claude auth loginAccedi 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 Claudeclaude auth login --console
claude auth logoutEsci dal tuo account Anthropicclaude auth logout
claude auth statusMostra lo stato di autenticazione come JSON. Usa --text per output leggibile dall’uomo. Esce con codice 0 se connesso, 1 se noclaude auth status
claude agentsElenca tutti i subagents configurati, raggruppati per fonteclaude agents
claude auto-mode defaultsStampa le regole del classificatore auto mode integrate come JSON. Usa claude auto-mode config per visualizzare la tua configurazione effettiva con le impostazioni applicateclaude auto-mode defaults > rules.json
claude mcpConfigura server Model Context Protocol (MCP)Vedi la documentazione MCP di Claude Code.
claude pluginGestisci i plugins di Claude Code. Alias: claude plugins. Vedi il riferimento plugin per i sottocomandiclaude plugin install code-review@claude-code-marketplace
claude remote-controlAvvia 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à serverclaude remote-control --name "My Project"

Flag CLI

Personalizza il comportamento di Claude Code con questi flag da riga di comando:
FlagDescrizioneEsempio
--add-dirAggiungi directory di lavoro aggiuntive per l’accesso di Claude (convalida che ogni percorso esista come directory)claude --add-dir ../apps ../lib
--agentSpecifica un agent per la sessione corrente (sostituisce l’impostazione agent)claude --agent my-custom-agent
--agentsDefinisci subagents personalizzati dinamicamente tramite JSON. Utilizza gli stessi nomi di campo del frontmatter dei subagents, più un campo prompt per le istruzioni dell’agentclaude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissionsAbilita il bypass delle autorizzazioni come opzione senza attivarla immediatamente. Consente la composizione con --permission-mode (usa con cautela)claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedToolsStrumenti 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"Bash(git log *)" "Bash(git diff *)" "Read"
--append-system-promptAggiungi testo personalizzato alla fine del prompt di sistema predefinitoclaude --append-system-prompt "Always use TypeScript"
--append-system-prompt-fileCarica testo di prompt di sistema aggiuntivo da un file e aggiungi al prompt predefinitoclaude --append-system-prompt-file ./extra-rules.txt
--bareModalità 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à bareclaude --bare -p "query"
--betasIntestazioni beta da includere nelle richieste API (solo utenti con chiave API)claude --betas interleaved-thinking
--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.aiclaude --channels plugin:my-notifier@my-marketplace
--chromeAbilita integrazione browser Chrome per l’automazione web e i testclaude --chrome
--continue, -cCarica la conversazione più recente nella directory correnteclaude --continue
--dangerously-load-development-channelsAbilita channels che non sono nell’elenco di approvazione, per lo sviluppo locale. Accetta voci plugin:<name>@<marketplace> e server:<name>. Richiede confermaclaude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissionsSalta tutti i prompt di autorizzazione (usa con cautela). Vedi modalità di autorizzazione per quello che questo fa e non fa saltareclaude --dangerously-skip-permissions
--debugAbilita la modalità debug con filtro di categoria opzionale (ad esempio, "api,hooks" o "!statsig,!file")claude --debug "api,mcp"
--disable-slash-commandsDisabilita tutti gli skills e i comandi per questa sessioneclaude --disable-slash-commands
--disallowedToolsStrumenti che vengono rimossi dal contesto del modello e non possono essere utilizzati"Bash(git log *)" "Bash(git diff *)" "Edit"
--effortImposta il livello di sforzo per la sessione corrente. Opzioni: low, medium, high, max (solo Opus 4.6). Limitato alla sessione e non persiste nelle impostazioniclaude --effort high
--fallback-modelAbilita il fallback automatico al modello specificato quando il modello predefinito è sovraccarico (solo modalità print)claude -p --fallback-model sonnet "query"
--fork-sessionQuando riprendi, crea un nuovo ID di sessione invece di riutilizzare l’originale (usa con --resume o --continue)claude --resume abc123 --fork-session
--from-prRiprendi sessioni collegate a una specifica PR di GitHub. Accetta un numero di PR o un URL. Le sessioni vengono collegate automaticamente quando create tramite gh pr createclaude --from-pr 123
--ideConnettiti automaticamente all’IDE all’avvio se esattamente un IDE valido è disponibileclaude --ide
--initEsegui hook di inizializzazione e avvia la modalità interattivaclaude --init
--init-onlyEsegui hook di inizializzazione e esci (nessuna sessione interattiva)claude --init-only
--include-partial-messagesIncludi eventi di streaming parziali nell’output (richiede --print e --output-format=stream-json)claude -p --output-format stream-json --include-partial-messages "query"
--input-formatSpecifica il formato di input per la modalità print (opzioni: text, stream-json)claude -p --output-format json --input-format stream-json
--json-schemaOttieni 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"
--maintenanceEsegui hook di manutenzione e esciclaude --maintenance
--max-budget-usdImporto massimo in dollari da spendere nelle chiamate API prima di fermarsi (solo modalità print)claude -p --max-budget-usd 5.00 "query"
--max-turnsLimita il numero di turni agentici (solo modalità print). Esce con un errore quando il limite viene raggiunto. Nessun limite per impostazione predefinitaclaude -p --max-turns 3 "query"
--mcp-configCarica server MCP da file JSON o stringhe (separati da spazi)claude --mcp-config ./mcp.json
--modelImposta il modello per la sessione corrente con un alias per il modello più recente (sonnet o opus) o il nome completo di un modelloclaude --model claude-sonnet-4-6
--name, -nImposta 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-chromeDisabilita integrazione browser Chrome per questa sessioneclaude --no-chrome
--no-session-persistenceDisabilita la persistenza della sessione in modo che le sessioni non vengano salvate su disco e non possano essere riprese (solo modalità print)claude -p --no-session-persistence "query"
--output-formatSpecifica il formato di output per la modalità print (opzioni: text, json, stream-json)claude -p "query" --output-format json
--enable-auto-modeSblocca auto mode nel ciclo Shift+Tab. Richiede un piano Team (supporto Enterprise e API in arrivo a breve) e Claude Sonnet 4.6 o Opus 4.6claude --enable-auto-mode
--permission-modeInizia in una modalità di autorizzazione specificataclaude --permission-mode plan
--permission-prompt-toolSpecifica uno strumento MCP per gestire i prompt di autorizzazione in modalità non interattivaclaude -p --permission-prompt-tool mcp_auth_tool "query"
--plugin-dirCarica plugin da una directory per questa sessione solo. Ogni flag accetta un percorso. Ripeti il flag per più directory: --plugin-dir A --plugin-dir Bclaude --plugin-dir ./my-plugins
--print, -pStampa la risposta senza modalità interattiva (vedi documentazione Agent SDK per i dettagli di utilizzo programmatico)claude -p "query"
--remoteCrea una nuova sessione web su claude.ai con la descrizione dell’attività fornitaclaude --remote "Fix the login bug"
--remote-control, --rcAvvia 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 sessioneclaude --remote-control "My Project"
--resume, -rRiprendi una sessione specifica per ID o nome, o mostra un selettore interattivo per scegliere una sessioneclaude --resume auth-refactor
--session-idUsa uno specifico ID di sessione per la conversazione (deve essere un UUID valido)claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sourcesElenco separato da virgole delle fonti di impostazioni da caricare (user, project, local)claude --setting-sources user,project
--settingsPercorso di un file JSON di impostazioni o una stringa JSON da cui caricare impostazioni aggiuntiveclaude --settings ./settings.json
--strict-mcp-configUsa solo server MCP da --mcp-config, ignorando tutte le altre configurazioni MCPclaude --strict-mcp-config --mcp-config ./mcp.json
--system-promptSostituisci l’intero prompt di sistema con testo personalizzatoclaude --system-prompt "You are a Python expert"
--system-prompt-fileCarica il prompt di sistema da un file, sostituendo il prompt predefinitoclaude --system-prompt-file ./custom-prompt.txt
--teleportRiprendi una sessione web nel tuo terminale localeclaude --teleport
--teammate-modeImposta come i compagni di squadra del team di agent vengono visualizzati: auto (predefinito), in-process, o tmux. Vedi configurare team di agentclaude --teammate-mode in-process
--toolsLimita 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"
--verboseAbilita la registrazione dettagliata, mostra l’output completo turno per turnoclaude --verbose
--version, -vRestituisce il numero di versioneclaude -v
--worktree, -wAvvia Claude in un git worktree isolato in <repo>/.claude/worktrees/<name>. Se non viene fornito alcun nome, uno viene generato automaticamenteclaude -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.
FlagComportamentoEsempio
--system-promptSostituisce l’intero prompt predefinitoclaude --system-prompt "You are a Python expert"
--system-prompt-fileSostituisce con il contenuto del fileclaude --system-prompt-file ./prompts/review.txt
--append-system-promptAggiunge al prompt predefinitoclaude --append-system-prompt "Always use TypeScript"
--append-system-prompt-fileAggiunge il contenuto del file al prompt predefinitoclaude --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. Per la maggior parte dei casi d’uso, usa un flag di aggiunta. L’aggiunta preserva le capacità integrate di Claude Code mentre aggiunge i tuoi requisiti. Usa un flag di sostituzione solo quando hai bisogno del controllo completo sul prompt di sistema.

Vedi anche