OpenAI Codex CLI: Der vollständige Entwicklerleitfaden (2026)

Alles, was Sie für den Einstieg in OpenAI Codex CLI brauchen — Installation, Konfiguration und Erweiterung mit Video-, Bild- und Websuchfunktionen. Der einzige Leitfaden, den Sie 2026 benötigen.

by AnyCap

OpenAI Codex CLI ist der agentische Coding-Assistent, der in Ihrem Terminal läuft — er plant Features, schreibt Code über Ihr gesamtes Repository hinweg, führt Shell-Befehle aus und liefert fertige Ergebnisse.

Anders als GitHub Copilot (der inline Vorschläge macht) arbeitet Codex CLI autonom. Sie beschreiben ein Ziel. Es liest Ihre Codebasis, plant die Implementierung, schreibt die Dateien, führt die Tests durch und berichtet zurück. Der komplette Ablauf — direkt im Terminal.

Hier ist alles, was Sie über Codex CLI in 2026 wissen müssen — Installation, Konfiguration, Erweiterung und Integration.


Was ist OpenAI Codex CLI?

Codex CLI ist das agentische Coding-Tool von OpenAI, das im April 2025 veröffentlicht und seitdem kontinuierlich bis 2026 weiterentwickelt wurde. Es unterscheidet sich von früheren „Codex"-Angeboten (dem API-Modell) in einem wesentlichen Punkt: Es führt Aktionen aus — nicht nur Vorschläge.

Was Codex CLI leistet:

  • Liest Ihr gesamtes Repository als Kontext (nicht nur die geöffnete Datei)
  • Plant mehrstufige Implementierungen, bevor eine einzige Zeile geschrieben wird
  • Führt Shell-Befehle aus (npm test, git commit, make build)
  • Schreibt, bearbeitet und refaktoriert Dateien über Verzeichnisse hinweg
  • Läuft in Schleifen, bis Tests bestehen oder ein blockierendes Problem auftaucht

Was es nativ nicht kann:

  • Bilder oder Videos generieren
  • Im Web suchen
  • Dateien in der Cloud speichern oder teilen
  • Externe APIs ohne benutzerdefinierte Integration aufrufen

Diese Lücken sind bewusst so gestaltet — und lassen sich schließen. Mehr dazu weiter unten.


Ein Entwickler arbeitet in einer terminalbasierten agentischen Coding-Umgebung mit Codex CLI

Codex CLI installieren

Voraussetzungen: Node.js 18+, ein OpenAI API-Schlüssel, macOS oder Linux (Windows via WSL). Node.js 20 LTS wird für beste Kompatibilität empfohlen.

npm i -g @openai/codex

API-Schlüssel setzen:

export OPENAI_API_KEY=sk-...

Oder fügen Sie ihn Ihrem Shell-Profil hinzu (~/.zshrc, ~/.bashrc), damit er sitzungsübergreifend gespeichert bleibt.

Installation überprüfen:

codex --version

MacBook mit Codex CLI bei der Ausführung einer mehrstufigen agentischen Aufgabe im Terminal

Codex CLI konfigurieren

Codex CLI liest seine Konfiguration aus ~/.codex/config.json. Erstellen oder bearbeiten Sie diese Datei:

{
  "model": "gpt-4.5",
  "notify": true,
  "approvalMode": "suggest"
}

Wichtige Konfigurationsoptionen:

Option Werte Wirkung
model gpt-4.5, o3, o4-mini Modell für Planung und Code-Generierung
approvalMode suggest, auto-edit, full-auto Wie eigenständig Codex ohne Ihre Genehmigung handelt
notify true / false Desktop-Benachrichtigungen bei Aufgabenabschluss
context Pfad oder auto Zusätzliche Kontextdateien einbeziehen

approvalMode im Detail:

  • suggest — Codex schlägt jede Änderung vor; Sie genehmigen manuell. Empfohlen für Produktions-Repos.
  • auto-edit — Codex bearbeitet Dateien ohne Genehmigung, fragt aber vor Shell-Befehlen nach.
  • full-auto — Codex plant und führt den gesamten Ablauf autonom aus. Am besten für isolierte Aufgaben oder saubere Feature-Branches.

Kernfunktionen von Codex CLI

Was Codex von Haus aus kann — ohne jede Erweiterung:

1. Agentische Code-Implementierung

codex "Add a rate limiter middleware to the Express API — 100 req/min per IP, return 429 with Retry-After header"

Codex liest Ihre Projektstruktur, identifiziert die richtigen Dateien, schreibt das Middleware, bindet es in app.js ein und fügt den Test hinzu.

2. Repository-weites Refactoring

codex "Migrate all fetch() calls in /src to use the axios wrapper in lib/http.js"

Codex findet jede Instanz im gesamten Repository, schreibt sie konsistent um und führt die Testsuite aus.

3. Test-Generierung

codex "Generate Jest tests for every exported function in /src/utils — aim for 80% branch coverage"

4. Shell-Befehl-Verkettung

Codex verkettet Befehle auf natürliche Weise:

npm run build && anycap video generate --prompt "product demo" --model veo-3.1 -o demo.mp4 && git add . && git commit -m "add demo"

Es kennt die Ausgabe jedes Befehls und passt sich entsprechend an. Schlägt npm run build fehl, diagnostiziert Codex den Fehler, anstatt einfach fortzufahren.

5. Dokumentations-Generierung

codex "Write a README for this project — setup instructions, API reference, and examples"

Codex CLI erweitern: Die Fähigkeitsschicht

Codex ist bewusst auf Coding-Aufgaben beschränkt. Videogenerierung, Bilderstellung, Websuche und Cloud-Speicher sind nicht eingebaut — sie leben in einer Fähigkeitsschicht, die Codex über Skills oder MCP-Server aufruft.

MCP-Server

Model Context Protocol Server ermöglichen Codex, externe Tools aufzurufen, als wären sie nativ eingebaut. Jeder MCP-Server verwaltet eine Fähigkeit — eine Video-API, eine Datenbank, ein Browser-Automatisierungstool.

Der Kompromiss: Jeder Server erfordert eigene Einrichtung, Authentifizierung und Wartung. Wenn Sie Video + Bild + Suche + Speicher benötigen, sind das vier separate Server.

Skills (CLI-basiert)

Skills sind CLI-Tools, die Codex erkennt und über Shell-Befehle aufruft. Das einfachste Erweiterungsmodell: eine CLI installieren, und Codex kann sie nutzen.

AnyCap ist der Skill, der die gesamte Fähigkeitslücke in einer einzigen Installation schließt — und die Einrichtung dauert unter 60 Sekunden:

  • Videogenerierung (Veo 3.1, Sora 2 Pro, Kling 3.0, Seedance 2.0)
  • Bildgenerierung (GPT Image 2, Seedream 5, Flux)
  • Websuche mit Quellenangaben
  • Cloud-Speicher und Dateifreigabe
npm i -g anycap
anycap login
anycap skill install --target ~/.codex/skills/anycap-cli/

Nach der Installation erkennt Codex alle anycap-Befehle als verfügbare Aktionen.


Was Sie mit Codex + AnyCap erreichen können

Produktdemo-Video generieren

anycap video generate \
  --prompt "a smooth walkthrough of a SaaS dashboard, clean UI, soft lighting" \
  --model veo-3.1 \
  -o demo.mp4

Codex implementiert das Feature. AnyCap generiert die Demo. In derselben Terminal-Sitzung.

→ Vollständiger Leitfaden: So generieren Sie Videos mit Codex

Bilder für Ihren Build generieren

anycap image generate \
  --prompt "product hero shot, dark UI, floating interface, product photography" \
  --model gpt-image-2 \
  -o hero.png

→ Vollständiger Leitfaden: So generieren Sie Bilder mit Codex

Das Web nach aktuellen Informationen durchsuchen

anycap search --prompt "best practices for API rate limiting 2026" --citations

Codex erhält zitierte, strukturierte Ergebnisse — sachliche Grundlage für die Code-Generierung.

→ Vollständiger Leitfaden: Codex Web-Suche Leitfaden 2026

Generierte Dateien speichern und teilen

anycap drive upload demo.mp4

Gibt einen teilbaren Link zurück. Codex kann diesen in die von ihm generierte Dokumentation einbetten.


Codex CLI vs. Claude Code vs. Cursor

Codex CLI Claude Code Cursor
Primäre Schnittstelle Terminal Terminal IDE (VS Code)
Modell GPT-4.5 / o3 / o4-mini Claude 3.7 / 4 GPT-4o / Claude
Repository-Kontext Vollständiges Repo Vollständiges Repo Datei-/Ordnerbereich
Shell-Ausführung Ja Ja Eingeschränkt
Ökosystem OpenAI-nativ Anthropic-nativ Multi-Modell
AnyCap-Support ~/.codex/skills/ ~/.claude/skills/ ~/.cursor/skills/
Am besten für OpenAI-Ökosystem, autonome Schleifen Komplexe Reasoning-Aufgaben, Subagenten-Parallelismus In-IDE-Bearbeitung + Generierung

Dieselben anycap-Befehle funktionieren in allen drei Tools — unterschiedlicher Installationspfad, identische Fähigkeiten.


Codex CLI + OpenAI-Ökosystem: Der vollständige Stack

Wenn Sie End-to-End mit OpenAI entwickeln:

# 1. Research (web-grounded)
anycap search --prompt "competitor features for project management SaaS 2026" --citations

# 2. Plan + implement (Codex)
codex "Add the top 3 missing features identified in the research to our roadmap page"

# 3. Generate visuals (GPT Image 2, via AnyCap)
anycap image generate --prompt "roadmap hero, timeline graphic, product UI" --model gpt-image-2 -o roadmap-hero.png

# 4. Generate demo video (Sora 2 Pro, via AnyCap)
anycap video generate --prompt "product roadmap walkthrough" --model sora-2-pro --mode image-to-video --param images=./roadmap-hero.png -o demo.mp4

# 5. Store and share
anycap drive upload demo.mp4

Codex + GPT Image 2 + Sora 2 Pro + AnyCap-Suche — alles OpenAI-nativ oder OpenAI-kompatibel, über eine einzige CLI gesteuert.


Häufige Fragen

Ist Codex CLI kostenlos?

Codex CLI ist kostenlos zu installieren. Sie zahlen für die API-Nutzung auf Ihrem OpenAI-Konto. Die Kosten hängen von der Modellwahl ab — o4-mini bewältigt typische Aufgaben für ca. 0,003–0,01 $ pro Sitzung, während o3 besser für komplexe Reasoning-Aufgaben bei ca. 0,05–0,15 $ pro Sitzung geeignet ist. AnyCap bietet neuen Nutzern 250 kostenlose Credits — genug für ~22 Bildgenerierungen oder 5 kurze Videos zum Ausprobieren der Fähigkeitsschicht.

Was ist der Unterschied zwischen Codex CLI und der Codex API?

Die Codex API (verfügbar 2021–2023) war ein Code-Vervollständigungsmodell — Sie sendeten einen Prompt und erhielten eine Vervollständigung. Codex CLI (2025+) ist ein agentisches System: Es liest Ihr Repo, plant Implementierungen, führt Shell-Befehle aus und liefert Code von Anfang bis Ende. Ein völlig anderes Paradigma.

Funktioniert Codex CLI unter Windows?

Ja, über WSL (Windows Subsystem for Linux). Nativer Windows-Support ist eingeschränkt; WSL 2 mit Ubuntu ist der empfohlene Weg.

Was bedeutet approvalMode: full-auto und wann sollte ich es verwenden?

Full-auto bedeutet, Codex führt den gesamten Plan aus — Dateibearbeitungen, Shell-Befehle, Test-Läufe — ohne bei jedem Schritt um Genehmigung zu bitten. Verwenden Sie es auf isolierten Feature-Branches, nicht auf Ihrem Haupt-Branch oder Produktions-Repos ohne vorherigen Review.

Kann Codex CLI parallel zu Claude Code verwendet werden?

Ja. Beide sind eigenständige Tools mit separaten Konfigurationen. Manche Teams nutzen Codex für die primäre Implementierungsschleife (OpenAI-Modelle) und Claude Code für längere Reasoning-Aufgaben oder parallele Subagenten-Workflows. AnyCap funktioniert mit beiden identisch.

Wie füge ich Videogenerierung zu Codex CLI hinzu?

AnyCap installieren (npm i -g anycap && anycap login), dann anycap skill install --target ~/.codex/skills/anycap-cli/ ausführen. Danach erkennt Codex anycap video generate als verfügbaren Befehl. Vollständiger Leitfaden: Codex-Videogenerierung.


Fazit

Codex CLI ist der leistungsfähigste terminal-native Coding-Agent des Jahres 2026. Einmal installiert und konfiguriert, bewältigt er den gesamten Coding-Ablauf autonom — Planung, Implementierung, Tests und Commits in einer einzigen unbeaufsichtigten Sitzung.

Die Lücke — Mediengenerierung, Websuche, Cloud-Speicher — schließt sich mit einer AnyCap-Installation. Dieselbe CLI, dieselbe Sitzung, vollständige Pipeline. Teams, die Codex + AnyCap einsetzen, berichten, dass sie vollständige Feature-zu-Demo-Zyklen (Code → Bild → Video) in einer einzigen Terminal-Sitzung abschließen, für die früher 3–4 separate Tools notwendig waren.


Vollständige Fähigkeiten zu Codex hinzufügen — AnyCap kostenlos installieren


📖 Was Sie als Nächstes lesen sollten


Verwandte Artikel


Geschrieben vom AnyCap-Team. Wir entwickeln die Capability Runtime, die Codex, Claude Code und Cursor Video-, Bild-, Such- und Speicherfunktionen über eine einzige CLI bereitstellt.