Riassunto rapido: Claude Code CLI viene installato tramite un singolo comando che scarica e configura automaticamente lo strumento. Su macOS e Linux, utilizzare lo script della shell ufficiale dalla documentazione di Anthropic, mentre gli utenti Windows eseguono comandi PowerShell o WSL. Dopo l'installazione, autenticati con la tua API key per iniziare a usare l'assistente di codifica AI di Claude nel tuo terminale.
Claude Code è uno strumento di codifica agentivo che vive nel tuo terminale e comprende l'intero tuo codebase. Secondo la documentazione ufficiale di Claude Code, può leggere file, eseguire comandi, modificare codice e integrarsi con gli strumenti di sviluppo tramite conversazioni in linguaggio naturale.
Ma iniziare richiede una corretta installazione. Ecco tutto il necessario per installare Claude Code CLI e configurarlo correttamente.
Requisiti di sistema prima dell'installazione
Prima di installare Claude Code, verifica che il sistema soddisfi i requisiti di base. Secondo la documentazione ufficiale sull'installazione avanzata, rimuovi completamente questa frase.
Controlla l'installazione di Node.js aprendo un terminale ed eseguendo:
| node –version |
Se Node.js non è installato o la versione è inferiore alla 18, scaricalo dal sito ufficiale di Node.js. La versione Long-Term Support (LTS) funziona perfettamente per Claude Code.
Oltre a Node.js, il sistema necessita di requisiti di base: macOS 13.0 o superiore per gli utenti Mac, Windows 10 o superiore per i sistemi Windows e la maggior parte delle distribuzioni Linux moderne funzionano senza problemi. È inoltre richiesto un account Claude da Anthropic per l'autenticazione dopo l'installazione.
Installazione di Claude Code su macOS e Linux
Il processo di installazione per macOS e Linux utilizza un singolo comando shell che gestisce tutto automaticamente. Questo metodo è documentato nella guida rapida ufficiale di Claude Code.
Apri Terminale ed esegui lo script di installazione:
| curl -fsSL claude.ai/install.sh | bash |
Lo script scarica il binario di Claude Code, lo posiziona nella directory corretta e configura automaticamente il PATH. L'intero processo si completa tipicamente in meno di un minuto.
Per gli utenti macOS che preferiscono Homebrew, esiste un metodo di installazione alternativo, sebbene non sia documentato ufficialmente nelle fonti primarie. Il metodo curl rimane l'approccio consigliato secondo la documentazione ufficiale.
Verifica dell'installazione
Una volta completata l'installazione, verifica che Claude Code sia accessibile:
| claude –version |
Questo comando dovrebbe mostrare il numero di versione installato. Se appare un errore del tipo "comando non trovato", la configurazione del PATH necessita di aggiustamenti.
Secondo la documentazione ufficiale sulla risoluzione dei problemi, i problemi di PATH sono il problema di installazione più comune. La soluzione consiste nell'aggiungere la directory di installazione di Claude al file di configurazione della shell.
Installazione di Claude Code su macOS e Linux
Il processo di installazione per macOS e Linux si basa su npm (Node Package Manager). Secondo la documentazione ufficiale, è necessario avere installato Node.js 18+ sul proprio sistema prima di procedere. A differenza degli strumenti CLI tradizionali che utilizzano script shell, Claude Code viene installato globalmente tramite il terminale per garantire che tutte le dipendenze siano gestite correttamente.
Apri il tuo Terminale ed esegui il seguente comando per installare il pacchetto:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Nota: La variabile d'ambiente CLAUDE_CODE_RELEASE_ALPHA=1 è attualmente richiesta durante la fase beta/alfa pubblica per riconoscere lo stato di anteprima dello strumento.
Questo comando scarica il pacchetto dal registro npm ufficiale e collega l'eseguibile claude alla directory bin globale del tuo sistema. Mentre alcuni utenti potrebbero tentare di trovare formule Homebrew, il metodo npm è l'unico percorso di installazione ufficialmente supportato e documentato.
Verifica dell'installazione
Dopo il completamento dell'installazione, verifica che la CLI sia correttamente mappata al tuo ambiente eseguendo:
| claude –version |
Questo comando dovrebbe visualizzare il numero di versione corrente (ad es. 0.2.9). Se riscontri un errore "comando non trovato", significa in genere che la tua directory npm globale non è inclusa nel PATH del tuo sistema.
Secondo la documentazione ufficiale sulla risoluzione dei problemi, puoi risolvere questo problema identificando il tuo prefisso npm con `npm config get prefix` e assicurandoti che la cartella `/bin` risultante sia aggiunta al tuo file .zshrc o .bashrc.
Installazione di Claude Code su Windows
L'installazione su Windows offre due approcci principali: installazione nativa tramite PowerShell o utilizzo di Windows Subsystem for Linux (WSL). La documentazione ufficiale raccomanda PowerShell per la maggior parte degli utenti.
Metodo di installazione tramite PowerShell
Apri PowerShell come Amministratore (fai clic destro sul menu Start e seleziona "Windows PowerShell (Amministratore)"). Esegui questo comando:
| irm claude.ai/install.ps1 | iex |
Lo script PowerShell gestisce automaticamente il download, l'installazione e la configurazione del PATH. Al termine, chiudi e riapri PowerShell per assicurarti che gli aggiornamenti del PATH abbiano effetto.
Metodo di installazione WSL
Gli sviluppatori che utilizzano già WSL possono installare Claude Code utilizzando il metodo Linux. Apri il terminale WSL ed esegui lo stesso comando curl utilizzato per Linux:
| curl -fsSL claude.ai/install.sh | bash |
L'approccio WSL funziona in modo identico alle installazioni Linux native. Un vantaggio: WSL fornisce un ambiente più simile a Unix che corrisponde alle configurazioni dei server di produzione.
Secondo la documentazione ufficiale sulla risoluzione dei problemi, gli utenti WSL occasionalmente incontrano problemi di connettività di rete. Se l'installazione si blocca, verifica che WSL possa accedere alle reti esterne e che le regole del firewall non blocchino il traffico.
Trova Crediti Claude e per Strumenti AI in un unico posto
Installare Claude Code CLI è un passo. Pagare per gli strumenti AI a lungo termine è un altro. Get AI Perks raccoglie crediti di startup e sconti software per strumenti AI e cloud in un unico posto. Offre ai fondatori l'accesso a oltre 200 vantaggi, comprese offerte da Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom e altri. La piattaforma mostra anche le condizioni dei vantaggi e le guide per riscattare ciascuna offerta.
Cerchi crediti Claude o Anthropic?
Controlla Get AI Perks per:
- trovare crediti e sconti per strumenti AI in un unico posto
- rivedere le condizioni dei vantaggi prima di fare domanda
- accedere a guide per riscattare le offerte per startup
👉 Visita Get AI Perks per sfogliare i vantaggi disponibili per Claude, Anthropic e altri software AI.
Autenticazione e configurazione iniziale
Dopo l'installazione, Claude Code richiede l'autenticazione prima di poter funzionare. Lo strumento utilizza le API key di Anthropic per verificare l'accesso.
Avvia il processo di autenticazione eseguendo:
| claude |
La prima volta che questo comando viene eseguito, Claude Code chiede l'autenticazione. Secondo la guida rapida ufficiale, questo apre una finestra del browser per accedere all'account Anthropic.
Dopo l'accesso tramite browser, la CLI riceve automaticamente un token di autenticazione. Questo token viene memorizzato localmente e persiste tra le sessioni, quindi non è necessaria un'autenticazione ripetuta.
Configurazione delle impostazioni a livello di progetto
Claude Code supporta la configurazione a più livelli secondo la documentazione ufficiale delle impostazioni. I livelli di configurazione più comuni sono:
| Ambito | Posizione | Caso d'uso |
|---|---|---|
| Utente | directory ~/.claude/ | Preferenze personali tra tutti i progetti |
| Progetto | .claude/ nel repository | Configurazione condivisa del team |
| Locale | .claude/settings.local.json | Override specifici della macchina |
Per la configurazione iniziale, la configurazione a livello utente è sufficiente. Le impostazioni a livello di progetto diventano importanti quando si lavora con team che condividono standard di codifica.
Avvio della tua prima sessione di Claude Code
Una volta completate l'installazione e l'autenticazione, avvia Claude Code eseguendo il comando senza argomenti:
| claude |
Questo avvia la modalità interattiva in cui Claude risponde alle richieste in linguaggio naturale. La documentazione ufficiale descrive la modalità interattiva come il modo principale per utilizzare Claude Code per attività di sviluppo.
Prova un semplice comando di test:
| Mostrami la struttura di questo progetto |
Claude Code analizza la directory corrente e fornisce una panoramica della struttura del codebase. Questo dimostra che l'installazione funziona correttamente e Claude ha accesso in lettura ai file.
Comandi essenziali per l'uso quotidiano
Oltre alla modalità interattiva, Claude Code supporta diversi modelli di comando documentati nel riferimento della CLI:
| Modello di comando | Scopo | Esempio |
|---|---|---|
| claude | Avvia sessione interattiva | claude |
| claude “task” | Esegui attività singola | claude “correggi gli errori di linting” |
| claude -p “query” | Query rapida senza sessione | claude -p “cosa fa questa funzione” |
Il modello per attività singola è particolarmente utile per pipeline CI/CD e script di automazione dove una sessione interattiva non è appropriata.
Risoluzione dei problemi comuni di installazione
Anche con gli script di installazione automatizzati, occasionalmente si verificano problemi. La documentazione ufficiale sulla risoluzione dei problemi copre i problemi più frequenti.
Errori di comando non trovato
Se il terminale visualizza "comando non trovato: claude" dopo l'installazione, la configurazione del PATH non è stata completata correttamente. Per macOS e Linux, aggiungi manualmente la posizione del binario di Claude al file di configurazione della shell.
Per gli utenti bash, modifica ~/.bashrc o ~/.bash_profile e aggiungi:
| export PATH=”$HOME/.local/bin:$PATH” |
Per gli utenti zsh (impostazione predefinita sui moderni macOS), modifica ~/.zshrc con la stessa riga. Dopo aver salvato, ricarica la configurazione con `source ~/.zshrc` o apri una nuova finestra del terminale.
Problemi di rete e firewall
Le reti aziendali e i firewall restrittivi bloccano a volte lo script di installazione. Secondo la documentazione sulla risoluzione dei problemi, se l'installazione si blocca o restituisce HTML anziché eseguire, l'accesso di rete ai server di Anthropic potrebbe essere bloccato.
La soluzione prevede il download separato dello script di installazione:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Questo approccio offre maggiore visibilità su ciò che non funziona in caso di errori durante il download o l'esecuzione.
Problemi specifici di WSL
Gli utenti Windows che eseguono WSL incontrano talvolta problemi di connettività tra il sottosistema Linux e Windows. La documentazione ufficiale menziona che potrebbe essere necessario adeguare le regole del firewall per consentire il traffico WSL.
Se Claude Code viene installato correttamente ma non riesce a raggiungere i server di Anthropic per l'autenticazione, verifica che il firewall di Windows consenta l'accesso di rete a WSL. La guida alla risoluzione dei problemi fornisce comandi PowerShell specifici per configurare le regole del firewall.
Aggiornamento di Claude Code
Claude Code riceve aggiornamenti regolari con nuove funzionalità e miglioramenti. Secondo la documentazione ufficiale, gli aggiornamenti vengono installati utilizzando lo stesso comando dell'installazione iniziale.
Esegui nuovamente lo script di installazione:
| curl -fsSL code.anthropic.com/install.sh | sh |
Lo script rileva l'installazione esistente e la aggiorna alla versione più recente. Nessuna configurazione o autenticazione viene persa durante il processo di aggiornamento.
Controlla la versione corrente prima e dopo l'aggiornamento:
| claude –version |
Il registro delle modifiche nella documentazione ufficiale di Claude Code elenca tutte le modifiche tra le versioni, il che aiuta a determinare se un aggiornamento introduce funzionalità pertinenti per flussi di lavoro specifici.
Passi successivi all'installazione
Con Claude Code installato e funzionante, diventa possibile esplorare le funzionalità avanzate. La documentazione ufficiale descrive diverse aree degne di indagine:
- Skill e personalizzazione: Secondo la documentazione ufficiale delle skill, Claude Code supporta skill personalizzate definite in file Markdown nella directory .claude/skills/. Queste skill estendono le capacità di Claude con comandi e flussi di lavoro specifici del progetto.
- Model Context Protocol (MCP): L'integrazione MCP consente a Claude Code di connettersi a strumenti e servizi esterni. Questo trasforma Claude in un hub che può accedere a database, API e altre risorse di sviluppo.
- Collaborazione in team: I file di configurazione a livello di progetto nella directory .claude/ possono essere sottoposti a commit nel controllo versione, condividendo le impostazioni di Claude Code tra interi team di sviluppo.
- La documentazione ufficiale fornisce guide dettagliate per ciascuna di queste aree, basandosi sull'installazione di base trattata qui.
Domande frequenti
Ho bisogno di un abbonamento a pagamento a Claude per utilizzare Claude Code CLI?
Claude Code richiede un account Claude da Anthropic, ma il livello di abbonamento specifico necessario dipende dall'utilizzo. Secondo la documentazione ufficiale, l'autenticazione è necessaria, ma i dettagli sui prezzi dovrebbero essere verificati sul sito ufficiale di Anthropic poiché i piani cambiano nel tempo.
Posso installare Claude Code senza privilegi di amministratore?
Su macOS e Linux, Claude Code si installa nella directory home dell'utente per impostazione predefinita e non richiede l'accesso amministrativo. Gli utenti Windows potrebbero aver bisogno di privilegi di amministratore per il metodo di installazione PowerShell, sebbene le installazioni WSL non richiedano l'accesso amministrativo.
Claude Code funziona offline?
No. Claude Code è uno strumento basato sull'intelligenza artificiale che comunica con i server di Anthropic per elaborare le richieste. Secondo la documentazione ufficiale, è necessaria una connessione Internet attiva affinché Claude possa analizzare il codice e generare risposte.
Come disinstallo Claude Code?
La documentazione ufficiale sull'installazione avanzata spiega che la disinstallazione comporta la rimozione del binario e dei file di configurazione. Su macOS e Linux, elimina la directory ~/.claude e rimuovi la modifica del PATH dai file di configurazione della shell. Gli utenti Windows dovrebbero rimuovere la directory di installazione e cancellare la variabile d'ambiente PATH.
Claude Code può accedere all'intero mio filesystem?
Per impostazione predefinita, Claude Code opera all'interno della directory di lavoro corrente e delle sue sottodirectory. Secondo la documentazione ufficiale sulle autorizzazioni, l'accesso può essere ulteriormente limitato utilizzando le impostazioni di sandbox nei file di configurazione. Claude chiede sempre conferma prima di eseguire operazioni potenzialmente distruttive.
Qual è la differenza tra Claude Code CLI e Claude Desktop?
Claude Code CLI viene eseguito nel terminale e si concentra sui flussi di lavoro di sviluppo con accesso diretto al filesystem ed esecuzione di comandi. Claude Desktop è un'applicazione autonoma con un'interfaccia grafica. Entrambi gli strumenti servono casi d'uso diversi, con la CLI ottimizzata per gli sviluppatori che preferiscono flussi di lavoro basati sul terminale.
Ogni quanto dovrei aggiornare Claude Code?
Gli aggiornamenti possono essere installati quando è più comodo. Il registro ufficiale delle modifiche documenta nuove funzionalità e correzioni di bug. Per i team, coordinare gli aggiornamenti assicura che tutti utilizzino versioni compatibili, sebbene Claude Code mantenga la retrocompatibilità con i file di configurazione tra le versioni.
Conclusione
Installare Claude Code CLI richiede solo pochi minuti indipendentemente dal sistema operativo. Gli script di installazione automatizzati gestiscono la configurazione, l'impostazione del PATH e il posizionamento del binario senza interventi manuali.
Dopo l'installazione e l'autenticazione, Claude Code diventa un potente assistente di codifica AI accessibile da qualsiasi terminale. I comandi in linguaggio naturale consentono agli sviluppatori di scrivere codice, correggere bug e automatizzare attività senza lasciare la riga di comando.
Pronto a sperimentare lo sviluppo assistito dall'IA? Esegui il comando di installazione per la tua piattaforma e inizia oggi stesso la tua prima sessione di Claude Code. La documentazione ufficiale su code.claude.com fornisce guide complete per le funzionalità avanzate una volta completata la configurazione di base.
