​
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

​
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, consulta 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 è completato, 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): Iscriviti 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. Consulta Gestione delle credenziali per i dettagli.

​
Configurazione Windows

Opzione 1: Claude Code all’interno di WSL

  • Sono supportati sia WSL 1 che WSL 2

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

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 npm dell’aggiornatore automatico
  • 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, consulta 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 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 sono installati
  • Applicazione 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

​
Aggiornamento manuale

claude update