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+ RAM
  • Software: Node.js 18+
  • Rete: Connessione Internet richiesta per l’autenticazione e l’elaborazione AI
  • Shell: Funziona meglio in Bash, Zsh o Fish
  • Posizione: Paesi supportati da Anthropic

Dipendenze aggiuntive

Installazione standard

To install Claude Code, run the following command:

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

NON utilizzare sudo npm install -g poiché questo può portare a problemi di permessi e rischi di sicurezza. Se incontri errori di permessi, vedi configurare Claude Code per soluzioni consigliate.

Alcuni utenti potrebbero essere automaticamente migrati a un metodo di installazione migliorato. Esegui claude doctor dopo l’installazione per verificare il tuo tipo di installazione.

Dopo che il processo di installazione si completa, naviga al tuo progetto e avvia Claude Code:

cd your-awesome-project
claude

Claude Code offre le seguenti opzioni di autenticazione:

  1. Console Anthropic: L’opzione predefinita. Connettiti tramite la Console Anthropic e completa il processo OAuth. Richiede fatturazione attiva su console.anthropic.com.
  2. App Claude (con piano Pro o Max): Abbonati al 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 il lancio, 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 memorizza in modo sicuro le tue credenziali. Vedi Gestione delle Credenziali per i dettagli.

Configurazione 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 installazioni Git portatili, specifica il percorso al 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 incontri problemi durante l’installazione, consulta la guida alla risoluzione dei problemi.

Esegui claude doctor dopo l’installazione per verificare il tuo tipo di installazione e versione.

Installazione npm globale

Metodo tradizionale mostrato nei passaggi di installazione sopra

Installazione binaria nativa (Beta)

Se hai un’installazione esistente di Claude Code, usa claude install per avviare l’installazione binaria nativa.

Per un’installazione nuova, esegui il seguente comando:

macOS, Linux, WSL:

# Installa versione stabile (predefinita)
curl -fsSL https://claude.ai/install.sh | bash

# Installa ultima versione
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 di installare ripgrep. Installa (Alpine: apk add ripgrep) e imposta USE_BUILTIN_RIPGREP=0.

Windows PowerShell:

# Installa versione stabile (predefinita)
irm https://claude.ai/install.ps1 | iex

# Installa ultima versione
& ([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

L’installer nativo di Claude Code è supportato su macOS, Linux e Windows.

Assicurati di rimuovere eventuali alias o symlink obsoleti. Una volta completata l’installazione, esegui claude doctor per verificare l’installazione.

Installazione locale

  • Dopo l’installazione globale tramite npm, usa claude migrate-installer per passare a locale
  • Evita problemi di permessi dell’aggiornatore automatico npm
  • Alcuni utenti potrebbero essere automaticamente migrati a questo metodo

Esecuzione su AWS o GCP

Per impostazione predefinita, Claude Code utilizza l’API di Anthropic.

Per dettagli sull’esecuzione di Claude Code su AWS o GCP, vedi integrazioni di terze parti.

Aggiornare Claude Code

Aggiornamenti automatici

Claude Code si mantiene automaticamente aggiornato per assicurarti di avere le ultime funzionalità e correzioni di sicurezza.

  • Controlli di aggiornamento: Eseguiti all’avvio e periodicamente durante l’esecuzione
  • Processo di aggiornamento: Scarica e installa automaticamente in background
  • Notifiche: Vedrai una notifica quando gli aggiornamenti sono installati
  • Applicazione degli aggiornamenti: Gli aggiornamenti hanno effetto la prossima volta che avvii Claude Code

Disabilitare gli aggiornamenti automatici:

# Tramite configurazione
claude config set autoUpdates false --global

# O tramite variabile d'ambiente
export DISABLE_AUTOUPDATER=1

Aggiornare manualmente

claude update