MCP

codex-cc-orchestrator: Codex Aufgaben an Claude Code zur Ausführung und Überprüfung verteilen lassen

Die Zuteilungsbühne eignet sich am besten, um Codex Programmieraufgaben an Claude Code zur Ausführung verteilen zu lassen und diese von einer unabhängigen, rein lesenden Sitzung prüfen zu lassen – Voraussetzung ist, dass Sie einen vertrauenswürdigen project_root explizit übergeben und beide Agenten installiert haben.

Official source · 点将台 codex-cc-orchestrator

Install

git clone https://github.com/zjgxkj/codex-cc-orchestrator.git && cd codex-cc-orchestrator && git checkout v0.4.0 && uv sync

Die Zuteilungsbühne (codex-cc-orchestrator) eignet sich für Szenarien, in denen ein steuernder Agent Aufgaben an einen Ausführer verteilt und diese anschließend von einer unabhängigen, rein lesenden Sitzung überprüft werden lassen sollen. Das Wichtigste vorab: Sie müssen sowohl Codex als auch Claude Code als lokale Agenten installiert und konfiguriert haben, und für jede Aufgabe muss ein vertrauenswürdiger project_root explizit übergeben werden – der Dienst rät nicht anhand des aktuellen Verzeichnisses, welches Arbeitsverzeichnis gemeint ist.

Für wen geeignet

  • Nutzer, die bereits Codex verwenden und Claude Code installiert haben und Aufgaben über MCP an Claude Code zur Ausführung und Überprüfung verteilen möchten, um eine mehrstufige Kooperations-Orchestrierung zu erreichen.
  • Entwickler-Workflows, die Aufgabenverteilung, Ausführung, Fortsetzung, unabhängige Überprüfung, Ergebnisverdichtung und Nutzungsprotokollierung benötigen.
  • Nicht geeignet für: Personen, die nicht gleichzeitig sowohl die Codex- als auch die Claude-Code-Umgebung besitzen; die Belege geben nicht an, ob eine der beiden Seiten einzeln nutzbar ist – maßgeblich ist die offizielle Dokumentation.
  • Voraussetzungen: Auf dem Rechner werden Python 3.13+ und uv benötigt. Die vollständigen chinesischen Installationsschritte finden Sie in der offiziellen INSTALL.md.

Erster Versuch in 3 Minuten

Voraussetzungen: Python 3.13+, uv sowie bereits konfiguriertes Codex und Claude Code.

  1. Herunterladen und installieren (offizieller Hauptweg):
git clone https://github.com/zjgxkj/codex-cc-orchestrator.git
cd codex-cc-orchestrator
git checkout v0.4.0
uv sync
  1. Dienst in der STDIO-MCP-Konfiguration von Codex registrieren (offizielles Windows-Beispiel):
[mcp_servers.codex-claude-agent]
command = 'D:\path\to\codex-claude-agent-mcp\.venv\Scripts\python.exe'
args = ['-m', 'codex_claude_agent_mcp']
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 7200
  1. Einen risikoarmen ersten Test durchführen: Der Dienst stellt das Werkzeug ping bereit, mit dem Sie prüfen können, ob der MCP-Kanal erreichbar ist – ohne jegliches Schreiben von Dateien. Erfolgssignal: Codex kann die Werkzeuge des Dienstes auflisten und eine ping-Antwort empfangen. Beachten Sie: stdout trägt ausschließlich MCP-Protokollnachrichten; Logs und Fehlermeldungen landen auf stderr. Bei Startproblemen also stderr prüfen.

Echte Aufgabenausführung (execute_task usw.) ist etwas anderes: Hier muss ein von Ihnen vertrauenswürdiger project_root explizit übergeben werden. Die Ausführung liest und schreibt Dateien in diesem Verzeichnis – das ist kein rein lesender Vorgang. Bestätigen Sie daher vor dem Aufruf das Zielprojektverzeichnis.

Anwendungsbeispiele

Beispiel 1: Eine Programmieraufgabe verteilen und ausführen. Rufen Sie in der Codex-Sitzung execute_task auf und übergeben Sie die Aufgabenbeschreibung sowie den von Ihnen explizit autorisierten project_root. Die Ausführer-Sitzung arbeitet mit einem eingeschränkten Werkzeugsatz (Read/Grep/Glob/Edit/Write/Bash, Internetzugang erlaubt, verschachtelte Agenten und Notebook-Bearbeitung verboten) und nimmt die Änderungen vor. Zu erwarten: Die Aufgabe wird ausgeführt, der Status wird lokal in SQLite persistiert (~/.codex-claude-agent-mcp/state.db).

Beispiel 2: Unabhängige Überprüfung und Fortsetzung. Der Aufruf von review_task lässt eine völlig neue, rein lesende Sitzung das Ausführungsergebnis prüfen und ein PASS/FAIL-Urteil abgeben. Bei FAIL können Sie continue_task aufrufen, um auf Basis der gespeicherten Ausführungssitzung mit dem Feedback fortzufahren. Zu erwarten: Die lesende Überprüfung ändert keine Dateien, die Fortsetzung nutzt den Sitzungskontext wieder. Mit run_job / run_jobs können Sie mehrere Aufgaben orchestrieren und mit get_job_status den Fortschritt abfragen.

Nutzungsgrenzen

  • Lese-/Schreibverhalten: ping ist ein rein lesender Erreichbarkeitstest; execute_task, run_job und run_jobs schreiben Dateien unterhalb von project_root – das sind echte Seiteneffekte, prüfen Sie vor dem Aufruf, ob das Verzeichnis korrekt ist; review_task erledigt die Überprüfung in einer rein lesenden Sitzung.
  • Autorisierung: Jede Aufgabe kann einen project_root entgegennehmen; Codex muss eine vertrauenswürdige Workspace-Root explizit übergeben. Der Dienst rät sie nicht aus dem cwd seines eigenen Prozesses. ALLOWED_PROJECT_ROOTS ist eine optionale Liste dauerhaft vertrauenswürdiger Root-Verzeichnisse.
  • Lokaler Status: Der Status von Ausführungssitzungen usw. wird in ~/.codex-claude-agent-mcp/state.db persistiert. Die offiziellen Quellen nennen keinen Weg, diesen Status zu löschen oder zurückzuziehen.
  • Parallelisierungsgrenze: CLAUDE_MAX_CONCURRENCY (Standard 4) wirkt nur innerhalb eines einzelnen MCP-Server-Prozesses.
  • Der Hinweis „nur lesend“ bei Werkzeugen bedeutet lediglich, dass keine Schreiboperationen ausgeführt werden – nicht, dass es keinen Internetzugang oder keine Datenschutzgrenzen gäbe. Was die offiziellen Quellen nicht abdecken (z. B. Details zum Umgang mit Anmeldeinformationen), sollte nicht als risikofrei betrachtet werden.