Come installare Claude Code da Terminale su Mac: la guida completa

• Un Mac con macOS 13 o successivo, almeno 4 GB di RAM e una connessione a internet.
• Un account a pagamento di Claude (Pro, Max, Ultra, Team o Enterprise) oppure un account Console. Il piano gratuito di claude.ai non include Claude Code.
• Il Terminale: se non l’hai mai usato, leggi prima i comandi di base.

Non serve installare altro: né Node.js né Homebrew, a meno che tu scelga quei metodi alternativi (vedi più sotto).

Apri il Terminale (⌘ Spazio, «Terminale»), incolla questo comando e premi Invio:

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

Non vedrai una barra di avanzamento: aspetta che il comando finisca. Non usare sudo: lo script si rifiuta di partire se lo fai, perché installerebbe tutto nella cartella sbagliata.

Il comando fa due cose: curl scarica lo script dal sito di Claude (-f fallisce se c’è un errore, -s lavora in silenzio, -S mostra comunque gli errori, -L segue i reindirizzamenti), e | bash lo esegue.

Chiudi il Terminale e aprine uno nuovo, poi scrivi:

claude --version

Se funziona, stampa un numero di versione. Sul nostro Mac ha risposto 2.1.316 (Claude Code); il tuo numero sarà diverso perché esce spesso una versione nuova.

Per un controllo più completo, in sola lettura:

claude doctor

Sul nostro Mac le righe principali erano: Running: native, Platform: darwin-arm64, Auto-updates: enabled, Auto-update channel: latest e l’esito dell’ultimo aggiornamento (success).

Spostati nella cartella su cui vuoi lavorare e avvia Claude Code. Per le prime prove usa una cartella di prova, non i tuoi documenti importanti:

mkdir Prova-claude
cd Prova-claude
claude

Alla prima partenza segui le istruzioni nel browser per accedere con il tuo account. Poi continua con la prima sessione passo dopo passo. Se imposti la variabile ANTHROPIC_API_KEY e confermi quando Claude Code te lo chiede, l’accesso nel browser viene saltato.

Con l’installazione nativa Claude Code si aggiorna da solo in background e la nuova versione parte alla successiva apertura. Per aggiornare subito:

claude update

Se dice «Claude Code is up to date» sei già all’ultima. Puoi scegliere se ricevere le novità subito (canale latest, quello predefinito) o una versione di circa una settimana prima (stable) nelle impostazioni, con il comando /config dentro Claude Code.

Significa che il programma c’è ma la sua cartella non è nel PATH, l’elenco di cartelle in cui la shell cerca i comandi. Controlla prima il file, poi il PATH:

ls -la ~/.local/bin/claude
echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

Se il secondo comando non stampa niente, aggiungi la cartella al PATH. Su macOS la shell predefinita è zsh:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Questo comando aggiunge una riga al file ~/.zshrc. Poi apri un nuovo Terminale e riprova claude --version. Sul nostro Mac la cartella ~/.local/bin era già nel PATH e il file claude era un collegamento verso la versione installata.

Capita se in passato l’hai installato con npm. Per vedere quali copie ci sono:

which -a claude

Sul nostro Mac claude doctor segnalava proprio questo: una versione nativa in ~/.local/bin e un residuo di una vecchia installazione npm. La correzione che suggerisce il programma stesso è npm -g uninstall @anthropic-ai/claude-code.

Homebrew (se lo usi già):

brew install --cask claude-code

Questo segue il canale stabile. Per le novità subito esiste claude-code@latest. Con Homebrew gli aggiornamenti non sono automatici: usa brew upgrade claude-code.

npm (serve Node.js 22 o successivo):

npm install -g @anthropic-ai/claude-code

Non usare mai sudo con npm per questo pacchetto: causa problemi di permessi e Claude Code non potrebbe aggiornarsi da solo. Per aggiornare: npm install -g @anthropic-ai/claude-code@latest.

Per l’installazione nativa:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Con Homebrew: brew uninstall --cask claude-code. Con npm: npm uninstall -g @anthropic-ai/claude-code.