Configurare Claude Code
Installa, autentica e inizia a utilizzare Claude Code sulla tua macchina di sviluppo.
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
- ripgrep: Solitamente incluso con Claude Code. Se la funzionalità di ricerca fallisce, vedi risoluzione dei problemi di ricerca.
Installazione standard
To install Claude Code, run the following command:
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:
Claude Code offre le seguenti opzioni di autenticazione:
- Console Anthropic: L’opzione predefinita. Connettiti tramite la Console Anthropic e completa il processo OAuth. Richiede fatturazione attiva su console.anthropic.com.
- 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.
- 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
:
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:
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:
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: