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 CodeCodex CLI
Windows-VersionWindows 10 1809 oder neuer, Windows Server 2019 oder neuerWindows 11 empfohlen, aktuelles Windows 10 als „Best Effort“
Prozessorx64 oder ARM64, nie 32 Bitx64 oder ARM64
KontoEin kostenpflichtiger Claude-Plan oder ein Console-KontoEin ChatGPT-Plan oder ein OpenAI-API-Schlüssel
Node.jsNur für den npm-Weg, Version 22 oder neuerNur für den npm-Weg
Git for WindowsOptionalNicht nötig
Sandbox unter nativem WindowsNein, nur in WSL 2Ja, eine eigene Windows-Sandbox
Administratorrechte für die InstallationNeinNein

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.

WegBefehl
PowerShell (empfohlen)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

Was jeder Weg hinterlässt:

  • Nativer Installer: claude.exe in %USERPROFILE%\.local\bin, die Versionen in %USERPROFILE%\.local\share\claude. Der Installer warnt dich, wenn .local\bin nicht 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.

WegBefehl
PowerShell-Installerpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm 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 installierenirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.sh | bash innerhalb von WSL
Codex installierender PowerShell-Installercurl -fsSL https://chatgpt.com/codex/install.sh | sh innerhalb von WSL
Sandbox von Claude Codenicht verfügbarverfügbar, mit bubblewrap und socat
Sandbox von Codexdie Windows-Sandboxdie Linux-Sandbox
Wo das Repository liegen sollteegal wounter ~/, 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:

  1. 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 WSL2 ab, und Installationen unter WSL 1 können mit Exec format error scheitern. Eine Distribution wandelst du mit wsl --set-version <DistroName> 2 um.
  2. 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.
  3. 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 siehstWarumLö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 PATHZum PATH des Benutzers hinzufügen (Befehle unten), dann ein neues Terminal öffnen
Nach dem Hinzufügen immer noch nicht erkanntDas Terminal, oder der Editor drumherum, wurde vor der Änderung gestartetTerminal schließen und neu öffnen, ebenso den Editor, wenn das Terminal darin läuft
Direkt nach einem Update nicht erkanntEin mitten im Austausch unterbrochenes Update hat keine claude.exe hinterlassenDie neueste claude.exe.old.* wieder in claude.exe umbenennen (Befehl unten)
'irm' is not recognizedDu hast die PowerShell-Zeile in CMD eingefügtPowerShell öffnen oder die CMD-Zeile nehmen
The token '&&' is not a valid statement separatorDu hast die CMD-Zeile in Windows PowerShell eingefügtDie PowerShell-Zeile nehmen
npm.ps1 cannot be loaded because running scripts is disabled on this systemDie Ausführungsrichtlinie blockiert den PowerShell-Shim von npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, oder npm.cmd aufrufen
Ein Fehler zu 32-Bit-Windows auf einem 64-Bit-PCDu hast „Windows PowerShell (x86)“ aus dem Startmenü geöffnetDie normale 64-Bit-PowerShell öffnen
claude öffnet die Desktop-App statt der CLIEine alte Claude-Desktop-App hat eine Claude.exe in WindowsApps abgelegt, die im PATH vor der CLI stehtDie Claude-Desktop-App aktualisieren
requires either Git for Windows (for bash) or PowerShellClaude Code hat keine der beiden Shells gefundenGit for Windows installieren oder prüfen, ob PowerShell im PATH steht
EBADENGINE während npm installNode.js ist älter als 22Node.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 CodeCodex CLI
Jetzt aktualisierenclaude update (nativ), winget upgrade Anthropic.ClaudeCode oder die npm-Installation erneutcodex update bei Versionen, die es unterstützen, der PowerShell-Installer erneut oder npm install -g @openai/codex
Automatische Updatesnur bei der nativen Installation, abschaltbar mit DISABLE_AUTOUPDATER=1nicht 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-codeden 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ü.

DevOps EngineerTexterFrontend-EntwicklerVertriebsmitarbeiterBackend-EntwicklerCoach & TrainerSoftwarearchitektRechtsberaterQA EngineerFinanzen & VerwaltungFull-Stack-EntwicklerKreativdesignerMobile EntwicklerRechercheurSecurity EngineerPersonal & Recruiting
ProjektmanagerÜbersetzerGit-ExperteDatenanalystSEO-SpezialistBuchhalterLokalisierungsspezialistKommunikation & PRBrainstormerOperations & LogistikMarketing-SpezialistKundenserviceProjektassistentEinkäuferCommunity ManagerPersönlicher Assistent

AgentsRoom herunterladen

Führe alle deine KI-Agenten aus, in all deinen Projekten, aus einem einzigen Fenster.

AgentsRoom herunterladenKostenlos

Companion-App: Agenten auch unterwegs im Blick behalten

Nutze Claude, Codex, Antigravity CLI oder einen anderen KI-Anbieter.

Erweiterung installieren
Chrome Web Store

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.

Konversationsansicht

AgentsRoom Konversationsansicht: die Arbeit eines KI-Coding-Agenten als Chatverlauf
Multi-Projekte
Multi-Provider
Multi-Agenten
Live-Status
Diff & Commit
Mobile App
Live-Vorschau
Agent-Teams
Browser-Tests
Backlog-getriebene Entwicklung
Prompt-Bibliothek
Skills-Bibliothek
Alle Funktionen ansehen

Weiterlesen