Vuoi usare Claude Code sul tuo PC Windows ma non sai da dove iniziare? Questa guida ti mostra esattamente come installare e configurare Claude Code su Windows 10 o 11, anche se non hai mai toccato un terminale in vita tua. L'installazione completa richiede circa 10 minuti e non necessita di alcuna conoscenza tecnica preliminare. Installerai Visual Studio Code, aggiungerai l'estensione Claude Code, configurerai il tuo accesso API e creerai il tuo primo progetto. Ogni passaggio è dettagliato con screenshot e spiegazioni semplici in modo che tu possa seguire senza perderti.

Quali sono i prerequisiti per installare Claude Code su Windows?

Ti servono tre elementi prima di iniziare: Windows 10 o 11 aggiornato, 4 GB di RAM minimo e una connessione internet stabile. Claude Code funziona su qualsiasi PC recente, non hai bisogno di una macchina potentissima.

Ecco l'elenco completo dei prerequisiti:

  • Sistema operativo: Windows 10 (versione 1809 o superiore) o Windows 11
  • Memoria RAM: 4 GB minimo, 8 GB consigliati per un comfort ottimale
  • Spazio disco: 500 MB per Visual Studio Code e l'estensione
  • Connessione internet: necessaria per scaricare gli strumenti e comunicare con l'API Claude
  • Diritti amministratore: richiesti solo per l'installazione iniziale

Non hai bisogno di una scheda grafica potente o di un processore di ultima generazione. Claude Code viene eseguito nel cloud tramite l'API di Anthropic, il tuo computer funge solo da interfaccia. Anche un PC desktop base del 2018 funziona perfettamente.

Se usi un Mac, consulta la nostra guida di installazione per macOS che dettaglia le specifiche di quell'ambiente.

Come scaricare e installare Visual Studio Code?

Vai su code.visualstudio.com, scarica l'installer per Windows e avvialo accettando le opzioni predefinite. L'installazione richiede 2-3 minuti al massimo.

Ecco il processo dettagliato:

  1. Apri il tuo browser e vai su code.visualstudio.com
  2. Clicca sul grande pulsante blu "Download for Windows"
  3. Il file VSCodeUserSetup-x64-1.XX.X.exe si scarica automaticamente
  4. Fai doppio clic sul file scaricato nella cartella Download
  5. Accetta i termini di utilizzo e clicca su "Avanti"
  6. Lascia il percorso di installazione predefinito (C:\Users\TuoNome\AppData\Local\Programs\Microsoft VS Code)
  7. Importante: spunta la casella "Aggiungi a PATH" durante l'installazione
  8. Spunta anche "Crea un'icona sul Desktop" per un accesso facile
  9. Clicca su "Installa" e attendi 2 minuti
  10. Deseleziona "Avvia Visual Studio Code" per ora e clicca su "Fine"

Visual Studio Code (VS Code in breve) è un editor di codice gratuito sviluppato da Microsoft. È lo strumento che gli sviluppatori usano per scrivere codice, ma non hai bisogno di saper programmare per usarlo con Claude Code. Pensa a VS Code come a un Word specializzato per il codice.

La dimensione del download è di circa 90 MB. Se il tuo antivirus ti chiede una conferma, accetta: VS Code è un software ufficiale e sicuro, utilizzato da più di 20 milioni di sviluppatori secondo le statistiche di Microsoft.

Come installare l'estensione Claude Code in VS Code?

Apri VS Code, clicca sull'icona Estensioni (quattro quadrati) nella barra laterale sinistra, digita "Claude Code" nella ricerca e clicca su "Installa". L'estensione si installa in pochi secondi.

Passaggi dettagliati:

  1. Avvia Visual Studio Code dall'icona sul Desktop o dal menu Start
  2. Individua la barra di icone verticale sul lato sinistro della finestra
  3. Clicca sull'icona che assomiglia a quattro piccoli quadrati (è il gestore delle estensioni)
  4. Nella barra di ricerca che appare in alto, digita esattamente: Claude Code
  5. L'estensione ufficiale appare come primo risultato (verifica che sia pubblicata da Anthropic)
  6. Clicca sul pulsante blu "Installa" a destra del nome
  7. Attendi 10-15 secondi durante l'installazione
  8. Un messaggio di conferma appare in basso a destra: "Estensione installata con successo"
  9. Una nuova icona Claude (un piccolo logo arancione) appare nella tua barra laterale sinistra

Se non trovi l'estensione, verifica di aver digitato "Claude Code" e non solo "Claude". Esistono diverse estensioni correlate a Claude, ma quella che ci interessa si chiama esattamente "Claude Code" o "Claude Dev" a seconda delle versioni.

L'estensione pesa circa 15 MB e non rallenta il tuo computer. Aggiunge semplicemente un'interfaccia in VS Code per comunicare con Claude tramite l'API di Anthropic.

Come ottenere e configurare la tua chiave API Claude?

Vai su console.anthropic.com, crea un account gratuito, genera una chiave API nelle impostazioni e incollala in VS Code quando l'estensione te lo chiede. Questa chiave consente a Claude Code di comunicare con l'intelligenza artificiale Claude.

Procedura completa:

  1. Apri console.anthropic.com nel tuo browser
  2. Clicca su "Sign Up" in alto a destra
  3. Crea un account con la tua email (riceverai un'email di conferma da convalidare)
  4. Una volta connesso, clicca sul tuo nome in alto a destra poi "API Keys"
  5. Clicca sul pulsante "Create Key" o "Crea una chiave"
  6. Dai un nome alla tua chiave (ad esempio: "Claude Code Windows")
  7. Clicca su "Create": la tua chiave appare (inizia con "sk-ant-")
  8. Cruciale: copia immediatamente questa chiave e salvala in un file di testo
  9. Non potrai mai più vedere questa chiave, se la perdi dovrai crearne una nuova

Ora configura la chiave in VS Code:

  1. Torna in Visual Studio Code
  2. Clicca sull'icona Claude nella barra laterale sinistra
  3. Una finestra ti chiede la tua chiave API
  4. Incolla la chiave che hai appena copiato (Ctrl+V)
  5. Premi Invio per convalidare
  6. Un messaggio conferma che la connessione funziona

La chiave API è come una password che consente al tuo computer di comunicare con i server di Claude. Anthropic offre 5 dollari di credito gratuito all'iscrizione, che rappresenta circa 200.000 parole generate da Claude secondo la loro documentazione ufficiale dei prezzi. Più che sufficiente per i tuoi primi progetti.

Attenzione: non condividere mai la tua chiave API pubblicamente (su GitHub, Discord, ecc.). Se qualcuno la ottiene, può usare il tuo credito al tuo posto.

Come creare il tuo primo progetto con Claude Code?

Crea una nuova cartella sul tuo Desktop, aprila in VS Code tramite File > Apri cartella, quindi avvia Claude Code e chiedigli di creare una semplice pagina web. In 30 secondi vedrai Claude scrivere codice per te.

Ecco come procedere:

  1. Fai clic destro sul tuo Desktop Windows
  2. Seleziona "Nuovo > Cartella"
  3. Nomina la cartella "mio-primo-progetto-claude"
  4. In VS Code, clicca su "File" nel menu in alto
  5. Seleziona "Apri cartella..."
  6. Naviga fino al tuo Desktop e seleziona la cartella che hai appena creato
  7. Clicca su "Seleziona cartella"
  8. VS Code potrebbe chiederti se ti fidi degli autori: clicca su "Sì, mi fido"
  9. Ora clicca sull'icona Claude nella barra laterale sinistra
  10. Nella casella di testo in basso, digita: "Crea una semplice pagina web che visualizzi Ciao mondo in un grande titolo"
  11. Premi Invio

Claude allora:

  • Creerà automaticamente un file index.html nella tua cartella
  • Scriverà il codice HTML necessario
  • Ti mostrerà ogni passaggio di ciò che sta facendo
  • Ti proporrà di visualizzare l'anteprima del risultato

Per vedere la tua pagina web, fai clic destro sul file index.html nell'explorer dei file a sinistra, quindi seleziona "Mostra in Esplora file". Fai doppio clic sul file: si aprirà nel tuo browser.

Questo primo test ti mostra la potenza di Claude Code: descrivi quello che vuoi in italiano normale e Claude scrive il codice tecnico per te. È esattamente questo principio che insegniamo su Skilzy, dove impari a creare applicazioni complete senza scrivere una riga di codice tu stesso.

Se vuoi andare oltre, scopri i 20 comandi essenziali che puoi dare a Claude Code per creare progetti più complessi.

Quali sono i problemi comuni e le loro soluzioni?

I tre errori più frequenti sono: chiave API non valida, problema di connessione internet e conflitto con l'antivirus. Ognuno si risolve in pochi minuti.

Errore: "Invalid API Key"

Se vedi questo messaggio, la tua chiave API non è configurata correttamente. Soluzioni:

  • Verifica di aver copiato la chiave completa (deve iniziare con "sk-ant-")
  • Assicurati di non aver aggiunto spazi all'inizio o alla fine
  • Torna su console.anthropic.com e genera una nuova chiave se necessario
  • In VS Code, clicca sull'icona dell'ingranaggio in basso a sinistra > Impostazioni > Estensioni > Claude Code > Modifica chiave API

Errore: "Connection timeout"

Claude Code non riesce a raggiungere i server di Anthropic. Verifica:

  • La tua connessione internet funziona (apri un sito web per testare)
  • Il tuo firewall Windows non è troppo restrittivo (Impostazioni > Aggiornamento e sicurezza > Sicurezza Windows > Firewall)
  • Aggiungi un'eccezione per VS Code se necessario
  • Se sei su una rete aziendale, potrebbe bloccare l'accesso all'API

VS Code non si avvia dopo l'installazione

Rari casi in cui VS Code si rifiuta di avviarsi:

  • Riavvia il tuo computer (risolve l'80% dei problemi)
  • Disinstalla VS Code tramite Impostazioni > App > Visual Studio Code > Disinstalla
  • Scarica l'ultima versione dal sito ufficiale
  • Reinstalla come amministratore (clic destro sull'installer > Esegui come amministratore)

L'estensione Claude Code non appare

Se non vedi l'icona Claude dopo l'installazione:

  • Chiudi completamente VS Code (File > Esci)
  • Riapri VS Code
  • Vai in Estensioni e verifica che Claude Code sia nella lista "Installate"
  • Clicca sulla piccola icona di ricaricamento accanto all'estensione se appare
  • Come ultimo ricorso, disinstalla e reinstalla l'estensione

La comunità Claude Code su Discord e i forum di Anthropic sono anche eccellenti risorse se incontri un problema specifico. Puoi anche confrontare con Cursor, un'alternativa che funziona diversamente e potrebbe essere più adatta a alcune configurazioni Windows.

Conclusione

Ora hai Claude Code operativo sul tuo PC Windows. L'installazione completa ti ha richiesto meno di 15 minuti: Visual Studio Code come base, l'estensione Claude Code per l'interfaccia, la tua chiave API per l'accesso all'intelligenza artificiale e il tuo primo progetto per testare che tutto funzioni. Il passo successivo è esplorare cosa puoi creare con questo strumento: siti web, applicazioni, automazioni. Inizia con progetti semplici e aumenta gradualmente la complessità. Claude Code impara dalle tue richieste e migliora nel corso delle conversazioni.

Su Skilzy, ti mostriamo come trasformare questa installazione in una competenza professionale. Il nostro metodo di apprendimento ti guida passo dopo passo per creare vere applicazioni, anche se oggi non sai fare la differenza tra HTML e CSS. Consulta il nostro tutorial completo per principianti per scoprire tutto quello che puoi realizzare con Claude Code.