Installare Claude Code su Windows, Mac e Linux

Per installare Claude Code, esegui in un terminale il comando ufficiale di Anthropic: curl -fsSL https://claude.ai/install.sh | bash su macOS, Linux e WSL, oppure irm https://claude.ai/install.ps1 | iex in PowerShell su Windows. Poi verifica con claude --version e digita claude per accedere. Serve un abbonamento Claude a pagamento o un account Console: il piano gratuito non include Claude Code.
Claude Code si installa con un solo comando su Windows, macOS e Linux, ma i dettagli cambiano da un sistema all'altro: PowerShell o CMD, WSL, Homebrew, repository Linux, PATH da correggere. Questa guida riporta i comandi ufficiali rilevati il 18 novembre 2026, come verificare che tutto funzioni, gli errori più comuni e, per finire, il collegamento a un modello locale con Ollama.
#Come installare Claude Code? Prerequisiti e comandi ufficiali
Claude Code si installa con un solo comando ufficiale: curl -fsSL https://claude.ai/install.sh | bash su macOS, Linux e WSL, oppure irm https://claude.ai/install.ps1 | iex in PowerShell su Windows. Questo script nativo è il metodo consigliato da Anthropic, perché si aggiorna da solo in background.
Claude Code è l'agente di programmazione di Anthropic: un programma che si usa nel terminale, legge il codice di un progetto, modifica file ed esegue comandi dopo la tua approvazione. Il programma si installa sul tuo computer, ma il modello di IA gira sui server di Anthropic: secondo la documentazione ufficiale consultata il 18 novembre 2026, è obbligatoria una connessione a Internet.
| Sistema | Metodo | Commande | Aggiornamento automatico |
|---|---|---|---|
| macOS, Linux, WSL | Script nativo (consigliato) | curl -fsSL https://claude.ai/install.sh | bash | Sì, in background |
| Windows (PowerShell) | Script nativo (consigliato) | irm https://claude.ai/install.ps1 | iex | Sì, in background |
| Windows (CMD) | Script nativo | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd | Sì, in background |
| macOS | Homebrew | brew install --cask claude-code | No, non per impostazione predefinita: brew upgrade claude-code |
| Windows | WinGet | winget install Anthropic.ClaudeCode | No per impostazione predefinita: winget upgrade Anthropic.ClaudeCode |
| Debian, Ubuntu, Fedora, RHEL, Alpine | Repository apt, dnf, apk firmati | Consulta la documentazione ufficiale | No: aggiornamento di sistema |
| Tutti (Node.js 22 o superiore) | npm | npm install -g @anthropic-ai/claude-code@latest | A seconda dei permessi della cartella npm |
#Configurazione richiesta
Approfitta della nostra esperienza e di un percorso guidato per scegliere gli strumenti adatti al tuo Mac e usare la tua IA ogni giorno.
- Spazio online a vita
- PDF + file
- Garanzia di rimborso di 30 giorni
- Sistema
- macOS 13.0 o successivo, Windows 10 1809 o successivo (o Windows Server 2019), Ubuntu 20.04 o successivo, Debian 10 o successivo, Alpine Linux 3.19 o successivo.
- Hardware
- 4 GB di RAM come minimo e un processore x64 o ARM64. Non serve alcuna scheda grafica, dato che il modello Claude gira in remoto.
- Compte
- Un abbonamento Claude Pro, Max, Ultra, Team o Enterprise, oppure un account Claude Console con pagamento a consumo. Il piano gratuito di claude.ai non include Claude Code.
- Paese
- Claude Code è accessibile solo dai paesi supportati da Anthropic; la Francia è tra questi.
Quanto al prezzo, la pagina ufficiale di Anthropic consultata il 18 novembre 2026 indica il piano Pro a 20 dollari al mese con fatturazione mensile, e precisa che Claude Code è incluso in tutti i piani a pagamento, con gli stessi limiti di utilizzo del resto dell'abbonamento. Il dettaglio dei piani e delle alternative gratuite è trattato nella guida dedicata al prezzo di Claude Code.
#Installare Claude Code su Windows: PowerShell, CMD o WSL
Su Windows, Claude Code si installa da PowerShell con irm https://claude.ai/install.ps1 | iex, senza diritti di amministratore. In alternativa puoi installarlo in WSL 2, il sottosistema Linux di Windows, con il comando Linux: è l'unica modalità Windows in cui è supportata la sandbox dei comandi.
- 01Apri PowerShellApri il menu Start, digita PowerShell e avvialo normalmente, senza «Esegui come amministratore». Il prompt inizia con PS C:\Users\VotreNom>, a conferma che sei in PowerShell e non nel prompt dei comandi CMD.
- 02Avviare lo script di installazioneIncolla il comando irm https://claude.ai/install.ps1 | iex e conferma con Invio. Lo script scarica Claude Code senza mostrare una barra di avanzamento: attendi che ricompaia il prompt prima di fare altro.
- 03Apri un nuovo terminaleChiudi la finestra di PowerShell e aprine una nuova, in modo che la cartella di installazione venga presa in considerazione. Il programma si trova in %USERPROFILE%\.local\bin\claude.exe.
- 04Verifica la versioneDigita claude --version. Un'installazione riuscita mostra un numero di versione seguito da (Claude Code). Se Windows risponde che claude non è riconosciuto, applica la correzione del PATH descritta più avanti.
- 05Installare Git for Windows (consigliato)Git for Windows è facoltativo ma consigliato da Anthropic: fornisce Git Bash, che Claude Code usa per eseguire i suoi comandi. Senza di esso, Claude Code passa da PowerShell. Un'installazione in WSL non ne ha bisogno.
#Installare Claude Code su Mac: script nativo o Homebrew
Su Mac, Claude Code si installa aprendo l'app Terminale ed eseguendo curl -fsSL https://claude.ai/install.sh | bash. Serve macOS 13.0 o successivo; sono supportati sia i Mac Apple Silicon (ARM64) sia i Mac Intel (x64). Homebrew è un'alternativa, ma senza aggiornamento automatico.
Homebrew offre due pacchetti di Claude Code. Il pacchetto claude-code segue il canale stabile, che in genere è indietro di circa una settimana ed esclude le versioni con regressioni importanti. Il pacchetto claude-code@latest riceve ogni versione appena esce. Per impostazione predefinita, l'aggiornamento tramite Homebrew si esegue manualmente con brew upgrade claude-code, oppure brew upgrade claude-code@latest per il secondo pacchetto. Perché sia Claude Code stesso ad avviare questo aggiornamento tramite Homebrew o WinGet, la documentazione di Anthropic indica di impostare la variabile d'ambiente CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE su 1.
Lo script nativo colloca il launcher in ~/.local/bin/claude. Se il Terminale risponde «command not found: claude», questa cartella non è ancora nel PATH della tua shell: la soluzione è indicata nella sezione dedicata agli errori.
#Installare Claude Code su Linux: script, apt, dnf o Alpine
Su Linux, Claude Code si installa con lo stesso script del Mac: curl -fsSL https://claude.ai/install.sh | bash, senza sudo. Anthropic pubblica anche repository firmati apt (Debian, Ubuntu), dnf (Fedora, RHEL) e apk (Alpine) per le macchine in cui il software deve passare dal gestore di pacchetti.
Alpine Linux e le altre distribuzioni basate su musl non includono né bash né curl per impostazione predefinita. Senza di essi, lo script di installazione fallisce con un errore «not found». Installa prima questi due pacchetti, poi rilancia il comando di installazione.
I repository apt, dnf e apk offrono ciascuno un canale stable e un canale latest. La loro configurazione richiede diversi comandi, tra cui la verifica dell'impronta della chiave di firma di Anthropic: seguili direttamente nella pagina di installazione avanzata della documentazione ufficiale, linkata in fondo alla guida. Queste installazioni si aggiornano insieme al sistema, per esempio sudo apt update && sudo apt upgrade claude-code.
#Come verificare che Claude Code sia installato correttamente?
Per verificare l'installazione di Claude Code, apri un nuovo terminale e digita claude --version: deve comparire un numero di versione. Il 18 novembre 2026, la versione più recente in cima al changelog ufficiale è la 2.1.327, mentre il canale stabile distribuisce la 2.1.311 secondo il registro npm. Un numero più vecchio quindi non è necessariamente un errore: il pacchetto Homebrew claude-code e i repository Linux configurati per impostazione predefinita seguono questo canale stabile. Il comando claude doctor fornisce poi una diagnosi completa.
Il comando claude doctor mostra, senza aprire una sessione, lo stato dell'installazione, gli errori nei file di impostazioni e gli avvisi con una correzione suggerita. È la prima cosa da fare quando Claude Code si comporta in modo strano dopo un'installazione o un aggiornamento.
- 01Posizionarsi in un progettoNel terminale, spostati nella cartella del progetto su cui vuoi lavorare con il comando cd seguito dal percorso della cartella. Claude Code lavora sui file della cartella da cui viene avviato.
- 02Avviare Claude CodeDigita claude. Al primo avvio, Claude Code apre il browser per farti accedere con il tuo account Claude (Pro, Max, Ultra, Team, Enterprise) o con il tuo account Console. Se il browser mostra un codice invece di tornare al terminale, incolla quel codice nel terminale.
- 03Porre una prima domandaUna volta effettuato l'accesso, il prompt di Claude Code mostra la versione, il modello e la cartella di lavoro. Chiedi per esempio «cosa fa questo progetto?». Le credenziali restano salvate: l'accesso non viene più richiesto agli avvii successivi.
- 04Preparare il progettoDigita /init perché Claude Code analizzi il codice e generi un file CLAUDE.md iniziale, con i comandi di compilazione e di test e le convenzioni del progetto. Digita /help per l'elenco dei comandi e /config per le impostazioni.
#Aggiornare o disinstallare Claude Code
Un'installazione nativa di Claude Code si aggiorna da sola all'avvio e in background; il comando claude update applica subito l'ultima versione. Per un'installazione nativa su macOS, Linux o WSL, la disinstallazione consiste nell'eliminare il launcher e la cartella delle versioni.
#Claude Code non trovato o installazione bloccata: gli errori comuni
L'errore più frequente dopo l'installazione di Claude Code è «command not found: claude» o «'claude' non è riconosciuto»: il programma è installato correttamente, ma la sua cartella, ~/.local/bin su Mac e Linux o %USERPROFILE%\.local\bin su Windows, non è nel PATH. Il programma di installazione lo segnala nelle sue «Setup notes» senza correggere da solo il PATH.
| Messaggio visualizzato | Causa | Correttivo |
|---|---|---|
| command not found: claude / 'claude' is not recognized | Cartella di installazione non presente nel PATH | Aggiungere ~/.local/bin (o %USERPROFILE%\.local\bin) al PATH, poi aprire un nuovo terminale |
| The token '&&' is not a valid statement separator | Comando CMD incollato in PowerShell | Usare il comando PowerShell |
| 'irm' is not recognized as an internal or external command | Comando PowerShell incollato in CMD | Usare il comando CMD |
| curl: (22) The requested URL returned error: 403 | Proxy o filtro di rete, oppure paese non supportato | Verificare la rete o il proxy aziendale |
| App unavailable in region | Paese non supportato da Anthropic | Claude Code non è disponibile in questo paese |
| not found su Alpine | bash ou curl absents | apk add bash curl |
La correzione per zsh vale su macOS, dove zsh è la shell predefinita. Su Linux con bash, la stessa riga export va aggiunta al file ~/.bashrc; su Mac con bash, va in ~/.bash_profile, perché il Terminale di macOS avvia bash come shell di login, che ignora ~/.bashrc. Un terminale aperto prima della correzione mantiene il vecchio PATH, e un terminale integrato in un editor come VS Code eredita il PATH dell'editor: chiudi e riapri la finestra, o l'editor, prima di riprovare claude --version.
#Come collegare Claude Code a VS Code?
Per usare Claude Code in VS Code, installa l'estensione ufficiale Claude Code di Anthropic: apri la vista Estensioni con Cmd+Shift+X su Mac o Ctrl+Shift+X su Windows e Linux, cerca «Claude Code» e fai clic su Installa. Servono VS Code 1.94.0 o successivo e un account Claude a pagamento o un account Console.
L'estensione VS Code di Claude Code include una propria copia del programma per il pannello di chat, ma non la aggiunge al PATH. Per digitare claude nel terminale integrato di VS Code serve comunque l'installazione autonoma descritta sopra. L'estensione si installa anche in Cursor e negli altri editor derivati da VS Code, tramite il registro Open VSX.
#Collegare Claude Code a un modello locale con Ollama
Claude Code può funzionare con un modello locale grazie a Ollama, che espone un'API compatibile con quella di Anthropic. Una volta installati Claude Code e Ollama, il comando ollama launch claude avvia Claude Code collegato a Ollama. La documentazione di Ollama consiglia un modello locale impostato su un contesto di 64k token o più.
La documentazione di Ollama descrive anche una configurazione manuale tramite variabili d'ambiente, che indirizza Claude Code verso il server locale di Ollama sulla porta 11434. L'esempio ufficiale usa il modello qwen3.5, il cui tag predefinito nella libreria Ollama corrisponde alla versione 9B, da 6,6 a 7,6 GB; un modello deve supportare il tool calling perché Claude Code possa leggere e modificare i file.
Claude Code è gratuito?+
Serve Node.js per installare Claude Code?+
Servono i diritti di amministratore per installare Claude Code su Windows?+
Come installare un plugin su Claude Code?+
Come configurare al meglio Claude Code dopo l'installazione?+
Claude Code funziona offline?+
Come aggiornare Claude Code?+
#Fonti e verifica del 18 novembre 2026
I comandi, i prerequisiti, le versioni e i prezzi di questa guida sono stati rilevati il 18 novembre 2026 nella documentazione ufficiale di Claude Code, nella pagina dei prezzi di Anthropic, nel changelog del repository GitHub di Anthropic e nella documentazione di Ollama; comandi e prezzi cambiano spesso, verificali prima di un'installazione in azienda.
- Fonte: installazione avanzata di Claude Code (Anthropic)
- Fonte: guida rapida di Claude Code (Anthropic)
- Fonte: risoluzione dei problemi di installazione (Anthropic)
- Fonte: estensione VS Code (Anthropic)
- Fonte: prezzi dei piani Claude (Anthropic)
- Fonte: changelog di Claude Code (GitHub, Anthropic)
- Fonte: Claude Code con Ollama (documentazione Ollama)
Un feedback, un errore, una precisazione? Facci sapere, così la guida migliora per tutti.