MCP

Punto de mando codex-cc-orchestrator: haz que Codex despache tareas a Claude Code para ejecutarlas y revisarlas

El punto de mando es ideal para que Codex despache tareas de codificación a Claude Code para su ejecución y revisión por una sesión independiente de solo lectura, pero requiere pasar explícitamente un project_root de confianza y tener ambos Agentes instalados.

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

El punto de mando (codex-cc-orchestrator) es adecuado para escenarios donde necesitas que un Agente maestro despache tareas a un ejecutor y que después una sesión independiente de solo lectura las revise. Lo más importante antes de empezar: necesitas tener instalados y configurados a la vez dos Agentes locales, Codex y Claude Code, y cada tarea debe recibir explícitamente un project_root de confianza; el servicio no adivina el espacio de trabajo a partir del directorio actual.

¿Para quién es?

  • Usuarios que ya usan Codex y tienen Claude Code instalado, y que quieren despachar tareas a Claude Code vía MCP para su ejecución y revisión, logrando una orquestación de colaboración en capas.
  • Flujos de trabajo de desarrollo que necesiten despacho de tareas, ejecución, reanudación, revisión independiente, compresión de resultados y registro de uso.
  • No es adecuado para: quienes no tengan ambos entornos, Codex y Claude Code, al mismo tiempo; la evidencia no indica si se puede usar cada extremo por separado, así que consulta la documentación oficial.
  • Requisito previo: el equipo necesita Python 3.13+ y uv. Los pasos completos de instalación en chino están en el INSTALL.md oficial.

Primer intento en 3 minutos

Requisitos: Python 3.13+, uv, y Codex y Claude Code ya configurados.

  1. Obtén e instala (vía principal oficial):
git clone https://github.com/zjgxkj/codex-cc-orchestrator.git
cd codex-cc-orchestrator
git checkout v0.4.0
uv sync
  1. Registra el servicio en la configuración STDIO MCP de Codex (ejemplo oficial para 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. Haz una primera prueba de bajo riesgo: el servicio expone la herramienta ping; úsala para confirmar que el canal MCP funciona, sin ninguna escritura de archivos. La señal de éxito es que Codex pueda listar las herramientas del servicio y recibir la respuesta de ping. Ten en cuenta que stdout solo transporta mensajes del protocolo MCP; los registros y errores van por stderr, así que para diagnosticar problemas de arranque revisa stderr.

Ejecutar tareas reales (execute_task, etc.) es otra cosa: debes pasar explícitamente un project_root de confianza; la ejecución lee y escribe archivos dentro de ese directorio, no es una operación de solo lectura, así que confirma el directorio del proyecto de destino antes de llamar.

Casos de uso

Caso uno: despachar y ejecutar una tarea de codificación. En una sesión de Codex, llama a execute_task con la descripción de la tarea y el project_root que autorizas explícitamente. La sesión ejecutora usa un conjunto restringido de herramientas (Read/Grep/Glob/Edit/Write/Bash, con red permitida, sin Agentes anidados ni edición de notebooks) para completar los cambios. Puedes esperar: la tarea se ejecuta y el estado se persiste en un SQLite local (~/.codex-claude-agent-mcp/state.db).

Caso dos: revisión independiente y reanudación. Llamar a review_task hace que una sesión completamente nueva de solo lectura revise el resultado y dé un PASS/FAIL; si es FAIL, puedes llamar a continue_task para continuar sobre la sesión de ejecución guardada incluyendo el feedback. Puedes esperar: la revisión de solo lectura no modifica archivos, y la reanudación reutiliza el contexto de la sesión. También puedes orquestar varias tareas con run_job / run_jobs y consultar el progreso con get_job_status.

Límites de uso

  • Naturaleza de lectura/escritura: ping es una sonda de solo lectura; execute_task, run_job y run_jobs escriben archivos bajo project_root, con efectos reales, así que confirma que el directorio es correcto antes de llamar; review_task realiza la revisión desde una sesión de solo lectura.
  • Autorización: cada tarea puede recibir un project_root; Codex debe pasar explícitamente un workspace root de confianza; el servicio no lo adivina a partir del cwd de su propio proceso. ALLOWED_PROJECT_ROOTS es una lista opcional de confianza a largo plazo.
  • Estado local: el estado de las sesiones de ejecución, entre otros, se persiste en ~/.codex-claude-agent-mcp/state.db. El proveedor oficial no documenta una vía de borrado o revocación de ese estado.
  • Límite de concurrencia: CLAUDE_MAX_CONCURRENCY (por defecto 4) solo aplica a un único proceso de servidor MCP.
  • La indicación de solo lectura de una herramienta solo significa que no ejecuta escrituras; no implica que no acceda a la red ni que no existan límites de privacidad; lo que la documentación oficial no especifica (por ejemplo, detalles de gestión de credenciales) no debe asumirse como sin riesgo.