Prima di iniziare
Claude Code gira nel terminale del tuo computer, quella finestra di testo dove digiti i comandi. Ti servirà anche un piano Claude a pagamento (Pro o Max); il piano gratuito non include Claude Code.
La buona notizia: con l'installer ufficiale non devi installare Node.js. Si tratta di un singolo comando.
Una cosa da fare prima se sei su Windows: Claude Code ha bisogno di uno strumento gratuito chiamato Git for Windows per funzionare (lo usa in background, non dovrai impararlo o usarlo tu stesso). Se sei su Windows e non ce l'hai già, installalo prima di proseguire:
Vai su git-scm.com/downloads/win e scarica l'installer.
Esegui l'installer. Clicca su "Next" (Avanti) su ogni schermata per accettare le impostazioni predefinite: non devi cambiare nulla, anche se ci sono diverse schermate.
Se ti chiede quale editor usare, lascia quello predefinito e clicca "Next" (Avanti).
Quando arrivi alla schermata "Adjusting your PATH environment", mantieni l'opzione già selezionata.
Non sei sicuro se hai Git? Installalo comunque, reinstallarlo non crea problemi. Gli utenti Mac possono saltare questo passaggio; non serve altro.
Passo 1 — Apri il terminale
Apri il terminale sul tuo computer. Il modo di farlo dipende dal tuo sistema:
Windows 10: Premi il tasto Windows + R, digita
cmde premi Invio. Si aprirà il Prompt dei comandi.Windows 11: Clicca sulla barra di ricerca nella barra delle applicazioni (o premi il tasto Windows), digita
Terminale clicca su Terminal nei risultati. In alternativa, fai clic destro sul pulsante Start e seleziona Terminal.Mac: Premi Cmd + Spazio per aprire Spotlight, digita
Terminale premi Invio.
Si aprirà una finestra con una riga vuota dove puoi digitare; qui andranno tutti i comandi che seguiranno.
Passo 2 — Esegui l'installer
Copia il comando per il tuo sistema, incollalo nel terminale e premi Invio.
Mac:
curl -fsSL https://claude.ai/install.sh | bash
Windows 11 (e Windows 10 usando Terminal/PowerShell):
irm https://claude.ai/install.ps1 | iex
Windows 10 (se hai aperto il Prompt dei comandi con cmd al Passo 1):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Vedrai scorrere del testo mentre lavora. Quando ha finito, vedrai un messaggio che conferma che Claude Code è stato installato con successo. Se invece appare un errore, controlla la sezione "Risoluzione dei problemi" in fondo.
Passo 3 — Apri una nuova finestra del terminale
È un passaggio facile da saltare, ma è importante. Chiudi completamente la finestra del terminale e aprine una nuova (usando lo stesso metodo del Passo 1).
L'installer aggiunge Claude Code al tuo sistema, ma il terminale si accorge del cambiamento solo quando avvii una nuova finestra. Saltare questo passaggio è il motivo più comune per cui il passo successivo sembra "non funzionare".
Passo 4 — Avvia Claude Code ed effettua il login
Nella tua nuova finestra del terminale, digita:
claude
La prima volta che lo esegui, ti chiederà come vuoi accedere. Scegli di accedere con il tuo account Claude (non con una API key). Si aprirà una finestra del browser dove potrai accedere al tuo account Claude. Una volta effettuato l'accesso, puoi tornare al terminale: il tuo abbonamento Pro o Max ora funziona in Claude Code.
È tutto. Ora puoi digitare domande o richieste direttamente nel terminale.
Risoluzione dei problemi
I passaggi di installazione sono gli stessi su ogni sistema, ma se qualcosa va storto, la soluzione può variare a seconda di cosa stai usando. Ecco i problemi più comuni.
"claude non è riconosciuto" o "comando non trovato" dopo l'installazione
Questo significa quasi sempre che hai saltato il Passo 3. Chiudi completamente il terminale, aprilo di nuovo, e digita di nuovo claude. Il terminale riconosce i comandi appena installati solo quando avvii una nuova sessione.
Windows: "irm non è riconosciuto" (sei nel Prompt dei comandi, non in PowerShell)
Se il comando irm dà un errore come "non è riconosciuto come comando interno o esterno", sei nel Prompt dei comandi (CMD) anziché in PowerShell. Puoi capire in quale dei due ti trovi guardando l'inizio della riga: PowerShell mostra PS C:\... mentre il Prompt dei comandi mostra solo C:\....
Usa invece la versione del comando per il Prompt dei comandi:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows 10: "Impossibile creare un canale sicuro SSL/TLS"
Questo può accadere su sistemi Windows 10 più vecchi. In PowerShell, esegui prima la riga qui sotto, poi riesegui il comando di installazione:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 irm https://claude.ai/install.ps1 | iex
Windows: "Claude Code su Windows richiede git-bash"
Ciò significa che Git for Windows non è installato (o Claude Code non riesce a trovarlo). Torna alla sezione "Prima di iniziare" sopra e installa Git for Windows, poi chiudi il tuo terminale, aprine uno nuovo ed esegui di nuovo claude.
Mac: messaggio di sicurezza o "permesso"
Dato che l'installer ufficiale mette Claude Code in una cartella di tua proprietà (all'interno della tua directory home), gli errori di permesso causati da metodi di installazione precedenti non si verificano qui. Se il tuo Mac mostra un popup di sicurezza la prima volta che esegui claude dicendo che non è riuscito a verificare l'app, apri Impostazioni di Sistema → Privacy e Sicurezza, scorri fino al messaggio relativo a claude, e clicca su Consenti comunque. Poi esegui di nuovo claude nel terminale.
Ancora bloccato?
Dopo l'installazione, puoi eseguire questo comando per far controllare a Claude Code se stesso e segnalare cosa c'è che non va:
claude doctor
Analizza la tua installazione e le impostazioni comuni e di solito ti dice esattamente cosa correggere.