Zo installeer je Claude Code en Codex CLI op Windows

De exacte PowerShell-, CMD-, WinGet- en npm-commando's om Claude Code en Codex CLI te installeren op Windows 10 en 11, wanneer je voor WSL kiest, en hoe je “claude wordt niet herkend” en de andere fouten oplost die je tegenkomt.

Beide CLI's installeer je op Windows tegenwoordig met één regel. De meeste problemen komen pas na die regel: een terminal die het commando niet vindt, een uitvoeringsbeleid dat npm blokkeert, een oude WSL 1-distributie, een commando dat in de verkeerde shell is geplakt. Deze gids geeft de exacte commando's voor elke installatieroute, daarna de fouten en hoe je ze oplost.

De feiten over de twee CLI's komen uit de documentatie van Anthropic en OpenAI en uit de installatiescripts zelf, gelezen op 16 november 2026, met Claude Code 2.1.318 en Codex CLI 0.169.0. Beide tools veranderen snel: als een commando hieronder mislukt, kijk dan op de officiële pagina die in elke sectie gelinkt staat.

Het korte antwoord. Open PowerShell, niet CMD, en voer uit:

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

Open daarna een nieuwe terminal en voer claude --version en codex --version uit. Als Windows antwoordt dat claude niet wordt herkend, staat de oplossing voor het PATH verderop in de tabel met fouten.

Wat elke CLI op Windows nodig heeft

Claude CodeCodex CLI
Windows-versieWindows 10 1809 of nieuwer, Windows Server 2019 of nieuwerWindows 11 aanbevolen, recente Windows 10 op basis van “best effort”
Processorx64 of ARM64, nooit 32-bitsx64 of ARM64
AccountEen betaald Claude-abonnement of een Console-accountEen ChatGPT-abonnement of een OpenAI API-sleutel
Node.jsAlleen voor de npm-route, versie 22 of nieuwerAlleen voor de npm-route
Git for WindowsOptioneelNiet nodig
Sandbox op native WindowsNee, alleen in WSL 2Ja, een eigen Windows-sandbox
Beheerdersrechten om te installerenNeeNee

Twee regels in deze tabel verrassen mensen. Claude Code vereist Git for Windows niet meer: zonder Git gebruikt het PowerShell als shell-tool. En Codex voert commando's op native Windows uit in een sandbox, terwijl Claude Code dat alleen binnen WSL 2 doet.

Claude Code installeren op Windows

De installatiepagina van Anthropic noemt vier routes. De native installer is de aanbevolen route: hij heeft geen Node.js nodig en werkt zichzelf op de achtergrond bij.

RouteCommando
PowerShell (aanbevolen)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

Wat elke route achterlaat:

  • Native installer: claude.exe in %USERPROFILE%\.local\bin, de versies in %USERPROFILE%\.local\share\claude. De installer waarschuwt je als .local\bin niet in je PATH staat, en voegt de map niet voor je toe.
  • WinGet: geen automatische updates. Je werkt bij met winget upgrade Anthropic.ClaudeCode, en Anthropic merkt op dat een update kan mislukken terwijl Claude Code draait, omdat Windows het uitvoerbare bestand vergrendelt.
  • npm: met een Node.js ouder dan 22 eindigt de installatie met een EBADENGINE-waarschuwing.

Om één release achter de nieuwste te blijven, op het stabiele kanaal:

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

Controleer daarna de installatie. claude --version toont de versie, en claude doctor voert een alleen-lezen diagnose uit van de installatie en de instellingen.

Als je Git for Windows hebt, zoekt Claude Code Git Bash in C:\Program Files\Git, dan in C:\Program Files (x86)\Git, dan via de git in je PATH. Om een andere af te dwingen, stel je CLAUDE_CODE_GIT_BASH_PATH in het env-blok van je settings.json in. Die moet verwijzen naar een bestand met de naam bash.exe of sh.exe, niet git-bash.exe.

Codex CLI installeren op Windows

De Windows-pagina van OpenAI is duidelijk: gebruik Codex standaard native met zijn Windows-sandbox, en kies WSL als je tooling al onder Linux leeft. Eén bron loopt achter: de installatiepagina van de GitHub-repository zegt nog steeds “Windows 11 via WSL2”. De officiële documentatie is verder, en de installer ook.

RouteCommando
PowerShell-installerpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm install -g @openai/codex

De PowerShell-installer is de makkelijke route. Wie het script leest, ziet wat het doet: het installeert Codex in %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, voegt die map toe aan het PATH van je gebruiker en aan de huidige sessie, en vraagt je een nieuw PowerShell-venster te openen. Hetzelfde commando opnieuw uitvoeren werkt Codex bij. Met npm werk je bij door het installatiecommando opnieuw uit te voeren.

Log daarna in. Voer codex uit en kies Sign in with ChatGPT, of voer codex login uit. Op een machine zonder browser geeft codex login --device-auth je een code die je op een ander apparaat intypt. codex login status vertelt je met welk account je bent ingelogd.

De Windows-sandbox

Codex heeft op Windows drie sandbox-implementaties:

  • mxc: de aanbevolen variant, zonder configuratie door een beheerder. Vereist Windows 11 24H2 (build 26100.9278) of 25H2 (build 26200.9278).
  • elevated: de voorkeursterugval. Vereist een eenmalige configuratie die een beheerder goedkeurt.
  • unelevated: zwakkere netwerkisolatie, en geen alleen-lezen paden.

Je kiest in config.toml:

[features]
prefer_mxc = true

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

Als de sandbox mislukt met fout 1385, heeft Windows het aanmeldingstype van het sandbox-account geweigerd. OpenAI vraagt in dat geval om CODEX_HOME/.sandbox/sandbox.log. Deel nooit wat er in .sandbox-secrets/ staat.

Native Windows of WSL?

Native (PowerShell, CMD)WSL 2
Claude Code installerenirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.sh | bash binnen WSL
Codex installerende PowerShell-installercurl -fsSL https://chatgpt.com/codex/install.sh | sh binnen WSL
Sandbox van Claude Codeniet beschikbaarbeschikbaar, met bubblewrap en socat
Sandbox van Codexde Windows-sandboxde Linux-sandbox
Waar je de repository bewaartoveralonder ~/, niet onder /mnt/c/

Kies WSL 2 als je project toch al onder Linux wordt gebouwd en draait, of als je wilt dat Claude Code de commando's die het uitvoert in een sandbox isoleert. Blijf native als je project een Windows-project is: .NET, PowerShell-scripts, overal Windows-paden.

Drie regels als je voor WSL kiest:

  1. WSL 2, nooit WSL 1. Codex ondersteunt WSL 1 niet meer sinds versie 0.115. De sandbox van Claude Code weigert WSL 1 met Sandboxing requires WSL2, en installaties op WSL 1 kunnen mislukken met Exec format error. Zet een distributie om met wsl --set-version <DistroName> 2.
  2. Installeer en draai binnen WSL. Voer het Linux-commando uit in de WSL-terminal, niet in PowerShell. Wie de Windows-versie van Node.js vanuit WSL aanroept, krijgt exec: node: not found: installeer Node.js in de distributie zelf, met de pakketbeheerder ervan of met nvm.
  3. Houd de code in het Linux-bestandssysteem. Beide makers raden aan de repository buiten /mnt/c/ te houden, en Anthropic merkt op dat de zoekopdrachten van Claude Code daar minder volledig zijn. Clone hem in je Linux-thuismap.

“claude wordt niet herkend” en de andere fouten

Wat je zietWaaromOplossing
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell)%USERPROFILE%\.local\bin staat niet in je PATHToevoegen aan het PATH van de gebruiker (commando's hieronder), daarna een nieuwe terminal openen
Nog steeds niet herkend na het toevoegenDe terminal, of de editor eromheen, is gestart vóór de wijzigingDe terminal sluiten en opnieuw openen, en ook de editor als de terminal daarin draait
Niet herkend direct na een updateEen update die halverwege het verwisselen werd onderbroken, heeft geen claude.exe achtergelatenDe nieuwste claude.exe.old.* terug hernoemen naar claude.exe (commando hieronder)
'irm' is not recognizedJe hebt de PowerShell-regel in CMD geplaktPowerShell openen, of de CMD-regel gebruiken
The token '&&' is not a valid statement separatorJe hebt de CMD-regel in Windows PowerShell geplaktDe PowerShell-regel gebruiken
npm.ps1 cannot be loaded because running scripts is disabled on this systemHet uitvoeringsbeleid blokkeert de PowerShell-shim van npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, of npm.cmd aanroepen
Een fout over 32-bits Windows op een 64-bits pcJe hebt “Windows PowerShell (x86)” geopend vanuit het StartmenuDe gewone 64-bits PowerShell openen
claude opent de desktop-app in plaats van de CLIEen oude Claude-desktop-app heeft een Claude.exe in WindowsApps gezet, vóór de CLI in het PATHDe Claude-desktop-app bijwerken
requires either Git for Windows (for bash) or PowerShellClaude Code heeft geen van beide shells gevondenGit for Windows installeren, of controleren of PowerShell in het PATH staat
EBADENGINE tijdens npm installNode.js is ouder dan 22Node.js bijwerken, of de native installer gebruiken

De oplossing voor het PATH, in PowerShell, voor de huidige gebruiker, zonder beheerdersrechten:

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

Om te controleren waar Windows zoekt voordat je iets wijzigt:

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

Het hernoemen na een mislukte update:

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

Over het uitvoeringsbeleid: Windows PowerShell 5.1, de versie die met Windows wordt meegeleverd, staat op client-pc's standaard op Restricted, en daarom blokkeert een nieuwe laptop npm.ps1. Het bereik CurrentUser heeft geen beheerdersrechten nodig. De native Claude-installer en de Codex-installer hebben hier geen last van: irm | iex en -ExecutionPolicy ByPass laden nooit een scriptbestand van schijf.

Bijwerken en verwijderen

Claude CodeCodex CLI
Nu bijwerkenclaude update (native), winget upgrade Anthropic.ClaudeCode, of de npm-installatie opnieuwcodex update in releases die het ondersteunen, de PowerShell-installer opnieuw, of npm install -g @openai/codex
Automatische updatesalleen bij de native installatie, uit te zetten met DISABLE_AUTOUPDATER=1niet gedocumenteerd
Verwijderen%USERPROFILE%\.local\bin\claude.exe en %USERPROFILE%\.local\share\claude wissen, of winget uninstall Anthropic.ClaudeCode, of npm uninstall -g @anthropic-ai/claude-codede installatiemap wissen, of npm uninstall -g @openai/codex
Achtergebleven instellingen%USERPROFILE%\.claude en %USERPROFILE%\.claude.json%USERPROFILE%\.codex

Wat we leerden door agent-CLI's op Windows te draaien

AgentsRoom start Claude Code, Codex en de andere agent-CLI's naast elkaar, en de Windows-versie ervan leerde ons waar deze installaties breken zodra ze de terminal verlaten. Vier dingen zijn het weten waard, ook als je onze app nooit gebruikt.

Een programma dat vanuit het Startmenu is gestart, houdt het PATH waarmee het startte. Je installeert Claude Code, voegt .local\bin toe aan het PATH, en een desktop-app die al open stond, vindt claude nog steeds niet. Je terminal herstarten is niet genoeg voor apps die CLI's voor je starten. AgentsRoom leest het PATH van de gebruiker en van de machine opnieuw uit het register wanneer het een CLI zoekt, zodat een installatie die net is gelukt niet als ontbrekend wordt gemeld.

npm installeert geen .exe. npm install -g @openai/codex schrijft drie bestanden naar %APPDATA%\npm: codex, codex.cmd en codex.ps1. Een programma dat codex rechtstreeks start, krijgt spawn codex ENOENT, omdat Windows alleen .exe aan een kale naam toevoegt. Je terminal verbergt dit, omdat PowerShell en CMD PATHEXT lezen. Nog een reden om de native installers te verkiezen, die wel een uitvoerbaar bestand leveren.

npm-shims hebben Node.js nodig tijdens het draaien. Als je in dezelfde sessie Node.js en daarna een CLI installeert, wordt de .cmd-shim wel gevonden, maar mislukt met “node is not recognized” in elk programma dat werd gestart voordat Node.js in het PATH stond. Hetzelfde symptoom krijg je met een Node-versiebeheerder waarvan de shims naar een versie wijzen die niet actief is.

Een proces starten kost op Windows veel meer. We maten 20 tot 80 ms om op Windows een proces aan te maken, tegenover 1 tot 3 ms op macOS, en elke bestandscontrole kost meer omdat de antivirus die inspecteert. Onze eerste CLI-detectie probeerde elke map, elke naam en elke extensie, en liet de app op Windows tot een seconde bevriezen. Elke map maar één keer lezen loste het op.

In de app installeert de installatie-assistent een ontbrekende CLI met de eigen installer van de maker voor jouw besturingssysteem (irm https://claude.ai/install.ps1 | iex voor Claude Code, het script van OpenAI voor Codex), valt terug op npm als het script mislukt, en voert het uit in een terminal die je kunt volgen. Als een CLI niet start, leest CLI Doctor de fout en het exacte commando en vertelt je daarna wat er stuk ging. Zodra beide CLI's op --version antwoorden, neemt de handleiding om te beginnen het over, en de aankondiging van de Windows-versie beschrijft wat de app op Windows doet.

Veelgestelde vragen

Hoe installeer ik Claude Code op Windows?

Open PowerShell en voer irm https://claude.ai/install.ps1 | iex uit. In CMD gebruik je in plaats daarvan de install.cmd-regel van de installatiepagina van Anthropic, en met WinGet voer je winget install Anthropic.ClaudeCode uit. Het programma komt in %USERPROFILE%\.local\bin terecht, en die map voegt de installer niet toe aan je PATH: voeg hem zelf toe als claude niet wordt herkend, open daarna een nieuwe terminal en voer claude --version uit.

Heb ik WSL nodig om Claude Code of Codex op Windows te gebruiken?

Nee. Beide draaien native in PowerShell of CMD op Windows 10 en 11. WSL 2 is de moeite waard als je project al onder Linux leeft, of als je de sandbox van Claude Code wilt, die niet op native Windows draait. Neem WSL 2, niet WSL 1: Codex heeft WSL 1 laten vallen in versie 0.115.

Waarom zegt Windows direct na de installatie dat 'claude' niet wordt herkend?

De native installer zet claude.exe in %USERPROFILE%\.local\bin en toont een waarschuwing als die map niet in je PATH staat, maar past het PATH zelf niet aan. Voeg de map toe aan het PATH van je gebruiker, sluit dan de terminal en open hem opnieuw, en ook de editor als de terminal daarin draait. Een terminal die al open stond, houdt zijn oude PATH.

Heeft Claude Code Git for Windows nodig?

Niet meer. De installatiepagina van Anthropic noemt Git for Windows optioneel: zonder Git gebruikt Claude Code PowerShell als shell-tool. Met Git vindt Claude Code Git Bash in C:\Program Files\Git, en met de instelling CLAUDE_CODE_GIT_BASH_PATH kun je naar een andere bash.exe verwijzen.

Kan ik Codex CLI op Windows installeren zonder Node.js?

Ja. De PowerShell-installer van OpenAI downloadt een zelfstandige Codex, zet die in %LOCALAPPDATA%\Programs\OpenAI\Codex\bin en voegt die map toe aan het PATH van je gebruiker. Alleen de npm-route, npm install -g @openai/codex, heeft Node.js nodig.

Gebruik ik PowerShell of CMD om ze te installeren?

PowerShell. Beide officiële one-liners zijn PowerShell-commando's, en de fouten die mensen het vaakst tegenkomen ontstaan door een PowerShell-regel in CMD te plakken of andersom: 'irm' is not recognized (op een Nederlandstalige Windows “'irm' wordt niet herkend als een interne of externe opdracht”) betekent dat je in CMD zit, en '&&' is not a valid statement separator betekent dat je in PowerShell zit. Gebruik de 64-bits PowerShell, niet de vermelding “Windows PowerShell (x86)” in het Startmenu.

DevOps EngineerTekstschrijverFrontend-ontwikkelaarSalesmedewerkerBackend-ontwikkelaarCoach & trainerSoftwarearchitectJuridisch adviseurQA EngineerFinanciën & administratieFull-Stack DeveloperCreatief ontwerperMobiele ontwikkelaarOnderzoekerBeveiligingsingenieurHR & werving
ProjectmanagerVertalerGit ExpertData-analistSEO-specialistBoekhouderLokalisatiespecialistCommunicatie & PRBrainstormerOperations & logistiekMarketing SpecialistKlantenserviceProjectassistentInkoperCommunitymanagerPersoonlijk assistent

Download AgentsRoom

Draai al je AI-agenten, op al je projecten, vanuit één enkel venster.

Download AgentsRoomGratis

Companion-app: houd je agents onderweg in de gaten

Breng je eigen: Claude, Codex, Antigravity CLI of andere AI-provider.

Download de extensie
Chrome Web Store

Stuur bugs en verzoeken direct naar je openbare backlog.

Agents die je leest als een gesprek

Elke agent heeft een rol, een gezicht en een draad die je leest als een chat-app.

Gespreksweergave

AgentsRoom gespreksweergave: het werk van een AI-codingagent als chatthread
Meerdere projecten
Multi-provider
Meerdere agenten
Live status
Bestandsverschil & commit
Mobiele metgezel
Live voorbeeld
Agententeams
Browserautomatisering
Backlog-gedreven ontwikkeling
Promptbibliotheek
Vaardighedenbibliotheek
Bekijk alle functies

Verder lezen