Per installare Claude Code terminale e comandi cambiano in base al sistema

Installare Claude Code da terminale: che cos’è la CLI e perché usarla?#

Il terminale spaventa quasi tutti quelli che si avvicinano al vibe coding senza un background nello sviluppo software. Sembra una finestra nera dei film sugli hacker, ma in realtà è solo una riga in cui si digitano comandi. Claude Code ne ha bisogno proprio per poter aprire i tuoi file, modificarli ed eseguire controlli da solo mentre descrivi l'attività a parole.

Anthropic descrive così il prodotto.

La differenza rispetto a una chat familiare è semplice. Nel browser, copi il codice a mano, avanti e indietro tra la finestra e l'editor. Claude Code entra direttamente nella cartella del progetto, legge i file necessari, apporta la modifica e ti mostra che cosa ha cambiato. Sei tu a decidere e approvare; lui svolge il lavoro meccanico.

Se proprio non vuoi usare il terminale, Anthropic offre un'app desktop con una normale finestra e una versione web su claude.ai/code che funziona direttamente nel browser. Ma l'opzione più potente e flessibile è la versione per terminale, di cui parla questo articolo.

Con Claude Code installare la CLI inizia dal sito ufficiale#

Il primo punto che confonde i principianti è capire dov'è il sito ufficiale di Claude Code e che cosa cliccare per scaricarlo. Ecco una tabella con tutti gli indirizzi ufficiali di Anthropic, così non dovrai tirare a indovinare.

Non si scarica dal sito un programma di installazione come si farebbe per un normale programma, cosa che va contro le aspettative. Lo si installa con un comando del terminale, che scarica la versione giusta per il tuo sistema. Questo articolo contiene i comandi esatti per Mac, Windows e Linux.

Una confusione frequente riguarda il nome: spesso si sbaglia a scriverlo come clode code, clade code, слод код o clode design. Il prodotto si chiama Claude Code, con au. Tienilo presente quando cerchi il sito ufficiale: i domini con grafie simili appartengono ad altri.

È utile conoscere anche il nome esatto del pacchetto npm. Il pacchetto canonico è @anthropic-ai/claude-code, con il prefisso @anthropic-ai/. Anthropic detiene il nome breve claude-code senza prefisso: è il suo riferimento ufficiale allo stesso pacchetto. La regola semplice è: l'editore deve essere Anthropic e il nome da usare per l'installazione include il prefisso.

Prima di installare Claude Code su Ubuntu: requisiti del computer#

I requisiti di Claude Code sono modesti: sono i server di Anthropic a svolgere il lavoro più impegnativo; il computer invia solo richieste e riceve risposte.

Una nota a parte su Node.js, visto che circolano molti miti al riguardo. Il programma di installazione nativo, quello consigliato da Anthropic stessa, non ha bisogno di Node.js: si installa come un unico file autonomo. Node.js serve solo se installi Claude Code tramite npm, e in quel caso occorre la versione 22 o successiva. Gli articoli più vecchi dicono «Node 18 e versioni successive»: è un'informazione superata; prendi come riferimento la versione 22 o superiore.

Per la versione principale serve un terminale. Se non vuoi usarne uno, installa l'app desktop con la sua normale finestra oppure usa la versione web su claude.ai/code. La versione per terminale offre comunque più funzionalità, quindi il resto dell'articolo spiega come installare quella.

Installare Claude Code è come procurarsi uno strumento. Ma da solo spesso ha allucinazioni: dimentica il tuo progetto, inventa cose e perde il filo a metà di un'attività. Una combinazione di tre elementi lo rende affidabile: un clone AI, un Second Brain e il context engineering. Sono i tre pilastri che impediscono all'AI di avere allucinazioni.

Come installare Claude Code su Mac: metodo nativo e Homebrew#

Apri Terminale (è incluso in ogni Mac: premi Cmd+Space in Spotlight e digita «Terminal») e incolla questa riga:

curl -fsSL https://claude.ai/install.sh | bash

Il comando scarica il programma di installazione dall'indirizzo ufficiale di Anthropic e installa Claude Code. Node.js non serve. Il metodo nativo è comodo anche per gli aggiornamenti.

Se usi già Homebrew, c'è una seconda opzione:

brew install --cask claude-code

La differenza sta nel modo in cui funzionano gli aggiornamenti: il programma di installazione nativo si aggiorna autonomamente, mentre Homebrew no, quindi dovrai aggiornarlo manualmente con il comando brew upgrade claude-code. Il programma è lo stesso, perciò scegli il metodo a cui sei abituato. Se non sai quale scegliere, usa il primo.

Come installare Claude Code su Windows?#

Per prima cosa, verifica in quale ambiente ti trovi. Windows ha due shell, ciascuna con il proprio comando. Apri una finestra e guarda l'inizio del prompt: PS C:\> indica PowerShell, mentre C:\> senza PS indica il Prompt dei comandi (CMD).

Per PowerShell (il modo più semplice per aprirlo è fare clic con il tasto destro sul pulsante Start e scegliere «Terminal»):

irm https://claude.ai/install.ps1 | iex

Per il Prompt dei comandi (CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

C'è una terza opzione: usare il gestore di pacchetti WinGet integrato:

winget install Anthropic.ClaudeCode

Se hai già un ambiente WSL funzionante (Linux all'interno di Windows), installa Claude Code direttamente in WSL usando lo stesso comando che useresti su Linux. Per WSL c'è una particolarità separata relativa a Node, che illustrerò nella sezione sugli errori frequenti qui sotto.

Per installare Claude Code Ubuntu supporta l’installer nativo e i repository Linux#

Il metodo di base è lo stesso per tutte le distribuzioni più diffuse: il programma di installazione autonomo:

curl -fsSL https://claude.ai/install.sh | bash

Node.js non è necessario: il programma viene fornito come un unico file e da quel momento si aggiorna autonomamente.

Se sei abituato a installare programmi solo tramite il gestore di pacchetti del sistema, puoi aggiungere i repository ufficiali di Anthropic: apt per Debian e Ubuntu, dnf per Fedora e RHEL, e apk per Alpine. Sono firmati con una chiave e dispongono dei canali stable e latest. Per un principiante è eccessivo, quindi lascio i dettagli alla documentazione nella sezione delle fonti e consiglio di norma il comando qui sopra.

Può esserci un intoppo sui server economici. Se il computer ha pochissima memoria libera, l'installazione può interrompersi con la parola Killed (codice 137): il sistema ha terminato il processo perché ha esaurito la memoria. La soluzione è aggiungere un file di swap: per l'installazione Claude Code ha bisogno di circa 512 MB di memoria libera.

Come si avvia Claude Code per la prima volta?#

Il primo avvio richiede un paio di minuti. Ecco come procedere.

1. Vai nella cartella del progetto

   Nel terminale, usa il comando cd path-to-project per raggiungere la cartella su cui vuoi lavorare, poi digita claude.

2. Accedi al tuo account

   Si aprirà un browser con una finestra di accesso. Se non si apre automaticamente, premi c per copiare il link e incollalo manualmente in un browser. Se il browser mostra un codice (può capitare in WSL e sui server remoti), incollalo di nuovo nel terminale.

3. Attendi la conferma

   Una volta effettuato l'accesso, il terminale mostrerà Login successful e ti chiederà di premere Invio.

4. Fai la tua prima domanda

   Chiedi qualcosa di semplice sul progetto, per esempio «che cosa fa questo progetto?». Claude leggerà i file e risponderà.

5. Approva la prima modifica

   Quando gli chiedi di modificare qualcosa, Claude ti mostrerà le modifiche proposte e chiederà conferma. Puoi cambiare la modalità di accesso con Shift+Tab.

Vale la pena imparare subito alcuni comandi di base all'interno della sessione: /help elenca i comandi, /clear cancella la cronologia della conversazione e /exit esce (fa lo stesso anche premere due volte Ctrl+D). Claude ti mostrerà tutto questo se digiti /help.

Accesso con un abbonamento o una chiave API: quale scegliere?#

Questa è la prima domanda che sorge quando si effettua l'accesso.

Ci sono due modi per accedere e differiscono per il metodo di pagamento.

Per accedere con un abbonamento, basta usare il proprio account Claude.ai. Per accedere con una chiave API, procuratene una da Claude Console (platform.claude.com): gli addebiti vengono scalati dal saldo prepagato mentre lavori. Imposta la chiave nella variabile d'ambiente ANTHROPIC_API_KEY e Claude Code non aprirà il browser a ogni avvio.

Puoi cambiare account durante una sessione con /login e disconnetterti con /logout.

Ma Claude Code non si avvia senza un accesso a pagamento. Se non hai ancora un account, scopri prima quale indirizzo email usare per registrarti: non potrai cambiarlo in seguito.

Installare Claude Code CLI: come verificare che l’installazione sia riuscita?#

Ci sono tre comandi che è utile conoscere fin da subito.

Il primo controlla la versione:

claude --version

Un'installazione funzionante risponde con un numero nel formato X.Y.Z (Claude Code). Le cifre specifiche cambiano da una versione all'altra; l'importante è che il comando restituisca un numero di versione. Una risposta «command not found» indica un altro problema, che esaminerò nella sezione successiva.

Il secondo è lo strumento di diagnostica, da usare se qualcosa non va.

Il terzo è /status all'interno di una sessione: mostra come hai effettuato l'accesso, quale email o organizzazione è collegata e se l'accesso è scaduto. E claude update applica subito l'ultimo aggiornamento invece di attendere quello in background.

Perché il comando claude non viene trovato dopo l'installazione?#

È il problema più segnalato dai principianti e sembra più spaventoso di quanto sia. Il terminale non cerca i comandi in tutto il computer: controlla solo le cartelle indicate in PATH. Claude Code si installa in ~/.local/bin/claude (su Mac e Linux) o %USERPROFILE%\\.local\\bin\\claude.exe (su Windows) e, se quella cartella non è in PATH, il terminale semplicemente non riesce a vedere il programma.

Su Mac e Linux, aggiungi la cartella all'elenco. Apri il file delle impostazioni della shell (~/.zshrc per Zsh, ~/.bashrc per Bash) e aggiungi questa riga alla fine:

export PATH="$HOME/.local/bin:$PATH"

Poi chiudi e riapri il terminale (oppure esegui source ~/.zshrc). A quel punto, il comando claude verrà trovato.

Errori comuni durante l'installazione e il primo avvio#

Esaminiamoli nell'ordine; sono tutti tratti dalla guida ufficiale alla risoluzione dei problemi di Anthropic.

1. Versione vecchia di Node per l'installazione tramite npm. Il pacchetto @anthropic-ai/claude-code richiede Node.js 22 o versione successiva. Su Windows, npm può non riuscire con un messaggio che indica che gli script sono disabilitati: è la policy di PowerShell che ne blocca l'esecuzione. In WSL, un errore frequente è exec: node: not found: WSL sta usando Node per Windows invece di Node per Linux. Se npm ti dà problemi, passa al programma di installazione nativo: non richiede Node.
2. Programma di installazione errato per la shell. 'irm' is not recognized significa che hai incollato un comando di PowerShell nel Prompt dei comandi. The token '&&' is not a valid statement separator significa che hai fatto il contrario e hai eseguito un comando CMD in PowerShell. A parameter cannot be found that matches parameter name 'fsSL' significa che hai eseguito in PowerShell il comando per Mac/Linux. Controlla l'inizio del prompt: PS C:\ indica PowerShell e C:\ indica CMD.
3. Una vecchia chiave API prevale sull'abbonamento. Se l'abbonamento è attivo ma nell'ambiente è ancora impostata una vecchia chiave, vedrai API Error: 400 ... This organization has been disabled. La chiave ha la precedenza sull'accesso tramite abbonamento. Rimuovila con unset ANTHROPIC_API_KEY (in PowerShell, usa Remove-Item Env:ANTHROPIC_API_KEY), controlla ~/.zshrc e ~/.bashrc, poi digita /status.
4. Memoria insufficiente su un server poco potente. L'installazione si interrompe con la parola Killed e il codice 137: significa che la RAM non basta. Servono circa 512 MB liberi; aggiungendo swap il problema si risolve.
5. Il programma di installazione ha restituito qualcos'altro. L'errore syntax error near unexpected token '<' o un riferimento a <!DOCTYPE html> significa che l'URL di installazione ha restituito una pagina web invece dello script di installazione, di solito a causa della regione geografica, di un firewall aziendale o di un'interruzione temporanea. Prova un altro metodo (Homebrew, WinGet) oppure riprova tra qualche minuto.

Per ciascuno di questi errori, il primo passo è lo stesso: esegui claude doctor. Mostrerà che cosa non va e suggerirà dove cercare.

C'è una particolarità diagnostica: un semplice 403 durante l'installazione può anche dipendere da un firewall o proxy aziendale. Se sei collegato alla rete dell'ufficio, controlla prima che non stia bloccando l'accesso.

Che cosa fare dopo l'installazione: i primi passi#

L'installazione è solo l'inizio. Il vero lavoro comincia dopo e il primo problema che si incontra è la memoria. Un modello linguistico non si ricorda di te tra una conversazione e l'altra: in una nuova chat conosce solo ciò che hai inserito nel suo contesto.

Il primo passo concreto dopo l'installazione è quindi creare un file CLAUDE.md nella radice del progetto. È un file di testo con regole e contesto del progetto, che Claude Code legge a ogni avvio. Descrivi una volta sola che cosa fai, com'è organizzato il progetto e che cosa conta: non dovrai ripeterlo in ogni conversazione.

In una guida separata spiego come preparare quel file e personalizzare Claude: come personalizzare Claude. Ho anche preparato una mappa generale degli strumenti per il vibe coding del 2026.

Che cos'altro chiedono le persone?#

Il framework completo per il vibe coding: clone AI + Second Brain + context engineering.