Installare Claude Code su Windows, macOS e Linux (maggio 2026)

Claude Code è passato da zero a oltre un milione di ricerche al mese in meno di un anno. Se sei capitato qui perché “ne parlano tutti” e vuoi provarlo di persona, questa è la tua guida setup in 5 minuti per qualsiasi sistema operativo.

Quattro cose da sapere prima di iniziare:

1. Ti serve un piano a pagamento. Claude Pro (20$/mese), Max, Team, Enterprise o un account Claude Console sbloccano Claude Code. Il piano gratuito Claude.ai non lo include.
2. Claude Code vive nel terminale — quella finestra di testo dove digiti i comandi. (Anthropic ha anche una app desktop se preferisci saltare il terminale.)
3. L’installer nativo è il metodo ufficiale nel 2026. Anthropic ha aggiunto anche Homebrew, WinGet e repository di pacchetti Linux firmati a inizio 2026. Chi già lavora con un package manager ora ha opzioni di prima scelta. La via legacy npm funziona ancora ma non è più consigliata.
4. Heads-up bug dei token: Le versioni dalla v2.1.100 gonfiano il consumo di token di circa il 40%. L’ultima al 4 maggio è la v2.1.126 — workaround più sotto.

Scegli il tuo OS — ogni percorso d’installazione è un solo comando:

Andiamo.

Requisiti di sistema

Prima di installare, verifica di essere su un OS supportato:

Se sei su Windows 11, sei a posto. Se sei su macOS Monterey (12) o precedente, aggiorna prima.

Installare su Windows

Hai tre percorsi su Windows. Scegli in base a se ti serve un toolchain stile Linux (WSL) o vuoi rimanere nativo (PowerShell + Git Bash).

Windows nativo: PowerShell (la via più semplice)

Apri PowerShell (non serve Amministratore) e lancia:

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

Se irm ti restituisce “is not recognized as an internal or external command”, sei in CMD, non in PowerShell. Il prompt mostra PS C:\ in PowerShell e C:\ in CMD. Per usare CMD:

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

Dopo l’installazione, chiudi e riapri il terminale per aggiornare il PATH, poi verifica:

claude --version
claude doctor

Consigliato: Installa Git for Windows prima di lanciare claude. Anthropic lo consiglia perché Claude Code usa Git Bash internamente per gli strumenti shell. Senza, Claude Code ripiega su PowerShell come strumento shell, che ha meno funzionalità.

Se claude doctor si lamenta di non trovare Git Bash, indicagli il percorso in ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Windows nativo: WinGet (installazione gestita)

Anthropic pubblica Claude Code tramite il package manager ufficiale di Microsoft:

winget install Anthropic.ClaudeCode

Le installazioni WinGet non si aggiornano da sole — esegui winget upgrade Anthropic.ClaudeCode periodicamente.

Installare su Windows con WSL

WSL 2 (Windows Subsystem for Linux) ti dà un vero ambiente Linux dentro Windows. Anthropic consiglia WSL quando vuoi esecuzione comandi in sandbox o lavori già con toolchain Linux.

Passo 1 — Installare WSL. Apri PowerShell come Amministratore e lancia:

wsl --install

Riavvia quando te lo chiede. Dopo il reboot, apri il terminale Ubuntu dal menu Start.

Passo 2 — Installare Claude Code dentro WSL. Dal prompt Ubuntu:

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

Passo 3 — Verificare e iniziare a lavorare su un progetto:

claude --version
claude doctor
cd /mnt/c/Users/TUO_USERNAME/percorso/al/progetto
claude

Il percorso /mnt/c/ è come WSL accede ai dischi Windows. Il C: sta in /mnt/c/, il D: in /mnt/d/, e così via.

Installare su macOS o Linux

Apri Terminal. Incolla questo. Premi Invio.

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

Ecco tutta l’installazione. L’installer nativo scarica il binario, lo mette in ~/.local/bin e configura gli auto-update. Niente Node.js, zero dipendenze, niente drama da package manager.

Verifica che funzioni:

claude --version
claude doctor

claude doctor esegue diagnostiche: stato auth, PATH, config, server MCP. Eseguilo sempre dopo l’installazione per beccare problemi presto.

Ora entra in un progetto:

cd /percorso/al/tuo/progetto
claude

Fatto. Sei dentro Claude Code.

Installare con Homebrew (macOS)

Se gestisci già i tuoi tool con Homebrew, Anthropic pubblica un cask ufficiale:

brew install --cask claude-code

In realtà ci sono due cask:

• claude-code — segue il canale stable (circa una settimana indietro rispetto a latest, salta release con regressioni grandi). Scelta più sicura.
• claude-code@latest — segue il canale latest (versioni nuove appena escono).

# Per il canale bleeding-edge:
brew install --cask claude-code@latest

Heads-up: le installazioni Homebrew non si auto-aggiornano. Esegui brew upgrade claude-code (o claude-code@latest) per nuove versioni e patch di sicurezza.

Installare su Linux con i package manager

Anthropic pubblica repository firmati di apt, dnf e apk. È la via più pulita su Debian/Ubuntu, Fedora/RHEL e Alpine perché gli update passano dal tuo workflow normale di upgrade del sistema.

Debian / Ubuntu (apt):

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

Verifica il fingerprint della chiave GPG prima di fidarti: gpg --show-keys /etc/apt/keyrings/claude-code.asc deve mostrare 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.

Fedora / RHEL (dnf):

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

Alpine (apk):

wget -O /etc/apk/keys/claude-code.rsa.pub \
  https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

Per il canale rolling, cambia stable in latest nell’URL e nel nome suite. Aggiorna poi con il comando normale del package manager (sudo apt upgrade claude-code, sudo dnf upgrade claude-code, apk upgrade claude-code).

Installare via npm (la via legacy)

Se hai già Node.js 18+ installato e preferisci npm:

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

Questo installa lo stesso binario nativo dell’installer standalone, attraverso una dipendenza opzionale per piattaforma. Tre motivi per cui la maggior parte ora la evita:

1. Niente auto-update. Devi fare npm update a mano quando escono versioni nuove.
2. Richiede Node.js 18+. L’installer nativo ha zero dipendenze.
3. Errori di permessi. Specialmente con sudo npm install -g — non farlo.

Se hai già installato via npm e vuoi migrare al nativo:

curl -fsSL https://claude.ai/install.sh | bash
npm uninstall -g @anthropic-ai/claude-code

Autenticazione (la danza del login)

La prima volta che lanci claude, ti apre il browser per il login OAuth. Accedi con l’account Anthropic che usi:

• Abbonamento personale Claude Pro/Max — login claude.ai
• Claude Team o Enterprise — login del tuo workspace
• Claude Console — se la tua org ti ha invitato

Se il browser non si apre da solo, premi c nel terminale per copiare l’URL di login, incollala nel browser, finisci il login, poi incolla il codice di nuovo nel terminale quando te lo chiede.

Per cambiare account più tardi:

/logout

(Questo comando va dentro Claude Code, non nella shell.)

I tuoi primi comandi

Dopo che claude ti ha messo in una sessione interattiva, prova:

/help          # Mostra tutti i comandi disponibili
/status        # Vedi auth, abbonamento, rate limit
/config        # Vedi la config attuale
/logout        # Esci

Dalla tua shell (fuori dalla sessione interattiva):

claude doctor    # Report diagnostico
claude --version # Versione installata
claude mcp list  # Lista server MCP configurati

Una vera prima task

Apri un progetto che hai già. Qualsiasi cosa — una app Next.js, uno script Python, un repo di config. Lancia Claude Code:

cd /percorso/al/progetto
claude

Poi scrivi una task vera in italiano o inglese. Tipo:

“Leggi il README e spiegami come è organizzato questo progetto.”

O:

“Aggiungi una funzione che valida indirizzi email. Mettila dove fitta meglio nel codebase.”

O:

“Trova tutti i commenti TODO ed elencali con i percorsi dei file.”

Claude guarda i tuoi file, pensa, e propone modifiche. Ti chiede di approvare ogni edit prima di farlo. Mantieni tu il controllo.

Problemi tipici di setup (e fix)

“command not found: claude”

L’installer ha messo il binario in ~/.local/bin, ma la tua shell non conosce quella directory. Aggiungila al PATH:

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

Sostituisci .bashrc con .zshrc se sei su zsh (default macOS dal Catalina).

“The token ‘&&’ is not a valid statement separator”

Hai incollato un comando stile CMD in PowerShell. O passa a CMD, o usa la versione PowerShell:

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

“Permission denied” durante npm install

Hai provato sudo npm install -g e hai rotto i permessi. Non usare sudo con npm. In alternativa:

• Usa l’installer nativo (no sudo): curl -fsSL https://claude.ai/install.sh | bash
• Usa nvm (Node Version Manager) per installare Node nella tua home

WSL non riesce a raggiungere internet

Prova con curl https://claude.ai. Se fallisce, il firewall Windows o la VPN sta bloccando WSL. La maggior parte delle VPN ha un’opzione “exclude local traffic” — attivala.

Rate limit subito dopo l’install

Sei su Pro e tocchi i limiti in meno di un’ora? È un problema vero che Anthropic ha riconosciuto il 31 marzo 2026. Verifica la tua versione Claude Code:

claude --version

L’ultima build al 4 maggio è la v2.1.126 (uscita il 1 maggio), che ha aggiunto il comando utile claude project purge [path] e fixato un bug della percentuale /context di Opus 4.7 — ma il problema di inflazione token introdotto in v2.1.100 non ha ancora una patch pubblica. Workaround secondo i report community: scendere a v2.1.34, o reinstallare via npm invece del binario nativo.

Puoi pinnare una versione specifica con l’installer nativo:

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

O fissa un floor minimo in ~/.claude/settings.json così update futuri non ti riportano per sbaglio a una versione brutta:

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.34"
}

Estendere Claude Code con MCP

Quando le basi girano, il vero potere è collegare Claude Code ad altri strumenti via MCP (Model Context Protocol). MCP trasforma Claude Code da “assistente di programmazione” a “assistente con accesso diretto ai tuoi database, API e strumenti di team”.

Lista i server MCP attuali:

claude mcp list

Aggiungine uno nuovo (esempio — collegare un database):

claude mcp add my-db --command "docker run --rm my-db-mcp:latest"

Ogni progetto può avere il proprio file .claude/.mcp.json che elenca i server MCP che quel progetto usa. Codebase condivise possono committare questo file così tutto il team ha lo stesso setup di strumenti.

Riferimento rapido per OS

Cosa significa per te

Se non hai mai usato un terminale: Resta su macOS o WSL su Windows. Il terminale fa parte dell’identità di Claude Code — non puoi usarlo davvero senza almeno un comfort base con il terminale. Passa un po’ di tempo a imparare cd, ls, pwd e le basi di git se non l’hai già fatto.

Se sei dev e stai valutando Claude Code: Installalo in 5 minuti, puntalo a un side project, dagli una task vera. Cursor è più stile IDE, Copilot è più stile autocompletamento — Claude Code è genuinamente diverso, e devi sentirlo per capirlo.

Se stai facendo il setup per il tuo team: Crea una directory .claude/ nei repo condivisi con la configurazione MCP del team. Committala. I nuovi membri eseguono l’installer, si autenticano, ed ereditano il setup di strumenti del team automaticamente.

Se hai già installato Claude Code: L’ecosistema di plugin e MCP è dove sali da “user” a “power user”. I corsi specifici Claude Code in italiano sono in arrivo — nel frattempo, la documentazione ufficiale Anthropic (in inglese) è la risorsa migliore.

In sintesi

Installare Claude Code richiede tra i 30 secondi e i 5 minuti a seconda dell’OS. L’installer nativo (default da aprile 2026) è affidabile, veloce e senza dipendenze.

La vera curva di apprendimento non è l’installazione — è scoprire come usare Claude Code in modo produttivo una volta installato. Inizia con task piccole, cresci verso workflow più grandi, aggiungi strumenti MCP quando trovi necessità reali. Non provare a configurare tutto al day one.

E budget per l’abbonamento. Il piano gratuito non ti porta dove devi andare. Pro a 20$/mese è il vero punto di ingresso.

Prossimo passo: Una volta installato, esplora i pattern agentic con skill, hook e MCP. La documentazione ufficiale Claude Code (in inglese) è il riferimento più completo.

Fonti (verificate il 4 maggio 2026):

• Claude Code Setup — Documentazione ufficiale (verificato live per la sintassi dei comandi)
• Claude Code Changelog — Ufficiale
• Release Claude Code v2.1.126 — 1 maggio 2026
• Install Claude Code — Anthropic