Riepilogo rapido: Claude Code può essere installato tramite installer nativi su macOS, Windows e Linux dal sito ufficiale di Claude Code. Gli utenti Windows devono installare prima WSL2 prima di eseguire Claude Code. Dopo l'installazione, autenticati con il tuo account Claude quando Claude Code apre una finestra del browser per il login al primo avvio per iniziare a codificare con l'assistenza AI direttamente dal tuo terminale o dall'app desktop.
Claude Code rappresenta lo sforzo di Anthropic nello sviluppo di strumenti AI agentivi. Questo assistente da riga di comando legge codebase, modifica file, esegue comandi e si integra nei flussi di lavoro di sviluppo.
Ma installarlo non è sempre facile. Piattaforme diverse richiedono approcci diversi. Windows necessita di configurazioni aggiuntive. E la documentazione, sebbene completa, può sopraffare i nuovi arrivati.
Questa guida semplifica la complessità. Copre i requisiti di sistema, i passaggi di installazione specifici per piattaforma, l'autenticazione e la verifica: tutto il necessario per far funzionare correttamente Claude Code.
Requisiti di sistema prima dell'installazione
Secondo la documentazione ufficiale di Claude Code, lo strumento supporta macOS, Windows e Linux. Tuttavia, ogni piattaforma ha prerequisiti specifici.
Per macOS, i requisiti sono minimi. Il sistema necessita di macOS 13.0 o versioni successive. Entrambi i chip Intel e Apple Silicon funzionano bene.
Windows presenta maggiore complessità. Il sistema operativo deve essere Windows 10 Build 19041 o versioni successive, oppure Windows 11. Ma ecco il problema: Claude Code non funziona nativamente su Windows.
Il sottosistema Windows per Linux 2 (WSL2) è obbligatorio. Questo crea un ambiente Linux in cui Claude Code opera effettivamente. Senza WSL2, l'installazione fallisce.
Gli utenti Linux necessitano di una distribuzione a 64 bit. La documentazione ufficiale conferma il supporto per Ubuntu, Debian, Fedora e altre distribuzioni principali. Alpine Linux e sistemi basati su musl richiedono configurazioni aggiuntive.
Tutte le piattaforme necessitano di una connessione Internet stabile durante l'installazione. Le dimensioni dei download variano ma vanno tipicamente da 50 MB a 500 MB a seconda di ciò che è già installato.
| Piattaforma | Versione minima | Requisiti speciali |
|---|---|---|
| macOS | 13.0 | Nessuno |
| Windows | 10 Build 19041 o 11 | Richiesto WSL2 |
| Linux | Distribuzione a 64 bit | Preferito basato su glibc |
Installazione di Claude Code su macOS
Il processo di installazione di macOS utilizza un installer nativo. Questo è il percorso più semplice tra tutte le piattaforme.
Innanzitutto, scarica l'installer dal sito ufficiale di Claude Code. La pagina di download rileva automaticamente macOS e offre il pacchetto appropriato.
Apri il file .dmg scaricato. Trascina l'applicazione Claude Code nella cartella Applicazioni. Installazione standard di macOS, niente di insolito qui.
Alcuni utenti incontrano un avviso di sicurezza al primo avvio. macOS blocca le app da sviluppatori non identificati per impostazione predefinita. Fai clic destro sull'applicazione Claude Code e seleziona "Apri" per bypassare questo avviso una tantum.
Lo strumento da riga di comando si installa automaticamente con l'applicazione desktop. Apri Terminale e digita claude --version per verificare. Se appare il numero di versione, l'installazione è riuscita.
Verifica dell'installazione su macOS
Esegui questi comandi per confermare che tutto funzioni:
| claude --version claude --help |
Entrambi i comandi dovrebbero restituire output senza errori. Il comando di versione mostra la versione installata di Claude Code. Il comando help visualizza le opzioni e i comandi disponibili.
La creazione di una directory di test aiuta a verificare la piena funzionalità. Naviga in una cartella di progetto ed esegui claude per avviare una sessione interattiva. Lo strumento dovrebbe inizializzare e richiedere l'autenticazione se non sei già loggato.
Installazione su Windows con WSL2
L'installazione su Windows richiede più passaggi. Il processo richiede più tempo di macOS ma rimane gestibile.
WSL2 deve essere installato per primo. Apri PowerShell come amministratore ed esegui:
| wsl --install |
Questo comando installa WSL2 e Ubuntu per impostazione predefinita. Il sistema richiederà un riavvio. Dopo il riavvio, Ubuntu si avvia automaticamente per completare la configurazione iniziale.
Crea un nome utente e una password Unix quando richiesto. Queste credenziali sono separate dalle credenziali di accesso di Windows.
Una volta che WSL2 è in esecuzione, si applica il processo di installazione Linux. Apri il terminale Ubuntu (installato con WSL2) e scarica l'installer di Claude Code per Linux.
Installazione di Claude Code in WSL2
Secondo la documentazione ufficiale, il comando di installazione scarica ed esegue l'installer nativo:
| curl -o- raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
Questo script gestisce le dipendenze automaticamente. Installa Node.js se necessario, configura il binario di Claude Code e imposta le variabili PATH.
L'installazione richiede alcuni minuti. Le barre di avanzamento e i messaggi di stato indicano cosa sta succedendo. Al termine, chiudi e riapri il terminale per aggiornare le variabili d'ambiente.
Il test dell'installazione segue lo stesso processo di macOS. Esegui claude --version per verificare.
Processo di installazione su Linux
Gli utenti Linux hanno il percorso di installazione più semplice. L'installer nativo funziona direttamente senza strati aggiuntivi come WSL2.
Scarica ed esegui lo script di installazione:
| curl -fsSL claude.ai/install.sh | bash |
Questo scarica il binario di Claude Code, installa le dipendenze e configura l'ambiente della shell. Lo script rileva la distribuzione e si adatta di conseguenza.
Per i sistemi basati su Ubuntu e Debian, lo script configura l'installazione. La documentazione ufficiale conferma il supporto per Ubuntu 20.04+, Debian 10+ e altre distribuzioni.
Considerazioni su Alpine Linux
Alpine Linux e le distribuzioni basate su musl richiedono passaggi aggiuntivi. La documentazione ufficiale nota che questi sistemi richiedono una configurazione manuale.
L'installer standard potrebbe fallire su Alpine. Invece, scarica il binario compatibile con musl direttamente dalla pagina delle release. Estrailo in una directory nel PATH di sistema, tipicamente /usr/local/bin.
Imposta i permessi eseguibili:
| chmod +x /usr/local/bin/claude |
Gli utenti di Alpine dovrebbero verificare la compatibilità prima di procedere. Alcune funzionalità potrebbero non funzionare in modo identico alle distribuzioni basate su glibc.
Autenticazione e configurazione dell'account
Dopo aver installato Claude Code, esegui claude nel tuo terminale. Al primo avvio, Claude Code aprirà una finestra del browser per il login.
Questo aprirà la pagina di autenticazione di Claude. Accedi con un account Claude esistente o creane uno nuovo.
Il browser mostrerà un codice di autorizzazione. Copia questo codice e torna al terminale. Incolla il codice quando richiesto.
L'autenticazione riuscita memorizza le credenziali localmente. Le sessioni future non richiederanno il login a meno che le credenziali non scadano o vengano cancellate manualmente.
Autenticazione per Team e Aziende
Secondo la documentazione ufficiale sull'autenticazione, i team che utilizzano Claude per Team o Enterprise hanno opzioni aggiuntive. Le organizzazioni possono configurare il single sign-on (SSO) o l'autenticazione tramite provider cloud.
La configurazione SSO richiede la configurazione da parte dell'amministratore. I singoli sviluppatori si autenticano quindi tramite il provider di identità della loro organizzazione anziché tramite account Claude personali.
L'autenticazione tramite provider cloud funziona per le implementazioni AWS, Google Cloud e Azure. Questo metodo utilizza le credenziali cloud esistenti anziché account Claude separati.
| Metodo di autenticazione | Caso d'uso | Complessità di configurazione |
|---|---|---|
| Account personale | Sviluppatori individuali | Semplice |
| SSO per Team/Aziende | Organizzazioni | Richiede amministratore |
| Provider Cloud | Utenti AWS/GCP/Azure | Moderata |
Installazione dell'app desktop
Claude Code offre sia applicazioni da riga di comando che desktop. L'app desktop fornisce un'interfaccia grafica mantenendo la piena funzionalità del terminale.
Scarica l'installer desktop dal sito ufficiale di Claude. La pagina offre versioni per macOS, Windows e Windows ARM64. Seleziona la versione appropriata per il sistema.
L'installazione su macOS segue lo stesso processo .dmg descritto in precedenza. Gli utenti Windows possono scaricare l'app desktop per un'interfaccia grafica senza richiedere la configurazione di WSL2.
L'app desktop include l'accesso al terminale integrato. Può avviare sessioni di Claude Code senza passare ad applicazioni terminali esterne.
Un vantaggio dell'app desktop è la disponibilità in background. Secondo la pagina di download ufficiale, l'app "rimane pronta in background" e può essere richiamata da qualsiasi app senza cambiare finestra o perdere il focus.
Usa Get AI Perks per trovare crediti per il tuo stack Claude Code
L'installazione è la parte facile. Il costo reale deriva solitamente da tutto ciò che la circonda: infrastruttura, strumenti di supporto e servizi a pagamento utilizzati durante la configurazione e il test. Get AI Perks può aiutare elencando i crediti startup e gli sconti in un unico posto, insieme a indicazioni su come applicarli.
Con Get AI Perks, puoi:
- Trovare crediti per strumenti cloud e legati all'IA
- Verificare le condizioni dei perk prima di fare domanda
- Evitare di perdere tempo in offerte per le quali potresti non qualificarti
- Ridurre il costo per mettere in atto la tua configurazione
Visita Get AI Perks per vedere se le offerte disponibili corrispondono agli strumenti che prevedi di utilizzare con Claude Code.
Estensioni IDE e integrazioni
Oltre all'installazione standalone, Claude Code si integra con ambienti di sviluppo popolari. Esistono estensioni per Visual Studio Code e IDE JetBrains.
L'estensione VS Code si installa tramite il marketplace. Cerca "Claude Code" nel pannello Estensioni e fai clic su Installa. L'estensione richiede che lo strumento da riga di comando sia installato per primo.
Alcuni utenti segnalano problemi con il file dell'estensione VS Code inclusa. Se l'installazione automatica fallisce con un errore "End of central directory record signature not found", il file .vsix incluso potrebbe essere corrotto.
La soluzione consiste nell'installare l'estensione manualmente dal marketplace di VS Code anziché fare affidamento sulla versione inclusa nella CLI. Questo separa i due componenti e previene conflitti di installazione.
L'integrazione JetBrains funziona in modo simile. Installa il plugin dal marketplace JetBrains all'interno di IntelliJ IDEA, PyCharm, WebStorm o altri prodotti JetBrains.
Verifica del successo dell'installazione
Una verifica corretta garantisce che Claude Code funzioni correttamente prima di iniziare le attività di sviluppo effettive.
La verifica di base controlla la disponibilità dei comandi:
| claude --help claude --version |
Questi comandi dovrebbero essere eseguiti senza errori. Il comando help elenca le opzioni disponibili. Il comando version mostra la release installata.
Il test funzionale richiede l'avvio di una sessione. Crea una directory di test:
| mkdir test-project cd test-project claude |
Questo inizializza una sessione interattiva di Claude Code. Lo strumento dovrebbe analizzare la directory (vuota in questo caso) e presentare un prompt.
Prova comandi semplici all'interno della sessione. Digita help per vedere le azioni disponibili. Richiedi compiti semplici come "crea un file README" o "spiega cosa puoi fare".
Risposte positive indicano un'installazione corretta. Se si verificano errori, di solito sono correlati all'autenticazione, alla connettività di rete o alle dipendenze mancanti.
Gestione degli aggiornamenti e delle versioni
Claude Code si aggiorna automaticamente per impostazione predefinita. La documentazione ufficiale spiega che lo strumento controlla nuove versioni e le installa senza intervento dell'utente.
Il comportamento di aggiornamento può essere configurato tramite le impostazioni di Claude Code. La documentazione ufficiale copre la configurazione del canale di rilascio e le opzioni di aggiornamento manuale.
Gli aggiornamenti manuali richiedono di eseguire nuovamente lo script di installazione. Lo stesso comando utilizzato per l'installazione iniziale scarica la versione più recente:
| curl -fsSL claude.ai/install.sh | bash |
L'installazione di versioni specifiche è possibile per test o motivi di compatibilità. La documentazione di configurazione avanzata copre il blocco delle versioni e la configurazione del canale di rilascio.
I canali di rilascio includono stabile, beta e nightly. Stabile è raccomandato per il lavoro in produzione. I canali beta e nightly forniscono accesso anticipato a nuove funzionalità ma potrebbero contenere bug.
Problemi comuni di installazione
Diversi problemi appaiono frequentemente nelle discussioni della community sull'installazione di Claude Code.
La configurazione del PATH causa molti problemi. Se il comando claude non viene trovato dopo l'installazione, la directory del binario non è nel PATH di sistema.
Su macOS e Linux, l'aggiunta della directory al PATH solitamente comporta la modifica di ~/.bashrc, ~/.zshrc o file di configurazione della shell simili. Lo script di installazione solitamente gestisce questo automaticamente, ma la verifica manuale aiuta a risolvere i problemi.
Gli utenti Windows in WSL2 potrebbero dover chiudere e riaprire il terminale dopo l'installazione. Le variabili d'ambiente non si aggiornano nelle sessioni esistenti.
Restrizioni di rete bloccano alcune installazioni. Firewall aziendali o server proxy possono impedire il download dell'installer o la connessione ai server di autenticazione.
La configurazione del proxy richiede variabili d'ambiente:
| export HTTP_PROXY= proxy.example.com:8080 export HTTPS_PROXY= proxy.example.com:8080 |
Errori di permessi si verificano durante l'installazione in directory protette. L'installer necessita di accesso in scrittura a /usr/local/bin o posizioni equivalenti. Eseguire con sudo risolve questo problema ma dovrebbe essere evitato a meno che non sia necessario.
Domande frequenti
Claude Code può funzionare senza connessione internet?
No. Claude Code richiede connettività internet per funzionare. Lo strumento invia codice e query ai server di Anthropic per l'elaborazione. La memorizzazione nella cache locale potrebbe consentire ad alcune operazioni di funzionare temporaneamente offline, ma la piena funzionalità richiede una connessione attiva.
Claude Code funziona con gli strumenti di codifica AI esistenti?
Sì. Claude Code può essere eseguito insieme a GitHub Copilot, Cursor o altri strumenti di sviluppo AI. Operano indipendentemente e non entrano in conflitto. Tuttavia, utilizzare più assistenti AI contemporaneamente può creare confusione su quale strumento gestisca quale attività.
WSL2 è richiesto per tutte le funzionalità di Windows?
Lo strumento da riga di comando richiede WSL2 su Windows. Tuttavia, l'applicazione desktop funziona nativamente su Windows senza WSL2. L'app desktop fornisce funzionalità simili tramite un'interfaccia grafica anziché un'interazione pura da riga di comando.
Quanto costa usare Claude Code?
I prezzi variano in base all'utilizzo e al livello di abbonamento. Controlla il sito ufficiale di Claude per i prezzi attuali, poiché i costi e le strutture dei piani cambiano nel tempo. Alcune funzionalità richiedono abbonamenti Claude Pro o Enterprise.
Claude Code può modificare file al di fuori della directory del progetto?
Per impostazione predefinita, Claude Code limita l'accesso ai file alla directory del progetto corrente per motivi di sicurezza. Le impostazioni di configurazione possono espandere i permessi, ma farlo richiede un'autorizzazione esplicita. La documentazione di sandboxing copre la gestione dei permessi in dettaglio.
Qual è la differenza tra Claude Code e l'API Claude?
Claude Code è uno strumento di sviluppo per l'assistenza interattiva alla codifica. L'API Claude fornisce accesso programmatico per la creazione di applicazioni che utilizzano le capacità AI di Claude. Servono scopi diversi: uno per gli sviluppatori che scrivono codice, l'altro per le applicazioni che integrano funzionalità AI.
La disinstallazione rimuove tutti i dati di Claude Code?
La disinstallazione rimuove il binario dell'applicazione ma potrebbe lasciare file di configurazione e dati memorizzati nella cache. La rimozione completa richiede l'eliminazione manuale della directory ~/.claude su macOS e Linux, o la posizione equivalente in AppData su Windows.
Primi passi dopo l'installazione
Con Claude Code installato e verificato, il passo successivo consiste nel capire come utilizzarlo efficacemente.
La documentazione "quickstart" consiglia di iniziare con compiti semplici. Naviga in un progetto esistente ed esegui claude per iniziare una sessione interattiva.
Chiedi a Claude di spiegare la struttura del progetto. Richiedi un riassunto di cosa fa la codebase. Queste query esplorative aiutano a capire come lo strumento interpreta il codice.
Prova a apportare piccole modifiche. Chiedi a Claude di aggiungere commenti alle funzioni, creare semplici file di test o rifattorizzare blocchi di codice di base. Questi compiti dimostrano le capacità di modifica senza rischi.
L'integrazione Git funziona automaticamente se il progetto utilizza il controllo versione. Claude Code può creare commit, spiegare diff e suggerire miglioramenti basati sulle modifiche.
La documentazione ufficiale include esempi di flussi di lavoro per attività di sviluppo comuni. Questi coprono la correzione di bug, l'implementazione di funzionalità, la revisione del codice e il testing automatizzato.
Claude Code è uno strumento in evoluzione. L'installazione è solo la base. Capire le sue capacità, limitazioni e migliori pratiche richiede sperimentazione e pratica.
Pronto per installare Claude Code? Scarica l'installer appropriato per la tua piattaforma dal sito ufficiale e segui i passaggi descritti in questa guida. Autenticati con il tuo account Claude, verifica che l'installazione funzioni correttamente e inizia a esplorare lo sviluppo assistito dall'IA.
