claude-code-setup-macos.mdx

title	Installazione Claude Code su macOS
description	Setup completo di Claude Code su macOS con fnm/nvm, configurazione zsh e troubleshooting
icon	🍎
tag	Tutorial
date	2026-01-05

import InfoBox from '../../components/InfoBox.astro'; import ProsCons from '../../components/ProsCons.astro'; import StepHeader from '../../components/StepHeader.astro';

---

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

- **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

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

---

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

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

---

Con npm disponibile, installa Claude Code globalmente:

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

Verifica l'installazione

claude --help

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

---

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

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.

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