Vai al contenuto principale

​
Requisiti di sistema

  • Sistemi operativi: macOS 13.0+, Ubuntu 20.04+/Debian 10+, o Windows 10+ (con WSL 1, WSL 2, o Git per Windows)
  • Hardware: 4 GB+ di RAM
  • Rete: Connessione Internet richiesta (vedi configurazione di rete)
  • Shell: Funziona meglio in Bash o Zsh
  • Posizione: Paesi supportati da Anthropic

​
Dipendenze aggiuntive

​
Installazione

To install Claude Code, use one of the following methods: Dopo il completamento del processo di installazione, accedi al tuo progetto e avvia Claude Code: 
cd your-awesome-project
claude
Se riscontri problemi durante l’installazione, consulta la guida alla risoluzione dei problemi.
Esegui claude doctor dopo l’installazione per controllare il tipo di installazione e la versione.
Alpine Linux e altre distribuzioni basate su musl/uClibc: Il programma di installazione nativo richiede libgcc, libstdc++ e ripgrep. Per Alpine: apk add libgcc libstdc++ ripgrep. Imposta USE_BUILTIN_RIPGREP=0.

​
Autenticazione

​
Per i singoli utenti

  1. Piano Claude Pro o Max (consigliato): Sottoscrivi il piano Pro o Max di Claude per un abbonamento unificato che include sia Claude Code che Claude sul web. Gestisci il tuo account in un unico posto e accedi con il tuo account Claude.ai.
  2. Claude Console: Connettiti tramite la Claude Console e completa il processo OAuth. Richiede una fatturazione attiva nella Console Anthropic. Uno spazio di lavoro “Claude Code” viene creato automaticamente per il tracciamento dell’utilizzo e la gestione dei costi. Non puoi creare chiavi API per lo spazio di lavoro Claude Code; è dedicato esclusivamente all’utilizzo di Claude Code.

​
Per team e organizzazioni

  1. Claude for Teams o Enterprise (consigliato): Sottoscrivi Claude for Teams o Claude for Enterprise per la fatturazione centralizzata, la gestione del team e l’accesso sia a Claude Code che a Claude sul web. I membri del team accedono con i loro account Claude.ai.
  2. Claude Console con fatturazione del team: Configura un’organizzazione Claude Console condivisa con fatturazione del team. Invita i membri del team e assegna ruoli per il tracciamento dell’utilizzo.
  3. Provider cloud: Configura Claude Code per utilizzare Amazon Bedrock, Google Vertex AI, o Microsoft Foundry per distribuzioni con la tua infrastruttura cloud esistente.

​
Installa una versione specifica

Il programma di installazione nativo accetta un numero di versione specifico o un canale di rilascio (latest o stable). Il canale che scegli al momento dell’installazione diventa il tuo predefinito per gli aggiornamenti automatici. Vedi Configura 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 1.0.58

​
Integrità binaria e firma del codice

  • I checksum SHA256 per tutte le piattaforme sono pubblicati nei manifesti di rilascio, attualmente ubicati in https://storage.googleapis.com/claude-code-dist-86c565f3-f756-42ad-8dfa-d59b1c096819/claude-code-releases/{VERSION}/manifest.json (esempio: sostituisci {VERSION} con 2.0.30)
  • I binari firmati sono distribuiti per le seguenti piattaforme:
    • macOS: Firmato da “Anthropic PBC” e notarizzato da Apple
    • Windows: Firmato da “Anthropic, PBC”

​
Installazione NPM (deprecata)

L’installazione NPM è deprecata. Utilizza il metodo di installazione nativa quando possibile. Per migrare un’installazione npm esistente a nativa, esegui claude install. Installazione npm globale 
npm install -g @anthropic-ai/claude-code
NON utilizzare sudo npm install -g poiché ciò può portare a problemi di permessi e rischi di sicurezza. Se riscontri errori di permesso, vedi risoluzione dei problemi di permesso per le soluzioni consigliate.

​
Configurazione di Windows

Opzione 1: Claude Code all’interno di WSL
  • Sia WSL 1 che WSL 2 sono supportati
Opzione 2: Claude Code su Windows nativo con Git Bash
  • Richiede Git per Windows
  • Per le installazioni Git portatili, specifica il percorso del tuo bash.exe: 
    $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"

​
Aggiorna Claude Code

​
Aggiornamenti automatici

Claude Code si aggiorna automaticamente per assicurarti di avere le funzionalità più recenti e le correzioni di sicurezza.
  • Controlli degli aggiornamenti: Eseguiti all’avvio e periodicamente durante l’esecuzione
  • Processo di aggiornamento: Scarica e installa automaticamente in background
  • Notifiche: Vedrai una notifica quando gli aggiornamenti vengono installati
  • Applicazione degli aggiornamenti: Gli aggiornamenti hanno effetto la prossima volta che avvii Claude Code
Le installazioni Homebrew e WinGet non si aggiornano automaticamente. Utilizza brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode per aggiornare manualmente.Problema noto: Claude Code potrebbe notificarti degli aggiornamenti prima che la nuova versione sia disponibile in questi gestori di pacchetti. Se un aggiornamento non riesce, attendi e riprova più tardi.

​
Configura canale di rilascio

Configura quale canale di rilascio Claude Code segue sia per gli aggiornamenti automatici che per claude update con l’impostazione autoUpdatesChannel:
  • "latest" (predefinito): Ricevi nuove funzionalità non appena vengono rilasciate
  • "stable": Utilizza una versione che è tipicamente circa una settimana vecchia, saltando i rilasci con regressioni importanti
Configura questo tramite /config → Canale di aggiornamento automatico, o aggiungilo al tuo file settings.json: 
{
  "autoUpdatesChannel": "stable"
}
Per le distribuzioni aziendali, puoi applicare un canale di rilascio coerente in tutta l’organizzazione utilizzando impostazioni gestite.

​
Disabilita aggiornamenti automatici

Imposta la variabile di ambiente DISABLE_AUTOUPDATER nella tua shell o nel file settings.json: 
export DISABLE_AUTOUPDATER=1

​
Aggiorna manualmente

claude update

​
Disinstalla Claude Code

Se hai bisogno di disinstallare Claude Code, segui le istruzioni per il tuo metodo di installazione.

​
Installazione nativa

Rimuovi il binario Claude Code e i file di versione: macOS, Linux, WSL: 
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude
Windows PowerShell: 
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Windows CMD: 
del "%USERPROFILE%\.local\bin\claude.exe"
rmdir /s /q "%USERPROFILE%\.local\share\claude"

​
Installazione Homebrew

brew uninstall --cask claude-code

​
Installazione WinGet

winget uninstall Anthropic.ClaudeCode

​
Installazione NPM

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

​
Pulisci i file di configurazione (facoltativo)

La rimozione dei file di configurazione eliminerà tutte le tue impostazioni, gli strumenti consentiti, le configurazioni del server MCP e la cronologia della sessione.
Per rimuovere le impostazioni e i dati memorizzati nella cache di Claude Code: macOS, Linux, WSL: 
# Rimuovi le impostazioni utente e lo stato
rm -rf ~/.claude
rm ~/.claude.json

# Rimuovi le impostazioni specifiche del progetto (esegui dalla directory del tuo progetto)
rm -rf .claude
rm -f .mcp.json
Windows PowerShell: 
# Rimuovi le impostazioni utente e lo stato
Remove-Item -Path "$env:USERPROFILE\.claude" -Recurse -Force
Remove-Item -Path "$env:USERPROFILE\.claude.json" -Force

# Rimuovi le impostazioni specifiche del progetto (esegui dalla directory del tuo progetto)
Remove-Item -Path ".claude" -Recurse -Force
Remove-Item -Path ".mcp.json" -Force
Windows CMD: 
REM Rimuovi le impostazioni utente e lo stato
rmdir /s /q "%USERPROFILE%\.claude"
del "%USERPROFILE%\.claude.json"

REM Rimuovi le impostazioni specifiche del progetto (esegui dalla directory del tuo progetto)
rmdir /s /q ".claude"
del ".mcp.json"