Utilizzo e controlli della CLI
Impara a utilizzare Claude Code dalla riga di comando, inclusi i comandi CLI, i flag e i comandi slash.
Per iniziare
Claude Code offre due modi principali per interagire:
- Modalità interattiva: Esegui
claudeper avviare una sessione REPL - Modalità one-shot: Usa
claude -p "query"per comandi rapidi
Comandi CLI
| Comando | Descrizione | Esempio |
|---|---|---|
claude | Avvia REPL interattivo | claude |
claude "query" | Avvia REPL con prompt iniziale | claude "spiega questo progetto" |
claude -p "query" | Esegui query singola, poi esci | claude -p "spiega questa funzione" |
cat file | claude -p "query" | Elabora contenuto tramite pipe | cat logs.txt | claude -p "spiega" |
claude -c | Continua la conversazione più recente | claude -c |
claude -c -p "query" | Continua in modalità print | claude -c -p "Controlla errori di tipo" |
claude -r "<session-id>" "query" | Riprendi sessione per ID | claude -r "abc123" "Completa questa PR" |
claude update | Aggiorna all’ultima versione | claude update |
claude mcp | Configura i server Model Context Protocol | Vedi sezione MCP nei tutorial |
Flag CLI
Personalizza il comportamento di Claude Code con questi flag da riga di comando:
| Flag | Descrizione | Esempio |
|---|---|---|
--add-dir | Aggiungi directory di lavoro aggiuntive a cui Claude può accedere (verifica che ogni percorso esista come directory) | claude --add-dir ../apps ../lib |
--allowedTools | Un elenco di strumenti che dovrebbero essere consentiti senza chiedere il permesso all’utente, in aggiunta ai file settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Write" |
--disallowedTools | Un elenco di strumenti che dovrebbero essere vietati senza chiedere il permesso all’utente, in aggiunta ai file settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Write" |
--print, -p | Stampa la risposta senza modalità interattiva (vedi documentazione SDK per dettagli sull’uso programmatico) | claude -p "query" |
--output-format | Specifica il formato di output per la modalità print (opzioni: text, json, stream-json) | claude -p "query" --output-format json |
--verbose | Abilita il logging dettagliato, mostra l’output completo turno per turno (utile per il debug sia in modalità print che interattiva) | claude --verbose |
--max-turns | Limita il numero di turni agentici in modalità non interattiva | claude -p --max-turns 3 "query" |
--model | Imposta il modello per la sessione corrente con un alias per l’ultimo modello (sonnet o opus) o il nome completo di un modello | claude --model claude-sonnet-4-20250514 |
--permission-prompt-tool | Specifica uno strumento MCP per gestire le richieste di autorizzazione in modalità non interattiva | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--resume | Riprendi una sessione specifica per ID, o scegliendo in modalità interattiva | claude --resume abc123 "query" |
--continue | Carica la conversazione più recente nella directory corrente | claude --continue |
--dangerously-skip-permissions | Salta le richieste di autorizzazione (usa con cautela) | claude --dangerously-skip-permissions |
Il flag --output-format json è particolarmente utile per scripting e
automazione, permettendo di analizzare programmaticamente le risposte di Claude.
Per informazioni dettagliate sulla modalità print (-p) inclusi i formati di output,
lo streaming, il logging dettagliato e l’uso programmatico, consulta la
documentazione SDK.
Comandi slash
Controlla il comportamento di Claude durante una sessione interattiva:
| Comando | Scopo |
|---|---|
/bug | Segnala bug (invia la conversazione ad Anthropic) |
/clear | Cancella la cronologia della conversazione |
/compact [istruzioni] | Compatta la conversazione con istruzioni di focus opzionali |
/config | Visualizza/modifica la configurazione |
/cost | Mostra le statistiche di utilizzo dei token |
/doctor | Controlla lo stato di salute dell’installazione di Claude Code |
/help | Ottieni aiuto sull’utilizzo |
/init | Inizializza il progetto con la guida CLAUDE.md |
/login | Cambia account Anthropic |
/logout | Disconnettiti dal tuo account Anthropic |
/memory | Modifica i file di memoria CLAUDE.md |
/model | Seleziona o cambia il modello AI |
/permissions | Visualizza o aggiorna permessi |
/pr_comments | Visualizza i commenti delle pull request |
/review | Richiedi revisione del codice |
/status | Visualizza lo stato dell’account e del sistema |
/terminal-setup | Installa la combinazione di tasti Shift+Enter per nuove righe (solo iTerm2 e VSCode) |
/vim | Entra in modalità vim per alternare modalità di inserimento e comando |
Scorciatoie speciali
Memoria rapida con #
Aggiungi memorie istantaneamente iniziando il tuo input con #:
Ti verrà chiesto di selezionare in quale file di memoria memorizzare questo.
Interruzioni di riga nel terminale
Inserisci comandi multilinea usando:
- Escape rapido: Digita
\seguito da Invio - Scorciatoia da tastiera: Option+Invio (o Shift+Invio se configurato)
Per configurare Option+Invio nel tuo terminale:
Per Mac Terminal.app:
- Apri Impostazioni → Profili → Tastiera
- Seleziona “Usa Option come tasto Meta”
Per iTerm2 e terminale VSCode:
- Apri Impostazioni → Profili → Tasti
- In Generale, imposta il tasto Option sinistro/destro su “Esc+”
Suggerimento per utenti iTerm2 e VSCode: Esegui /terminal-setup all’interno di Claude Code per
configurare automaticamente Shift+Invio come alternativa più intuitiva.
Vedi configurazione del terminale nelle impostazioni per dettagli sulla configurazione.
Modalità Vim
Claude Code supporta un sottoinsieme di associazioni di tasti Vim che possono essere abilitate con /vim
o configurate tramite /config.
Il sottoinsieme supportato include:
- Cambio di modalità:
Esc(a NORMAL),i/I,a/A,o/O(a INSERT) - Navigazione:
h/j/k/l,w/e/b,0/$/^,gg/G - Modifica:
x,dw/de/db/dd/D,cw/ce/cb/cc/C,.(ripeti)