Questa pagina ti accompagna passo passo. Non do nulla per scontato: ti spiego cos’è Git, cos’è PowerShell, quale account aprire, cosa installare, cosa cliccare, cosa incollare e come verificare che tutto funzioni davvero. Ogni comando ha il suo pulsante Copia.
Prima di installare qualsiasi cosa, chiarisco le parole che incontrerai. Così non ti senti perso mentre segui la procedura.
È un assistente AI per programmare. Funziona soprattutto nel terminale: può leggere il tuo progetto, spiegarti i file, proporti modifiche, creare codice e lanciare comandi, chiedendoti conferma quando serve.
Git è uno strumento che serve a tenere traccia delle modifiche nei progetti. Su Windows, Claude Code usa Git internamente. Per iniziare non devi studiarlo: adesso ti basta solo installarlo.
PowerShell è la finestra di comando di Windows dove scrivi i comandi. È simile al Prompt dei comandi, ma più potente. Noi useremo PowerShell perché la procedura consigliata per Claude Code parte da lì.
Se sei da solo e vuoi la strada più semplice, crea un account Claude e usa un piano Pro o Max. Il piano Free non basta per usare Claude Code. Le alternative come Console, Team o Enterprise esistono, ma non sono la scelta più semplice per un principiante.
Per un principiante su Windows consiglio questa sequenza: account Claude → Git for Windows → PowerShell → installazione nativa ufficiale → login → primo test in una cartella vuota. È il percorso più lineare e con meno complicazioni.
Segui questi passaggi in ordine. Non saltare niente la prima volta.
Per usare Claude Code come utente singolo, la strada più semplice è partire da Claude. Il piano Free non include Claude Code, quindi devi usare almeno un piano adatto come Pro o Max.
Se fai login con un account Free, Claude Code può non funzionare oppure può chiederti di fare upgrade.
Su Windows, Claude Code ha bisogno di Git for Windows. Tu non devi imparare Git adesso: devi solo installarlo.
Se non sai se Git è già installato, installarlo di nuovo di solito non crea problemi.
Adesso devi aprire la finestra dove scriverai i comandi. Noi useremo PowerShell.
Se all’inizio della riga vedi qualcosa come PS C:\Users\TuoNome>, sei nel posto giusto. Se non vedi PS, probabilmente sei nel Prompt dei comandi.
Non serve avviare PowerShell come amministratore per questa installazione standard.
Questo è il metodo ufficiale consigliato su Windows da PowerShell. Copia il comando, incollalo in PowerShell e premi Invio.
irm https://claude.ai/install.ps1 | iexCon l’installazione nativa, gli aggiornamenti sono automatici in background. È uno dei motivi per cui questo metodo è il più semplice.
Funziona, ma non è il metodo più semplice per un principiante e non si aggiorna da solo.
winget install Anthropic.ClaudeCodeDopo l’installazione, chiudi la finestra di PowerShell e riaprila. Questo serve a far riconoscere il nuovo comando claude.
claude --versionclaude doctorSe vedi una versione con numeri e claude doctor non segnala problemi gravi, l’installazione è andata bene.
Ora lancia Claude Code. Al primo avvio si occupa lui di aprire il browser per completare il login.
claudeNella finestra di Claude Code premi semplicemente il tasto c. Claude Code copierà negli appunti il link di accesso. Incollalo nel browser e completa il login.
claude auth status --textclaude auth loginclaude auth logoutDentro Claude Code lavori scrivendo testo. Non devi cliccare su pulsanti. Scrivi una richiesta e premi Invio.
/helpClaude Code normalmente ti chiede conferma prima di modificare file o eseguire comandi. Questo aiuta a lavorare con più tranquillità.
Adesso facciamo un test semplice e reale: una cartella vuota sul Desktop e una piccola pagina web creata da Claude Code.
Apri PowerShell e incolla i comandi qui sotto, uno alla volta oppure tutti insieme. Questo creerà una cartella sul Desktop dove faremo il primo test.
cd $HOME\Desktopmkdir claude-primo-testcd claude-primo-testclaudeQuando Claude Code è aperto dentro la cartella di test, scrivi una richiesta semplice in italiano. Per esempio:
Crea una pagina index.html semplice ed elegante in italiano, con un titolo, un paragrafo e un pulsante.Apri la cartella in Esplora file e fai doppio clic su index.html per vedere la pagina nel browser.
start .Dopo il primo test, prova a chiedere a Claude Code di migliorare la pagina appena creata. In questo modo vedi come propone modifiche e come ti chiede l’approvazione.
Rendi la pagina più moderna con colori, ombre morbide e un layout centrato.Spiegami quali file hai creato e cosa fa ognuno di essi.Qui trovi i problemi più frequenti quando si parte da zero su Windows.
Succede spesso se non hai chiuso e riaperto PowerShell dopo l’installazione, oppure se la cartella del comando non è nel PATH.
$env:PATH -split ";" | Select-String "local\\bin"Se non vedi nessun risultato, aggiungi il percorso al PATH utente:
$currentPath = [Environment]::GetEnvironmentVariable("PATH", "User")
[Environment]::SetEnvironmentVariable("PATH", "$currentPath;$env:USERPROFILE\.local\bin", "User")claude --versionA volte su Windows Claude Code non riesce a capire da solo dove si trova Git Bash. In quel caso devi dirglielo in un file di configurazione.
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}Poi chiudi e riapri PowerShell e riprova.
È un problema semplice da aggirare.
Le cause più comuni sono queste:
Prova così:
claude auth logoutclaude auth loginSe ancora non funziona, controlla che il tuo piano sia davvero uno tra quelli supportati da Claude Code.
In ambienti aziendali può capitare che il download venga bloccato. Prima verifica se la rete riesce a raggiungere il server di download.
curl -sI https://storage.googleapis.comSe non funziona, probabilmente la rete o il proxy sta bloccando il download. In un PC aziendale conviene chiedere al reparto IT.
Se hai provato sia l’installer nativo sia WinGet sia altri metodi, può nascere confusione tra versioni diverse. Per un principiante è meglio tenere un solo metodo di installazione.
where.exe claudeMetti la spunta a ogni punto. La pagina salva le spunte nel browser.
Questi sono i riferimenti ufficiali da cui deriva la procedura di questa pagina.