Come Installare Claude Code su Windows, Mac e Linux (2026)

Installare Claude Code nel 2026 è un comando solo. Non serve più Node.js, non serve essere amministratore, e su Windows non serve più WSL. Eppure la metà delle domande che ricevo su Claude Code riguarda l'installazione, perché in giro ci sono ancora guide del 2025 che parlano di npm install -g, di Node 18 e di WSL obbligatorio. Tutto superato.

Questa guida segue la documentazione ufficiale aggiornata ad agosto 2026 e copre come installare Claude Code su Windows, Mac e Linux, il login con abbonamento o API key, l'integrazione con VS Code, e gli errori che bloccano le persone al primo avvio. Se invece cerchi il modo per usarlo gratis, ho scritto una guida a parte sui tre metodi che funzionano.

Prima di installare Claude Code: cosa serve

Tre cose, e nessuna è Node.js:

• Un account con accesso a Claude Code. Serve il piano Pro (20$/mese), Max, Team, Enterprise oppure un account API con crediti. Il piano gratuito di Claude.ai non include Claude Code. Se vuoi il quadro completo di quanto costa Claude Code tra piani e API, l'ho messo in un articolo dedicato.
• Un sistema operativo supportato: macOS 13 o superiore, Windows 10 (build 1809+) o 11, Ubuntu 20.04+, Debian 10+, Alpine 3.19+. Processore x64 o ARM64, 4 GB di RAM.
• Un terminale. Su Mac e Linux quello di sistema. Su Windows PowerShell o CMD vanno bene entrambi.

Se non ti va di usare il terminale, Anthropic distribuisce anche Claude Desktop con Claude Code integrato in interfaccia grafica: la parte "Code" dell'app fa le stesse cose. Il resto di questa guida è per chi vuole il terminale, che resta la versione più completa.

Come installare Claude Code su Mac

Apri il Terminale (Cmd + Spazio, scrivi "Terminale") e incolla:

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

Lo script scarica il binario nativo firmato da Anthropic e lo mette in ~/.local/bin/claude. Funziona sia su Apple Silicon (M1, M2, M3, M4, M5) sia su Intel. Al termine chiudi e riapri il terminale, poi verifica:

claude --version

Se preferisci Homebrew:

brew install --cask claude-code

Attenzione a una differenza: l'installazione nativa si aggiorna da sola in background, quella Homebrew no. Con brew devi lanciare brew upgrade claude-code a mano ogni tanto. Esiste anche il cask claude-code@latest per avere le release appena escono invece del canale stabile.

Come installare Claude Code su Windows

Nel 2026 Claude Code gira nativamente su Windows, senza WSL. Hai due strade e la scelta dipende da cosa vedi nel prompt del terminale.

Da PowerShell (prompt che inizia con PS C:\)

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

Da CMD (prompt che inizia con C:\ senza PS)

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

Non serve aprire il terminale come amministratore. Se vedi l'errore "The token '&&' is not a valid statement separator" sei in PowerShell e hai usato il comando CMD; se vedi "'irm' is not recognized" è il contrario.

Git for Windows: opzionale ma consigliato

Claude Code usa una shell per eseguire comandi. Senza Git for Windows usa PowerShell, che funziona. Con Git for Windows installato usa Git Bash, e la maggior parte degli script, dei tutorial e delle skill della community presuppone Bash. Se lavori su progetti web con npm, Docker o script shell, installalo. Se Claude Code non trova Git Bash, indicagli il percorso in ~/.claude/settings.json:

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

E WSL? Quando conviene ancora

WSL 2 resta la scelta giusta se i tuoi progetti vivono già dentro Linux, se usi toolchain Linux (Docker nativo, Python di sistema, make) o se vuoi il sandboxing dei comandi, che su Windows nativo non è supportato. In quel caso apri il terminale Ubuntu di WSL e usi il comando Linux qui sotto: installi e lanci claude dentro WSL, non da PowerShell.

C'è anche WinGet, per chi gestisce tutto da lì: winget install Anthropic.ClaudeCode. Come Homebrew, non si aggiorna da solo.

Come installare Claude Code su Linux (Ubuntu, Debian, Fedora)

Stesso comando del Mac:

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

L'unico problema tipico su Linux: il binario finisce in ~/.local/bin, che su alcune distribuzioni non è nel PATH di default. Se dopo l'installazione ottieni "command not found", aggiungi questa riga a ~/.bashrc o ~/.zshrc e riapri il terminale:

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

Con apt su Ubuntu e Debian

Se preferisci che gli aggiornamenti passino da apt upgrade come tutto il resto, Anthropic pubblica un repository firmato:

sudo apt install curl gnupg
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

Prima di fidarti della chiave, controlla il fingerprint con gpg --show-keys /etc/apt/keyrings/claude-code.asc: deve essere 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE. Per Fedora e RHEL esiste il repository dnf equivalente, per Alpine quello apk.

Su un server (Hetzner, VPS, Docker)

Uso Claude Code anche sui server dove girano i progetti dei clienti, per debug e manutenzione. Il comando è lo stesso, ma due accortezze: crea un utente non root per l'installazione, e per l'autenticazione usa una API key via variabile d'ambiente invece del login browser, che su un server headless non si apre. Vedi la sezione login qui sotto.

E l'installazione con npm?

Ancora possibile, ma non più consigliata:

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

Dal 2026 richiede Node.js 22 o superiore, e in ogni caso scarica lo stesso binario nativo: Node serve solo per l'installazione, non a runtime. Ha senso solo se il tuo ambiente gestisce già tutte le CLI globali via npm. Mai usare sudo npm install -g. Se hai una vecchia installazione npm, claude install la migra al binario nativo mantenendo le impostazioni.

Primo avvio e login: abbonamento o API key

Entra nella cartella di un progetto e lancia:

cd il-tuo-progetto
claude

Al primo avvio si apre il browser per il login. Qui c'è la scelta che determina quanto paghi:

• Login con account Claude.ai (Pro/Max/Team): Claude Code usa la quota dell'abbonamento. Nessun costo aggiuntivo oltre i 20$ o 100$ mensili.
• API key (Console): paghi a consumo per token. Per lavoro continuativo costa di più dell'abbonamento, ma è l'unica via su server headless e in CI/CD.

Il tranello più comune: se hai la variabile ANTHROPIC_API_KEY impostata nella shell, magari da un altro progetto, Claude Code la usa al posto dell'abbonamento e ti addebita l'API. Se vuoi usare l'abbonamento, rimuovila con unset ANTHROPIC_API_KEY prima di lanciare claude.

Per usare invece una chiave su un server:

export ANTHROPIC_API_KEY=sk-ant-la-tua-chiave
claude

Claude Code ti chiede una volta di approvare la chiave e non apre il browser. Con Opus 5 come modello di default sui piani a pagamento, vale la pena capire quale modello selezionare in base a cosa fai.

Installare Claude Code in VS Code

Il terminale integrato di VS Code funziona già: apri il progetto, apri il terminale (Ctrl + `) e lancia claude. Se vuoi l'integrazione vera, con le modifiche che compaiono come diff nell'editor, installa l'estensione ufficiale Claude Code dal marketplace di VS Code. L'estensione usa la stessa installazione e le stesse credenziali del terminale. Lo stesso vale per il plugin JetBrains su PhpStorm, WebStorm e IntelliJ.

Verifica, aggiornamento e canale stabile

Due comandi da conoscere. Il primo dice se tutto è a posto:

claude doctor

Mostra tipo di installazione, versione, errori nei file di impostazioni e l'esito dell'ultimo aggiornamento automatico. Il secondo forza l'aggiornamento senza aspettare il controllo in background:

claude update

Di default l'installazione nativa segue il canale latest: ogni release appena esce. Se lavori su progetti dove una regressione ti costa una giornata, passa al canale stable, che è circa una settimana indietro e salta le release con problemi noti. Da dentro Claude Code: /config → Auto-update channel, oppure in ~/.claude/settings.json:

{
  "autoUpdatesChannel": "stable"
}

Errori comuni e soluzioni

"command not found: claude" dopo l'installazione. Il PATH non include ~/.local/bin. Chiudi e riapri il terminale; se non basta, aggiungi la riga export vista nella sezione Linux.

"syntax error near unexpected token '<'" o errore 403 durante curl. Un proxy aziendale o un firewall sta intercettando il download. Prova da un'altra rete, oppure usa il repository apt/dnf o Homebrew.

Il login nel browser non si completa. Lancia claude logout e poi di nuovo claude. Su server senza browser usa la API key.

Claude Code usa l'API invece dell'abbonamento. Hai ANTHROPIC_API_KEY nell'ambiente. Rimuovila dalla shell e dai file .env caricati automaticamente.

Su Windows i comandi Bash falliscono. Manca Git for Windows, o Claude Code non lo trova: imposta CLAUDE_CODE_GIT_BASH_PATH come mostrato sopra.

Due versioni di Claude Code in conflitto. Succede a chi aveva la versione npm e ha installato la nativa. claude doctor lo segnala; rimuovi quella npm con npm uninstall -g @anthropic-ai/claude-code.

Homebrew o WinGet dicono "up to date" ma la versione è vecchia. Normale: quei gestori non si aggiornano da soli. brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode.

Disinstallare Claude Code

Installazione nativa su Mac e Linux:

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

Su Windows PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Per Homebrew brew uninstall --cask claude-code, per WinGet winget uninstall Anthropic.ClaudeCode, per apt sudo apt remove claude-code. Le impostazioni, gli MCP server configurati e la cronologia delle sessioni restano in ~/.claude: cancella quella cartella solo se vuoi davvero ripartire da zero.

Dopo l'installazione: da dove iniziare

Con Claude Code installato, le tre cose che fanno la differenza nella prima settimana sono un file CLAUDE.md nel progetto con le regole del codebase, un paio di MCP server collegati ai tuoi strumenti, e le skill giuste. Nella cheatsheet trovi tutti i comandi, qui le 15 skill ed estensioni che uso, e se vuoi vedere come si posiziona rispetto alla concorrenza il confronto con Codex è aggiornato al 2026.

Leggi anche

• Quanto costa Claude Code: piani, limiti e prezzi 2026
• Claude Code Cheatsheet 2026: Guida Completa per Sviluppatori
• Claude Code Gratis: 3 Metodi Senza Abbonamento
• Claude Code Skill: 15 Estensioni, Repo e Tips 2026
• Claude Opus 5 vs Fable 5: Quale Scegliere nel 2026
• Ralph Loop: Il Plugin Claude Code per lo sviluppo autonomo

Conclusioni

Installare Claude Code nel 2026 richiede un comando per sistema operativo, nessuna dipendenza e nessun privilegio di amministratore. Le cose che contano davvero sono tre: scegliere tra login con abbonamento e API key sapendo cosa paghi, tenere il canale stabile se lavori in produzione, e lanciare claude doctor prima di cercare soluzioni su Reddit.

Se vuoi portare Claude Code nel tuo team o integrarlo nei processi della tua azienda, con setup, CLAUDE.md, MCP server e formazione, contattami: è una delle cose che faccio più spesso con le PMI che seguo, e rientra nei servizi di sviluppo e automazione AI.