Principiante 14 minIDE

Installare Claude Code su Windows, Mac e Linux

Un portatile aperto illumina di verde una scrivania scura.
Risposta diretta

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.

Di Mohamed Meguedmi·Agg. 2026-11-20·Testato su Windows 11

#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.

Metodi di installazione di Claude Code in base al sistema (documentazione Anthropic, 18 novembre 2026)
SistemaMetodoCommandeAggiornamento automatico
macOS, Linux, WSLScript nativo (consigliato)curl -fsSL https://claude.ai/install.sh | bashSì, in background
Windows (PowerShell)Script nativo (consigliato)irm https://claude.ai/install.ps1 | iexSì, in background
Windows (CMD)Script nativocurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdSì, in background
macOSHomebrewbrew install --cask claude-codeNo, non per impostazione predefinita: brew upgrade claude-code
WindowsWinGetwinget install Anthropic.ClaudeCodeNo per impostazione predefinita: winget upgrade Anthropic.ClaudeCode
Debian, Ubuntu, Fedora, RHEL, AlpineRepository apt, dnf, apk firmatiConsulta la documentazione ufficialeNo: aggiornamento di sistema
Tutti (Node.js 22 o superiore)npmnpm install -g @anthropic-ai/claude-code@latestA seconda dei permessi della cartella npm

#Configurazione richiesta

Il kit completo per sfruttare l’IA locale sul tuo Mac.

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.

  1. 01
    Apri PowerShell
    Apri 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.
  2. 02
    Avviare lo script di installazione
    Incolla 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.
  3. 03
    Apri un nuovo terminale
    Chiudi 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.
  4. 04
    Verifica la versione
    Digita 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.
  5. 05
    Installare 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.
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
Windows (CMD)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows (WinGet)
winget install Anthropic.ClaudeCode
→
WSL 2 o Windows nativo?
Scegli Windows nativo per progetti e strumenti Windows. Scegli WSL 2 se i tuoi progetti usano strumenti Linux o se vuoi la sandbox dei comandi, che secondo la documentazione di Anthropic non è supportata né su Windows nativo né su WSL 1. In WSL, installa e avvia claude dal terminale WSL, non da PowerShell.

#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.

macOS (Terminale, script nativo)
curl -fsSL https://claude.ai/install.sh | bash
macOS (Homebrew)
brew install --cask claude-code

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.

Linux (Ubuntu, Debian, Fedora…)
curl -fsSL https://claude.ai/install.sh | bash

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.

Linux (Alpine)
apk add bash curl

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.

!
Installazione tramite npm: mai con sudo
Il metodo npm richiede Node.js 22 o superiore. La documentazione di Anthropic sconsiglia espressamente sudo npm install -g, causa di problemi di permessi e di rischi per la sicurezza, e precisa che un'installazione che richiede sudo non può aggiornarsi da sola. Lo script nativo evita questo problema.
macOS, Linux, Windows (npm, Node.js 22+)
npm install -g @anthropic-ai/claude-code@latest

#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.

macOS, Linux, Windows
claude --version
claude doctor

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.

  1. 01
    Posizionarsi in un progetto
    Nel 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.
  2. 02
    Avviare Claude Code
    Digita 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.
  3. 03
    Porre una prima domanda
    Una 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.
  4. 04
    Preparare il progetto
    Digita /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.

macOS, Linux, WSL (disinstallazione nativa)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

#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.

Errori di installazione di Claude Code e relative soluzioni (guida alla risoluzione dei problemi Anthropic, 18 novembre 2026)
Messaggio visualizzatoCausaCorrettivo
command not found: claude / 'claude' is not recognizedCartella di installazione non presente nel PATHAggiungere ~/.local/bin (o %USERPROFILE%\.local\bin) al PATH, poi aprire un nuovo terminale
The token '&&' is not a valid statement separatorComando CMD incollato in PowerShellUsare il comando PowerShell
'irm' is not recognized as an internal or external commandComando PowerShell incollato in CMDUsare il comando CMD
curl: (22) The requested URL returned error: 403Proxy o filtro di rete, oppure paese non supportatoVerificare la rete o il proxy aziendale
App unavailable in regionPaese non supportato da AnthropicClaude Code non è disponibile in questo paese
not found su Alpinebash ou curl absentsapk add bash curl
macOS (zsh): aggiungere ~/.local/bin al PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Windows (PowerShell): aggiungere la cartella al PATH utente
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

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.

i
Senza terminale: l'app desktop
La documentazione di Anthropic propone anche l'app desktop Claude per usare Claude Code senza terminale, su macOS, Windows e Linux (versione beta su Linux). Richiede lo stesso accesso con un account Claude a pagamento.

#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ù.

macOS, Linux, Windows (Ollama installato)
ollama launch claude

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.

macOS, Linux (Bash o Zsh)
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5
!
Configurazione non supportata da Anthropic
La documentazione di Claude Code indica che Anthropic non supporta l'uso di Claude Code con modelli diversi da Claude tramite un gateway. Il collegamento a Ollama funziona secondo la documentazione di Ollama, ma un eventuale problema è di competenza di Ollama, non del supporto di Anthropic. La qualità dipende molto dal modello locale e dalla memoria disponibile.
Domande frequenti
Claude Code è gratuito?+
Il programma Claude Code si installa gratuitamente, ma il suo utilizzo con i modelli Claude richiede un abbonamento a pagamento (Pro, Max, Ultra, Team, Enterprise) o un account Console con pagamento a consumo. Secondo la documentazione di Anthropic consultata il 18 novembre 2026, il piano gratuito di claude.ai non include Claude Code. Il collegamento a un modello locale tramite Ollama sostituisce i modelli Claude con un modello della tua macchina, al di fuori del supporto di Anthropic.
Serve Node.js per installare Claude Code?+
No, Node.js non è più necessario per installare Claude Code con lo script nativo, Homebrew, WinGet o i repository Linux. Solo il metodo npm richiede Node.js 22 o superiore, e la documentazione precisa che il programma installato è un binario nativo che non usa Node.js in fase di esecuzione. Lo script nativo resta il metodo consigliato.
Servono i diritti di amministratore per installare Claude Code su Windows?+
No. La documentazione di Anthropic indica che il comando di installazione di Claude Code si avvia da PowerShell o CMD senza eseguire il terminale come amministratore. Il programma si installa nella cartella utente, in %USERPROFILE%\.local\bin.
Come installare un plugin su Claude Code?+
In una sessione di Claude Code, il comando /plugin apre un pannello che elenca i plugin dei cataloghi configurati, e /plugin install seguito dal nome e dal catalogo, ad esempio commit-commands@claude-plugins-official, apre la scheda del plugin prima dell'installazione. La documentazione di Anthropic ricorda che un plugin può eseguire hook e server MCP: leggi la sua scheda prima di installarlo.
Come configurare al meglio Claude Code dopo l'installazione?+
Dopo aver installato Claude Code, esegui /init nel tuo progetto per generare un file CLAUDE.md che descrive i comandi di build, di test e le convenzioni. Le impostazioni si modificano con /config o nel file ~/.claude/settings.json. Il comando claude doctor segnala i file di impostazioni non validi e i problemi di installazione.
Claude Code funziona offline?+
No. La documentazione di Anthropic indica che una connessione Internet è obbligatoria per usare Claude Code, perché i modelli Claude girano sui server di Anthropic. Con Ollama e un modello locale, le richieste al modello restano sulla macchina, ma la documentazione di Anthropic non descrive un funzionamento completamente offline: considera questo punto come non garantito.
Come aggiornare Claude Code?+
Un'installazione nativa di Claude Code si aggiorna da sola, all'avvio e in background, e claude update forza l'aggiornamento immediato. Per impostazione predefinita, le installazioni Homebrew, WinGet, apt, dnf e apk non si aggiornano da sole: usa brew upgrade claude-code, winget upgrade Anthropic.ClaudeCode o l'aggiornamento del sistema Linux. Per Homebrew e WinGet, la variabile CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 affida questo aggiornamento a 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.

Questa guida ti è stata utile?

Un feedback, un errore, una precisazione? Facci sapere, così la guida migliora per tutti.