Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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. Su Windows nativo, è consigliato Git for Windows; Claude Code ritorna a PowerShell quando Git Bash è assente. Le configurazioni WSL non richiedono Git for Windows.
  • 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 o Windows.Siete nuovi al terminale? Consultate la guida del terminale per istruzioni passo dopo passo.
To install Claude Code, use one of the following methods: You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine. Dopo il completamento dell’installazione, aprite un terminale nel progetto su cui desiderate lavorare e avviate Claude Code: 
claude
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:
OpzioneRichiedeSandboxingQuando utilizzare
Windows nativoGit for Windows consigliato; PowerShell utilizzato se assenteNon supportatoProgetti e strumenti nativi di Windows
WSL 2WSL 2 abilitatoSupportatoToolchain Linux o esecuzione di comandi in sandbox
WSL 1WSL 1 abilitatoNon supportatoSe WSL 2 non è disponibile
Opzione 1: Windows nativo con Git Bash Installate Git for Windows, quindi eseguite il comando di installazione da PowerShell o CMD. Non è necessario eseguire come Amministratore. 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 PowerShell, CMD o Git Bash. Quando Git Bash è installato, Claude Code lo utilizza internamente per eseguire i comandi indipendentemente da dove lo avviate. Se Claude Code non riesce a trovare l’installazione di Git Bash, impostate il percorso nel vostro file settings.json: 
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}
Claude Code può anche eseguire PowerShell nativamente su Windows. Quando Git Bash è installato, lo strumento PowerShell è in fase di rollout progressivo come opzione aggiuntiva: impostate CLAUDE_CODE_USE_POWERSHELL_TOOL=1 per attivare o 0 per disattivare. Consultate PowerShell tool per la configurazione e le limitazioni. Opzione 2: WSL Aprite la vostra distribuzione WSL ed eseguite l’installer Linux dalle istruzioni di installazione sopra. Installate e avviate claude all’interno del terminale WSL, non da PowerShell o CMD.

​
Alpine Linux e distribuzioni basate su musl

L’installer nativo su Alpine e altre distribuzioni basate su musl/uClibc richiede libgcc, libstdc++ e ripgrep. Installate questi utilizzando il gestore di pacchetti della vostra distribuzione, quindi impostate USE_BUILTIN_RIPGREP=0. Questo esempio installa i pacchetti richiesti su Alpine: 
apk add libgcc libstdc++ ripgrep
Quindi impostate USE_BUILTIN_RIPGREP a 0 nel vostro file settings.json: 
{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

​
Verificare l’installazione

Dopo l’installazione, confermate che Claude Code funziona: 
claude --version
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

​
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 Vertex AI o Microsoft Foundry. Dopo l’installazione, accedete eseguendo claude e seguendo i prompt del browser. Consultate 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.
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: 
{
  "autoUpdatesChannel": "stable"
}
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.

​
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: 
{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.100"
}
Nelle impostazioni gestite, questo applica un minimo a livello di organizzazione che le impostazioni utente e di progetto non possono ignorare.

​
Disabilitare gli aggiornamenti automatici

Impostate DISABLE_AUTOUPDATER a "1" nella chiave env del vostro file settings.json: 
{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}
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: 
claude update

​
Opzioni di installazione avanzate

Queste opzioni sono per il pinning delle versioni, i gestori di pacchetti Linux, npm 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): 
curl -fsSL https://claude.ai/install.sh | bash
Per installare la versione stabile: 
curl -fsSL https://claude.ai/install.sh | bash -s stable
Per installare un numero di versione specifico: 
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

​
Installare con i gestori di pacchetti Linux

Claude Code pubblica repository apt, dnf e apk firmati. Sostituite stable con latest per il canale rolling. Le installazioni tramite gestore di pacchetti non si aggiornano automaticamente tramite Claude Code; gli aggiornamenti arrivano attraverso il vostro normale flusso di lavoro di aggiornamento del sistema. Tutti i repository sono firmati con la chiave di firma del rilascio di Claude Code. Prima di fidarvi della chiave, verificatela come descritto in ogni scheda.
Per Debian e Ubuntu. Per utilizzare il canale rolling, cambiate entrambi gli occorrimenti di stable nella riga deb: il percorso dell’URL e il nome della suite.
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
Verificate l’impronta digitale della chiave GPG prima di fidarvi: gpg --show-keys /etc/apt/keyrings/claude-code.asc dovrebbe riportare 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.Per aggiornare in seguito, eseguite sudo apt update && sudo apt upgrade claude-code.

​
Installare con npm

Potete anche installare Claude Code come pacchetto npm globale. Il pacchetto richiede Node.js 18 o successivo. 
npm install -g @anthropic-ai/claude-code
Il pacchetto npm installa lo stesso binario nativo dell’installer standalone. npm estrae il binario attraverso una dipendenza opzionale per piattaforma come @anthropic-ai/claude-code-darwin-arm64, e un passaggio postinstall lo collega in posizione. Il binario claude installato non invoca Node stesso. Le piattaforme di installazione npm supportate sono darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 e win32-arm64. Il vostro gestore di pacchetti deve consentire dipendenze opzionali. Consultate la risoluzione dei problemi se il binario manca dopo l’installazione. Per aggiornare un’installazione npm, eseguite npm install -g @anthropic-ai/claude-code@latest. Evitate npm update -g, che rispetta l’intervallo semver dall’installazione originale e potrebbe non portarvi al rilascio più recente.
NON utilizzate sudo npm install -g poiché ciò può portare a problemi di permessi e rischi di sicurezza. Se riscontrate errori di permessi, consultate la risoluzione dei problemi di permessi.

​
Integrità dei binari e firma del codice

Ogni rilascio pubblica un manifest.json contenente checksum SHA256 per ogni binario di piattaforma. Il manifest è firmato con una chiave GPG di Anthropic, quindi la verifica della firma sul manifest verifica transitivamente ogni binario che elenca.

​
Verificare la firma del manifest

I passaggi 1-3 richiedono una shell POSIX con gpg e curl. Su Windows, eseguiteli in Git Bash o WSL. Il passaggio 4 include un’opzione PowerShell.
1

Scaricare e importare la chiave pubblica

La chiave di firma del rilascio è pubblicata a un URL fisso.
curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import
Visualizzate l’impronta digitale della chiave importata.
gpg --fingerprint security@anthropic.com
Confermate che l’output includa questa impronta digitale:
31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE
2

Scaricare il manifest e la firma

Impostate VERSION al rilascio che desiderate verificare.
REPO=https://downloads.claude.ai/claude-code-releases
VERSION=2.1.89
curl -fsSLO "$REPO/$VERSION/manifest.json"
curl -fsSLO "$REPO/$VERSION/manifest.json.sig"
3

Verificare la firma

Verificate la firma staccata rispetto al manifest.
gpg --verify manifest.json.sig manifest.json
Un risultato valido riporta Good signature from "Anthropic Claude Code Release Signing <security@anthropic.com>".gpg stampa anche WARNING: This key is not certified with a trusted signature! per qualsiasi chiave appena importata. Questo è previsto. La riga Good signature conferma che il controllo crittografico è passato. Il confronto dell’impronta digitale nel Passaggio 1 conferma che la chiave stessa è autentica.
4

Controllare il binario rispetto al manifest

Confrontate il checksum SHA256 del vostro binario scaricato con il valore elencato sotto platforms.<platform>.checksum in manifest.json.
sha256sum claude
Le firme del manifest sono disponibili per i rilasci da 2.1.89 in poi. I rilasci precedenti pubblicano checksum in manifest.json senza una firma staccata.

​
Firme del codice della piattaforma

Oltre al manifest firmato, i singoli binari portano firme del codice native della piattaforma dove supportate.
  • macOS: firmato da “Anthropic PBC” e notarizzato da Apple. Verificate con codesign --verify --verbose ./claude.
  • Windows: firmato da “Anthropic, PBC”. Verificate con Get-AuthenticodeSignature .\claude.exe.
  • Linux: i binari non sono individualmente firmati dal codice. Se scaricate direttamente dal bucket claude-code-releases o utilizzate l’installer nativo, verificate l’integrità con la firma del manifest sopra. Se installate con apt, dnf o apk, il vostro gestore di pacchetti verifica automaticamente le firme utilizzando la chiave di firma del repository.

​
Disinstallare Claude Code

Per rimuovere Claude Code, seguite le istruzioni per il vostro metodo di installazione. Se claude continua a funzionare in seguito, probabilmente avete una seconda installazione o un alias shell residuo da un programma di installazione più vecchio. Consultate Verificare le installazioni in conflitto per trovarla e rimuoverla.

​
Installazione nativa

Rimuovete il binario di Claude Code e i file di versione: 
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

​
Installazione Homebrew

Rimuovete il cask Homebrew che avete installato. Se avete installato il cask stabile: 
brew uninstall --cask claude-code
Se avete installato il cask latest: 
brew uninstall --cask claude-code@latest

​
Installazione WinGet

Rimuovete il pacchetto WinGet: 
winget uninstall Anthropic.ClaudeCode

​
apt / dnf / apk

Rimuovete il pacchetto e la configurazione del repository: 
sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc

​
npm

Rimuovete il pacchetto npm globale: 
npm uninstall -g @anthropic-ai/claude-code

​
Rimuovere i file di configurazione

La rimozione dei file di configurazione eliminerà tutte le vostre impostazioni, gli strumenti consentiti, le configurazioni del server MCP e la cronologia delle sessioni.
L’estensione VS Code, il plugin JetBrains e l’app Desktop scrivono anche in ~/.claude/. Se uno di essi è ancora installato, la directory viene ricreata la prossima volta che viene eseguito. Per rimuovere Claude Code completamente, disinstallate l’estensione VS Code, il plugin JetBrains e l’app Desktop prima di eliminare questi file. Per rimuovere le impostazioni di Claude Code e i dati memorizzati nella cache: 
# Rimuovere le impostazioni utente e lo stato
rm -rf ~/.claude
rm ~/.claude.json

# Rimuovere le impostazioni specifiche del progetto (eseguire dalla directory del progetto)
rm -rf .claude
rm -f .mcp.json