Installazione Claude Code su macOS - Software Engineering 3.0

Installa un Node Version Manager

Usare un version manager per Node.js ti permette di gestire multiple versioni senza problemi di permessi. Su macOS hai due ottime opzioni:

fnm (Consigliato)

# Installa fnm con Homebrew
brew install fnm

# Configura la shell - aggiungi a ~/.zshrc
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc

✅ Vantaggi di fnm

Velocissimo - Scritto in Rust, molto più veloce di nvm
Auto-switch - Cambia versione automaticamente con .node-version
Cross-platform - Funziona identicamente su macOS, Linux e Windows
Homebrew native - Installazione e aggiornamenti semplici

nvm

# Installa nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

ℹ️ Dopo l'installazione

Chiudi e riapri il terminale, oppure esegui source ~/.zshrc per ricaricare la configurazione.

Installa Node.js

Apri Terminal e installa la versione LTS (Long Term Support) di Node.js:

Con fnm

fnm install --lts
fnm use lts-latest

Con nvm

nvm install --lts
nvm use --lts

Verifica l’installazione

node --version
npm --version

✅ Output atteso

Dovresti vedere i numeri di versione, es. v22.x.x e 10.x.x

Installa Claude Code

Con npm disponibile, installa Claude Code globalmente:

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

Verifica l’installazione

claude --help

✅ Installazione completata!

Il comando claude è ora disponibile in qualsiasi finestra di Terminal.

Primi passi con Claude Code

Autenticazione

Al primo avvio, Claude Code ti chiederà di autenticarti con il tuo account Anthropic:

claude

Comandi utili

# Avvia una sessione interattiva
claude

# Esegui un comando singolo
claude "spiega questo codice"

# Mostra la versione
claude --version

# Mostra tutti i comandi disponibili
claude --help

Troubleshooting

⚠️ fnm o nvm non riconosciuto

Verifica che la configurazione sia presente nel tuo ~/.zshrc:

cat ~/.zshrc | grep -E "(fnm|nvm)"

Se non vedi output, ripeti il passo di configurazione della shell.

⚠️ claude non riconosciuto dopo l'installazione

Verifica che npm abbia installato correttamente:

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

Se il pacchetto è presente, riavvia il terminale.

Comandi utili per debug

# Verifica quale Node stai usando
which node

# Verifica le versioni installate (fnm)
fnm list

# Verifica le versioni installate (nvm)
nvm list

# Reinstalla Claude Code
npm uninstall -g @anthropic-ai/claude-code
npm install -g @anthropic-ai/claude-code

Aggiornamenti

Aggiornare Node.js (fnm)

fnm install --lts
fnm use lts-latest
fnm default lts-latest

Aggiornare Claude Code

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

Aggiornare fnm (se installato via Homebrew)

brew upgrade fnm