Come installare Claude Code e Codex CLI su Windows

I comandi esatti di PowerShell, CMD, WinGet e npm per installare Claude Code e Codex CLI su Windows 10 e 11, quando scegliere WSL e come correggere «claude non è riconosciuto» e gli altri errori che incontrerai.

Oggi entrambe le CLI si installano su Windows con una sola riga. Quasi tutti i problemi arrivano dopo quella riga: un terminale che non trova il comando, dei criteri di esecuzione che bloccano npm, una vecchia distribuzione WSL 1, un comando incollato nella shell sbagliata. Questa guida dà i comandi esatti di ogni metodo di installazione, poi gli errori e le relative soluzioni.

Quello che si dice delle due CLI viene dalla documentazione di Anthropic e di OpenAI e dagli script di installazione stessi, letti il 16 novembre 2026, con Claude Code 2.1.318 e Codex CLI 0.169.0. Entrambi gli strumenti cambiano in fretta: se un comando qui sotto fallisce, controlla la pagina ufficiale collegata in ogni sezione.

La risposta breve. Apri PowerShell, non CMD, ed esegui:

irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Poi apri un nuovo terminale ed esegui claude --version e codex --version. Se Windows risponde che claude non è riconosciuto, la correzione del PATH è nella tabella degli errori, più in basso.

Cosa richiede ogni CLI su Windows

Claude CodeCodex CLI
Versione di WindowsWindows 10 1809 o successivo, Windows Server 2019 o successivoWindows 11 consigliato, Windows 10 recente senza garanzie («best effort»)
Processorex64 o ARM64, mai 32 bitx64 o ARM64
AccountUn piano Claude a pagamento o un account ConsoleUn piano ChatGPT o una chiave API di OpenAI
Node.jsSolo per il metodo npm, versione 22 o successivaSolo per il metodo npm
Git for WindowsFacoltativoNon necessario
Sandbox su Windows nativoNo, solo in WSL 2Sì, la sua sandbox Windows
Diritti di amministratore per installareNoNo

Due righe di questa tabella sorprendono. Claude Code non richiede più Git for Windows: senza, usa PowerShell come strumento shell. E Codex isola i suoi comandi in una sandbox su Windows nativo, mentre Claude Code lo fa solo dentro WSL 2.

Installare Claude Code su Windows

La pagina di installazione di Anthropic elenca quattro metodi. L'installer nativo è quello consigliato: non richiede Node.js e si aggiorna da solo in background.

MetodoComando
PowerShell (consigliato)irm https://claude.ai/install.ps1 | iex
CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGetwinget install Anthropic.ClaudeCode
npm (Node.js 22+)npm install -g @anthropic-ai/claude-code@latest

Cosa lascia ogni metodo:

  • Installer nativo: claude.exe in %USERPROFILE%\.local\bin, le versioni in %USERPROFILE%\.local\share\claude. L'installer ti avvisa quando .local\bin non è nel tuo PATH, e non lo aggiunge al posto tuo.
  • WinGet: niente aggiornamenti automatici. Aggiorni con winget upgrade Anthropic.ClaudeCode, e Anthropic avverte che un aggiornamento può fallire mentre Claude Code è in esecuzione, perché Windows blocca l'eseguibile.
  • npm: con un Node.js precedente alla 22, l'installazione termina con un avviso EBADENGINE.

Per restare una versione indietro rispetto all'ultima, sul canale stabile:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Poi verifica l'installazione. claude --version mostra la versione, e claude doctor esegue una diagnosi in sola lettura dell'installazione e delle sue impostazioni.

Se hai Git for Windows, Claude Code cerca Git Bash in C:\Program Files\Git, poi in C:\Program Files (x86)\Git, poi il git del tuo PATH. Per imporne un altro, imposta CLAUDE_CODE_GIT_BASH_PATH nel blocco env del tuo settings.json. Deve puntare a un file chiamato bash.exe o sh.exe, non git-bash.exe.

Installare Codex CLI su Windows

La pagina Windows di OpenAI è chiara: usa Codex in modo nativo con la sua sandbox Windows come impostazione predefinita, e scegli WSL quando i tuoi strumenti vivono già su Linux. Una fonte è rimasta indietro: la pagina di installazione del repository GitHub dice ancora «Windows 11 via WSL2». La documentazione ufficiale è cambiata, e l'installer anche.

MetodoComando
Installer PowerShellpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm install -g @openai/codex

L'installer PowerShell è il più semplice. Leggendo lo script si vede cosa fa: installa Codex in %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, aggiunge quella cartella al PATH del tuo utente e alla sessione corrente, e ti dice di aprire una nuova finestra di PowerShell. Rieseguire lo stesso comando aggiorna Codex. Con npm, aggiorni rieseguendo il comando di installazione.

Poi accedi. Esegui codex e scegli Sign in with ChatGPT, oppure esegui codex login. Su una macchina senza browser, codex login --device-auth ti dà un codice da digitare su un altro dispositivo. codex login status ti dice con quale account hai effettuato l'accesso.

La sandbox di Windows

Codex ha tre implementazioni della sandbox su Windows:

  • mxc: quella consigliata, senza configurazione da amministratore. Richiede Windows 11 24H2 (build 26100.9278) o 25H2 (build 26200.9278).
  • elevated: il ripiego preferito. Richiede una configurazione una tantum approvata da un amministratore.
  • unelevated: un isolamento di rete più debole, e nessun percorso in sola lettura.

La scelta si fa in config.toml:

[features]
prefer_mxc = true

[windows]
sandbox = "elevated" # or "unelevated"

Se la sandbox fallisce con l'errore 1385, Windows ha rifiutato il tipo di accesso dell'account della sandbox. In quel caso OpenAI chiede CODEX_HOME/.sandbox/sandbox.log. Non condividere mai il contenuto di .sandbox-secrets/.

Windows nativo o WSL?

Nativo (PowerShell, CMD)WSL 2
Installare Claude Codeirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.sh | bash dentro WSL
Installare Codexl'installer PowerShellcurl -fsSL https://chatgpt.com/codex/install.sh | sh dentro WSL
Sandbox di Claude Codenon disponibiledisponibile, con bubblewrap e socat
Sandbox di Codexla sandbox Windowsla sandbox Linux
Dove tenere il repositoryovunquesotto ~/, non sotto /mnt/c/

Scegli WSL 2 quando il tuo progetto si compila e gira comunque su Linux, o quando vuoi che Claude Code isoli in una sandbox i comandi che esegue. Resta sul nativo quando il tuo progetto è un progetto Windows: .NET, script PowerShell, percorsi Windows ovunque.

Tre regole se scegli WSL:

  1. WSL 2, mai WSL 1. Codex non supporta più WSL 1 dalla versione 0.115. La sandbox di Claude Code rifiuta WSL 1 con Sandboxing requires WSL2, e le installazioni su WSL 1 possono fallire con Exec format error. Converti una distribuzione con wsl --set-version <DistroName> 2.
  2. Installa ed esegui dentro WSL. Esegui il comando Linux nel terminale WSL, non in quello di PowerShell. È il Node.js di Windows lanciato da WSL a produrre exec: node: not found: installa Node.js nella distribuzione stessa, con il suo gestore di pacchetti o con nvm.
  3. Tieni il codice nel file system Linux. Entrambi i fornitori ti dicono di tenere il repository fuori da /mnt/c/, e Anthropic fa notare che lì le ricerche di Claude Code sono meno complete. Clonalo nella tua home Linux.

«claude non è riconosciuto» e gli altri errori

Cosa vediPerchéSoluzione
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell)%USERPROFILE%\.local\bin non è nel tuo PATHAggiungerlo al PATH dell'utente (comandi più in basso), poi aprire un nuovo terminale
Ancora non riconosciuto dopo averlo aggiuntoIl terminale, o l'editor che lo contiene, è partito prima della modificaChiudere e riaprire il terminale, e l'editor se il terminale vive al suo interno
Non riconosciuto subito dopo un aggiornamentoUn aggiornamento interrotto a metà sostituzione non ha lasciato nessun claude.exeRinominare il claude.exe.old.* più recente in claude.exe (comando più in basso)
'irm' is not recognizedHai incollato la riga PowerShell in CMDAprire PowerShell, o usare la riga CMD
The token '&&' is not a valid statement separatorHai incollato la riga CMD in Windows PowerShellUsare la riga PowerShell
npm.ps1 cannot be loaded because running scripts is disabled on this systemI criteri di esecuzione bloccano il lanciatore PowerShell di npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, oppure chiamare npm.cmd
Un errore su Windows a 32 bit su un PC a 64 bitHai aperto «Windows PowerShell (x86)» dal menu StartAprire il normale PowerShell a 64 bit
claude apre l'app desktop invece della CLIUna vecchia app desktop di Claude ha messo un Claude.exe in WindowsApps, davanti alla CLI nel PATHAggiornare l'app desktop di Claude
requires either Git for Windows (for bash) or PowerShellClaude Code non ha trovato nessuna delle due shellInstallare Git for Windows, o verificare che PowerShell sia nel PATH
EBADENGINE durante npm installNode.js è precedente alla 22Aggiornare Node.js, o usare l'installer nativo

La correzione del PATH, in PowerShell, per l'utente corrente, senza diritti di amministratore:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Per vedere dove cerca Windows prima di cambiare qualsiasi cosa:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude

La ridenominazione dopo un aggiornamento andato male:

Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

Sui criteri di esecuzione: Windows PowerShell 5.1, quello incluso in Windows, è impostato di default su Restricted sui PC client, ed è per questo che un portatile nuovo blocca npm.ps1. L'ambito CurrentUser non richiede diritti di amministratore. L'installer nativo di Claude e quello di Codex non sono coinvolti: irm | iex e -ExecutionPolicy ByPass non caricano mai un file di script dal disco.

Aggiornare e disinstallare

Claude CodeCodex CLI
Aggiornare subitoclaude update (nativo), winget upgrade Anthropic.ClaudeCode, o rieseguire l'installazione npmcodex update sulle versioni che lo supportano, rieseguire l'installer PowerShell, o npm install -g @openai/codex
Aggiornamenti automaticisolo con l'installazione nativa, disattivabili con DISABLE_AUTOUPDATER=1non documentati
Disinstallareeliminare %USERPROFILE%\.local\bin\claude.exe e %USERPROFILE%\.local\share\claude, oppure winget uninstall Anthropic.ClaudeCode, oppure npm uninstall -g @anthropic-ai/claude-codeeliminare la cartella di installazione, oppure npm uninstall -g @openai/codex
Impostazioni che restano sul disco%USERPROFILE%\.claude e %USERPROFILE%\.claude.json%USERPROFILE%\.codex

Cosa abbiamo imparato facendo girare CLI di agenti su Windows

AgentsRoom lancia Claude Code, Codex e le altre CLI di agenti fianco a fianco, e la sua versione Windows ci ha insegnato dove queste installazioni si rompono appena escono dal terminale. Quattro cose meritano di essere conosciute, anche se non usi mai la nostra app.

Un programma avviato dal menu Start conserva il PATH con cui è partito. Installi Claude Code, aggiungi .local\bin al PATH, e un'app desktop già aperta continua a non trovare claude. Riavviare il terminale non basta per le app che lanciano le CLI al posto tuo. AgentsRoom rilegge il PATH dell'utente e della macchina dal registro di sistema quando cerca una CLI, così un'installazione appena riuscita non viene segnalata come mancante.

npm non installa un .exe. npm install -g @openai/codex scrive tre file in %APPDATA%\npm: codex, codex.cmd e codex.ps1. Un programma che lancia codex direttamente riceve spawn codex ENOENT, perché Windows aggiunge solo .exe a un nome senza estensione. Il tuo terminale te lo nasconde, dato che PowerShell e CMD leggono PATHEXT. È un motivo in più per preferire gli installer nativi, che installano davvero un eseguibile.

I lanciatori di npm hanno bisogno di Node.js al momento dell'esecuzione. Se installi Node.js e poi una CLI nella stessa sessione, il lanciatore .cmd viene trovato ma fallisce con «node is not recognized» in qualsiasi programma avviato prima che Node.js fosse nel PATH. Stesso sintomo con un gestore di versioni di Node i cui lanciatori puntano a una versione non attiva.

Avviare un processo costa molto di più su Windows. Abbiamo misurato da 20 a 80 ms per creare un processo su Windows, contro 1 a 3 ms su macOS, e ogni controllo su un file costa di più perché l'antivirus lo ispeziona. Il nostro primo rilevamento delle CLI provava ogni cartella, ogni nome e ogni estensione, e bloccava l'app fino a un secondo su Windows. Leggere ogni cartella una sola volta ha risolto il problema.

Nell'app, l'assistente di installazione installa una CLI mancante con l'installer del fornitore per il tuo sistema (irm https://claude.ai/install.ps1 | iex per Claude Code, lo script di OpenAI per Codex), ripiega su npm quando lo script fallisce, e lo esegue in un terminale che puoi seguire. Quando una CLI non si avvia, CLI Doctor legge l'errore e il comando esatto, poi ti dice cosa si è rotto. Quando entrambe le CLI rispondono a --version, la guida per iniziare prende il testimone, e l'annuncio della versione Windows spiega cosa fa l'app su Windows.

Domande frequenti

Come installo Claude Code su Windows?

Apri PowerShell ed esegui irm https://claude.ai/install.ps1 | iex. In CMD usa invece la riga install.cmd della pagina di installazione di Anthropic, e con WinGet esegui winget install Anthropic.ClaudeCode. Il binario finisce in %USERPROFILE%\.local\bin, che l'installer non aggiunge al tuo PATH: aggiungilo tu se claude non è riconosciuto, poi apri un nuovo terminale ed esegui claude --version.

Serve WSL per usare Claude Code o Codex su Windows?

No. Entrambi girano in modo nativo in PowerShell o CMD su Windows 10 e 11. WSL 2 conviene quando il tuo progetto vive già su Linux, o quando vuoi la sandbox di Claude Code, che non gira su Windows nativo. Usa WSL 2, non WSL 1: Codex ha abbandonato WSL 1 con la versione 0.115.

Perché Windows dice che 'claude' non è riconosciuto subito dopo l'installazione?

L'installer nativo mette claude.exe in %USERPROFILE%\.local\bin e mostra un avviso se quella cartella non è nel tuo PATH, ma non modifica il PATH da solo. Aggiungi la cartella al PATH del tuo utente, poi chiudi e riapri il terminale, e anche l'editor se il terminale gira al suo interno. Un terminale già aperto conserva il suo vecchio PATH.

Claude Code ha bisogno di Git for Windows?

Non più. La pagina di installazione di Anthropic indica Git for Windows come facoltativo: senza, Claude Code usa PowerShell come strumento shell. Con Git for Windows, Claude Code trova Git Bash in C:\Program Files\Git, e puoi indicare un altro bash.exe con l'impostazione CLAUDE_CODE_GIT_BASH_PATH.

Posso installare Codex CLI su Windows senza Node.js?

Sì. L'installer PowerShell di OpenAI scarica un Codex autonomo, lo mette in %LOCALAPPDATA%\Programs\OpenAI\Codex\bin e aggiunge quella cartella al PATH del tuo utente. Solo il metodo npm, npm install -g @openai/codex, richiede Node.js.

PowerShell o CMD per installarli?

PowerShell. I due comandi ufficiali su una riga sono comandi PowerShell, e gli errori più frequenti nascono da una riga PowerShell incollata in CMD o viceversa: 'irm' is not recognized (o «'irm' non è riconosciuto» su un Windows in italiano) significa che sei in CMD, e '&&' is not a valid statement separator significa che sei in PowerShell. Usa PowerShell a 64 bit, non la voce «Windows PowerShell (x86)» del menu Start.

Ingegnere DevOpsCopywriterSviluppatore FrontendCommercialeSviluppatore BackendCoach e FormatoreArchitetto SoftwareConsulente LegaleIngegnere QAAmministrazione e FinanzaSviluppatore Full-StackDesigner CreativoSviluppatore MobileRicercatoreIngegnere di SicurezzaRisorse Umane e Selezione
Project ManagerTraduttoreEsperto GitData AnalystSpecialista SEOContabileSpecialista LocalizzazioneComunicazione e PRBrainstormerOperations e LogisticaSpecialista MarketingAssistenza ClientiAssistente del progettoBuyerCommunity ManagerAssistente Personale

Scarica AgentsRoom

Esegui tutti i tuoi agenti AI, su tutti i tuoi progetti, da una sola finestra.

Scarica AgentsRoomGratis

App companion: monitora i tuoi agenti in movimento

Usa Claude, Codex, Antigravity CLI o un altro provider IA.

Installa l'estensione
Chrome Web Store

Invia bug e richieste direttamente nel tuo backlog pubblico.

Agenti che leggi come una conversazione

Ogni agente ha un ruolo, una faccia e un thread che leggi come un'app di messaggistica.

Vista conversazione

Vista conversazione di AgentsRoom: il lavoro di un agente AI di coding mostrato come chat
Multi-progetto
Multi-provider
Multi-agente
Stato in tempo reale
Diff e commit
App mobile
Anteprima live
Team di agenti
Test browser
Dev guidata da backlog
Libreria di prompt
Libreria di skill
Vedi tutte le funzionalità

Continua a leggere