Configurazione avanzata

Requisiti di sistema, installazione specifica per piattaforma, gestione delle versioni e disinstallazione per Claude Code.

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

• ripgrep: solitamente incluso con Claude Code. Se la ricerca non funziona, consultate la risoluzione dei problemi di ricerca.

Installare Claude Code

To install Claude Code, use one of the following methods:

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

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

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

brew install --cask claude-code

winget install Anthropic.ClaudeCode

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:

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.

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

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

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

Per installare la versione stabile:

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

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

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

Per installare un numero di versione specifico:

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

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

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

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.

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

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

wget -O /etc/apk/keys/claude-code.rsa.pub \
https://downloads.claude.ai/keys/claude-code.rsa.pub
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add 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.

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.

curl -fsSL https://downloads.claude.ai/keys/claude-code.asc | gpg --import

gpg --fingerprint security@anthropic.com

31DD DE24 DDFA B679 F42D  7BD2 BAA9 29FF 1A7E CACE

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"

gpg --verify manifest.json.sig manifest.json

sha256sum claude

shasum -a 256 claude

(Get-FileHash claude.exe -Algorithm SHA256).Hash.ToLower()

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

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

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

sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

npm

Rimuovete il pacchetto npm globale:

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

Rimuovere i file di configurazione

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

# Rimuovere le impostazioni utente e lo stato
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# Rimuovere le impostazioni specifiche del progetto (eseguire dalla directory del progetto)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force