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 Code | Codex CLI | |
|---|---|---|
| Windows-versie | Windows 10 1809 of nieuwer, Windows Server 2019 of nieuwer | Windows 11 aanbevolen, recente Windows 10 op basis van “best effort” |
| Processor | x64 of ARM64, nooit 32-bits | x64 of ARM64 |
| Account | Een betaald Claude-abonnement of een Console-account | Een ChatGPT-abonnement of een OpenAI API-sleutel |
| Node.js | Alleen voor de npm-route, versie 22 of nieuwer | Alleen voor de npm-route |
| Git for Windows | Optioneel | Niet nodig |
| Sandbox op native Windows | Nee, alleen in WSL 2 | Ja, een eigen Windows-sandbox |
| Beheerdersrechten om te installeren | Nee | Nee |
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.
| Route | Commando |
|---|---|
| PowerShell (aanbevolen) | irm https://claude.ai/install.ps1 | iex |
| CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| WinGet | winget install Anthropic.ClaudeCode |
| npm (Node.js 22+) | npm install -g @anthropic-ai/claude-code@latest |
Wat elke route achterlaat:
- Native installer:
claude.exein%USERPROFILE%\.local\bin, de versies in%USERPROFILE%\.local\share\claude. De installer waarschuwt je als.local\binniet 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.
| Route | Commando |
|---|---|
| PowerShell-installer | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm 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 installeren | irm https://claude.ai/install.ps1 | iex | curl -fsSL https://claude.ai/install.sh | bash binnen WSL |
| Codex installeren | de PowerShell-installer | curl -fsSL https://chatgpt.com/codex/install.sh | sh binnen WSL |
| Sandbox van Claude Code | niet beschikbaar | beschikbaar, met bubblewrap en socat |
| Sandbox van Codex | de Windows-sandbox | de Linux-sandbox |
| Waar je de repository bewaart | overal | onder ~/, 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:
- 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 metExec format error. Zet een distributie om metwsl --set-version <DistroName> 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. - 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 ziet | Waarom | Oplossing |
|---|---|---|
'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 PATH | Toevoegen aan het PATH van de gebruiker (commando's hieronder), daarna een nieuwe terminal openen |
| Nog steeds niet herkend na het toevoegen | De terminal, of de editor eromheen, is gestart vóór de wijziging | De terminal sluiten en opnieuw openen, en ook de editor als de terminal daarin draait |
| Niet herkend direct na een update | Een update die halverwege het verwisselen werd onderbroken, heeft geen claude.exe achtergelaten | De nieuwste claude.exe.old.* terug hernoemen naar claude.exe (commando hieronder) |
'irm' is not recognized | Je hebt de PowerShell-regel in CMD geplakt | PowerShell openen, of de CMD-regel gebruiken |
The token '&&' is not a valid statement separator | Je hebt de CMD-regel in Windows PowerShell geplakt | De PowerShell-regel gebruiken |
npm.ps1 cannot be loaded because running scripts is disabled on this system | Het uitvoeringsbeleid blokkeert de PowerShell-shim van npm | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, of npm.cmd aanroepen |
| Een fout over 32-bits Windows op een 64-bits pc | Je hebt “Windows PowerShell (x86)” geopend vanuit het Startmenu | De gewone 64-bits PowerShell openen |
claude opent de desktop-app in plaats van de CLI | Een oude Claude-desktop-app heeft een Claude.exe in WindowsApps gezet, vóór de CLI in het PATH | De Claude-desktop-app bijwerken |
requires either Git for Windows (for bash) or PowerShell | Claude Code heeft geen van beide shells gevonden | Git for Windows installeren, of controleren of PowerShell in het PATH staat |
EBADENGINE tijdens npm install | Node.js is ouder dan 22 | Node.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 Code | Codex CLI | |
|---|---|---|
| Nu bijwerken | claude update (native), winget upgrade Anthropic.ClaudeCode, of de npm-installatie opnieuw | codex update in releases die het ondersteunen, de PowerShell-installer opnieuw, of npm install -g @openai/codex |
| Automatische updates | alleen bij de native installatie, uit te zetten met DISABLE_AUTOUPDATER=1 | niet 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-code | de 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.
Download AgentsRoom
Draai al je AI-agenten, op al je projecten, vanuit één enkel venster.
Companion-app: houd je agents onderweg in de gaten
Breng je eigen: Claude, Codex, Antigravity CLI of andere AI-provider.
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.

Verder lezen
De Claude Code-integratie van iTerm2: wat ze doet en hoe je ze instelt
iTerm2 3.7 kreeg een Claude Code-integratie: een status op elke Claude-sessie (working, waiting, idle, en sinds 3.7.5 done en error), een workgroup met Chat, Diff en Code Review, en reviewopmerkingen die als clippings teruggaan. Hoe je ze installeert, wat ze verandert in ~/.claude/settings.json, waarom de status stopt en wat Codex nodig heeft.
Lees het artikelSpraakmodus in Codex, OpenCode, Antigravity en Claude Code: welke CLI heeft er een?
We hebben op 13 oktober 2026 vijf CLI's voor codeeragents en twee apps gecontroleerd. Codex CLI en oh-my-pi voeren een gesproken gesprek, Claude Code en Antigravity CLI dicteren alleen in de prompt, OpenCode heeft niets ingebouwd. Hoe je elk ervan start, waar de audio naartoe gaat en wat spraak kost aan tokens.
Lees het artikelZo verwijder je Co-Authored-By Claude uit je git-commits
Claude Code ondertekent je commits met een Co-Authored-By-trailer en je pull requests met een regel Generated with Claude Code. De instelling die ze verwijdert, het bestand waarin je die zet, en hoe je commits opschoont die je al hebt gepusht.
Lees het artikel