Tutorial Claude Code 5: Come installare Claude Code?

Come installare Claude Code

L'installazione di Claude Code non ha un'interfaccia grafica con "Avanti", tutto si svolge nella riga di comando. Se usi npm di solito, l'intero processo non richiede più di due minuti.

Prerequisiti

Prima di iniziare, assicurati di avere quanto segue:

Node.js 18 o versione successiva
Verifica eseguendo node -v nel terminale. Se la versione è inferiore a 18, aggiorna usando nvm, fnm o scaricando direttamente da nodejs.org.
Un account Anthropic
Il sito di registrazione è https://console.anthropic.com. L'account fornirà una chiave API, necessaria dopo l'installazione. La registrazione è gratuita, il costo effettivo viene calcolato in base all'utilizzo.
Accesso di rete all'endpoint API di Anthropic
Il dominio predefinito è api.anthropic.com. Se l'ambiente richiede un proxy, imposta HTTP_PROXY o HTTPS_PROXY nel terminale.

Metodo di installazione 1: Installazione globale tramite npm

Questo è il metodo più comune: una volta installato, è disponibile ovunque.

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

Al termine, esegui claude --version: se viene visualizzato un numero di versione, l'installazione è riuscita. Dopo l'installazione globale, il comando claude può essere chiamato direttamente da qualsiasi directory.

Se si verifica un errore di autorizzazione (comune nella directory /usr/local/lib su macOS), due modi per gestirlo:

Usare sudo per l'installazione (comodo ma controverso per la sicurezza).
Configurare npm per usare la directory utente, evitando sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Poi aggiungi ~/.npm-global/bin al PATH, e riavvia il terminale.

Metodo di installazione 2: Usa npx al volo

Se non vuoi installare nulla a livello globale, o vuoi solo provare temporaneamente, npx è più diretto.

npx @anthropic-ai/claude-code

npx scaricherà temporaneamente l'ultimo pacchetto, lo eseguirà e non lascerà comandi globali. Ogni utilizzo verifica la presenza di aggiornamenti, quindi è sempre alla versione più recente. Lo svantaggio è che è leggermente più lento (deve scaricare ogni volta) e non è adatto per script automatici chiamati frequentemente.

Adatto per: prima esperienza, uso temporaneo su macchine altrui, o uso occasionale.

Verifica che possa avviarsi correttamente

Dopo l'installazione, non affrettarti a autenticarti. Esegui un semplice comando per vedere se lo strumento si avvia:

claude --help

Se viene visualizzato un messaggio di aiuto, il file binario funziona. Il prossimo passo è collegare il tuo account, che sarà spiegato in seguito.

L'essenza dei due metodi di installazione è la stessa; autenticazione e uso successivi sono identici. Scegli quello che preferisci.

Problemi comuni

Versione di Node troppo bassa
Se inferiore a 18, si verifica un errore diretto, non un avviso. Aggiornare Node è la soluzione più diretta.
Timeout di rete
Sia per il download del pacchetto npm che per la successiva connessione API, potrebbe bloccarsi a causa di proxy o firewall. Prima verifica che curl https://api.anthropic.com funzioni, poi procedi.
Uso del cmd nativo su Windows
Sebbene teoricamente possibile, si consiglia di usare Git Bash, WSL2 o Windows Terminal per evitare problemi di escape dei percorsi.