Codex verwenden: kompletter Einstiegsleitfaden für CLI, IDE Extension, Codex Cloud und Desktop-App

Wenn Sie Codex zum ersten Mal nutzen, bitten Sie es nicht sofort, das ganze Projekt zu refactoren. Öffnen Sie zuerst das Repository und geben Sie ihm eine kleine Aufgabe, die Sie in etwa 20 Minuten prüfen können.

Überblick über die Entry Points

OpenAI Codex ist weder nur ein Terminal-Tool noch nur ein Editor-Plugin. Es ist ein coding agent, den Sie über mehrere Entry Points nutzen können. In der offiziellen Dokumentation sehen Sie CLI, IDE extension, Codex app und Codex web/cloud. Authentifizierung und Grundfähigkeiten ähneln sich, aber die passenden Einsatzfälle unterscheiden sich deutlich.

Vier Entry Points im Vergleich

Entry Point	Definition	Geeignet für	Typische Nutzer	Einschränkung
CLI	Coding agent im lokalen Terminal	Bestehende lokale Repositories, kleine Änderungen, Kommandozeilen-Workflows	Terminal-Power-User, CI-Umgebungen	Benötigt ein lokales Git-Repository; Dateiänderungen sind lokal sichtbar
IDE Extension	Zusammenarbeit in der Editor-Sidebar	Aktuelle Editor-Arbeit, kürzerer Kontext über open files / selected code	VS Code / Cursor / Windsurf / JetBrains Nutzer	Hängt von der Editor-Umgebung ab; komplexe Aufgaben können an Cloud delegiert werden
Codex App	Desktop command center	Mehrere Threads, worktrees, automations, Git-Verwaltung	Lokale Nutzer mit mehreren parallelen Aufgaben	macOS / Windows verfügbar; Linux-Verfügbarkeit auf der offiziellen Seite prüfen
Codex Cloud/Web	Cloud-Agent mit GitHub-Anbindung	Remote-Repositories, PRs, asynchrone Aufgaben, Arbeit ohne eigenen Rechner	Teamnutzer, Remote-Repository-Workflows	Enterprise workspaces können admin setup benötigen

Authentifizierung und Funktionsumfang

Codex unterstützt zwei Authentifizierungswege. Der Funktionsumfang ist aber nicht identisch:

Authentifizierung	Verfügbare Entry Points	Cloud-Funktionen	Geeignet für
ChatGPT account (Plus/Pro/Business/Edu/Enterprise)	Alle Entry Points (CLI/IDE/App/Cloud)	Enthält GitHub code review, Slack und weitere cloud-based features	Einzelne Abonnenten und Teams
API key	CLI, SDK, IDE Extension	Enthält GitHub code review, Slack und weitere cloud-based features nicht	CI, Automatisierung und API-abgerechnete Workflows

Preise, Limits und konkrete Funktionsfreigaben sollten Sie auf der offiziellen pricing-Seite und in Ihrem account dashboard prüfen. Wenn Sie sich mit einem API key anmelden und Cloud-Funktionen nicht verfügbar sind, ist das ein Unterschied der surface, kein Defekt.

CLI Entry Point

Die CLI ist ein coding agent, der im lokalen Terminal läuft. Sie kann den Code im ausgewählten Verzeichnis lesen, Dateien ändern, Befehle ausführen und Ergebnisse prüfen. Deshalb passt sie gut, wenn bereits ein lokales Repository vorhanden ist.

CLI-Definition und Einsatzfälle

Die Kernfähigkeit der CLI ist Arbeit innerhalb eines lokalen Repositories: Code lesen, Dateien ändern, Tests ausführen, Lint ausführen, Fehler prüfen und einen Diff erzeugen. Sie müssen die Datei nicht im Editor geöffnet haben. Eine Aufgabenbeschreibung im Terminal reicht.

Geeignet für die CLI:

• Es gibt ein lokales Git-Repository.
• Die Aufgabe betrifft mehrere Dateien oder braucht Befehle zur Verifikation.
• Änderungen sollen lokal sichtbar sein, damit Sie git diff und Commits nutzen können.
• Sie arbeiten in CI oder mit Automatisierungsskripten.

Nicht geeignet für die CLI:

• Es gibt noch kein lokales Repository; dann müssen Sie zuerst clonen.
• Sie wollen nur die aktuell geöffnete Datei ändern; dafür ist die IDE extension bequemer.
• Sie brauchen einen Remote-PR-Workflow; dafür passt Cloud besser.

CLI-Installation und Anmeldung

Installation und Anmeldung können sich ändern. Betrachten Sie die folgenden Punkte daher als groben Ablauf und prüfen Sie die exakten Befehle auf der offiziellen CLI-Seite:

1. Installationsweg auf der offiziellen CLI-Seite wählen: Die aktuelle offizielle Seite bietet einen standalone installer. Ältere Artikel erwähnen möglicherweise npm-Installation, aber die aktuelle offizielle Seite ist maßgeblich.
2. Erster Start: Nach der Installation führen Sie codex aus und folgen dem Anmeldeprozess.
3. Anmeldeweg wählen: Sie können einen ChatGPT account oder einen API key nutzen. Ein ChatGPT account deckt alle surfaces ab; ein API key ist auf CLI, SDK und IDE extension beschränkt und enthält keine Cloud-Funktionen.

Die CLI unterstützt macOS, Windows und Linux. Unter Windows können Sie den PowerShell native sandbox oder WSL2 nutzen; Details sollten Sie mit der offiziellen CLI-Seite abgleichen.

Häufige CLI-Befehle

Die CLI bietet interactive und non-interactive Modi. Diese 6 Befehle oder Befehlsgruppen sollten Einsteiger zuerst kennen. Namen können sich ändern, prüfen Sie bei Bedarf die CLI reference.

Befehl	Zweck	Beispiel
codex	Interactive mode für dialogbasierte Arbeit im Terminal	codex
codex exec	Non-interactive mode für CI oder Skripte	codex exec "fix the CI failure"
codex login	Anmelden oder Konto wechseln	codex login
codex update	CLI aktualisieren	codex update
codex doctor	Umgebungskonfiguration und Probleme prüfen	codex doctor
Häufige flags	Berechtigungen, Modell, sandbox und approvals anpassen	--sandbox read-only, --model, --ask-for-approval

Die CLI reference enthält weitere Befehle und flags wie codex apply, codex cloud und codex app. Manche Befehle können unterschiedliche Reifegrade haben. Lernen Sie als Anfänger zuerst den interactive mode; codex exec ist der nächste Schritt für Automatisierung.

Die erste CLI-Aufgabe

Die Regel für die erste Aufgabe ist einfach: Wählen Sie ein bestehendes Repository und geben Sie Codex eine Aufgabe, die Sie in etwa 20 Minuten prüfen können.

Die offiziellen best practices empfehlen einen Prompt mit vier Teilen:

Prompt-Teil	Bedeutung	Beispiel
Goal	Ziel der Aufgabe	„Den veralteten Installationsbefehl im README korrigieren“
Context	Relevanter Kontext	„Das ist ein Node.js-Projekt. Im README steht npm install, tatsächlich nutzt das Projekt inzwischen yarn.“
Constraints	Grenzen der Änderung	„Nur das README ändern. Keine anderen Dateien anfassen. Danach node README-example.js ausführen, um den Befehl zu prüfen.“
Done when	Abnahmekriterium	„Der README-Befehl ist aktualisiert und node README-example.js liefert die erwartete Ausgabe.“

Gute erste Aufgaben:

• Einen veralteten README-Befehl oder Link korrigieren.
• Einen fehlenden Test ergänzen oder einen failing test reparieren.
• Einen kleinen Bug mit klarer Fehlermeldung beheben.
• Einen TODO-Kommentar bereinigen.
• Einem Modul eine einfache Typannotation hinzufügen.

Vermeiden Sie als erste Aufgabe:

• Arbeit an Secrets oder Produktionsdaten.
• Große Refactorings oder komplette neue Features.
• Unklare Abnahmekriterien wie „Performance optimieren“.

CLI-Abnahmecheckliste

Wenn die CLI fertig ist, prüfen Sie das Ergebnis in dieser Reihenfolge:

1. Diff lesen: Führen Sie im Terminal git diff aus und prüfen Sie, ob die Änderung zur Aufgabe passt. Verlassen Sie sich nicht nur auf die Meldung „fertig“.
2. Tests ausführen: Wenn das Projekt Tests hat, führen Sie npm test oder den passenden Befehl aus.
3. Lint oder Typecheck ausführen: Wenn vorhanden, prüfen Sie, ob neue Fehler hinzugekommen sind.
4. Befehlsausgabe prüfen: Wenn die Aufgabe einen bestimmten Befehl enthält, kontrollieren Sie die erwartete Ausgabe.
5. Secrets von der ersten Aufgabe fernhalten: Wenn die Aufgabe sensible Konfiguration berührt, prüfen Sie zuerst manuell, ob der agent sie überhaupt ändern sollte.

Committen oder pushen Sie erst nach bestandener Prüfung. Wenn die Änderung nicht passt, stellen Sie sie mit Git zurück, präzisieren den Prompt und versuchen es erneut.

IDE Extension Entry Point

Die IDE extension bringt Codex in die Sidebar Ihres Editors. Sie passt, wenn Sie bereits im Editor arbeiten. Der Vorteil ist der kürzere, präzisere Kontext: open files, selected code und explizite @file-Referenzen, ohne das ganze Projekt im Terminal erklären zu müssen.

IDE-Definition und Einsatzfälle

Die IDE extension ersetzt den Editor nicht. Sie bettet Codex als coding agent in den Editor-Workflow ein. Kontext kommt aus aktuell geöffneten Dateien, ausgewählten Codefragmenten oder Dateien, die Sie mit @file explizit referenzieren. Für lokale Änderungen kann das präziser sein.

Geeignet für die IDE extension:

• Sie arbeiten in VS Code, Cursor, Windsurf oder JetBrains.
• Die Aufgabe betrifft die aktuelle Datei oder wenige verwandte Dateien.
• Sie möchten Änderungen direkt im Editor verfolgen.
• Sie müssen eine bestimmte Datei als Kontext referenzieren.

Nicht geeignet für die IDE extension:

• Es gibt keine Editor-Umgebung; dann ist die CLI einfacher.
• Die Aufgabe soll lange im Hintergrund laufen; dann kann Cloud übernehmen.
• Die Aufgabe betrifft viele Dateien oder komplexe Befehlsabläufe; dann passen CLI oder Cloud besser.

Unterstützte IDEs

Die IDE extension unterstützt die folgenden Editoren. Prüfen Sie die aktuelle Verfügbarkeit auf der offiziellen IDE-Seite.

Editor	Hinweis
VS Code	Offiziell unterstützt
Cursor	VS-Code-Fork, kompatibel mit der VS Code extension
Windsurf	VS-Code-Fork, kompatibel mit der VS Code extension
JetBrains	Unterstützt Rider, IntelliJ, PyCharm, WebStorm und verwandte IDEs, abhängig von offizieller Verfügbarkeit

Wenn Sie in Cursor oder Windsurf arbeiten, stehen Codex extension und die eingebauten KI-Funktionen des Editors nebeneinander. Codex ist ein weiterer coding agent, den Sie je nach Aufgabe wählen können.

IDE-Installation und Anmeldung

Folgen Sie für aktuelle Schritte der offiziellen IDE-Seite:

1. Aus dem Extension Marketplace installieren: Suchen Sie in VS Code, Cursor, Windsurf oder JetBrains nach der Codex extension.
2. Anmelden: Nutzen Sie einen ChatGPT account oder einen API key. Ein ChatGPT account deckt alle surfaces ab; ein API key enthält keine Cloud-Funktionen.

IDE-Kontext

Der wichtigste Vorteil der IDE extension ist Editor-Kontext:

Kontexttyp	Bedeutung	Beispiel
Open files	Aktuell geöffnete Dateien stehen als Kontext bereit	Öffnen Sie example.tsx, dann kann Codex die Datei direkt prüfen
Selected code	Der ausgewählte Codeausschnitt wird Kontext	Wählen Sie eine Funktion aus und bitten Sie Codex um Erklärung oder Refactoring
@file-Referenz	Eine andere Datei explizit per Namen referenzieren	@example.tsx bitte die Typdefinitionen dieser Komponente prüfen
Reasoning effort	Den Denkaufwand des agents anpassen	low/medium/high; für schwierigere Aufgaben höher setzen

Die IDE extension unterstützt außerdem Chat, Agent und Agent Full Access modes. Der Unterschied liegt in Berechtigungen und Automatisierungsgrad. Beginnen Sie mit dem Standard-Agent-Mode und ändern Sie ihn erst, wenn Sie die Trade-offs kennen.

Von der IDE an Cloud delegieren

Die IDE extension kann Aufgaben an Codex Cloud delegieren. Das passt, wenn:

• die Aufgabe länger laufen kann,
• ein Remote-Repository beteiligt ist,
• Sie den Rechner verlassen möchten, während die Arbeit weiterläuft,
• eine komplexe Aufgabe im Hintergrund laufen und später geprüft werden soll.

Häufige slash commands können wie folgt aussehen. Namen können sich ändern; prüfen Sie die IDE features page:

Befehl	Zweck
/cloud	Die aktuelle Aufgabe an Cloud delegieren
/local	Die Aufgabe lokal ausführen
/review	Base branch, uncommitted changes oder einen Commit reviewen
/status	Cloud-Task-Status prüfen

Nach /cloud zeigt die IDE den Task-Status an. Wenn die Cloud-Aufgabe fertig ist, kehren Sie zurück und prüfen Diff und Ergebnis.

Codex App Entry Point

Codex app ist ein Desktop command center für mehrere Threads und Git-Verwaltung. Es ist kein weiterer Chat. Die App kann Verlauf und Konfiguration aus CLI und IDE extension aufgreifen, sodass Sie an einem bestehenden Projekt leichter weiterarbeiten können.

App-Definition und Einsatzfälle

Die App konzentriert sich auf mehrere Threads, worktrees, automations und Git-Operationen. Sie ist nützlich, wenn Sie parallele Aufgaben, einen Diff-Pane und Git-Integration in einer lokalen Arbeitsumgebung brauchen.

Geeignet für die App:

• Sie brauchen mehrere Task-Threads gleichzeitig.
• Sie möchten parallele Arbeit über worktrees isolieren.
• Sie möchten einen visuellen Diff-Pane und Git-Operationen.
• Sie möchten einen Desktop-Workflow mit integriertem terminal.

Nicht geeignet für die App:

• Sie wollen nur die aktuell geöffnete Datei ändern; dafür ist die IDE extension angenehmer.
• Es gibt kein lokales Repository; nutzen Sie Cloud oder clonen Sie zuerst.
• Sie brauchen nur eine schnelle Aufgabe; dafür ist die CLI schneller.

App-Plattformunterstützung

Codex app unterstützt macOS und Windows. Prüfen Sie die Linux-Verfügbarkeit auf der offiziellen app-Seite.

App-Installation und Anmeldung

Folgen Sie für aktuelle Schritte der offiziellen app-Seite:

1. Herunterladen und installieren: Laden Sie den macOS- oder Windows-Installer von der offiziellen app-Seite.
2. Anmelden: Nutzen Sie einen ChatGPT account oder einen API key. Je nach offizieller guidance können einige Funktionen mit API key nicht verfügbar sein.
3. Projekt wählen: Beim ersten Start wählen Sie ein lokales Projektverzeichnis.

App Thread Modes

Die App bietet drei thread modes: Local, Worktree und Cloud.

Thread Mode	Bedeutung	Geeignet für
Local	Arbeitet direkt im aktuellen Projektverzeichnis	Kleine Änderungen, einzelne Threads, Standard für die erste Nachricht
Worktree	Erstellt einen isolierten worktree für den Thread	Parallele Aufgaben, isolierte Änderungen, Konfliktvermeidung
Cloud	Delegiert die Aufgabe an Codex Cloud	Remote-Repositories, PRs, lange laufende Aufgaben

Den detaillierten worktree-Workflow heben wir für einen späteren Guide auf. Als Anfänger beginnen Sie mit Local mode.

Kernfunktionen der App

Zu den Kernfunktionen der App gehören:

Funktion	Bedeutung
Diff pane	Dateiänderungen visuell prüfen und Chunks stagen oder revertieren
Git-Operationen	Commit, Push, PR-Erstellung und ähnliche Git-Flows unterstützen
Integriertes terminal	Cmd+J öffnet unter macOS das Terminal; aktuelle Shortcuts stehen auf der offiziellen Seite
IDE-Sync	IDE extension und app können im gleichen Projekt synchron arbeiten
Gemeinsame MCP settings	CLI, IDE und app können MCP settings teilen

Die App enthält auch einen in-app browser. Seiten, die einen eingeloggten Browser-Profile benötigen, funktionieren dort aber nicht zuverlässig. Öffnen Sie solche Seiten lieber im externen Browser.

Codex Cloud/Web Entry Point

Codex web/cloud verbindet sich mit einem GitHub account und lässt Codex in einem Remote-Repository arbeiten und PRs erstellen. Das passt zu Teams, Remote-Repositories und Aufgaben, die weiterlaufen sollen, während Sie nicht am Rechner sind.

Cloud-Definition und Einsatzfälle

Cloud steht für Remote-Repositories, PRs und asynchrone Arbeit. Es erstellt einen Cloud-Container, checkt das Repository aus, führt setup scripts aus, bearbeitet die Aufgabe und liefert Diff und Antwort zurück.

Geeignet für Cloud:

• Remote-Repositories, die Sie lokal nicht ändern möchten.
• PR-Flows, in denen Codex einen PR erstellen oder reviewen soll.
• Arbeit, die weiterlaufen soll, während Sie nicht am Rechner sind.
• Team-Workflows mit Review und Zusammenarbeit.

Nicht geeignet für Cloud:

• Kleine lokale Änderungen; dafür passen CLI oder IDE besser.
• Ihre allererste Aufgabe, die Sie besser lokal prüfen.
• Sehr interaktive Aufgaben, weil Cloud asynchron arbeitet.

Geeignete Cloud-Aufgaben

Cloud eignet sich für diese Aufgabentypen:

Aufgabentyp	Hinweis
PR review	Einen PR in einem Remote-Repository reviewen
Komplexe oder lange laufende Arbeit	Aufgaben ausführen, die mehr Zeit brauchen
Parallele Aufgaben	Mehrere Aufgaben gleichzeitig delegieren
Änderungen in Remote-Repositories	Änderungen ohne lokalen Checkout durchführen

Werfen Sie am ersten Tag kein großes Refactoring oder komplettes Feature in Cloud. Nutzen Sie zuerst CLI oder IDE lokal, lernen Sie die Ergebnisse zu prüfen, und verschieben Sie dann passende Aufgaben in Cloud.

Enterprise workspaces können admin setup benötigen. Prüfen Sie die offizielle Cloud-Seite und Ihre workspace policy.

Cloud-Ablauf

Eine Cloud task läuft grob in fünf Schritten:

1. Container erstellen: Cloud erstellt die Laufzeitumgebung.
2. Repository auschecken: Das GitHub-Repository wird ausgecheckt.
3. Setup script ausführen: Falls vorhanden, wird das konfigurierte setup script ausgeführt.
4. Agent loop ausführen: Der agent führt Befehle aus, prüft Ergebnisse und arbeitet bis zur Fertigstellung weiter.
5. Diff und Antwort zurückgeben: Nach Abschluss sehen Sie Diff und Antwort.

Container-Caching kann bis zu 12 Stunden dauern. Prüfen Sie die aktuelle Cache-Policy auf der offiziellen Cloud environments page.

Cloud-Sicherheitshinweise

Cloud hat einige wichtige Sicherheitsgrenzen:

Sicherheitsaspekt	Bedeutung
Secrets sind nur während setup verfügbar	Secrets stehen setup scripts zur Verfügung und werden vor der agent phase entfernt. Lassen Sie die agent phase nicht von scripts abhängen, die Secrets lesen.
Die agent phase hat standardmäßig kein Internet	Internet access ist in der agent phase standardmäßig off, kann aber limited oder unrestricted konfiguriert werden. Gehen Sie nicht davon aus, dass der agent externe Dienste erreicht.
Cache hält bis zu 12 Stunden	Container-Cache ist kein Langzeitspeicher. Rechnen Sie nicht damit, dass Zustand dauerhaft erhalten bleibt.

Die detaillierte Sicherheitskonfiguration gehört in den späteren Guide zu Berechtigungen, sandboxes und Secrets.

Nächste Schritte

Wenn Codex nach der ersten Aufgabe denselben Fehler beim zweiten oder dritten Lauf wiederholt, ist es Zeit für eine AGENTS.md-Projektanleitung. AGENTS.md enthält projektspezifische Hinweise für coding agents, damit Sie denselben Kontext nicht in jedem Prompt wiederholen müssen.

Empfohlene Folgethemen:

• AGENTS.md-Projektregeln: Projektanweisungen festhalten und wiederholten Kontext reduzieren.
• Worktree-Isolation: Mehrere Aufgaben parallel ausführen, ohne Änderungen zu vermischen.
• Cloud-Workflow: Remote-Repositories, PRs und Umgebungseinrichtung.
• Berechtigungen, sandboxes und Secrets: Sicherheitsgrenzen und Konfiguration.
• Vergleich dreier Tools: Codex vs Claude Code vs Cursor in echten Projekten.
• codex exec-Automatisierung: CI-Aufrufe und scriptbasierte Automatisierung.

Verwandte BetterLink-Artikel:

• Überblick über AI coding tools 2026
• Claude Code CLI produktiv nutzen
• Cursor workflow in der Praxis
• Codex gateway und harness