Codex CLI auf Deutsch: installieren, anmelden und sicher loslegen

Was ist Codex CLI und was brauchst du dafür?

Codex CLI ist der Coding-Agent von OpenAI fürs Terminal: Er liest dein Projekt, ändert Dateien und führt Befehle aus. Unter Windows installierst du ihn in PowerShell mit irm https://chatgpt.com/codex/install.ps1 | iex und meldest dich beim ersten Start mit deinem ChatGPT-Konto an, und zwar mit mindestens ChatGPT Plus.

Das Programm selbst ist Open Source unter der Lizenz Apache 2.0, der Quellcode liegt bei OpenAI auf GitHub. Bezahlen musst du trotzdem, denn die eigentliche Arbeit machen OpenAIs Modelle in der Cloud. Diese Anleitung bezieht sich auf Version 0.166.0 vom 29. Oktober 2026.

Als Basis empfiehlt OpenAI Windows 11. Windows 10 ab Version 1809 läuft laut Doku nur nach dem Prinzip „best effort“, also ohne Garantie. Git ist keine Pflicht, aber ich würde nie ohne anfangen: Ohne Git-Repository fehlt dir der Rückwärtsgang, falls der Agent mal falsch abbiegt.

So installierst du Codex unter Windows, macOS und Linux

Der offizielle Weg für Windows ist das Installationsskript aus dem GitHub-Repository. Falls deine PowerShell Skripte blockiert, startest du es so: powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". Hast du Node.js ohnehin auf dem Rechner, geht auch npm install -g @openai/codex, laut npm brauchst du dafür Node 16 oder neuer.

Im Windows-Paketmanager gibt es außerdem das Paket OpenAI.Codex mit dem Herausgeber OpenAI, Inc., installierbar mit winget install --id OpenAI.Codex --exact. In der OpenAI-Doku selbst taucht dieser Weg aber nicht als Installationsmethode auf, er ist also nicht offiziell bestätigt. Egal welchen Weg du nimmst: Öffne danach ein neues PowerShell-Fenster und tipp codex --version. Kommt eine Versionsnummer, ist alles drin.

Auf macOS und Linux nimmst du curl -fsSL https://chatgpt.com/codex/install.sh | sh, dasselbe Skript bringt Codex später auch auf den neuesten Stand. Auf dem Mac geht alternativ brew install --cask codex.

WSL brauchst du unter Windows nicht mehr. Codex läuft nativ in PowerShell mit einer eigenen Windows-Sandbox. WSL 2 lohnt sich nur, wenn dein Projekt sowieso in Linux lebt, dann nutzt Codex dort die Linux-Sandbox. Falls du im Repository noch die ältere Datei docs/install.md findest, die „Windows 11 via WSL2“ verlangt: Die ist überholt, maßgeblich ist die aktuelle Windows-Seite der offiziellen Doku.

ChatGPT-Konto oder API-Key: wer zahlt die Rechnung?

Beim ersten Start fragt Codex, wie du dich anmelden willst, und das ist eigentlich die Frage, wer bezahlt. Mit codex login öffnet sich der Browser und du meldest dich mit deinem ChatGPT-Konto an. Dann läuft alles über dein Abo und dessen Limits, und nur so kommst du auch an Codex Cloud.

Auf einem Rechner ohne Browser hilft codex login --device-auth. Das ist laut OpenAI noch Beta und muss vorher in den Sicherheitseinstellungen deines ChatGPT-Kontos erlaubt werden.

Die dritte Variante ist der API-Key. Den reichst du per Pipe an codex login --with-api-key weiter, statt ihn einzutippen. OpenAI zeigt dafür nur die Unix-Schreibweise printenv OPENAI_API_KEY | codex login --with-api-key, eine offizielle PowerShell-Variante gibt es nicht. Abgerechnet wird dann nach Verbrauch über dein OpenAI-Platform-Konto, dein ChatGPT-Abo zählt nicht, Codex Cloud und einige Plugins fehlen. Ob gerade Abo oder Key aktiv ist, verrät dir codex login status.

Deine Zugangsdaten speichert Codex standardmäßig in der Datei auth.json im Ordner .codex in deinem Benutzerverzeichnis. Willst du sie lieber in der Windows-Anmeldeinformationsverwaltung haben, trägst du in der config.toml die Zeile cli_auth_credentials_store = "keyring" ein, alternativ den Wert "auto".

Was kostet Codex CLI und wie weit kommst du damit?

Laut OpenAI ist Codex CLI ab ChatGPT Plus enthalten, außerdem in Pro, Business, Edu und Enterprise. ChatGPT Free und Go bekommen je nach Rollout nur die Codex-Desktop-App, die CLI nicht. Die offiziellen Listenpreise stehen in US-Dollar: Plus kostet 20 $ im Monat, das sind ca. 21,29 € inkl. 19 % MwSt. (EZB-Kurs 1,1179 vom 3.11.2026). Pro gibt es ab 100 $ in den Stufen 100, 200 und 500 $, Business kostet 25 $ pro Nutzer und Monat oder 20 $ bei Jahreszahlung. Verbindlich ist der Euro-Betrag, den dir der Checkout zeigt.

Die Limits zählen pro Fünf-Stunden-Fenster. OpenAI nennt dafür je Modell nur Spannen statt fester Werte, dazu können Wochenlimits kommen. Pro hat derzeit kein Fünf-Stunden-Limit. Ist das Kontingent leer, können Plus- und Pro-Nutzer Credits nachkaufen.

Wichtig: Codex teilt sein Kontingent mit ChatGPT Work, dem Agentenmodus in ChatGPT. Lokale Nachrichten und Cloud-Aufgaben ziehen aus demselben Tank. Dass deine normalen ChatGPT-Chats das Codex-Limit leer fahren, steht in der Quelle dagegen nicht. Wie sich das gegen Claude Code rechnet, steht im Ratgeber Claude Code oder Codex.

Sandbox und Freigaben: wie viel darf Codex allein?

Zwei Regler bestimmen, wie selbstständig Codex arbeitet. Der Sandbox-Modus legt fest, was technisch überhaupt geht, die Freigaberegel, wann Codex dich vorher fragt. Beim Start setzt du sie mit --sandbox (kurz -s) und --ask-for-approval (kurz -a), im laufenden Programm mit /permissions.

Es gibt drei Sandbox-Modi. Mit read-only liest Codex nur und fragt vor jeder Änderung und jedem Befehl, ideal für fremden Code oder ein erstes Beschnuppern. Mit workspace-write darf er im Projektordner schreiben und übliche lokale Befehle ausführen, laut OpenAI der Standard für die normale Arbeit. Mit danger-full-access fallen alle Grenzen bei Dateisystem und Netzwerk, das gehört nur in eine Wegwerf-Umgebung wie eine VM oder einen Container.

Bei der Freigaberegel bleiben zwei Werte: on-request, dann fragt Codex, sobald er die Sandbox verlassen will, und never, dann fragt er nie. Die alte Stufe untrusted hat OpenAI gestrichen. Als risikoarme Voreinstellung empfiehlt die Doku codex -s workspace-write -a on-request.

Unter Windows kommt noch die Art der Sandbox dazu. mxc ist auf kompatiblen Geräten die Empfehlung und braucht keine Admin-Einrichtung. elevated richtest du einmal mit /setup-default-sandbox und Administratorbestätigung ein, die Befehle laufen danach trotzdem ohne Adminrechte. Scheitert das, hast du meist die UAC-Abfrage weggeklickt. unelevated ist die Notlösung mit schwächerer Netzwerk-Isolierung. Und den Schalter --yolo, lang --dangerously-bypass-approvals-and-sandbox, lässt du auf dem Arbeitsrechner mit SSH-Keys und Kundenprojekten bitte im Werkzeugkasten. Der führt jeden Befehl ohne Rückfrage und ohne Sandbox aus.

AGENTS.md: die Hausordnung für dein Projekt

In die AGENTS.md schreibst du, was Codex über dein Projekt wissen muss: wie gebaut und getestet wird, welcher Stil gilt, was tabu ist. Mit /init legt Codex ein Gerüst an, das du danach von Hand nachschärfst. Ein gutes Beispiel für ein deutsches Projekt hat vier kurze Blöcke: Antworten und Commit-Nachrichten auf Deutsch, die Befehle für Abhängigkeiten und Tests, keine neuen Abhängigkeiten ohne Rückfrage, und ein paar Stilregeln wie strenges TypeScript.

Codex sucht die Dateien an zwei Stellen. Global im Codex-Ordner in deinem Benutzerverzeichnis, den du über CODEX_HOME verlegen kannst: Dort liest er zuerst AGENTS.override.md, sonst AGENTS.md. Das ist der Platz für persönliche Vorlieben wie „Antworte auf Deutsch“. Im Projekt geht er vom Projekt-Root, meist dem Git-Root, abwärts bis zum aktuellen Ordner und nimmt pro Ordner höchstens eine Datei, wieder die Override-Datei zuerst.

Alle gefundenen Dateien hängt Codex von oben nach unten aneinander. Was näher am aktuellen Ordner liegt, steht weiter hinten und gewinnt. Insgesamt liest Codex standardmäßig höchstens 32 KiB, einstellbar über project_doc_max_bytes. Ein dickes Regelwerk verteilst du deshalb besser auf Unterordner, statt alles in die Wurzel zu stopfen.

Nutzt du deine Regeln bisher unter einem anderen Dateinamen, trägst du den in project_doc_fallback_filenames in der config.toml ein. Arbeitest du parallel mit Claude Code, lies den Ratgeber AGENTS.md und CLAUDE.md, dort steht, wie beide Dateien friedlich nebeneinander leben.

Die Befehle, die du im Alltag wirklich brauchst

Mit codex startest du eine Sitzung im aktuellen Ordner, mit codex -s read-only eine, in der Codex erst mal nur schaut. codex exec "Behebe die fehlschlagenden Tests" läuft ohne Oberfläche, praktisch für Skripte und CI, die Kurzform ist codex e. Eine gespeicherte Sitzung holst du mit codex resume zurück, und codex review lässt Codex die aktuellen Änderungen begutachten.

Ein bestimmtes Modell wählst du mit codex -m und dem Modellnamen, im Programm mit /model. Mit codex -C und einem Pfad arbeitest du in einem anderen Ordner, ohne die Werkbank zu wechseln. codex mcp list zeigt eingerichtete MCP-Server, add und remove verwalten sie. codex update holt die neueste Version, bei einer winget-Installation geht auch winget upgrade OpenAI.Codex.

Im laufenden Programm helfen dir diese Slash-Befehle am meisten: /diff zeigt den Git-Diff inklusive neuer Dateien, /review prüft den Arbeitsstand, /compact fasst den Kontext zusammen, wenn er voll wird, /status zeigt Konfiguration und Token-Verbrauch, /usage dein Kontingent. Und /import übernimmt Einstellungen und Projekte aus Claude Code oder Cursor, falls du umsteigst.

Codex arbeitet standardmäßig mit OpenAI-Modellen, laut Konfigurationsdoku lassen sich aber auch eigene Provider wie Ollama, LM Studio oder Amazon Bedrock eintragen. Ob sich ein lokales Modell für dich lohnt, klärt der Ratgeber Lokale KI 2026.

Dein erster Durchlauf in vier Schritten

Erstens: Öffne deinen Projektordner in PowerShell und prüfe mit git status, dass alles committet ist. Dann hast du einen sauberen Ausgangspunkt, zu dem du jederzeit zurückkommst.

Zweitens: Starte codex, melde dich an und lass mit /init die AGENTS.md anlegen. Lies sie aufmerksam, denn darin steht, was Codex über dein Projekt verstanden hat. Liegt er falsch, korrigierst du das jetzt und nicht nach zwanzig Änderungen.

Drittens: Gib ihm eine kleine Aufgabe, etwa „Füge für die Funktion X einen Test hinzu“. Viertens: Schau dir mit /diff an, was passiert ist. Passt es, committest du selbst. Passt es nicht, setzt git restore . alles zurück, und keiner muss davon erfahren.