Skip to main content
Potete usare Claude Code anche se non avete mai usato un terminale prima. Questa guida vi accompagna nell’apertura di un terminale, nell’installazione di Claude Code e nelle vostre prime interazioni.
Non volete usare il terminale? L’app desktop Claude Code vi permette di saltare completamente il terminale. Scaricatela per macOS o Windows, quindi consultate la Guida rapida per desktop per iniziare. Su Linux, installate l’app con apt seguendo le istruzioni di installazione per Linux.

Installa Claude Code su macOS o Linux

Seguite questi passaggi per installare e avviare Claude Code da un terminale macOS o Linux. Claude Code richiede macOS 13.0 o versione successiva. Consultate i requisiti di sistema per le distribuzioni Linux supportate.
1

Aprire un terminale

macOS: Premete Cmd + Space per aprire Spotlight Search, digitate Terminal e premete Enter.Linux: Aprite l’app del vostro terminale. Sulla maggior parte delle distribuzioni, premete Ctrl + Alt + T o cercate “Terminal” nel vostro menu delle applicazioni.Apparirà una finestra con un cursore lampeggiante. Questo è il vostro terminale, dove digitate i comandi.
2

Installare Claude Code

Copiate questa riga, incollatela nel vostro terminale (Cmd + V su macOS, Ctrl + Shift + V su Linux) e premete Enter:
Questo scarica ed esegue il programma di installazione di Claude Code da claude.ai. Il comando non mostra alcun avanzamento mentre Claude Code viene scaricato, quindi lascia la finestra aperta e attendi. Quando il programma di installazione avrà finito, vedrai “Claude Code successfully installed!” Se invece vedi un errore, consulta la sezione sulla risoluzione dei problemi qui sotto.
3

Avviare Claude Code

Digitate claude e premete Enter:
Se vedete command not found: claude, la directory di installazione non è ancora nel vostro PATH. Seguite la correzione ‘command not found: claude’ qui sotto, quindi aprite una nuova finestra del terminale e riprovate.Vi verrà chiesto di accedere con il vostro account Claude. Seguite le istruzioni sullo schermo. Una finestra del browser si aprirà per farvi accedere.
4

Iniziare a usare Claude Code

Una volta effettuato l’accesso, potete iniziare a fare domande a Claude sul vostro codice o su qualsiasi altra cosa. Claude Code funziona interamente in testo. Digitate i messaggi e premete Enter per inviarli. Alcune cose da sapere:
  • Non potete fare clic su cose nel terminale. Usate i tasti freccia per muovervi.
  • Premete Esc per interrompere Claude se è in esecuzione.
  • Digitate exit o premete Ctrl + D due volte su un prompt vuoto per uscire da Claude Code.
  • Digitate /help per vedere i comandi disponibili.

Installare Claude Code su Windows

Seguite questi passaggi per installare facoltativamente Git per Windows, configurare PowerShell e avviare Claude Code su Windows. Claude Code richiede Windows 10 versione 1809 o successiva. Consultate i requisiti di sistema per i dettagli completi.
1

Installare Git per Windows (facoltativo)

Git per Windows fornisce Git Bash, che abilita lo strumento Bash. Senza di esso, Claude Code utilizza PowerShell. Non avrete bisogno di imparare Git da soli.Se non lo avete già:
  1. Andate su git-scm.com/downloads/win e scaricate il programma di installazione
  2. Eseguite il programma di installazione. Fate clic su Avanti su ogni schermata per accettare i valori predefiniti. Il programma di installazione ha molte schermate, ma non dovete cambiare nulla.
  3. Se vi chiede di scegliere un editor, mantenete il valore predefinito e fate clic su Avanti.
  4. Quando vedete “Adjusting your PATH environment,” mantenete l’opzione consigliata selezionata.
Avete già Git? Potete saltare questo passaggio. Se non siete sicuri, installatelo comunque. La reinstallazione non causerà problemi.
2

Aprire PowerShell

PowerShell è il terminale integrato di Windows per digitare comandi. È preinstallato su ogni computer Windows.Premete Win + X e selezionate Windows PowerShell (o Terminal) dal menu. Apparirà una finestra con un cursore lampeggiante. Qui digiterete i comandi.
Windows ha due programmi da riga di comando: PowerShell e CMD. Si assomigliano ma usano comandi diversi. Assicuratevi di essere in PowerShell per il passaggio successivo.Come capire in quale siete:
  • PowerShell: mostra PS C:\Users\YourName> all’inizio di ogni riga
  • CMD: mostra C:\Users\YourName> senza il PS
3

Installare Claude Code

Copiate questa riga, incollatela in PowerShell con Ctrl + V o fate clic con il pulsante destro del mouse, e premete Enter:
Questo scarica ed esegue il programma di installazione di Claude Code. irm recupera il file e iex lo esegue. Il comando non mostra alcun avanzamento mentre Claude Code viene scaricato, quindi lascia la finestra aperta e attendi. Quando il programma di installazione avrà finito, vedrai “Claude Code successfully installed!” Se invece vedi un errore, consulta la sezione risoluzione dei problemi qui sotto.
Se siete in CMD invece di PowerShell, usate questo comando:
4

Avviare Claude Code

Eseguite claude. Se PowerShell dice 'claude' is not recognized, la directory di installazione non è ancora nel vostro PATH. Seguite la correzione ‘claude is not recognized’ qui sotto, quindi aprite una nuova finestra PowerShell e riprovate.
Vi verrà chiesto di accedere con il vostro account Claude. Seguite le istruzioni sullo schermo. Una finestra del browser si aprirà per farvi accedere.
5

Iniziare a usare Claude Code

Una volta effettuato l’accesso, potete iniziare a fare domande a Claude sul vostro codice o su qualsiasi altra cosa. Claude Code funziona interamente in testo. Digitate i messaggi e premete Enter per inviarli. Alcune cose da sapere:
  • Non potete fare clic su cose nel terminale. Usate i tasti freccia per muovervi.
  • Premete Esc per interrompere Claude se è in esecuzione.
  • Digitate exit o premete Ctrl + D due volte su un prompt vuoto per uscire da Claude Code.
  • Digitate /help per vedere i comandi disponibili.

Cosa fare dopo?

Una volta che vedete la schermata di benvenuto di Claude Code, siete pronti a partire. Non avete bisogno di sapere come codificare. Descrivete quello che volete in inglese semplice, e Claude scrive il codice per voi.

Costruire qualcosa

Claude può creare progetti da una descrizione:
Se Claude ti chiede il permesso prima di creare o modificare file, premi Enter per scegliere Sì e approvare. Una volta che Claude ha creato i file, fai doppio clic sul file HTML per aprirlo nel tuo browser.

Lavorare con file sul vostro computer

Claude può leggere e organizzare file che avete già:

Fare domande

Claude può spiegare cose, aiutarvi a imparare o pianificare un progetto:
Se non avete ancora un progetto, va bene. Claude può aiutarvi a iniziarne uno nuovo.

Altri modi per usare Claude Code

Non dovete usare il terminale. Claude Code è disponibile anche in:

Scopri di più

Risoluzione dei problemi

Risoluzione dei problemi su macOS e Linux

Se riscontri problemi durante l’installazione su macOS o Linux, controlla questi problemi comuni:
Se vedi command not found: claude dopo l’installazione, la cartella in cui il programma di installazione ha inserito claude non si trova nel tuo PATH. Il programma di installazione stampa la correzione esatta sotto Setup notes alla fine dell’installazione, quindi esegui quel comando oppure usa quello per la tua shell riportato di seguito.Per Zsh, la shell predefinita di macOS:
Per Bash su Linux:
Per Bash su macOS, segui invece il passaggio per Bash su macOS in correggi il tuo PATH.Quindi apri un nuovo terminale e prova di nuovo claude. Se ancora non viene trovato, verifica che il file ~/.local/bin/claude esista. In caso contrario, l’installazione non è stata completata. Per maggiori dettagli, consulta correggi il tuo PATH.
Se vedi bash: line 1: syntax error near unexpected token '<' o codice HTML come <!DOCTYPE html> nel tuo terminale, l’URL di installazione ha restituito una pagina web invece dello script di installazione.Se la pagina riporta “App unavailable in region”, Claude Code non è disponibile nel tuo paese. Consulta i paesi supportati.Altrimenti, prova a eseguire di nuovo il comando. Se continua a succedere, installa invece con Homebrew:
Al termine, apri una nuova finestra del terminale, digita claude --version e premi Enter: se l’installazione è andata a buon fine, il comando stampa un numero di versione come 2.1.211 (Claude Code).
Se vedi dyld: cannot load, dyld: Symbol not found o built for Mac OS X 13.0, probabilmente la tua versione di macOS è più vecchia di quelle supportate da Claude Code.Apri il menu Apple e seleziona Informazioni su questo Mac per controllare la tua versione. Se è precedente alla 13.0, aggiorna macOS tramite Aggiornamento software. Consulta la guida alla risoluzione dei problemi su macOS per maggiori dettagli.
Per altri errori, consulta la guida completa alla risoluzione dei problemi di installazione.

Risoluzione dei problemi su Windows

Se riscontri problemi durante l’installazione su Windows, controlla questi problemi comuni:
Ti trovi in CMD, non in PowerShell. Chiudi questa finestra e apri invece PowerShell (Win + X quindi seleziona Windows PowerShell).In alternativa, usa il comando di installazione per CMD:
Di solito succede sui sistemi Windows 10 meno recenti. Esegui prima questa riga, quindi riprova l’installazione:
Non è stato trovato né PowerShell né Git Bash. Claude Code ha bisogno di almeno una shell.
  1. Assicurati che powershell.exe sia nel tuo PATH. La sua posizione predefinita è C:\Windows\System32\WindowsPowerShell\v1.0\. In alternativa, installa PowerShell 7, che fornisce pwsh.
  2. Se preferisci usare Git Bash, installa Git for Windows come indicato nel primo passaggio della sezione Windows.
  3. Se Git è installato ma Claude Code non riesce a trovarlo, indicagli dove cercare:
    Quindi esegui di nuovo claude. Se il tuo Git è installato altrove, trova il percorso eseguendo:
    Cerca la cartella Git\bin in quel percorso e usala al suo posto.
Per rendere questa impostazione permanente e non doverla impostare ogni volta, consulta configura il percorso di Git Bash.
Se l’errore è comparso subito dopo un aggiornamento di Claude Code, consulta prima ripristina claude.exe dal suo backup.Se la directory di installazione non è nel tuo PATH, aggiungila eseguendo questi comandi in PowerShell:
Chiudi PowerShell, apri una nuova finestra e prova di nuovo claude. Dovresti vedere la schermata di benvenuto di Claude Code. Consulta verifica il tuo PATH per maggiori dettagli.
Su una macchina a 64 bit, questo errore significa che hai aperto Windows PowerShell (x86) invece di Windows PowerShell. La voce x86 viene eseguita come processo a 32 bit. Chiudila, apri la voce del menu Start senza (x86) nel nome ed esegui di nuovo il comando di installazione. Se non sei sicuro che la tua macchina sia a 64 bit, o se l’errore persiste, consulta la spiegazione completa.
Per altri errori, consulta la guida completa alla risoluzione dei problemi di installazione.