Skip to main content
Questa pagina copre i requisiti di sistema, i dettagli di installazione specifici per piattaforma, gli aggiornamenti e la disinstallazione. Per una procedura guidata della vostra prima sessione, consultate la guida rapida. Se non avete mai utilizzato un terminale prima, consultate la guida del terminale.

​
Requisiti di sistema

Claude Code funziona sulle seguenti piattaforme e configurazioni:
  • Sistema operativo:
    • macOS 13.0+
    • Windows 10 1809+ o Windows Server 2019+
    • Ubuntu 20.04+
    • Debian 10+
    • Alpine Linux 3.19+
  • Hardware: 4 GB+ di RAM, processore x64 o ARM64
  • Rete: connessione a Internet richiesta. Consultate la configurazione di rete.
  • Shell: Bash, Zsh, PowerShell o CMD.
  • Posizione: paesi supportati da Anthropic

​
Dipendenze aggiuntive

​
Installare Claude Code

Preferite un’interfaccia grafica? L’app Desktop vi consente di utilizzare Claude Code senza il terminale. Scaricatela per macOS, Windows o Linux.
Per installare Claude Code, apri un terminale ed esegui il comando per il tuo sistema. Se non hai mai utilizzato un terminale prima, la guida al terminale mostra come aprirne uno e incollare il comando.
macOS, Linux, WSL:
Su Windows, il tuo prompt mostra PS C:\ quando sei in PowerShell e C:\ senza il PS quando sei in CMD.Windows PowerShell:
Windows CMD:
Il comando di installazione non mostra alcun avanzamento mentre scarica Claude Code. Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui claude --version. Un’installazione funzionante stampa un numero di versione. Se la tua shell dice che claude non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi Correggi il tuo PATH.Se vedi The token '&&' is not a valid statement separator, sei in PowerShell, non in CMD. Se vedi 'irm' is not recognized as an internal or external command, sei in CMD, non in PowerShell.Se il comando di installazione non riesce con syntax error near unexpected token '<', un 403 o qualsiasi altro errore, consulta Risoluzione dei problemi di installazione per abbinare l’errore a una soluzione e per metodi di installazione alternativi.Git for Windows è consigliato su Windows nativo in modo che Claude Code possa utilizzare lo strumento Bash. Se Git for Windows non è installato, Claude Code utilizza PowerShell come strumento shell. Le configurazioni WSL non necessitano di Git for Windows.
Le installazioni native si aggiornano automaticamente in background per mantenerti sulla versione più recente.
Puoi anche installare con apt, dnf, o apk su Debian, Fedora, RHEL e Alpine. Dopo il completamento dell’installazione, aprite un terminale nel progetto su cui desiderate lavorare e avviate Claude Code:
Claude Code apre una sessione interattiva nel vostro terminale. Se riscontrate problemi durante l’installazione, consultate Risoluzione dei problemi di installazione e accesso.

​
Configurazione su Windows

Potete eseguire Claude Code nativamente su Windows o all’interno di WSL. Scegliete in base a dove si trovano i vostri progetti e quali funzionalità vi servono:

​
Installare su Windows nativo

Esegui il comando di installazione da PowerShell o CMD. Non è necessario eseguire come Amministratore. L’installazione di Git for Windows è facoltativa. Fornisce Git Bash, necessario per lo strumento Bash e lo strumento Monitor. Se eseguite l’installazione da PowerShell o CMD influisce solo su quale comando di installazione eseguite. Il vostro prompt mostra PS C:\Users\YourName> in PowerShell e C:\Users\YourName> senza il PS in CMD. Se siete nuovi al terminale, la guida del terminale vi guida attraverso ogni passaggio. Dopo l’installazione, avviate claude da qualsiasi terminale.
  • Senza Git for Windows, Claude Code esegue i comandi della shell tramite lo strumento PowerShell.
  • Con Git for Windows, Claude Code utilizza Git Bash per lo strumento Bash. Se Claude Code non riesce a trovare Git Bash, impostate il percorso nel vostro file settings.json:
Quando Git for Windows è installato, lo strumento PowerShell è disponibile insieme a Bash: attivato per impostazione predefinita per gli account claude.ai e Console, e abilitato con CLAUDE_CODE_USE_POWERSHELL_TOOL=1 nelle sessioni Amazon Bedrock, Google Cloud’s Agent Platform e Microsoft Foundry. Impostatelo a 0 per disattivare lo strumento. Consultate PowerShell tool per la configurazione e le limitazioni.

​
Installare in WSL

Apri la tua distribuzione WSL ed esegui l’installer Linux dalle istruzioni di installazione. Installi e avvii claude all’interno del terminale WSL, non da PowerShell o CMD.

​
Alpine Linux e distribuzioni basate su musl

L’installazione di Claude Code su Alpine e altre distribuzioni basate su musl/uClibc richiede bash e curl per il comando di installazione, e libgcc, libstdc++ e ripgrep al runtime. Alpine non include bash o curl per impostazione predefinita, quindi il comando di installazione documentato non riesce con un errore not found finché non li installate. Installate questi pacchetti utilizzando il gestore di pacchetti della vostra distribuzione, quindi impostate USE_BUILTIN_RIPGREP=0. Questo esempio installa i pacchetti richiesti su Alpine:
Su Alpine, ripgrep si trova nel repository community. Se apk segnala che il pacchetto è mancante, aggiungete il repository community a /etc/apk/repositories, utilizzando la vostra versione di Alpine:
Eseguite apk update per aggiornare l’indice dei pacchetti e riprovate il comando apk add. Quindi impostate USE_BUILTIN_RIPGREP a 0 nel vostro file settings.json:

​
Verificare l’installazione

Dopo l’installazione, confermate che Claude Code funziona:
Un’installazione funzionante stampa un numero di versione come 2.1.211 (Claude Code). Se questo fallisce con command not found o un altro errore, consultate Risoluzione dei problemi di installazione e accesso. Per un controllo più dettagliato dell’installazione e della configurazione, eseguite claude doctor:
claude doctor stampa diagnostiche di installazione e impostazioni di sola lettura senza avviare una sessione, inclusi lo stato di salute dell’installazione, errori di convalida del file di impostazioni e eventuali avvisi con correzioni suggerite.

​
Autenticazione

Claude Code richiede un account Pro, Max, Team, Enterprise o Console. Il piano gratuito di Claude.ai non include l’accesso a Claude Code. Potete anche utilizzare Claude Code con un provider API di terze parti come Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry. Dopo l’installazione, accedi eseguendo claude e seguendo i prompt del browser. Se hai impostato la variabile d’ambiente ANTHROPIC_API_KEY e approvi la chiave quando Claude Code ti chiede se utilizzarla, Claude Code salta il prompt di accesso. Consulta Autenticazione per tutti i tipi di account e le opzioni di configurazione del team.

​
Aggiornare Claude Code

Le installazioni native si aggiornano automaticamente in background. Potete configurare il canale di rilascio per controllare se ricevere gli aggiornamenti immediatamente o secondo una pianificazione stabile ritardata, oppure disabilitare gli aggiornamenti automatici completamente. Le installazioni Homebrew, WinGet e gestori di pacchetti Linux richiedono aggiornamenti manuali per impostazione predefinita.

​
Aggiornamenti automatici

Claude Code verifica la disponibilità di aggiornamenti all’avvio e periodicamente durante l’esecuzione. Gli aggiornamenti si scaricano e si installano in background, quindi hanno effetto la prossima volta che avviate Claude Code. Eseguite claude doctor per visualizzare il risultato del tentativo di aggiornamento più recente. Su macOS e Linux, il programma di installazione nativo gestisce il launcher in ~/.local/bin/claude come un collegamento simbolico in ~/.local/share/claude/versions/. Se sostituisci quel launcher con il tuo script o collegamento simbolico, l’aggiornamento automatico e claude update lo lasciano in posizione: le nuove versioni si installano comunque nella directory versions/, e il tuo launcher decide quale versione viene eseguita. Con un launcher personalizzato, Claude Code mantiene anche ogni versione installata su disco perché non può determinare quale versione il launcher necessita. claude doctor segnala un launcher che il programma di installazione nativo non ha creato. Per consentire a Claude Code di gestire di nuovo il launcher, rimuovete ~/.local/bin/claude ed eseguite claude update. Se un’installazione globale npm non può aggiornarsi automaticamente perché la directory globale npm non è scrivibile, Claude Code mostra un avviso una sola volta all’avvio, e claude doctor elenca le correzioni disponibili. Consultate errori di autorizzazione durante l’installazione per i dettagli.
Le installazioni Homebrew, WinGet, apt, dnf e apk non si aggiornano automaticamente per impostazione predefinita; consultate di seguito per attivare l’opzione per Homebrew e WinGet. Per aggiornare Homebrew manualmente, eseguite brew upgrade claude-code o brew upgrade claude-code@latest, a seconda di quale cask avete installato. Per WinGet, eseguite winget upgrade Anthropic.ClaudeCode. Per i gestori di pacchetti Linux, consultate i comandi di aggiornamento in Installare con gestori di pacchetti Linux.Per fare in modo che Claude Code esegua il comando di aggiornamento per voi su Homebrew o WinGet, impostate CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE a 1. Claude Code esegue quindi l’aggiornamento in background quando una nuova versione è disponibile e mostra un prompt di riavvio al completamento. L’aggiornamento riguarda solo il pacchetto Claude Code e non influisce su altro software che avete installato.Su WinGet l’aggiornamento potrebbe non riuscire mentre Claude Code è in esecuzione perché Windows blocca l’eseguibile. In questo caso Claude Code mostra il comando manuale. apt, dnf e apk continuano a richiedere un aggiornamento manuale perché questi comandi necessitano di privilegi elevati.Problema noto: Claude Code potrebbe notificarvi gli aggiornamenti prima che la nuova versione sia disponibile in questi gestori di pacchetti. Se un aggiornamento non riesce, attendete e riprovate più tardi.Homebrew mantiene le versioni precedenti su disco dopo gli aggiornamenti. Eseguite brew cleanup periodicamente per recuperare spazio su disco.

​
Configurare il canale di rilascio

Controllate quale canale di rilascio Claude Code segue per gli aggiornamenti automatici e claude update con l’impostazione autoUpdatesChannel:
  • "latest", l’impostazione predefinita: ricevete le nuove funzionalità non appena vengono rilasciate
  • "stable": utilizzate una versione che è tipicamente circa una settimana più vecchia, saltando i rilasci con regressioni importanti
Configurate questo tramite /config → Auto-update channel, oppure aggiungetelo al vostro file settings.json:
Un modello appena lanciato può richiedere una versione di Claude Code più recente di quella fornita dal canale stable. Per eseguire subito il modello, passa al canale latest. Per le distribuzioni aziendali, potete applicare un canale di rilascio coerente in tutta l’organizzazione utilizzando impostazioni gestite. Le installazioni Homebrew scelgono un canale in base al nome del cask invece di questa impostazione: claude-code traccia stable e claude-code@latest traccia latest. Le installazioni dai repository apt, dnf e apk scelgono un canale in base al repository invece di questa impostazione. Per cambiarlo, segui Installare con gestori di pacchetti Linux.

​
Fissare una versione minima

L’impostazione minimumVersion stabilisce un limite inferiore. Gli aggiornamenti automatici in background e claude update rifiutano di installare qualsiasi versione al di sotto di questo valore, quindi il passaggio al canale "stable" non vi fa regredire se siete già su una build "latest" più recente. Il passaggio da "latest" a "stable" tramite /config vi chiede di rimanere sulla versione corrente o di consentire il downgrade. Se scegliete di rimanere, viene impostato minimumVersion a quella versione. Il passaggio di nuovo a "latest" lo cancella. Aggiungetelo al vostro file settings.json per fissare un limite inferiore esplicitamente:
Nelle impostazioni gestite, questo applica un minimo a livello di organizzazione che le impostazioni utente e di progetto non possono ignorare. Il pin minimumVersion vincola solo gli aggiornamenti. Per fare in modo che Claude Code rifiuti di avviarsi al di fuori di un intervallo di versioni, utilizzate invece le impostazioni gestite requiredMinimumVersion e requiredMaximumVersion. Gli aggiornamenti rispettano anche il limite requiredMaximumVersion. Consultate requiredMinimumVersion e requiredMaximumVersion.

​
Disabilitare gli aggiornamenti automatici

Impostate DISABLE_AUTOUPDATER a "1" nella chiave env del vostro file settings.json:
Su un’installazione nativa o npm, confermate che la modifica ha avuto effetto eseguendo claude doctor e verificando che la riga Auto-updates mostri disabled (set by env: DISABLE_AUTOUPDATER) invece di enabled. DISABLE_AUTOUPDATER arresta solo il controllo in background; claude update e claude install continuano a funzionare. Per bloccare tutti i percorsi di aggiornamento, inclusi gli aggiornamenti manuali, impostate invece DISABLE_UPDATES. Utilizzate questo quando distribuite Claude Code attraverso i vostri canali e avete bisogno che gli utenti rimangano sulla versione che fornite.

​
Aggiornare manualmente

Per applicare un aggiornamento immediatamente senza attendere il prossimo controllo in background, eseguite:
Quando un aggiornamento si installa, il comando segnala Successfully updated from <old version> to version <new version>. Se siete già sulla versione più recente, segnala Claude Code is up to date (<version>). Gli aggiornamenti gestiti da Homebrew, WinGet o apk segnalano invece Claude is up to date!.

​
Opzioni di installazione avanzate

Queste opzioni sono per il pinning delle versioni, i gestori di pacchetti Linux, npm, lo storage di rete e la verifica dell’integrità dei binari.

​
Installare una versione specifica

L’installer nativo accetta un numero di versione specifico o un canale di rilascio (latest o stable). Il canale che scegliete al momento dell’installazione diventa il vostro predefinito per gli aggiornamenti automatici. Consultate configurare il canale di rilascio per ulteriori informazioni. Per installare la versione più recente (predefinita):
Per installare la versione stabile: