Codex Plugin für Claude Code (openai/codex-plugin-cc)
Übersicht
codex-plugin-cc ist ein offizielles OpenAI-Plugin, das die OpenAI Codex CLI direkt in den Claude Code Entwickler-Workflow integriert. Es ermöglicht Claude Code-Benutzern, Codex-gestützte Code-Reviews, gegnerische Design-Herausforderungen und die Delegation von Hintergrundaufgaben auszulösen – alles, ohne die Claude Code-Oberfläche verlassen zu müssen.
Das Plugin verbindet zwei leistungsstarke KI-Codierungsagenten: Anthropic's Claude Code und OpenAI's Codex CLI, was eine "zweite Meinung" und einen kollaborativen Multi-Agenten-Workflow ermöglicht.
Warum es existiert
Claude Code ist ein hervorragendes agentisches Codierungswerkzeug, aber die gleichzeitige Nutzung von Codex erforderte bisher einen Kontextwechsel und die manuelle Ausführung separater Werkzeuge. Dieses Plugin eliminiert diese Reibungsverluste:
- Codex ist besonders stark bei detaillierten, skeptischen Code-Reviews.
- Die Ausführung von zwei unabhängigen KI-Modellen für denselben Code fängt mehr Probleme ab als nur eines allein.
- Benutzer können Claude Code als ihre primäre Schnittstelle beibehalten und gleichzeitig spezifische Aufgaben an Codex auslagern.
Anforderungen
| Anforderung | Details |
|---|---|
| Authentifizierung | ChatGPT-Abonnement (kostenlose Stufe inklusive) oder OpenAI API-Schlüssel |
| Node.js | v18.18 oder neuer |
| Codex CLI | Global installiert über npm install -g @openai/codex |
Die Nutzung zählt zu Ihren bestehenden Codex-Nutzungslimits.
Installation
# 1. Fügen Sie die Marktplatzquelle innerhalb von Claude Code hinzu
/plugin marketplace add openai/codex-plugin-cc
# 2. Installieren Sie das Plugin
/plugin install codex@openai-codex
# 3. Laden Sie die Plugins neu
/reload-plugins
# 4. Überprüfen Sie die Einrichtung
/codex:setup
Wenn die Codex CLI nicht installiert ist, kann /codex:setup diese optional automatisch über npm installieren.
Kernbefehle
/codex:review
Führt eine standardmäßige, schreibgeschützte Codex-Code-Überprüfung Ihrer aktuellen, nicht committeten Änderungen oder eines Branch-Diffs durch.
/codex:review # Überprüfung nicht committeter Änderungen
/codex:review --base main # Überprüfung gegen den main-Branch
/codex:review --background # Im Hintergrund ausführen (empfohlen für große Diffs)
Anwendungsfall: Sanity-Check vor dem Versand, Überprüfung von Änderungen an mehreren Dateien.
/codex:adversarial-review
Eine steuerbare, meinungsstarke Überprüfung, die Ihre Implementierungsentscheidungen in Frage stellt – nicht nur oberflächlichen Code-Stil. Sie hinterfragt Annahmen, Kompromisse, Fehlerfälle und alternative Ansätze.
/codex:adversarial-review
/codex:adversarial-review --base main challenge whether the caching strategy is correct
/codex:adversarial-review --background look for race conditions
Anwendungsfall: Pre-Launch-Reviews, Architektur-Audits, Stresstests von Designentscheidungen in Bezug auf Authentifizierung, Datenverlust, Rollback und Zuverlässigkeit.
/codex:rescue
Delegiert eine Aufgabe an Codex als Hintergrund-Subagenten (codex:codex-rescue). Codex wird Fehler untersuchen, Korrekturen anwenden oder von einer früheren Sitzung fortfahren.
/codex:rescue investigate why the tests started failing
/codex:rescue fix the failing test with the smallest safe patch
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky test
/codex:rescue --background investigate the regression
/codex:rescue --resume apply the top fix from the last run
Sie können auch natürliche Sprache verwenden:
Ask Codex to redesign the database connection to be more resilient.
Unterstützte Flags: --background, --wait, --resume, --fresh, --model, --effort
/codex:status
Listet laufende und kürzlich abgeschlossene Codex-Jobs für das aktuelle Repository auf.
/codex:status
/codex:status task-abc123
/codex:result
Ruft die Ausgabe eines abgeschlossenen Codex-Jobs ab. Gibt auch die Codex-Sitzungs-ID zurück, um sie direkt in der Codex CLI wieder zu öffnen.
/codex:result
/codex:result task-abc123
/codex:cancel
Bricht eine aktive Hintergrund-Codex-Aufgabe ab.
/codex:cancel
/codex:cancel task-abc123
/codex:setup
Überprüft den Codex-Installations- und Authentifizierungsstatus. Verwaltet auch das optionale Review Gate.
/codex:setup --enable-review-gate # automatische Überprüfung jeder Claude-Antwort über den Codex Stop Hook
/codex:setup --disable-review-gate
⚠️ Das Review Gate kann eine langlaufende Claude/Codex-Feedbackschleife erzeugen und die Nutzungslimits schnell aufbrauchen. Überwachen Sie Sitzungen aktiv, wenn es aktiviert ist.
Typische Workflows
1. Überprüfung vor dem Versand
/codex:review
2. Übergabe eines schwierigen Problems
/codex:rescue investigate why the build is failing in CI
3. Langlaufende Hintergrundarbeit
/codex:adversarial-review --background
/codex:rescue --background investigate the flaky test
# Später überprüfen:
/codex:status
/codex:result
Konfiguration
Das Plugin übernimmt die Codex CLI-Konfiguration aus ~/.codex/config.toml (Benutzerebene) oder .codex/config.toml (Projektebene).
Beispiel für eine projektbezogene Konfiguration zur ständigen Verwendung von gpt-5.4-mini mit xhigh Aufwand:
model = "gpt-5.4-mini"
model_reasoning_effort = "xhigh"
Benutzerdefinierte openai_base_url wird ebenfalls für benutzerdefinierte API-Endpunkte unterstützt.
Architektur
Das Plugin umschließt den Codex App Server und delegiert alle Arbeiten an die global installierte Codex CLI-Binärdatei auf demselben Rechner. Das bedeutet:
- Es wird keine separate Codex-Laufzeitumgebung eingeführt.
- Der Authentifizierungsstatus wird mit jeder vorhandenen Codex-Installation geteilt.
- Checkout und Umgebung des Repositorys sind identisch mit der direkten Codex-Nutzung.
- Ergebnisse von
/codex:resultenthalten Sitzungs-IDs, die direkt mitcodex resume <session-id>fortgesetzt werden können.
FAQ
F: Benötige ich ein separates Codex-Konto?
Nein. Wenn Sie auf der Maschine bereits bei der Codex CLI angemeldet sind, verwendet das Plugin diese Authentifizierung wieder.
F: Verwendet das Plugin eine separate Codex-Laufzeitumgebung?
Nein. Es delegiert über Ihre vorhandene lokale Codex CLI und den App-Server.
F: Kann ich meinen bestehenden API-Schlüssel oder meine benutzerdefinierte Basis-URL verwenden?
Ja. Das Plugin übernimmt Ihre Codex CLI-Konfiguration, einschließlich openai_base_url.
Zusammenfassung
codex-plugin-cc repräsentiert eine interessante Konvergenz im Ökosystem der KI-Codierungswerkzeuge: ein offizielles OpenAI-Tool, das entwickelt wurde, um ein konkurrierendes Produkt (Claude Code) zu erweitern. Es ermöglicht einen leistungsstarken Multi-Agenten-Review-Workflow, bei dem Claude Code schreibt und iteriert, während Codex eine unabhängige Überprüfung durchführt – und Probleme erkennt, die ein einzelnes Modell möglicherweise übersieht.