OpenAIs offizielle Coding-Agent-CLI. Installation, Authentifizierung, Autonomiemodi und ein Vergleich mit Claude Code — in 30 Minuten.

OpenAI bietet jetzt eine eigene Coding-Agent-CLI. Codex CLI ist das OpenAI-Pendant zu Anthropics Claude Code: auf GPT-5 (oder der o1/o3-Linie) aufgebaut, mit autonomer Shell-Ausführung, Mehrfachdatei-Bearbeitung und einem Plan-dann-Ausführen-Ablauf.

Ich denke, was das Ökosystem der Coding-Agenten gerade so interessant macht, ist nicht die Konkurrenz zwischen den Tools, sondern die Aufgabenteilung — weil verschiedene Modelle echte komplementäre Stärken mitbringen, vielmehr als bloße Alternativen zueinander. Früher gab es nur einen Weg, mit KI-Tools zu arbeiten; heute lässt sich die Arbeit sinnvoll aufteilen, da jedes Tool seinen Bereich hat.

Dieser Leitfaden richtet Codex CLI ein und erklärt — für alle, die bereits Claude Code oder Cursor verwenden — welche Aufgaben sich für Codex eignen. Neu dabei? Diesen Leitfaden am besten parallel zu Claude Code einrichten lesen.

TL;DR

Node.js 20+ → npm install -g @openai/codex → codex → Browser-Auth
OpenAI-API-Key oder ChatGPT Plus/Pro-Abonnement verwenden
Standard ist der Genehmigungsmodus (jeden Befehl bestätigen) — --auto-edit / --full-auto erhöhen die Autonomie
Modell wählen: --model gpt-5 oder o3 (Performance vs. Kosten-Abwägung)
Aufgabenteilung mit Claude Code: siehe §5

Voraussetzungen

Node.js 20+ (mac/dev-toolchain oder windows/initial-setup)
OpenAI-Konto — platform.openai.com oder ChatGPT Plus/Pro
Ein git-verwaltetes Projekt

1. Wo Codex CLI passt

Codex CLI ist OpenAIs eigene Coding-Agent-CLI. Im Gegensatz zu Drittanbieter-Tools (Cursor, Aider, Continue), die OpenAI-Modelle lediglich aufrufen, ist Codex CLI OpenAIs offizielle Referenzimplementierung.

Ähnlichkeiten mit Claude Code

Läuft autonom im Terminal
Mehrfachdatei-Bearbeitung · Shell-Befehle · git-Integration
Projektkontext (Codex speichert ihn im .codex/-Verzeichnis)
Plan → Ausführen → Überprüfen-Workflow (ähnlich wie Claude Codes Plan-Modus)

Unterschiede

Aspekt	Codex CLI	Claude Code
Modell	GPT-5 · o3 · o4	Claude Opus / Sonnet / Haiku
Kontextfenster	200K (je nach Modell)	1M (Opus/Sonnet 4)
Autonomie-Flags	`--auto-edit`, `--full-auto`	Berechtigungsmodus + Hooks
Auth	API-Key oder ChatGPT-Abonnement	API-Key oder Pro/Max-Abonnement
Preisgestaltung	Token-basiert oder Plus($20)/Pro($200)	Token-basiert oder Pro($20)/Max($100/$200)
MCP-Unterstützung	Teilweise (in Entwicklung)	Vollständig
IDE-Integration	Separate IDE-Erweiterung	VS Code · JetBrains · CLI

Für wen geeignet

Bereits bei ChatGPT Plus/Pro — Codex CLI ist enthalten
Bereits im OpenAI-Ökosystem — Keys mit Embeddings, DALL·E etc. teilen
o3/o4-Reasoning-Vorteil gewünscht für Aufgaben mit langem Denken
GPT-5 Multimodal benötigt — Bilder / Diagramme als Eingabe

2. Installation

2.1 npm global

npm install -g @openai/codex
codex --version

Bei Installationsfehlern oder Berechtigungsproblemen: Workaround für npm-Präfix unter Claude Code einrichten §1.1 nachlesen.

2.2 Erster Start

cd ~/projects/my-repo
codex

Ein Browser-Tab öffnet sich für OpenAI-Login → Zugriff gewähren → zurück zur CLI. Das Token wird im OS-Keychain gespeichert.

2.3 Auth-Optionen

Drei Wege:

# A. ChatGPT Plus/Pro (Abonnement)
codex auth login --use-chatgpt
 
# B. OpenAI-API-Key
codex auth login --use-api
# → liest OPENAI_API_KEY oder fragt nach
 
# C. Dediziertes Codex.com-Konto (Beta)
codex auth login --use-codex

Prüfen:

codex auth status
# Account: <E-Mail>
# Plan: ChatGPT Plus / API tier 2

3. Autonomiemodi

Der Standard ist bewusst konservativ — jeden Shell-Befehl und jede Bearbeitung einzeln bestätigen. Verfügbare Autonomiestufen:

Flag	Verhalten	Risiko
(Standard)	Vor jedem Befehl und jeder Bearbeitung fragen	Niedrig
`--auto-edit`	Bearbeitungen automatisch, Shell fragt noch	Mittel
`--full-auto`	Alles automatisch (gefährlich)	Hoch

Empfehlung: zunächst beim Standard bleiben, bis das Tool vertraut ist — dann für bekannte Repos auf --auto-edit wechseln.

codex --auto-edit
> Auth-Modul in kleinere Dateien refaktorieren

4. Kernbefehle

4.1 Eine Sitzung starten

codex
> Plan: Passwort-Zurücksetzen-Funktion hinzufügen

Natürlichsprachiger Prompt → Codex schlägt einen Plan vor → Bestätigen → Ausführen.

4.2 Slash-Commands

In einer Sitzung:

/help — Befehlsliste
/init — Projekt analysieren und AGENTS.md erstellen
/model gpt-5 — Modell wechseln
/clear — Kontext zurücksetzen
/exit — Beenden

4.3 `AGENTS.md` — Projektanleitung

Das Pendant zu Claude Codes CLAUDE.md. Im Projektstamm anlegen:

# AGENTS.md
 
## Stack
- Next.js 16 + TypeScript strict
- Supabase + Postgres
- pnpm 11
 
## Befehle
- Dev: `pnpm dev`
- Test: `pnpm test`
- Build: `pnpm build`
 
## Konventionen
- Keine `any`-Typen
- Routen: kebab-case
- Commits: `[Projekt] Typ: Beschreibung`
 
## Arbeitsprinzipien
- Bei 5+ Dateiänderungen zuerst planen
- Tests + Lint + Build müssen vor „fertig" bestehen
- Niemals Secrets einchecken

Wird beim Sitzungsstart automatisch geladen und ist funktional nahezu identisch mit CLAUDE.md.

Wenn beide Tools im selben Repo genutzt werden: entweder den Inhalt zwischen CLAUDE.md und AGENTS.md duplizieren, oder nur AGENTS.md führen und von CLAUDE.md via @AGENTS.md darauf verweisen.

5. Claude Code vs. Codex CLI — Aufgabenzuordnung

Aufgabe	Wahl	Warum
1M-Kontext Mehrfachdatei-Arbeit	Claude Code	Opus/Sonnet 4s 1M-Fenster
Langes Reasoning (Debugging, Architektur)	Codex CLI (o3)	Reasoning-Modell-Vorteil
Code + Bild (Screenshot-Analyse)	Codex CLI (GPT-5 multimodal)	Bildeingabe
Autonome Verifikation nach Änderungen	Claude Code	Hooks + Verify-System
OpenAI-Ökosystem-Integration (Embeddings etc.)	Codex CLI	Einheitliche Keys
MCP-Server (Linear, Notion etc.)	Claude Code	Vollständiges MCP
Kostenminimierung	Das Abonnement, das bereits vorhanden ist	API-Tokens vermeiden

Beide Tools arbeiten konfliktfrei im selben Repo (beide git-basiert).

6. Preisgestaltung (Stand 2026-05)

API-Preise (Codex CLI)

Modell	Eingabe	Ausgabe	Kosten pro 1k
GPT-5	$1,25 / 1M	$10 / 1M	Niedrige Eingabekosten
o3	$2 / 1M	$8 / 1M	Reasoning-optimiert
o4-mini	$0,30 / 1M	$1,20 / 1M	Bestes Preis-Leistungs-Verhältnis

Abonnements

Plan	Preis	Codex CLI Nutzung
ChatGPT Plus	$20/Mo	GPT-5 begrenzt, etwas o3
ChatGPT Pro	$200/Mo	Nahezu unbegrenzt

Tatsächliche Kosten variieren je nach Nutzungsintensität. Grober Durchschnitt für einen Fullstack-Entwickler via API: $30–100/Monat. Vielnutzer fahren mit dem Pro-Plan günstiger.

7. Überprüfen

# 1. Installiert
codex --version
 
# 2. Auth
codex auth status
 
# 3. Projektdateien
ls -la AGENTS.md .codex/
 
# 4. Erster Befehlstest
echo "create a hello.py that prints 'hello'" | codex --auto-edit

Alle vier bestanden — Einrichtung vollständig.

8. Fehlerbehebung

`codex: command not found`

npm-Präfix prüfen: /bin von npm config get prefix muss im PATH sein
Neues Terminal öffnen und erneut versuchen

Browser-Auth öffnet sich nicht

Headless-Umgebung (WSL2/SSH): URL aus der CLI in einen Browser kopieren
Immer noch fehlerhaft? ~/.codex/auth.json löschen und codex auth login --use-api mit einem Key verwenden

„Insufficient quota"

OpenAI-Nutzungslimit erreicht — platform.openai.com/usage
Das kostenlose Tier ist stark eingeschränkt. Tier 1+ (nach $10 Vorauszahlung aktiviert) ist das praktische Minimum

Codex und Claude Code bearbeiten dieselbe Datei gleichzeitig

Nur eines der beiden Tools gleichzeitig verwenden oder das zweite warten lassen
Alternativ eine .codex-lock-Sentinel-Datei zur Koordination in .gitignore aufnehmen

`--full-auto` lief zu aggressiv

Sofort Ctrl+C
git reset --hard HEAD oder git stash zur Wiederherstellung
Künftig bei --auto-edit bleiben

MCP-Server stellt keine Verbindung her

Stand 2026-05 ist die MCP-Unterstützung in Codex CLI noch unvollständig (Beta)
Für vollständige MCP-Integration Claude Code verwenden

9. Was als Nächstes kommt

Claude Code einrichten — /ai-agents/claude-code
Cursor einrichten — /ai-agents/cursor-setup
Copilot einrichten — /ai-agents/github-copilot
Multi-Tool-Workflow — /ai-agents/multi-tool-workflow

Referenzen

Changelog

2026-05-16: Erster Entwurf. Codex CLI Installation + drei Auth-Methoden + Autonomiemodi + AGENTS.md + Claude Code-Vergleichstabelle + sechs Fehlerbehebungsfälle.

OpenAI Codex CLI einrichten — Vergleich mit Claude Code und Cursor