Codex CLI installieren und aktualisieren: Mac, Linux, Windows

Die OpenAI Codex CLI zu installieren ist ein Befehl pro Plattform – curl -fsSL https://chatgpt.com/codex/install.sh | sh auf macOS und Linux, powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" auf Windows – mit npm und Homebrew als unterstützten Alternativen, und das Aktualisieren ist codex update, das Skript-, npm- und Homebrew-Installationen erkennt und das Upgrade des jeweiligen Kanals ausführt.¹⁴¹¹ Der Teil, den die meisten Seiten überspringen, kommt nach dem ersten Befehl: welche der fünf Installationsrouten man wählt, wie man eine Version festlegt, wenn ein Release etwas kaputtmacht, warum das winget-Paket npm um sieben Minor-Versionen hinterherhinkt und was eine Deinstallation in ~/.codex zurücklässt. Diese Seite ist diese Referenz, eine Tabelle pro Aufgabe, auf dem Stand von v0.153.4 (4. September 2026).⁹

TL;DR

• Der eigenständige Installer ist die Route, mit der OpenAI vorangeht, sowohl im README als auch in der CLI-Dokumentation, mit npm und Homebrew als Alternativen („you can also install“ in der CLI-Dokumentation, „can also be installed via“ im README): das Skript install.sh auf macOS und Linux, das Skript install.ps1 auf Windows. Es lädt die kompilierte Binärdatei herunter, braucht also kein Node.¹¹¹
• npm und Homebrew sind unterstützte Alternativen. npm install -g @openai/codex legt die Version mit einer gewöhnlichen Paketangabe (@<version>) fest; brew install --cask codex stand beim Schreiben auf derselben 0.153.4 wie npm.¹²¹⁰
• Meiden Sie winget, um Codex selbst zu installieren. OpenAI veröffentlicht zwar das Paket OpenAI.Codex, aber die Manifest-Pull-Requests für 0.147.0 bis 0.152.0 liegen seit dem 7. August 2026 ungemergt in microsoft/winget-pkgs, sodass die neueste installierbare Version am Tag des Schreibens 0.146.1 ist, gegenüber 0.153.4 bei npm.³¹⁰
• codex update deckt Skript-, npm- und Homebrew-Installationen ab (ab v0.128.0): Es nutzt die Installationskanal-Erkennung wieder, die die TUI bereits hat, und führt das passende Upgrade aus. Eine winget-Installation ist kein Kanal, den es erkennt; die aktualisieren Sie mit winget upgrade OpenAI.Codex. Die manuellen Entsprechungen für den Rest sind das erneute Ausführen des Installers, npm install -g @openai/codex@latest oder brew upgrade --cask codex.⁴¹¹
• Version festlegen mit --release <version> bei install.sh, $env:CODEX_RELEASE vor der install.ps1-Zeile oder @<version> bei npm. Der Homebrew-Cask führt eine einzige aktuelle Version und kann nicht festlegen.²¹²
• Das Paket zu deinstallieren entfernt Ihren Zustand nicht, aber bei einer Skript-Installation löscht rm -rf ~/.codex auch die CLI selbst, weil der Installer seine Releases unter ~/.codex/packages/standalone ablegt.¹²

Wie installiere ich die Codex CLI?

Vier Routen in der Reihenfolge, in der OpenAIs eigene Dokumentation sie präsentiert,¹¹¹ plus winget auf Windows, das OpenAI nicht dokumentiert:³

# Standalone installer, no Node required (macOS, Linux, WSL) -- the route OpenAI lists first
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

# npm (needs Node.js 16+; pins with a plain @version spec)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

# winget (Windows; lags npm, see the platform section)
winget install OpenAI.Codex

Dann bestätigen Sie, dass es angekommen ist, und melden sich an:

codex --version      # codex-cli 0.153.4
codex login          # ChatGPT account (recommended) or an API key

Bei einer ersten Skript-Installation wirkt der Profilblock erst in neuen Shells. Wenn codex in dem Terminal, aus dem Sie installiert haben, nicht gefunden wird, führen Sie dort export PATH="$HOME/.local/bin:$PATH" aus oder öffnen ein neues; der Installer gibt zum Schluss dieselben zwei Zeilen aus („Current terminal“ und „Future terminals“).¹²

Lieber eine rohe Binärdatei? Jedes GitHub-Release liefert Plattform-Tarballs (codex-aarch64-apple-darwin.tar.gz, codex-x86_64-apple-darwin.tar.gz, codex-x86_64-unknown-linux-musl.tar.gz, codex-aarch64-unknown-linux-musl.tar.gz), und seit v0.106.0 hängt dasselbe install.sh als Asset an jedem Release. Jedes Archiv enthält einen einzigen Eintrag mit der Plattform im Namen; benennen Sie ihn nach dem Entpacken in codex um.¹⁵

Der Installer lädt von OpenAI-gehosteter Release-Infrastruktur: chatgpt.com/codex/install.sh leitet auf releases.openai.com um, eine Änderung, die mit v0.146.0 kam, mit GitHub Releases als Fallback-Host.⁶ In einem Netzwerk, das OpenAIs Artefakt-Host blockiert oder drosselt, GitHub aber erlaubt, holen Sie das Skript vom Release-Asset und weisen es an, auch die Binärdatei von GitHub zu ziehen:¹¹²

curl -fsSL https://github.com/openai/codex/releases/latest/download/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh

Die Variable gehört auf die sh-Seite der Pipe. Die Form VAR=value curl ... | sh wendet die Variable nur auf curl an, sodass das Skript sie nie sieht und stillschweigend beim Standard bleibt. In PowerShell setzen Sie $env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM = 'false', bevor Sie die Installationszeile ausführen.

Welche Route sollten Sie wählen?

Welche Plattformen unterstützt Codex?

Auf Windows läuft Codex nativ in PowerShell mit einer Windows-Sandbox, und es gibt zwei Sandbox-Modi. elevated ist der bevorzugte: Er verwendet dedizierte Sandbox-Benutzer mit geringeren Rechten, Berechtigungsgrenzen im Dateisystem, Firewall-Regeln und Änderungen an lokalen Richtlinien und braucht eine vom Administrator genehmigte Einrichtung. unelevated ist der Fallback: Er führt Befehle mit einem eingeschränkten Windows-Token aus, das von Ihrem Benutzer abgeleitet ist, und mit ACL-basierten Dateisystemgrenzen.⁸ Den Modus wählen Sie in config.toml:

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

OpenAIs Empfehlung ist, standardmäßig die native Sandbox zu verwenden und WSL zu wählen, wenn Sie Linux-natives Tooling brauchen, wenn Ihr Workflow ohnehin in WSL2 lebt oder wenn keiner der nativen Windows-Sandbox-Modi Ihre Anforderungen erfüllt.⁸ Eines sollte man auseinanderhalten: Die Windows-Einrichtung setzt voraus, dass winget für ihre eigenen Einrichtungsschritte auf der Maschine vorhanden ist; das ist etwas anderes, als Codex über winget zu installieren. OpenAI veröffentlicht dieses Paket – der Release-Workflow hat einen winget-Job, der für stabile Releases einen Manifest-Pull-Request in microsoft/winget-pkgs öffnet – aber diese Einreichungen liegen ungemergt, seit das Manifest für 0.146.1 am 7. August 2026 gemergt wurde; die Anfragen für 0.147.0 bis 0.152.0 waren beim Schreiben alle noch offen, und für 0.153.0 bis 0.153.4 existiert gar keine. An der CLI ist nichts kaputt; der Paketindex hinkt hinterher.³⁸

Node.js ist nur für die npm-Route eine Voraussetzung. Die Installationsskripte laden die kompilierte Binärdatei herunter, und der Homebrew-Cask deklariert keine Abhängigkeiten.¹²

Wie aktualisiere ich die Codex CLI?

Codex aktualisiert sich nicht selbst. Die TUI bemerkt ein neueres Release und bietet den Befehl für Ihren Installationskanal an; ihn auszuführen liegt bei Ihnen, und der eingebaute deckt Skript-, npm- und Homebrew-Installationen ab.⁴ Die Startprüfung selbst ist ein Konfigurationsschlüssel: check_for_update_on_startup = false in config.toml, den die Referenz als „Check for Codex updates on startup (set to false only when updates are centrally managed)“ beschreibt; Flotten, die Updates zentral verwalten, setzen features.in_app_updates = false in requirements.toml.¹⁶

codex --version                      # what you run now
npm view @openai/codex version       # newest published

codex update                         # built-in, v0.128.0+; detects your install channel

codex update kam mit v0.128.0 am 30. April 2026; der Pull Request, der es hinzufügte, nutzte die Installationskanal-Erkennung und den Update-Runner wieder, die die TUI bereits für Update-Hinweise hatte. Die Kanalzuordnung umfasst npm (plus die Varianten bun, pnpm und Vite+), Homebrew und den eigenständigen Installer auf Unix und Windows; eine winget-Installation ist nicht darin, sodass ein per winget installiertes Codex nur über winget upgrade OpenAI.Codex aktualisiert wird.⁴ Die manuellen Entsprechungen, falls Sie sie bevorzugen oder ein Maschinenimage skripten:

curl -fsSL https://chatgpt.com/codex/install.sh | sh   # standalone: re-run the installer
npm install -g @openai/codex@latest                    # npm
brew upgrade --cask codex                              # Homebrew
winget upgrade OpenAI.Codex                            # winget (to whatever winget has)

irm https://chatgpt.com/codex/install.ps1 | iex           # standalone on Windows: re-run the installer

Releases erscheinen auf einer schnellen stabilen Linie – 0.150.0 bis 0.153.4 kamen zwischen dem 26. August und dem 4. September 2026 – sodass die Lücke zwischen „was ich nutze“ und „neueste“ oft eine Woche ist, kein Quartal.⁹

Wie installiere ich eine bestimmte Version?

npm und das Installationsskript legen beide nach Version fest; Homebrew nicht:²¹²

npm install -g @openai/[email protected]                                          # npm: exact version
curl -fsSL https://chatgpt.com/codex/install.sh | sh -s -- --release 0.152.1  # script: --release flag
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_RELEASE=0.152.1 sh    # script: env var, on the sh side
winget install OpenAI.Codex --version 0.146.1                                 # winget: only what it has
codex --version                                                               # verify the rollback took

Achten Sie bei der Umgebungsvariablen-Form auf die Position: CODEX_RELEASE=0.152.1 muss vor sh stehen, nach der Pipe. Vor curl geschrieben gilt die Variable nur für curl, und das Skript installiert latest, während Sie glauben, festgelegt zu haben.¹² Auf Windows deklariert das PowerShell-Skript $Release = $env:CODEX_RELEASE als seinen einzigen Parameter und fällt auf latest zurück, wenn er leer ist, sodass die Festlegung die Variable ist, gesetzt in derselben Sitzung:¹⁷

$env:CODEX_RELEASE = '0.152.1'; irm https://chatgpt.com/codex/install.ps1 | iex

Festlegen ist der richtige Zug, wenn ein Release Sie lahmlegt: Issue melden, auf die letzte gute Version festlegen, weitermachen. Prüfen Sie nach jeder Festlegung mit codex --version, denn eine zweite Installation anderswo auf Ihrem PATH liefert im Stillen weiter ihre eigene Binärdatei. Das Installationsskript prüft genau das: Findet es ein von Homebrew, npm oder bun verwaltetes codex bereits auf Ihrem PATH, warnt es „Multiple managed Codex installs can be ambiguous because PATH order decides which one runs“ und bietet an, die passende Deinstallation für Sie auszuführen.¹² codex doctor meldet denselben Zustand nachträglich unter Environment.⁷

Wie deinstalliere ich die Codex CLI?

Entfernen Sie es über die Route, mit der es installiert wurde:

npm uninstall -g @openai/codex
brew uninstall --cask codex
winget uninstall OpenAI.Codex

Eine Skript-Installation hat keinen Paketmanager, den man fragen könnte. Der Installer legt in ~/.local/bin einen Symlink codex an (überschreibbar mit CODEX_INSTALL_DIR), der auf die Binärdatei innerhalb von ~/.codex/packages/standalone/current zeigt (current/bin/codex in aktuellen Releases); current ist selbst ein Symlink in ~/.codex/packages/standalone/releases/, wo jedes heruntergeladene Release liegt. Auf macOS fügt der Installer neben dem ersten einen zweiten Symlink hinzu, codex-code-mode-host.¹² Entfernen Sie alles:

rm -f ~/.local/bin/codex ~/.local/bin/codex-code-mode-host   # the second link exists on macOS installs only
rm -rf ~/.codex/packages/standalone

Wenn ~/.local/bin bei der Installation nicht auf Ihrem PATH war oder der Installer eine konkurrierende Homebrew-, npm- oder bun-Installation fand und den Eintrag umschrieb, hat das Skript außerdem einen markierten Block an Ihr Shell-Profil angehängt: # >>> Codex installer >>> bis # <<< Codex installer <<< in ~/.zprofile (macOS zsh), ~/.bash_profile, ~/.zshrc, ~/.bashrc oder ~/.profile. Löschen Sie diese drei Zeilen, um fertig zu werden.¹²

Auf Windows behält install.ps1 dieselbe Anordnung unter %USERPROFILE%\.codex\packages\standalone (oder %CODEX_HOME%\packages\standalone, wenn Sie diese Variable gesetzt haben): heruntergeladene Releases in releases\, eine current-Junction, die auf das aktive zeigt. Es stellt codex.exe über %LOCALAPPDATA%\Programs\OpenAI\Codex\bin bereit (überschreibbar mit CODEX_INSTALL_DIR), das selbst eine Junction nach current\bin ist, und statt eines Profilblocks schreibt es diesen bin-Pfad für künftige PowerShell-Sitzungen in Ihren Benutzer-PATH. Entfernen Sie zuerst das standalone-Verzeichnis, dann die nun ins Leere zeigende bin-Junction, dann nehmen Sie den Eintrag unter Umgebungsvariablen wieder aus der Benutzervariablen Path heraus:¹⁷

Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\packages\standalone"   # releases plus the current junction
cmd /c rmdir "$env:LOCALAPPDATA\Programs\OpenAI\Codex\bin"                  # the bin junction; rmdir removes the link, not a target

Die Paketmanager-Deinstallationen oben rühren ~/.codex/ nicht an. Homebrews --zap in der Praxis auch nicht: Die einzige zap-Anweisung des Casks ist rmdir: "~/.codex", und Homebrew wendet rmdir: nur auf bereits leere Verzeichnisse an.² Dieses Verzeichnis enthält config.toml, Ihre gespeicherten Zugangsdaten und jede Sitzung, weshalb eine Neuinstallation Login und Verlauf dort aufnimmt, wo Sie aufgehört haben. Löschen Sie es nur, wenn Sie wirklich reinen Tisch machen wollen, und wissen Sie, was das bei einer Skript-Installation bedeutet:

rm -rf ~/.codex   # discards config.toml, credentials, all sessions -- AND the CLI itself on a script install

Eine saubere Neuinstallation, die Ihren Zustand behält, ist bei npm eine Zeile: npm uninstall -g @openai/codex && npm install -g @openai/codex@latest. Auf der Skript-Route ersetzt das erneute Ausführen des Installers das Release unter ~/.codex/packages/standalone und lässt Ihre Konfiguration in Ruhe.¹²

Der ganze Lebenszyklus in einer Tabelle

Was prüft codex doctor?

codex doctor ist der Befehl, den man ausführt, bevor man einen Bug meldet oder eine Installation debuggt, die „gestern noch funktionierte“. Auf 0.153.4 fasst es sieben Abschnitte in einem Bericht zusammen – Notes, Environment (Konsistenz von Laufzeit und Installation), Configuration (Ladestatus von config.toml, Auth, MCP, Sandbox-Richtlinie), Desktop App (hinzugefügt in v0.149.0), Updates, Connectivity und Background Server – mit --summary für eine kompakte Ansicht, --json für eine geschwärzte maschinenlesbare Form, --all zum Ausklappen gekürzter Listen und --no-color für Logs; codex doctor --help listet auf 0.153.4 auch --ascii.⁷¹³¹⁵ Die meisten „Codex ist kaputt“-Meldungen lösen sich in etwas auf, das es auf dem ersten Bildschirm benennt: ein veralteter Auth-Modus, eine config.toml, die nicht geparst werden konnte, oder eine zweite Installation, die die auf Ihrem PATH verdeckt. Die vollständige Aufschlüsselung Abschnitt für Abschnitt steht im Leitfaden.

Was sich nach der Installation ändert

Das Erste, worüber eine frische Installation stolpert, ist nicht die Binärdatei. Seit v0.149.0 verweigert die CLI den Start bei approval_policy = "untrusted", sodass eine von einer älteren Maschine kopierte config.toml eine Änderung braucht.¹³ Sie kommen von Claude Code? Der Migrationsbeitrag stellt die beiden Konfigurationen nebeneinander, und der Hooks-Beitrag behandelt, was Codex rund um das Modell ausführt. Der Codex-CLI-Leitfaden ist die vollständige Referenz: Sandbox- und Genehmigungsmodi, AGENTS.md, MCP, Skills und Cloud-Tasks. Und wenn Sie beide Werkzeuge nutzen, ist die Claude-Code-Installationsseite der Zwilling dieser Seite.

Häufige Fragen

Wie aktualisiere ich die Codex CLI auf die neueste Version?

Führen Sie codex update aus (ab v0.128.0); es erkennt, ob Sie über das Skript, npm oder Homebrew installiert haben, und führt das Upgrade dieses Kanals aus. Die manuellen Entsprechungen sind das erneute Ausführen des Installationsskripts, npm install -g @openai/codex@latest oder brew upgrade --cask codex. Eine winget-Installation ist kein Kanal, den codex update erkennt; verwenden Sie dafür winget upgrade OpenAI.Codex.

Aktualisiert sich die Codex CLI automatisch?

Nein. Die TUI prüft auf ein neueres Release und bietet den Update-Befehl an, der zu Ihrem Installationskanal passt, und codex update (ab v0.128.0) führt ihn aus; nichts wird heruntergeladen oder angewendet, bis Sie es tun.

Wie deinstalliere ich die Codex CLI?

Verwenden Sie die Route, mit der es installiert wurde: npm uninstall -g @openai/codex, brew uninstall --cask codex oder winget uninstall OpenAI.Codex. Bei einer Skript-Installation entfernen Sie den Symlink ~/.local/bin/codex (und ~/.local/bin/codex-code-mode-host auf macOS) sowie das Verzeichnis ~/.codex/packages/standalone. Auf Windows besteht die Skript-Installation aus %USERPROFILE%\.codex\packages\standalone, der Junction %LOCALAPPDATA%\Programs\OpenAI\Codex\bin und einem Eintrag in Ihrem Benutzer-PATH; entfernen Sie alle drei. Ihre Konfiguration, Zugangsdaten und Sitzungen bleiben in ~/.codex/, bis Sie den Rest dieses Verzeichnisses selbst entfernen.

Wie installiere ich die Codex CLI auf Windows?

Führen Sie powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" aus. Die CLI läuft nativ in PowerShell mit einer Windows-Sandbox (elevated bevorzugt, unelevated als Fallback); WSL2 ist eine Option, wenn Sie Linux-Tooling brauchen oder keiner der Sandbox-Modi passt, keine Voraussetzung. Windows 11 ist die empfohlene Basis. winget install OpenAI.Codex funktioniert auch, hinkt aber der stabilen Linie hinterher.

Brauche ich Node.js, um Codex zu installieren?

Nur für die npm-Route, und das Paket verlangt Node 16 oder neuer. Das Installationsskript, das PowerShell-Skript und der Homebrew-Cask liefern alle die kompilierte codex-Binärdatei, sodass eine Maschine ohne Node Codex ausführen kann.

Wie prüfe ich, welche Version von Codex ich habe?

codex --version gibt sie aus (zum Beispiel codex-cli 0.153.4). npm view @openai/codex version zeigt die neueste veröffentlichte Version, und codex doctor meldet den Installationspfad und ob eine andere Kopie auf Ihrem PATH sie verdeckt.