Riepilogo rapido: Claude Code è un assistente di codifica AI basato su terminale che funziona nativamente su macOS e Linux, o su Windows tramite WSL2. La sua configurazione richiede la creazione di una chiave API Anthropic, l'esecuzione di un programma di installazione specifico per la piattaforma, l'autenticazione con la chiave e la verifica dell'installazione con un comando di test.
Claude Code rappresenta l'assistente di codifica ufficiale di Anthropic basato su terminale. Risiede direttamente nella riga di comando e gestisce tutto, dalla generazione di codice alla correzione di bug, tramite comandi in linguaggio naturale.
Ma il processo di configurazione non è sempre lineare. Gli utenti Windows necessitano di WSL2. L'autenticazione API può confondere i principianti. Si verificano conflitti di versione.
Questa guida illustra l'intero processo di configurazione per tutte le piattaforme, dai requisiti di sistema alla prima sessione di codifica.
Cos'è effettivamente Claude Code
Claude Code è un'applicazione agentiva per terminale che si integra con gli ambienti di sviluppo. Comprende le codebase, esegue attività di routine e gestisce i flussi di lavoro git tramite comandi conversazionali.
A differenza degli strumenti basati su browser, Claude Code viene eseguito localmente nel terminale. Accede direttamente ai file di progetto, mantiene il contesto tra le sessioni e si integra con i flussi di lavoro di sviluppo esistenti. Secondo la documentazione ufficiale di Claude Code, lo strumento si connette all'API di Anthropic e supporta l'integrazione con Amazon Bedrock, Google Cloud Vertex AI e Azure AI.
Lo strumento opera in modo diverso dagli assistenti di codifica tradizionali. Parliamoci chiaro: è più simile ad avere un pair programmer nel tuo terminale che uno strumento di completamento del codice.
Requisiti di sistema per Claude Code
Prima dell'installazione, i sistemi devono soddisfare requisiti specifici. Ecco cosa richiede ciascuna piattaforma:
| Piattaforma | Requisiti | Note |
|---|---|---|
| macOS | macOS 13.0 o versione successiva | Supporto nativo, installazione semplice |
| Linux | Distribuzione a 64 bit con glibc 2.28+ | Supporto nativo per la maggior parte delle distribuzioni moderne |
| Windows | Windows 10 Build 19041+ o Windows 11 | Richiede prima l'installazione di WSL2 |
Tutte le piattaforme necessitano di una connessione Internet stabile per le chiamate API. I download di Claude Code richiedono in genere circa 50 MB, mentre WSL2 su Windows aggiunge circa 500 MB per il sottosistema Linux.
Per quanto riguarda lo spazio di archiviazione, prevedere almeno 4 GB di spazio libero. L'applicazione stessa è piccola, ma lo spazio per dipendenze e file di progetto è importante.
Requisiti specifici per Windows
Claude Code può essere eseguito su Windows tramite PowerShell o Prompt dei comandi se Node.js è installato. Lo strumento richiede Windows Subsystem for Linux 2 per creare un ambiente Linux.
Secondo le guide di installazione di claude.ai, i sistemi Windows 10 necessitano della Versione 1903 o successiva con Build 19041 o superiore. Gli utenti di Windows 11 dispongono del supporto WSL2 integrato. Sono richiesti privilegi di amministratore per la configurazione iniziale di WSL2.
Il processo prevede l'abilitazione della virtualizzazione nel BIOS, l'attivazione delle funzionalità di Windows e l'installazione di una distribuzione Linux. Ubuntu 22.04 LTS è la distribuzione consigliata per la compatibilità.
Installazione di Claude Code: Processo passo passo
Il processo di installazione varia a seconda della piattaforma. Ecco come far funzionare Claude Code su ciascun sistema operativo.
Installazione su macOS e Linux
Le installazioni su macOS e Linux seguono lo stesso schema. Entrambe le piattaforme supportano l'installazione nativa senza configurazione aggiuntiva.
Il processo inizia con il download del programma di installazione. Apri un terminale ed esegui:
curl -fsSL claude.ai/install.sh | sh
Lo script rileva il sistema operativo, scarica il binario appropriato e installa Claude Code nella directory bin locale. L'installazione si completa in genere in meno di due minuti con una connessione stabile.
Per i sistemi senza curl, wget funziona come alternativa. Il programma di installazione aggiunge automaticamente Claude Code al PATH del sistema.
Installazione su Windows tramite WSL2
L'installazione su Windows richiede prima la configurazione di WSL2. Ecco il processo completo:
Apri PowerShell come Amministratore e abilita WSL:
wsl –install
Questo comando abilita le funzionalità di Windows richieste, scarica il kernel WSL2 e installa Ubuntu per impostazione predefinita. Il sistema richiederà un riavvio. Dopo il riavvio, Ubuntu si avvierà automaticamente per completare la configurazione dell'utente.
Crea un nome utente e una password quando richiesto. Queste credenziali sono per l'ambiente Linux, separate dai dettagli di accesso di Windows.
Una volta che WSL2 è in esecuzione, si applica il processo di installazione Linux. Nel terminale Ubuntu, esegui il comando curl della sezione macOS/Linux sopra.
Il programma di installazione si occupa del resto. Claude Code viene installato all'interno dell'ambiente WSL2 e viene eseguito tramite il terminale Ubuntu.
Ottenere una chiave API Anthropic
Claude Code richiede una chiave API Anthropic per l'autenticazione. La chiave collega l'installazione locale ai server di Anthropic.
Visita la Console Anthropic su console.anthropic.com. Crea un account o accedi con le credenziali esistenti. Naviga su API Keys nelle impostazioni dell'account.
Fai clic su "Crea chiave" per generare una nuova chiave API. La chiave appare una sola volta: copiala immediatamente. Anthropic non visualizza più la chiave completa dopo aver lasciato la pagina.
Conserva la chiave in modo sicuro. Fornisce l'accesso completo all'API Anthropic e a qualsiasi fatturazione associata.
Comprendere i costi dell'API
Claude Code opera con un modello pay-per-use tramite l'API Anthropic. Sulla base dei dati delle guide di installazione di claude.ai, i costi variano a seconda del modello:
| Modello | Costo di input | Costo di output |
|---|---|---|
| Claude Opus 4.6 | $5 per milione di token | $25 per milione di token |
| Claude Sonnet 4.6 | $3 per milione di token | $15 per milione di token |
L'acquisto minimo per attivare la fatturazione è di $5, sebbene le discussioni della community suggeriscano che $20-30 offrano un margine migliore per i test. Le opzioni di abbonamento alternative includono Claude Pro a $20 mensili o Claude Max a $100 mensili per un uso intensivo.
Il comportamento predefinito utilizza Opus fino al raggiungimento del 50% dei limiti di utilizzo, quindi passa a Sonnet per l'efficienza dei costi.
Autenticazione e primo avvio
Dopo l'installazione, Claude Code necessita di autenticazione prima del primo utilizzo. Avvia Claude Code eseguendo:
claude
Il primo avvio richiede la chiave API. Incolla la chiave dalla Console Anthropic e premi Invio. Claude Code valida la chiave e la memorizza in modo sicuro nei file di configurazione locali.
L'autenticazione persiste tra le sessioni. La chiave API non deve essere reinserita a meno che non venga esplicitamente rimossa o quando si cambiano account.
Per verificare che l'autenticazione sia andata a buon fine, Claude Code visualizza un messaggio di benvenuto e un prompt dei comandi. L'interfaccia mostra i comandi disponibili e conferma la connessione all'API di Anthropic.
Configurazione delle preferenze del modello
Claude Code utilizza la selezione automatica del modello per impostazione predefinita, ma è possibile una configurazione manuale. Secondo la documentazione ufficiale, gli utenti possono regolare la selezione del modello tramite il comando /model o impostando la variabile d'ambiente CLAUDE_CODE_EFFORT_LEVEL.
Il livello di sforzo controlla la profondità di ragionamento per i modelli Opus 4.6 e Sonnet 4.6: basso, medio o alto. Livelli di sforzo più elevati aumentano la profondità di ragionamento ma anche i costi e i tempi di risposta.
Per progetti che richiedono analisi approfondite, includere "ultrathink" nei prompt imposta temporaneamente lo sforzo su alto per quel turno specifico.
Verifica del successo dell'installazione
Dopo l'autenticazione, verifica che Claude Code funzioni correttamente. Esegui questi test di base:
claude –help
claude –version
Il comando help visualizza le opzioni e i comandi disponibili. L'output della versione conferma quale release è installata. Entrambi i comandi dovrebbero essere eseguiti senza errori.
Successivamente, testa Claude Code in una directory di progetto. Crea una cartella di test:
mkdir test-project
cd test-project
echo “# Test Project” > README.md
claude
All'interno della sessione di Claude Code, prova interazioni di base:
- Digita "help" per vedere i comandi disponibili
- Chiedi "spiegami cosa sai fare"
- Richiedi "riassumi questo progetto"
- Prova il comando /help
Queste interazioni confermano che Claude Code può leggere i file di progetto e rispondere ai prompt. Risposte positive significano che l'installazione è funzionale.
Configurazione di Claude Code per i progetti
Claude Code memorizza le impostazioni specifiche del progetto nei file di configurazione. Questi file personalizzano il comportamento, definiscono la memoria e stabiliscono i flussi di lavoro.
Il file di configurazione principale è CLAUDE.md nella root del progetto. Questo file contiene istruzioni, contesto e linee guida specifiche del progetto a cui Claude Code fa riferimento durante le sessioni.
Crea un file CLAUDE.md di base:
# Contesto del progetto
Questo è un [tipo di progetto] costruito con [tecnologie].
## Linee guida chiave
– [Regola importante 1]
– [Regola importante 2]
## Struttura del progetto
[Breve spiegazione dell'organizzazione delle cartelle]
Il file accetta la formattazione Markdown. Claude Code legge questo contesto all'avvio della sessione e lo mantiene per tutta la conversazione.
Opzioni di configurazione avanzate
Oltre al contesto di base, Claude Code supporta la configurazione avanzata tramite la directory .claude. Questa directory può contenere:
- Skill: Capacità specializzate definite in .claude/skills/SKILL.md
- Comandi: Comandi slash personalizzati in .claude/commands/*.md
- Hook: Flussi di lavoro automatizzati attivati da eventi
- Plugin: Funzionalità estese tramite integrazione programmatica
Secondo la documentazione ufficiale dell'SDK Agent, queste funzionalità consentono una personalizzazione sofisticata. Le skill definiscono capacità riutilizzabili. I comandi creano scorciatoie per attività comuni. Gli hook automatizzano le risposte alle modifiche dei file o all'uso degli strumenti.
Utilizzo di Claude Code: Flussi di lavoro di base
Con l'installazione completata, Claude Code gestisce le attività di sviluppo comuni tramite linguaggio naturale.
Avvia una sessione navigando in una directory di progetto ed eseguendo:
claude
Il prompt accetta richieste in linguaggio semplice. Alcuni flussi di lavoro comuni:
- Generazione di codice: "Crea una funzione Python che convalida gli indirizzi email con una corretta gestione degli errori."
- Correzione di bug: "Questa funzione sta lanciando un'eccezione null pointer. Puoi identificare e correggere il problema?"
- Refactoring: "Rifattorizza questo componente per utilizzare l'iniezione di dipendenze anziché l'istanziazione diretta."
- Operazioni Git: "Crea un nuovo branch, esegui il commit di queste modifiche con un messaggio descrittivo e invia all'origine."
Claude Code mantiene il contesto durante la sessione. Ricorda le interazioni precedenti, tiene traccia delle modifiche ai file e comprende la struttura generale del progetto.
Comprendere la modalità Piano
Per modifiche complesse, Claude Code offre la modalità Piano. Questa modalità crea un piano di esecuzione dettagliato prima di apportare modifiche.
Attiva la modalità Piano prefissando le richieste con "plan:" o utilizzando il comando /plan. Claude Code quindi delinea le modifiche proposte, spiega il ragionamento e attende l'approvazione prima dell'esecuzione.
La modalità Piano è particolarmente utile per il refactoring, le modifiche architettoniche o le modifiche che interessano più file. Fornisce visibilità su ciò che Claude Code intende fare prima di impegnarsi nelle modifiche.
Integrazione con VS Code e IDE
Mentre Claude Code viene eseguito nel terminale, l'integrazione con gli editor di codice migliora il flusso di lavoro. L'estensione ufficiale di VS Code porta le funzionalità di Claude Code direttamente nell'editor.
Installa l'estensione dal marketplace di VS Code. Cerca "Claude Code" e fai clic su Installa. L'estensione aggiunge un pannello Claude Code alla barra laterale.
Secondo la documentazione ufficiale di VS Code, l'estensione supporta:
| Funzionalità | Scorciatoia | Descrizione |
|---|---|---|
| Input Focus | Cmd+Esc / Ctrl+Esc | Passa dall'editor a Claude |
| Apri in nuova scheda | Cmd+Shift+Esc / Ctrl+Shift+Esc | Avvia una nuova conversazione come scheda |
| Apri nel terminale | – | Avvia la modalità terminale da VS Code |
L'estensione mantiene la parità di funzionalità con la versione da terminale, aggiungendo comodità specifiche dell'IDE come diff inline e riferimenti ai file con @-mention.
Aggiornamento e gestione di Claude Code
Claude Code si aggiorna automaticamente per impostazione predefinita. L'applicazione verifica periodicamente la presenza di nuove versioni e installa gli aggiornamenti in background.
Per aggiornare manualmente, esegui:
claude –update
Ciò forza un controllo immediato e l'installazione della versione più recente. Il processo di aggiornamento conserva i file di configurazione e le credenziali di autenticazione.
Per le organizzazioni che richiedono il controllo delle versioni, gli aggiornamenti automatici possono essere disabilitati. Imposta la variabile d'ambiente CLAUDE_CODE_AUTO_UPDATE su false o configura tramite impostazioni gestite dal server.
Per installare una versione specifica, usa:
curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z
Sostituisci X.Y.Z con il numero di versione di destinazione.
Problemi comuni di configurazione e soluzioni
Diversi problemi si verificano comunemente durante la configurazione. Ecco come risolverli:
- Rifiuto della chiave API: Se Claude Code rifiuta la chiave API, verifica che non ci siano spazi o caratteri extra. Copia di nuovo la chiave dalla Console Anthropic. Verifica che la fatturazione sia attiva: le chiavi non funzioneranno senza un metodo di pagamento registrato.
- Errori di installazione di WSL2: I sistemi Windows a volte non riescono nell'installazione di WSL2 a causa delle impostazioni di virtualizzazione. Entra nel BIOS e abilita la virtualizzazione (Intel VT-x o AMD-V). Assicurati che la versione di Windows soddisfi i requisiti minimi.
- Comando non trovato: Se il terminale non riconosce il comando claude, il PATH non è stato aggiornato correttamente. Chiudi e riapri il terminale. Per problemi persistenti, aggiungi manualmente la directory di installazione al PATH.
- Timeout di connessione: Restrizioni di rete o firewall possono bloccare le chiamate API. Claude Code richiede l'accesso HTTPS a api.anthropic.com. Le reti aziendali potrebbero richiedere la configurazione di un proxy.
- Errori di permesso: Le installazioni Linux e macOS occasionalmente incontrano problemi di permesso. Esegui il programma di installazione con i permessi appropriati o installa in una directory utente anziché in posizioni a livello di sistema.
Controlla i crediti AI disponibili prima di configurare Claude Code
La configurazione di Claude Code di solito comporta la sperimentazione: esecuzione di prompt, test di integrazioni e creazione di piccoli prototipi prima che qualsiasi cosa vada in produzione. Quella fase iniziale porta spesso a un uso intensivo dell'API. Invece di pagare per ogni richiesta subito, molti sviluppatori cercano prima crediti disponibili o programmi di avvio che aiutino a ridurre quei costi iniziali.
Get AI Perks raccoglie queste opportunità in un unico posto. La piattaforma elenca crediti AI, sconti e programmi partner tra provider AI, piattaforme cloud e strumenti per sviluppatori, con guide passo passo che spiegano come reclamarli. In totale, il database include vantaggi da più di 200 strumenti e milioni di dollari in crediti disponibili a cui startup e sviluppatori possono fare domanda.
Prima di finire la configurazione di Claude Code, controlla Get AI Perks e reclama i crediti AI che possono coprire i tuoi primi esperimenti.
Domande frequenti
Devo pagare per Claude Code?
Claude Code è di per sé un software gratuito, ma richiede una chiave API Anthropic che opera su un modello pay-per-use. L'attivazione minima dell'account è di $5, sebbene l'uso pratico richieda in genere $20-30 in crediti. Piani di abbonamento alternativi come Claude Pro ($20/mese) o Claude Max ($100/mese) offrono diverse strutture di prezzo per utenti intensivi.
Claude Code può funzionare completamente offline?
No. Claude Code richiede una connessione Internet attiva per comunicare con i server API di Anthropic. L'applicazione elabora le richieste localmente ma invia i prompt ai modelli Claude in esecuzione sull'infrastruttura di Anthropic. Non esiste una modalità offline o un'opzione di modello locale.
Qual è la differenza tra Claude Code e Claude.ai?
Claude.ai è un'interfaccia di chat basata sul web per interazioni generali con Claude. Claude Code è un'applicazione specializzata per terminale progettata specificamente per lo sviluppo software. Claude Code si integra con git, legge direttamente i file di progetto, mantiene un contesto di sviluppo più lungo e include funzionalità specifiche per la codifica come la modalità Piano e le capacità di modifica dei file.
Come si passa da un modello all'altro di Claude?
Utilizza il comando /model all'interno di una sessione di Claude Code per passare da un modello all'altro disponibile. La configurazione predefinita utilizza Opus fino al raggiungimento del 50% di utilizzo, quindi passa a Sonnet. La selezione manuale consente di scegliere modelli specifici in base ai requisiti del compito: Opus per il ragionamento complesso, Sonnet per risposte più veloci ed economiche.
Posso usare Claude Code in VS Code?
Sì. Un'estensione ufficiale per VS Code porta le funzionalità di Claude Code nell'editor. Installala dal marketplace di VS Code. L'estensione offre le stesse funzionalità della versione da terminale con integrazioni IDE aggiuntive come diff inline, pannelli della barra laterale e scorciatoie da tastiera per un accesso rapido.
Claude Code memorizza il mio codice o le mie conversazioni?
Secondo le politiche di utilizzo dei dati di Anthropic, le interazioni API non vengono utilizzate per addestrare i modelli. Le organizzazioni possono configurare politiche di conservazione dei dati pari a zero tramite impostazioni enterprise. Codice e prompt vengono trasmessi ai server di Anthropic per l'elaborazione, ma la gestione dipende dalla configurazione dell'account e dalle impostazioni di conservazione dei dati.
Cosa succede se Claude Code commette un errore?
Claude Code include funzionalità di sicurezza come l'integrazione git e la modalità Piano per ridurre al minimo gli errori. Per gli errori che si verificano, si applicano le pratiche standard di controllo versione: la cronologia git fornisce la capacità di rollback. Il sistema dei permessi richiede l'approvazione per le operazioni sensibili. Alcune discussioni della community suggeriscono tassi di successo nell'intervallo 80-90% per le attività di routine, con supervisione raccomandata per modifiche critiche.
Andare avanti con Claude Code
Claude Code trasforma lo sviluppo basato su terminale integrando l'assistenza AI direttamente nella riga di comando. La configurazione richiede l'installazione specifica della piattaforma, l'autenticazione API e la configurazione di base, ma il processo è semplice se si seguono i passaggi corretti.
Lo strumento eccelle nelle attività di sviluppo di routine, nella generazione di codice e nella gestione dei flussi di lavoro git. La modalità Piano offre sicurezza per operazioni complesse. L'integrazione con IDE estende le capacità oltre il terminale.
Inizia con attività semplici per capire come Claude Code interpreta le richieste. Passa a flussi di lavoro più complessi man mano che la familiarità cresce. Usa il comando /clear tra attività distinte per mantenere un contesto pulito. Configura i file CLAUDE.md per una guida specifica del progetto.
I team possono esplorare le impostazioni gestite dal server e i marketplace dei plugin. Gli sviluppatori individuali possono beneficiare di skill e comandi personalizzati adattati ai modelli frequenti.
Il repository GitHub su anthropics/claude-code contiene esempi aggiuntivi, plugin della community e risorse per la risoluzione dei problemi. La documentazione ufficiale su docs.anthropic.com fornisce riferimenti tecnici completi.
Ora è il momento di iniziare a codificare. Naviga in un progetto, avvia Claude Code e scopri come lo sviluppo assistito dall'IA cambia il tuo flusso di lavoro.
