Vai al contenuto principale

​
Requisiti di sistema

  • Sistemi operativi: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows 10+ (con WSL 1, WSL 2, o Git per Windows)
  • Hardware: 4GB+ di RAM
  • Software: Node.js 18+ (richiesto solo per l’installazione NPM)
  • Rete: Connessione Internet richiesta per l’autenticazione e l’elaborazione dell’IA
  • Shell: Funziona meglio in Bash, Zsh o Fish
  • Posizione: Paesi supportati da Anthropic

​
Dipendenze aggiuntive

​
Installazione standard

To install Claude Code, use one of the following methods:
Alcuni utenti potrebbero essere automaticamente migrati a un metodo di installazione migliorato.
Dopo il completamento del processo di installazione, accedi al tuo progetto e avvia Claude Code: 
cd your-awesome-project
claude
Claude Code offre le seguenti opzioni di autenticazione:
  1. Claude Console: L’opzione predefinita. Connettiti tramite Claude Console e completa il processo OAuth. Richiede fatturazione attiva su console.anthropic.com. Uno spazio di lavoro “Claude Code” verrà creato automaticamente per il tracciamento dell’utilizzo e la gestione dei costi. Nota che non puoi creare chiavi API per lo spazio di lavoro Claude Code - è dedicato esclusivamente all’utilizzo di Claude Code.
  2. Claude App (con piano Pro o Max): Sottoscrivi il piano Pro o Max di Claude per un abbonamento unificato che include sia Claude Code che l’interfaccia web. Ottieni più valore allo stesso prezzo gestendo il tuo account in un unico posto. Accedi con il tuo account Claude.ai. Durante l’avvio, scegli l’opzione che corrisponde al tuo tipo di abbonamento.
  3. Piattaforme Enterprise: Configura Claude Code per utilizzare Amazon Bedrock o Google Vertex AI per distribuzioni enterprise con la tua infrastruttura cloud esistente.
Claude Code archivia in modo sicuro le tue credenziali. Consulta Gestione delle credenziali per i dettagli.

​
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"

​
Metodi di installazione alternativi

Claude Code offre molteplici metodi di installazione per adattarsi a diversi ambienti. Se riscontri problemi durante l’installazione, consulta la guida alla risoluzione dei problemi.
Esegui claude doctor dopo l’installazione per verificare il tipo di installazione e la versione.

​
Opzioni di installazione nativa

L’installazione nativa è il metodo consigliato e offre diversi vantaggi:
  • Un eseguibile autonomo
  • Nessuna dipendenza da Node.js
  • Stabilità migliorata dell’aggiornamento automatico
Se hai un’installazione esistente di Claude Code, usa claude install per migrare all’installazione del binario nativo. Per opzioni di installazione avanzate con il programma di installazione nativo: macOS, Linux, WSL: 
# Installa versione stabile (predefinita)
curl -fsSL https://claude.ai/install.sh | bash

# Installa versione più recente
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Installa numero di versione specifico
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
Alpine Linux e altre distribuzioni basate su musl/uClibc: La build nativa richiede l’installazione di libgcc, libstdc++ e ripgrep. Installa (Alpine: apk add libgcc libstdc++ ripgrep) e imposta USE_BUILTIN_RIPGREP=0.
Claude Code installato tramite Homebrew si aggiornerà automaticamente al di fuori della directory brew a meno che non sia esplicitamente disabilitato con la variabile di ambiente DISABLE_AUTOUPDATER (consulta la sezione Aggiornamenti automatici).
Windows PowerShell: 
# Installa versione stabile (predefinita)
irm https://claude.ai/install.ps1 | iex

# Installa versione più recente
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# Installa numero di versione specifico
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
Windows CMD: 
REM Installa versione stabile (predefinita)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM Installa versione più recente
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM Installa numero di versione specifico
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd
Assicurati di rimuovere eventuali alias o symlink obsoleti prima di installare.

​
Installazione NPM

Per ambienti in cui NPM è preferito o richiesto: 
npm install -g @anthropic-ai/claude-code
NON utilizzare sudo npm install -g poiché ciò può portare a problemi di autorizzazione e rischi di sicurezza. Se riscontri errori di autorizzazione, consulta configura Claude Code per le soluzioni consigliate.

​
Esecuzione su AWS o GCP

Per impostazione predefinita, Claude Code utilizza l’API Claude. Per i dettagli sull’esecuzione di Claude Code su AWS o GCP, consulta integrazioni di terze parti.

​
Aggiorna Claude Code

​
Aggiornamenti automatici

Claude Code si aggiorna automaticamente per assicurarti di avere le ultime funzionalità e 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
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