Skip to main content
Questa guida rapida tratta Claude Code nel tuo terminale: l’installazione della CLI, l’accesso dalla tua prima sessione e il suo utilizzo per le attività di sviluppo comuni nel tuo progetto.

Prima di iniziare

Assicurati di avere:
Questi casi sono trattati in altre pagine:

Passaggio 1: Installa Claude Code

Per installare Claude Code, apri un terminale ed esegui il comando per il tuo sistema. Se non hai mai utilizzato un terminale prima, la guida al terminale mostra come aprirne uno e incollare il comando.
macOS, Linux, WSL:
Su Windows, il tuo prompt mostra PS C:\ quando sei in PowerShell e C:\ senza il PS quando sei in CMD.Windows PowerShell:
Windows CMD:
Il comando di installazione non mostra alcun avanzamento mentre scarica Claude Code. Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui claude --version. Un’installazione funzionante stampa un numero di versione. Se la tua shell dice che claude non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi Correggi il tuo PATH.Se vedi The token '&&' is not a valid statement separator, sei in PowerShell, non in CMD. Se vedi 'irm' is not recognized as an internal or external command, sei in CMD, non in PowerShell.Se il comando di installazione non riesce con syntax error near unexpected token '<', un 403 o qualsiasi altro errore, consulta Risoluzione dei problemi di installazione per abbinare l’errore a una soluzione e per metodi di installazione alternativi.Git for Windows è consigliato su Windows nativo in modo che Claude Code possa utilizzare lo strumento Bash. Se Git for Windows non è installato, Claude Code utilizza PowerShell come strumento shell. Le configurazioni WSL non necessitano di Git for Windows.
Le installazioni native si aggiornano automaticamente in background per mantenerti sulla versione più recente.
Puoi anche installare con apt, dnf, o apk su Debian, Fedora, RHEL e Alpine. Per confermare che l’installazione ha funzionato, esegui:
Il comando stampa un numero di versione seguito da (Claude Code).

Passaggio 2: Avvia la tua prima sessione

Apri il terminale in qualsiasi directory di progetto e avvia Claude Code:
Sostituisci /path/to/your/project con il percorso del progetto su cui vuoi lavorare. Al primo utilizzo, Claude Code ti chiede di accedere. Per gli abbonamenti Claude o gli account Console, segui le istruzioni per completare l’autenticazione nel browser. Se hai impostato la variabile d’ambiente ANTHROPIC_API_KEY e approvi la chiave quando Claude Code ti chiede se usarla, Claude Code salta la richiesta di accesso. Puoi accedere con uno qualsiasi di questi tipi di account: Una volta effettuato l’accesso, le tue credenziali vengono memorizzate e non dovrai accedere di nuovo. Scopri di più in Gestione delle credenziali. Viene visualizzato il prompt di Claude Code, con la versione, il modello corrente e la directory di lavoro mostrati sopra di esso. Digita /help per i comandi disponibili oppure /resume per continuare una conversazione precedente. Per cambiare account in seguito o ripetere l’autenticazione, digita /login all’interno della sessione in esecuzione.

Passaggio 3: Fai la tua prima domanda

Prova uno di questi comandi:
Claude analizzerà i tuoi file e fornirà un riepilogo. Puoi anche fare domande più specifiche:
Puoi anche chiedere a Claude informazioni sulle sue capacità:
Claude Code legge i file del tuo progetto quando necessario. Non devi aggiungere manualmente il contesto.

Passaggio 4: Apporta la tua prima modifica al codice

Prova un’attività semplice:
Claude Code trova il file appropriato e ti mostra la modifica. Se ti chiede conferma prima di apportare la modifica, seleziona Yes per approvarla. La modalità di permesso della sessione stabilisce quali azioni Claude può eseguire senza chiederti prima conferma. Premi Shift+Tab in qualsiasi momento per cambiare la modalità di permesso della sessione in cui ti trovi.

Passaggio 5: Usa Git con Claude Code

Claude Code rende le operazioni Git conversazionali:
Puoi anche chiedere operazioni Git più complesse:

Passaggio 6: Correggi un bug o aggiungi una funzionalità

Descrivi ciò che desideri in linguaggio naturale:
Oppure correggi problemi esistenti:

Passaggio 7: Prova altri workflow comuni

Prova qualche altro prompt. Puoi chiedere a Claude di fare il refactoring del codice, scrivere test, aggiornare la documentazione o revisionare le tue modifiche:
Parla con Claude come faresti con un collega disponibile. Descrivi cosa vuoi ottenere e ti aiuterà a raggiungere il tuo obiettivo.

Comandi essenziali

Ecco i comandi più importanti per l’uso quotidiano, raggruppati in base a dove li esegui.

Comandi shell

Eseguili dal tuo terminale per avviare o riprendere Claude Code. Consulta il riferimento CLI per l’elenco completo dei comandi shell.

Comandi di sessione

Eseguili all’interno di Claude Code dopo l’avvio. Consulta il riferimento comandi per l’elenco completo dei comandi di sessione.

Suggerimenti professionali per i principianti

Per ulteriori informazioni, vedi best practices e flussi di lavoro comuni.
Invece di: “correggi il bug”Prova: “correggi il bug di accesso in cui gli utenti vedono una schermata vuota dopo aver inserito credenziali errate”
Suddividi i compiti complessi in passaggi:
Prima di apportare modifiche, lascia che Claude comprenda il tuo codice:
  • Digita / per vedere tutti i comandi e le skills disponibili
  • Usa Tab per il completamento dei comandi
  • Premi ↑ per la cronologia dei comandi
  • Premi Shift+Tab per ciclo tra le modalità di autorizzazione

Cosa fare dopo?

Ora che hai imparato le nozioni di base, esplora funzionalità più avanzate: Consulta la configurazione avanzata per le opzioni di installazione, gli aggiornamenti manuali o le istruzioni di disinstallazione.

Ottenere aiuto

  • In Claude Code: digita /help o fai una domanda del tipo “come faccio a…”
  • Documentazione: sfoglia le altre guide su questo sito
  • Corsi: Segui Claude Code 101 e altri corsi gratuiti a tuo ritmo su Claude Academy
  • Community: Unisciti al server Discord per suggerimenti e supporto