Codex einrichten: CLI, Desktop, IDE

OpenAI Codex Schritt für Schritt: CLI, Desktop und IDE 2026

OpenAI Codex 2026 Schritt für Schritt: CLI installieren, Desktop und IDE einrichten, AGENTS.md mit /init anlegen und Limits nach Tarif prüfen.

Von Wolfgang

16. Okt. 20268 Min. Lesezeit

Heller Entwicklerarbeitsplatz mit offenem Laptop und abstrakt leuchtendem Terminalfenster auf einem Holztisch, ohne Logos und ohne lesbaren Text
Heller Entwicklerarbeitsplatz mit offenem Laptop und abstrakt leuchtendem Terminalfenster auf einem Holztisch, ohne Logos und ohne lesbaren Text

OpenAI Codex hilft beim Schreiben, Prüfen und Ausführen von Code. Der Guide zeigt, wie Sie CLI, Desktop und IDE mit Ihrem ChatGPT-Konto einrichten und die erste Aufgabe sicher starten.

OpenAI Codex ist der Coding-Agent von OpenAI. Er läuft in der ChatGPT-Desktop-App, in der Kommandozeile, in der IDE und im Web. Laut OpenAI Help ist Codex in allen ChatGPT-Tarifen enthalten, auch in Free und Go. Codex Cloud bleibt dort außen vor. Dieser Guide führt von der Client-Wahl über die CLI-Installation bis zur ersten sicheren Aufgabe. Die reine Nachrichtensteuerung behandeln wir gesondert. Für Steer und Queue verweisen wir auf unseren Folgeschritt.

Kurz gesagt

Codex gehört zu jedem ChatGPT-Tarif, inklusive Free und Go. Cloud-Umgebungen brauchen mindestens Plus und die schrittweise Freischaltung. Für den Einstieg reichen Desktop-App oder CLI. Die CLI installieren Sie unter macOS und Linux mit dem curl-Skript von ChatGPT Learn. Danach starten Sie codex im Projektordner und melden sich mit ChatGPT an. Legen Sie mit /init eine AGENTS.md an. Halten Sie Berechtigungen zunächst eng. Record & Replay fehlt laut OpenAI Help in der EU, in der Schweiz und im Vereinigten Königreich.

Was OpenAI Codex ist und was es nicht ist

Codex ist ein KI-Agent für Softwarearbeit. Er liest Ihren Code, schlägt Änderungen vor, führt Befehle aus und kann Reviews starten. OpenAI beschreibt ihn als Agenten, der beim Schreiben, Prüfen und Bereitstellen von Code hilft. Im normalen ChatGPT-Chat stehen Fragen und Texte im Vordergrund. Bei Codex stehen ein Repository und konkrete Entwicklungsschritte im Vordergrund.

Codex ist kein Ersatz für Ihr Urteil. Sie entscheiden, welche Diffs Sie übernehmen. Sie prüfen Tests und Secrets. Codex ist auch kein Offline-Werkzeug. Für die Anmeldung und die Modellnutzung brauchen Sie ein ChatGPT-Konto. Wer lokal und ohne Cloud-Konto arbeiten will, findet in unserem Guide zu RAG mit Ollama und FAISS einen anderen Weg.

Datenschutz und Tarifwahl gehören dazu. Welches Modell Sie in ChatGPT, Gemini oder Claude für Alltag und DSGVO wählen, ordnet unser Vergleich ChatGPT, Gemini oder Claude ein. Die Chat-Grundeinstellungen erklärt der Beitrag ChatGPT sicher einrichten. Hier geht es um die Codex-Clients und den ersten sicheren Lauf.

Welchen Client Sie wählen: Desktop, CLI, IDE oder Cloud

OpenAI nennt vier Wege. Die ChatGPT-Desktop-App mit Codex-Modus. Die Codex CLI im Terminal. Die Codex-Erweiterung für IDEs, vor allem VS Code und kompatible Forks. Codex im Web, inklusive Cloud-Aufgaben. Die Academy-Quickstart-Seite empfiehlt die Desktop-App für Projekte mit lokalen Dateien. Die CLI und die IDE-Erweiterung richten sich an Entwickler, die im Terminal oder Editor bleiben wollen.

Die Wahl hängt vom Tarif und vom Arbeitsort ab. Die Übersicht unten folgt der Logik aus OpenAI Help und ChatGPT Learn.

Client Geeignet für Tarif-Hinweis
Desktop (Codex-Modus) Lokale Ordner, lange Aufgaben, Diff-Ansicht Codex in allen Tarifen. Cloud nur Plus und höher
CLI Terminal-Workflow, Skripte, CI mit codex exec Anmeldung mit ChatGPT. Limits laut Plan
IDE-Erweiterung Arbeit direkt im Editor Wie CLI. VS Code und viele Forks
Web / Cloud Aufgaben auf von OpenAI verwalteten Maschinen Nicht in Free und Go. Einführung schrittweise

Eigene Übersicht nach OpenAI Help und ChatGPT Learn, Stand 16.10.2026. Workspace-Admins können Cloud und lokale Nutzung getrennt steuern.

Cloud-Aufgaben laufen weiter, wenn Ihr Rechner schläft. Das ist der Vorteil gegenüber rein lokalen Sessions. Gastkonten und reine Leselizenzen dürfen laut Help keine Cloud-Umgebungen anlegen. In Enterprise-Workspaces ist Cloud-Zugriff oft standardmäßig aus.

Sites, also das Erzeugen und Veröffentlichen von Web-Sites über Codex, gehören laut Help zu den kostenpflichtigen Plänen. Free und Go haben diese Funktion nicht.

Codex CLI installieren und anmelden

Die offizielle CLI-Dokumentation nennt für macOS und Linux denselben Installer. Der Befehl lautet:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Denselben Aufruf nutzt OpenAI für Updates. Alternativen über npm oder Homebrew nennt die Learn-Seite je nach Reiter. Prüfen Sie dort den zu Ihrem System passenden Weg, falls der curl-Installer nicht passt.

Öffnen Sie danach Ihr Projektverzeichnis. Starten Sie codex. Beim ersten Start wählen Sie die Anmeldung mit ChatGPT. Folgen Sie dem Dialog im Terminal. OpenAI Help beschreibt denselben Ablauf: Projekt öffnen, codex ausführen, ChatGPT-Konto verbinden.

In der Session helfen Slash-Befehle. /status zeigt die aktuelle Konfiguration und Nutzungshinweise. /permissions steuert, was Codex ohne Rückfrage darf. /model listet verfügbare Modelle. /review prüft Änderungen. /init legt die Projektanweisungen an. Die genaue Modellliste hängt von Client-Version und Konto ab. Benennen Sie Modelle im Alltag nur so, wie sie unter /model erscheinen.

Unter Windows nennt OpenAI zusätzliche Hilfen wie codex doctor und die Auswahl einer WSL-Distribution. Wer VS Code nutzt, kann die Codex-Erweiterung installieren oder die CLI im integrierten Terminal laufen lassen.

Erste Aufgabe sicher starten

Beginnen Sie mit einer engen Aufgabe. Bitten Sie Codex zuerst, das Projekt zu erklären. Ein einfacher Prompt wie „Erkläre dieses Repository kurz und nenne die Startbefehle“ reicht. So sehen Sie zuerst, welche Dateien der Agent öffnet.

Die Best-Practices-Seite empfiehlt vier Bausteine im Prompt. Ziel. Kontext. Grenzen. Fertig-Kriterium. Nennen Sie also, was sich ändern soll, welche Dateien zählen, welche Regeln gelten und wann die Aufgabe erledigt ist. Für komplexe Vorhaben schalten Sie den Planmodus mit /plan ein, bevor Code geändert wird.

Halten Sie Sandbox und Freigaben restriktiv. OpenAI rät Einsteigern, die Standardberechtigungen beizubehalten und erst später zu lockern. Die Richtlinie approval_policy = "untrusted" wird laut Help nicht mehr unterstützt. Als restriktive Alternative nennt OpenAI sandbox_mode = "read-only" zusammen mit approval_policy = "on-request".

Legen Sie vor größeren Änderungen einen Git-Checkpoint an. Prüfen Sie jeden Diff. Lassen Sie Tests laufen, die zu Ihrem Projekt passen. Stecken Sie keine API-Schlüssel, Passwörter oder Tokens in den Prompt. Während Codex arbeitet, können Sie nachsteuern oder eine Nachricht in die Warteschlange legen. Enter steuert nach. Tab stellt in die Warteschlange. Den tiefen Vergleich von Steer und Queue finden Sie im Beitrag Codex Steer und Queue.

AGENTS.md und Projektregeln mit /init

Mit /init erzeugt Codex eine AGENTS.md im aktuellen Verzeichnis. Der Befehl existiert in der CLI und in der Desktop-App im Codex-Modus. Die Datei ist laut Best Practices eine Art README für Agenten. Sie wird automatisch in den Kontext geladen.

Eine gute AGENTS.md bleibt kurz und konkret. Sie beschreibt die Ordnerstruktur. Sie nennt Build-, Test- und Lint-Befehle. Sie hält Engineering-Regeln und Verbote fest. Sie definiert, wann eine Aufgabe fertig ist. Nach dem Scaffold sollten Sie die Datei an Ihr Team anpassen. Vage Wunschlisten helfen wenig.

Sie können mehrere Ebenen nutzen. Globale Defaults liegen unter ~/.codex. Das Repository trägt die gemeinsamen Standards. Unterordner können engere Regeln setzen. Die nähere Datei gewinnt. Dauerhafte Einstellungen wie Modell, Sandbox und MCP gehören in config.toml. Persönliche Defaults liegen in ~/.codex/config.toml. Repo-spezifisches Verhalten liegt in .codex/config.toml.

Wiederkehrende Abläufe können Sie später als Skills kapseln. Externe Systeme hängen Sie über MCP an. Beides beschreibt die Best-Practices-Seite. Für den ersten Tag reichen /init, enge Rechte und ein klarer Prompt.

Nutzungslimits, Tarife und was in der EU fehlt

Codex zählt gegen die Nutzungslimits Ihres ChatGPT-Plans. Die genauen Kontingente und Credit-Optionen stehen auf der Preisseite von ChatGPT. OpenAI Help verweist ausdrücklich auf chatgpt.com/pricing. In der CLI zeigt /status den aktuellen Stand. Wir nennen hier keine Euro-Beträge, weil sich Preise und Fenster ändern.

Free und Go bekommen Codex lokal. Sie bekommen keine Codex Cloud. Plus und höhere Stufen können Cloud nutzen, sobald die Einführung und die Workspace-Einstellungen es erlauben. Automatische Sicherheitsprüfungen sind bei Anmeldung mit ChatGPT laut Help kostenlos und belasten das Kontingent nicht. Sie ersetzen nicht jede manuelle Freigabe.

Record & Replay fehlt in der EU. OpenAI Help schreibt, dass die Funktion in der Desktop-App unter macOS für berechtigte Nutzer gedacht ist und Computer Use voraussetzt. Die initiale Verfügbarkeit schließt die Europäische Union, die Schweiz und das Vereinigte Königreich aus. Planen Sie Workflows in Deutschland deshalb ohne Record & Replay.

Modellnamen wechseln. Laut OpenAI Help sind GPT-5.4 und GPT-5.4 mini in Codex bei ChatGPT-Login seit dem 31. August 2026 nicht mehr verfügbar. Als Ersatz nennt Help GPT-5.6 Terra und GPT-5.6 Luna. Die API-Nutzung mit eigenem Schlüssel bleibt davon unberührt. Welche Modelle Ihr Client heute anbietet, prüfen Sie unter /model.

Für den Alltag in Deutschland zählen drei Kontrollen. Erstens die Trainings- und Datenoptionen in ChatGPT, die laut Help auch für Codex-Inhalte gelten. Zweitens enge Berechtigungen am Rechner. Drittens keine Secrets in Prompts oder Aufzeichnungen. Wer Gemini 4 als alternative Cloud-KI prüfen will, findet den Einstieg im Guide Gemini 4 in Deutschland.

Fazit

Für den Einstieg reichen ein ChatGPT-Konto, ein passender Client und ein enger erster Auftrag. Installieren Sie die CLI oder öffnen Sie den Codex-Modus in der Desktop-App. Melden Sie sich an. Legen Sie mit /init eine AGENTS.md an. Starten Sie mit Lesen und Erklären, bevor Sie Schreibrechte freigeben.

Cloud gehört nicht zu Free und Go. Record & Replay steht in der EU nicht zur Verfügung. Für die Feinsteuerung laufender Nachrichten nutzen Sie Steer und Queue und unseren Folgeschritt dazu. Codex bleibt so ein Werkzeug unter Ihrer Kontrolle.

Quellen

  • OpenAI Help Center: Codex mit Ihrem ChatGPT-Tarif verwenden, abgerufen 16.10.2026
  • ChatGPT Learn: Codex CLI, Installations- und Befehlsleitfaden, abgerufen 16.10.2026
  • OpenAI Academy: Codex How to Start / Quickstart, abgerufen 16.10.2026
  • ChatGPT Learn: Best practices für Codex, abgerufen 16.10.2026
  • ChatGPT Pricing: chatgpt.com/pricing (Limits und Credits, ohne eigene Euro-Angaben in diesem Artikel)

Für diesen Artikel wurden KI-gestützte Recherche- und Editierwerkzeuge verwendet. Der Inhalt wurde redaktionell geprüft.