Claude Code und Codex CLI unter Windows installieren
Die genauen PowerShell-, CMD-, WinGet- und npm-Befehle, um Claude Code und Codex CLI unter Windows 10 und 11 zu installieren, wann sich WSL lohnt und wie du „claude wird nicht erkannt“ und die anderen Fehler behebst, die dir begegnen werden.
Beide CLIs lassen sich unter Windows inzwischen mit einer Zeile installieren. Der meiste Ärger kommt erst nach dieser Zeile: ein Terminal, das den Befehl nicht findet, eine Ausführungsrichtlinie, die npm blockiert, eine alte WSL-1-Distribution, ein Befehl, der in der falschen Shell gelandet ist. Diese Anleitung gibt dir die genauen Befehle für jeden Installationsweg, danach die Fehler und ihre Lösungen.
Die Angaben zu den beiden CLIs stammen aus der Dokumentation von Anthropic und OpenAI und aus den Installationsskripten selbst, gelesen am 16. November 2026, mit Claude Code 2.1.318 und Codex CLI 0.169.0. Beide Tools entwickeln sich schnell: Wenn ein Befehl unten fehlschlägt, prüf die offizielle Seite, die in jedem Abschnitt verlinkt ist.
Die kurze Antwort. Öffne PowerShell, nicht CMD, und führe aus:
irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Öffne dann ein neues Terminal und führe claude --version und codex --version aus. Wenn Windows antwortet, dass claude nicht erkannt wird, findest du die PATH-Korrektur weiter unten in der Fehlertabelle.
Was jede CLI unter Windows braucht
| Claude Code | Codex CLI | |
|---|---|---|
| Windows-Version | Windows 10 1809 oder neuer, Windows Server 2019 oder neuer | Windows 11 empfohlen, aktuelles Windows 10 als „Best Effort“ |
| Prozessor | x64 oder ARM64, nie 32 Bit | x64 oder ARM64 |
| Konto | Ein kostenpflichtiger Claude-Plan oder ein Console-Konto | Ein ChatGPT-Plan oder ein OpenAI-API-Schlüssel |
| Node.js | Nur für den npm-Weg, Version 22 oder neuer | Nur für den npm-Weg |
| Git for Windows | Optional | Nicht nötig |
| Sandbox unter nativem Windows | Nein, nur in WSL 2 | Ja, eine eigene Windows-Sandbox |
| Administratorrechte für die Installation | Nein | Nein |
Zwei Zeilen dieser Tabelle überraschen viele. Claude Code verlangt Git for Windows nicht mehr: Ohne Git nutzt es PowerShell als Shell-Werkzeug. Und Codex führt Befehle unter nativem Windows in einer Sandbox aus, während Claude Code das nur innerhalb von WSL 2 tut.
Claude Code unter Windows installieren
Anthropics Setup-Seite nennt vier Wege. Der native Installer ist der empfohlene: Er braucht kein Node.js und aktualisiert sich selbst im Hintergrund.
| Weg | Befehl |
|---|---|
| PowerShell (empfohlen) | 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 |
Was jeder Weg hinterlässt:
- Nativer Installer:
claude.exein%USERPROFILE%\.local\bin, die Versionen in%USERPROFILE%\.local\share\claude. Der Installer warnt dich, wenn.local\binnicht in deinem PATH steht, trägt den Ordner aber nicht für dich ein. - WinGet: keine automatischen Updates. Du aktualisierst mit
winget upgrade Anthropic.ClaudeCode, und Anthropic weist darauf hin, dass ein Update fehlschlagen kann, während Claude Code läuft, weil Windows die ausführbare Datei sperrt. - npm: Mit einem Node.js älter als 22 endet die Installation mit einer
EBADENGINE-Warnung.
Um eine Version hinter der neuesten zu bleiben, auf dem stabilen Kanal:
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
Prüf danach die Installation. claude --version gibt die Version aus, und claude doctor führt eine reine Lesediagnose der Installation und ihrer Einstellungen durch.
Wenn du Git for Windows hast, sucht Claude Code Git Bash in C:\Program Files\Git, dann in C:\Program Files (x86)\Git, dann über das git in deinem PATH. Um ein anderes zu erzwingen, setz CLAUDE_CODE_GIT_BASH_PATH im env-Block deiner settings.json. Die Variable muss auf eine Datei namens bash.exe oder sh.exe zeigen, nicht auf git-bash.exe.
Codex CLI unter Windows installieren
Die Windows-Seite von OpenAI ist eindeutig: Nutze Codex standardmäßig nativ mit seiner Windows-Sandbox, und nimm WSL, wenn deine Werkzeuge ohnehin unter Linux leben. Eine Quelle hinkt hinterher: Die Installationsseite des GitHub-Repositorys sagt noch immer „Windows 11 via WSL2“. Die offizielle Dokumentation ist weiter, und der Installer auch.
| Weg | Befehl |
|---|---|
| PowerShell-Installer | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm install -g @openai/codex |
Der PowerShell-Installer ist der einfache Weg. Ein Blick ins Skript zeigt, was er tut: Er installiert Codex in %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, fügt diesen Ordner zum PATH deines Benutzers und zur laufenden Sitzung hinzu und sagt dir, dass du ein neues PowerShell-Fenster öffnen sollst. Derselbe Befehl, erneut ausgeführt, aktualisiert Codex. Mit npm aktualisierst du, indem du den Installationsbefehl noch einmal ausführst.
Melde dich danach an. Führe codex aus und wähle Sign in with ChatGPT, oder führe codex login aus. Auf einem Rechner ohne Browser gibt dir codex login --device-auth einen Code, den du auf einem anderen Gerät eingibst. codex login status zeigt dir, mit welchem Konto du angemeldet bist.
Die Windows-Sandbox
Codex hat unter Windows drei Sandbox-Implementierungen:
mxc: die empfohlene, ohne Einrichtung durch einen Administrator. Sie braucht Windows 11 24H2 (Build 26100.9278) oder 25H2 (Build 26200.9278).elevated: der bevorzugte Fallback. Sie braucht eine einmalige Einrichtung, die ein Administrator bestätigt.unelevated: schwächere Netzwerkisolation und keine schreibgeschützten Pfade.
Die Wahl triffst du in config.toml:
[features]
prefer_mxc = true
[windows]
sandbox = "elevated" # or "unelevated"
Wenn die Sandbox mit Fehler 1385 scheitert, hat Windows den Anmeldetyp des Sandbox-Kontos abgelehnt. OpenAI bittet in diesem Fall um CODEX_HOME/.sandbox/sandbox.log. Gib den Inhalt von .sandbox-secrets/ niemals weiter.
Natives Windows oder WSL?
| Nativ (PowerShell, CMD) | WSL 2 | |
|---|---|---|
| Claude Code installieren | irm https://claude.ai/install.ps1 | iex | curl -fsSL https://claude.ai/install.sh | bash innerhalb von WSL |
| Codex installieren | der PowerShell-Installer | curl -fsSL https://chatgpt.com/codex/install.sh | sh innerhalb von WSL |
| Sandbox von Claude Code | nicht verfügbar | verfügbar, mit bubblewrap und socat |
| Sandbox von Codex | die Windows-Sandbox | die Linux-Sandbox |
| Wo das Repository liegen sollte | egal wo | unter ~/, nicht unter /mnt/c/ |
Nimm WSL 2, wenn dein Projekt ohnehin unter Linux gebaut wird und läuft, oder wenn Claude Code die Befehle, die es ausführt, in einer Sandbox isolieren soll. Bleib nativ, wenn dein Projekt ein Windows-Projekt ist: .NET, PowerShell-Skripte, überall Windows-Pfade.
Drei Regeln, wenn du den WSL-Weg gehst:
- WSL 2, niemals WSL 1. Codex unterstützt WSL 1 seit Version 0.115 nicht mehr. Die Sandbox von Claude Code lehnt WSL 1 mit
Sandboxing requires WSL2ab, und Installationen unter WSL 1 können mitExec format errorscheitern. Eine Distribution wandelst du mitwsl --set-version <DistroName> 2um. - Innerhalb von WSL installieren und ausführen. Führe den Linux-Befehl im WSL-Terminal aus, nicht in PowerShell. Wer das Windows-Node.js aus WSL heraus aufruft, bekommt
exec: node: not found: Installiere Node.js in der Distribution selbst, mit ihrem Paketmanager oder mit nvm. - Den Code im Linux-Dateisystem halten. Beide Hersteller raten, das Repository außerhalb von
/mnt/c/zu halten, und Anthropic weist darauf hin, dass die Suchen von Claude Code dort weniger vollständig sind. Klone es in dein Linux-Home-Verzeichnis.
„claude wird nicht erkannt“ und die anderen Fehler
| Was du siehst | Warum | Lösung |
|---|---|---|
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell) | %USERPROFILE%\.local\bin steht nicht in deinem PATH | Zum PATH des Benutzers hinzufügen (Befehle unten), dann ein neues Terminal öffnen |
| Nach dem Hinzufügen immer noch nicht erkannt | Das Terminal, oder der Editor drumherum, wurde vor der Änderung gestartet | Terminal schließen und neu öffnen, ebenso den Editor, wenn das Terminal darin läuft |
| Direkt nach einem Update nicht erkannt | Ein mitten im Austausch unterbrochenes Update hat keine claude.exe hinterlassen | Die neueste claude.exe.old.* wieder in claude.exe umbenennen (Befehl unten) |
'irm' is not recognized | Du hast die PowerShell-Zeile in CMD eingefügt | PowerShell öffnen oder die CMD-Zeile nehmen |
The token '&&' is not a valid statement separator | Du hast die CMD-Zeile in Windows PowerShell eingefügt | Die PowerShell-Zeile nehmen |
npm.ps1 cannot be loaded because running scripts is disabled on this system | Die Ausführungsrichtlinie blockiert den PowerShell-Shim von npm | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, oder npm.cmd aufrufen |
| Ein Fehler zu 32-Bit-Windows auf einem 64-Bit-PC | Du hast „Windows PowerShell (x86)“ aus dem Startmenü geöffnet | Die normale 64-Bit-PowerShell öffnen |
claude öffnet die Desktop-App statt der CLI | Eine alte Claude-Desktop-App hat eine Claude.exe in WindowsApps abgelegt, die im PATH vor der CLI steht | Die Claude-Desktop-App aktualisieren |
requires either Git for Windows (for bash) or PowerShell | Claude Code hat keine der beiden Shells gefunden | Git for Windows installieren oder prüfen, ob PowerShell im PATH steht |
EBADENGINE während npm install | Node.js ist älter als 22 | Node.js aktualisieren oder den nativen Installer nehmen |
Die PATH-Korrektur, in PowerShell, für den aktuellen Benutzer, ohne Administratorrechte:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Um zu prüfen, wo Windows sucht, bevor du etwas änderst:
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude
Die Umbenennung nach einem abgebrochenen Update:
Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe
Zur Ausführungsrichtlinie: Windows PowerShell 5.1, die Version, die mit Windows ausgeliefert wird, steht auf Client-PCs standardmäßig auf Restricted, deshalb blockiert ein frisch eingerichteter Laptop npm.ps1. Der Bereich CurrentUser braucht keine Administratorrechte. Der native Claude-Installer und der Codex-Installer sind nicht betroffen: irm | iex und -ExecutionPolicy ByPass laden nie eine Skriptdatei von der Festplatte.
Aktualisieren und deinstallieren
| Claude Code | Codex CLI | |
|---|---|---|
| Jetzt aktualisieren | claude update (nativ), winget upgrade Anthropic.ClaudeCode oder die npm-Installation erneut | codex update bei Versionen, die es unterstützen, der PowerShell-Installer erneut oder npm install -g @openai/codex |
| Automatische Updates | nur bei der nativen Installation, abschaltbar mit DISABLE_AUTOUPDATER=1 | nicht dokumentiert |
| Deinstallieren | %USERPROFILE%\.local\bin\claude.exe und %USERPROFILE%\.local\share\claude löschen, oder winget uninstall Anthropic.ClaudeCode, oder npm uninstall -g @anthropic-ai/claude-code | den Installationsordner löschen oder npm uninstall -g @openai/codex |
| Zurückbleibende Einstellungen | %USERPROFILE%\.claude und %USERPROFILE%\.claude.json | %USERPROFILE%\.codex |
Was wir gelernt haben, als wir Agenten-CLIs unter Windows betrieben haben
AgentsRoom startet Claude Code, Codex und die anderen Agenten-CLIs nebeneinander, und seine Windows-Version hat uns gezeigt, wo diese Installationen brechen, sobald sie das Terminal verlassen. Vier Dinge lohnen sich zu wissen, auch wenn du unsere App nie benutzt.
Ein Programm, das aus dem Startmenü gestartet wurde, behält den PATH, mit dem es gestartet ist. Du installierst Claude Code, fügst .local\bin zum PATH hinzu, und eine Desktop-App, die schon offen war, findet claude trotzdem nicht. Das Terminal neu zu starten reicht nicht für Apps, die CLIs für dich starten. AgentsRoom liest den PATH des Benutzers und der Maschine erneut aus der Registry, wenn es nach einer CLI sucht, damit eine gerade erfolgreiche Installation nicht als fehlend gemeldet wird.
npm installiert keine .exe. npm install -g @openai/codex schreibt drei Dateien nach %APPDATA%\npm: codex, codex.cmd und codex.ps1. Ein Programm, das codex direkt startet, bekommt spawn codex ENOENT, weil Windows an einen nackten Namen nur .exe anhängt. Dein Terminal verbirgt das, weil PowerShell und CMD PATHEXT auswerten. Ein Grund mehr, die nativen Installer vorzuziehen, die tatsächlich eine ausführbare Datei mitbringen.
npm-Shims brauchen Node.js zur Laufzeit. Wenn du in derselben Sitzung Node.js und dann eine CLI installierst, wird der .cmd-Shim zwar gefunden, scheitert aber mit „node is not recognized“ in jedem Programm, das gestartet wurde, bevor Node.js im PATH stand. Dasselbe Symptom gibt es mit einem Node-Versionsmanager, dessen Shims auf eine Version zeigen, die nicht aktiv ist.
Einen Prozess zu starten kostet unter Windows viel mehr. Wir haben 20 bis 80 ms gemessen, um unter Windows einen Prozess zu erzeugen, gegenüber 1 bis 3 ms unter macOS, und jede Dateiprüfung kostet mehr, weil der Virenscanner sie untersucht. Unsere erste CLI-Erkennung probierte jeden Ordner, jeden Namen und jede Endung durch und hat die App unter Windows bis zu einer Sekunde eingefroren. Jeden Ordner nur einmal zu lesen hat das behoben.
In der App installiert der Einrichtungsassistent eine fehlende CLI mit dem Installer des Herstellers für dein Betriebssystem (irm https://claude.ai/install.ps1 | iex für Claude Code, das Skript von OpenAI für Codex), weicht auf npm aus, wenn das Skript scheitert, und führt das Ganze in einem Terminal aus, dem du zusehen kannst. Wenn eine CLI nicht startet, liest CLI Doctor den Fehler und den genauen Befehl und sagt dir dann, was kaputt ist. Sobald beide CLIs auf --version antworten, übernimmt der Leitfaden für den Einstieg, und die Ankündigung der Windows-Version beschreibt, was die App unter Windows kann.
Häufige Fragen
Wie installiere ich Claude Code unter Windows?
Öffne PowerShell und führe irm https://claude.ai/install.ps1 | iex aus. In CMD nimmst du stattdessen die install.cmd-Zeile von Anthropics Setup-Seite, und mit WinGet führst du winget install Anthropic.ClaudeCode aus. Die Binärdatei landet in %USERPROFILE%\.local\bin, und der Installer fügt diesen Ordner nicht zu deinem PATH hinzu: Trag ihn selbst ein, wenn claude nicht erkannt wird, öffne dann ein neues Terminal und führe claude --version aus.
Brauche ich WSL, um Claude Code oder Codex unter Windows zu nutzen?
Nein. Beide laufen nativ in PowerShell oder CMD unter Windows 10 und 11. WSL 2 lohnt sich, wenn dein Projekt ohnehin unter Linux lebt oder wenn du die Sandbox von Claude Code willst, die unter nativem Windows nicht läuft. Nimm WSL 2, nicht WSL 1: Codex hat WSL 1 mit Version 0.115 fallen gelassen.
Warum sagt Windows direkt nach der Installation, dass 'claude' nicht erkannt wird?
Der native Installer legt claude.exe in %USERPROFILE%\.local\bin ab und zeigt eine Warnung an, wenn dieser Ordner nicht in deinem PATH steht, ändert den PATH aber nicht selbst. Füge den Ordner zum PATH deines Benutzers hinzu, schließe dann das Terminal und öffne es neu, ebenso den Editor, wenn das Terminal darin läuft. Ein Terminal, das schon offen war, behält seinen alten PATH.
Braucht Claude Code Git for Windows?
Nicht mehr. Anthropics Setup-Seite führt Git for Windows als optional: Ohne Git nutzt Claude Code PowerShell als Shell-Werkzeug. Mit Git findet Claude Code Git Bash in C:\Program Files\Git, und über die Einstellung CLAUDE_CODE_GIT_BASH_PATH kannst du auf eine andere bash.exe verweisen.
Kann ich Codex CLI unter Windows ohne Node.js installieren?
Ja. Der PowerShell-Installer von OpenAI lädt ein eigenständiges Codex herunter, legt es in %LOCALAPPDATA%\Programs\OpenAI\Codex\bin ab und fügt diesen Ordner zum PATH deines Benutzers hinzu. Nur der npm-Weg, npm install -g @openai/codex, braucht Node.js.
Soll ich sie mit PowerShell oder mit CMD installieren?
Mit PowerShell. Beide offiziellen Einzeiler sind PowerShell-Befehle, und die häufigsten Fehler entstehen, wenn eine PowerShell-Zeile in CMD eingefügt wird oder umgekehrt: 'irm' is not recognized (auf einem deutschen Windows „Der Befehl ‚irm‘ ist entweder falsch geschrieben oder konnte nicht gefunden werden“) heißt, dass du in CMD bist, und '&&' is not a valid statement separator heißt, dass du in PowerShell bist. Nimm die 64-Bit-PowerShell, nicht den Eintrag „Windows PowerShell (x86)“ im Startmenü.
AgentsRoom herunterladen
Führe alle deine KI-Agenten aus, in all deinen Projekten, aus einem einzigen Fenster.
Companion-App: Agenten auch unterwegs im Blick behalten
Nutze Claude, Codex, Antigravity CLI oder einen anderen KI-Anbieter.
Bugs und Wünsche direkt in dein öffentliches Backlog schicken.
Agenten, die du wie eine Unterhaltung liest
Jeder Agent hat eine Rolle, ein Gesicht und einen Verlauf, den du wie in einer Messaging-App liest.

Weiterlesen
Claude Code vs Codex CLI: welches Tool du 2026 nehmen solltest (und warum nicht beide)
Ein ehrlicher Vergleich von Claude Code und Codex CLI: Preise, Geschwindigkeit, MCP, Kontrolle. Und warum ich nach ein paar Wochen aufgehört habe, mich zu entscheiden.
Zum ArtikelSprachmodus in Codex, OpenCode, Antigravity und Claude Code: Welche CLI hat einen?
Wir haben am 13. Oktober 2026 fünf CLIs für Coding-Agenten und zwei Apps geprüft. Codex CLI und oh-my-pi führen ein gesprochenes Gespräch, Claude Code und Antigravity CLI diktieren nur in den Prompt, OpenCode hat nichts eingebaut. Wie du jede startest, wohin das Audio geht und was Sprache an Tokens kostet.
Zum ArtikelSo entfernst du Co-Authored-By Claude aus deinen Git-Commits
Claude Code signiert deine Commits mit einem Co-Authored-By-Trailer und deine Pull Requests mit einer Zeile Generated with Claude Code. Die Einstellung, die beides entfernt, die Datei, in die sie gehört, und wie du bereits gepushte Commits bereinigst.
Zum Artikel