MCP

Le poste de commandement codex-cc-orchestrator : faire exécuter et réviser des tâches par Claude Code via Codex

Le poste de commandement convient le mieux pour que Codex délègue des tâches de codage à Claude Code pour exécution, avec révision par une session indépendante en lecture seule — à condition de passer explicitement un project_root de confiance et d'installer les deux Agents.

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

Le poste de commandement (codex-cc-orchestrator) convient aux scénarios où un Agent maître doit déléguer des tâches à un exécutant, puis faire réviser le résultat par une session indépendante en lecture seule. Le point le plus important avant de commencer : vous devez installer et configurer à la fois Codex et Claude Code, deux Agents locaux, et chaque tâche doit recevoir explicitement un project_root de confiance ; le service ne devine pas l'espace de travail à partir du répertoire courant.

Pour qui ?

  • Les utilisateurs qui utilisent déjà Codex et ont installé Claude Code, et qui souhaitent déléguer des tâches à Claude Code pour exécution et révision via MCP, afin de mettre en place une orchestration collaborative à plusieurs niveaux.
  • Les flux de travail de développement nécessitant la délégation de tâches, l'exécution, la reprise, la révision indépendante, la compression des résultats et le suivi de l'utilisation.
  • Ne convient pas : aux personnes ne disposant pas simultanément des deux environnements Codex et Claude Code ; les preuves ne précisent pas si l'un peut être utilisé seul, reportez-vous à la documentation officielle.
  • Prérequis : Python 3.13+ et uv sont nécessaires sur la machine. Les instructions complètes d'installation en chinois figurent dans le INSTALL.md officiel.

Première tentative en 3 minutes

Prérequis : Python 3.13+, uv, ainsi que Codex et Claude Code déjà configurés.

  1. Récupérer et installer (voie principale officielle) :
git clone https://github.com/zjgxkj/codex-cc-orchestrator.git
cd codex-cc-orchestrator
git checkout v0.4.0
uv sync
  1. Enregistrer le service dans la configuration STDIO MCP de Codex (exemple officiel Windows) :
[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. Effectuer un premier essai à faible risque : le service expose l'outil ping, qui permet de confirmer que le canal MCP fonctionne, sans aucune écriture de fichier. Le signal de succès est que Codex parvient à lister les outils du service et à recevoir la réponse du ping. Notez que stdout ne transporte que les messages du protocole MCP ; les journaux et les erreurs vont sur stderr — pour diagnostiquer un problème de démarrage, regardez stderr.

L'exécution réelle de tâches (execute_task, etc.) est une autre affaire : vous devez passer explicitement un project_root de confiance, et l'exécution lit et écrit des fichiers dans ce répertoire — ce n'est pas une opération en lecture seule. Vérifiez le répertoire du projet cible avant tout appel.

Cas d'usage

Cas 1 : déléguer et exécuter une tâche de codage. Dans une session Codex, appelez execute_task en fournissant la description de la tâche et le project_root que vous autorisez explicitement. La session exécutante utilise un ensemble d'outils restreint (Read/Grep/Glob/Edit/Write/Bash, accès réseau autorisé, Agents imbriqués et édition de notebooks interdits) pour réaliser les modifications. À attendre : la tâche est exécutée et son état est persisté dans une base SQLite locale (~/.codex-claude-agent-mcp/state.db).

Cas 2 : révision indépendante et reprise. Appeler review_task lance une session toute neuve en lecture seule qui révisera le résultat de l'exécution et rendra un verdict PASS/FAIL ; en cas de FAIL, vous pouvez appeler continue_task pour reprendre sur la session d'exécution sauvegardée en y apportant les retours. À attendre : la révision en lecture seule ne modifie aucun fichier, et la reprise réutilise le contexte de session. Vous pouvez aussi orchestrer plusieurs tâches avec run_job / run_jobs et suivre la progression avec get_job_status.

Limites d'utilisation

  • Nature des lectures/écritures : ping est une sonde en lecture seule ; execute_task, run_job et run_jobs écrivent des fichiers sous project_root — effet de bord réel, vérifiez l'exactitude du répertoire avant l'appel ; review_task effectue la révision depuis une session en lecture seule.
  • Autorisation : chaque tâche peut recevoir un project_root, et Codex doit passer explicitement une racine d'espace de travail de confiance ; le service ne la devine pas depuis le cwd de son propre processus. ALLOWED_PROJECT_ROOTS est une liste de confiance permanente optionnelle.
  • État local : l'état des sessions d'exécution, etc., est persisté dans ~/.codex-claude-agent-mcp/state.db. La documentation officielle n'indique aucune procédure de suppression ou de révocation de cet état.
  • Limite de concurrence : CLAUDE_MAX_CONCURRENCY (4 par défaut) ne s'applique qu'à un seul processus de serveur MCP.
  • L'indication « lecture seule » d'un outil signifie uniquement qu'il n'effectue pas d'opérations d'écriture ; cela ne garantit ni l'absence d'accès réseau ni l'existence de limites de confidentialité. Les aspects non documentés officiellement (par exemple la gestion des identifiants) ne doivent pas être considérés comme sans risque.