MCP

Ponto de Comando codex-cc-orchestrator: faça o Codex despachar tarefas para o Claude Code executar e revisar

O Ponto de Comando é ideal para o Codex despachar tarefas de codificação ao Claude Code para execução, com revisão por uma sessão independente somente leitura — mas exige que você passe explicitamente um project_root confiável e tenha ambos os Agents 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

O Ponto de Comando (codex-cc-orchestrator) é adequado para cenários em que um Agent principal precisa despachar tarefas para um executor e, em seguida, ter o resultado revisado por uma sessão independente somente leitura. O ponto mais importante antes de começar: você precisa ter tanto o Codex quanto o Claude Code instalados e configurados como Agents locais, e cada tarefa deve receber explicitamente um project_root confiável — o serviço não deduz o workspace a partir do diretório atual.

Para quem é indicado

  • Usuários que já utilizam o Codex e têm o Claude Code instalado, e que desejam despachar tarefas para o Claude Code via MCP para execução e revisão, criando uma orquestração colaborativa em camadas.
  • Fluxos de trabalho de desenvolvimento que precisam de despacho de tarefas, execução, retomada, revisão independente, compressão de resultados e registro de uso.
  • Não é indicado para quem não possui ambos os ambientes (Codex e Claude Code); a evidência não esclarece se uma das pontas pode ser usada isoladamente — consulte a documentação oficial.
  • Pré-requisitos: Python 3.13+ e uv na máquina. As etapas completas de instalação (em chinês) estão no INSTALL.md oficial.

Primeira tentativa em 3 minutos

Pré-requisitos: Python 3.13+, uv, e o Codex e o Claude Code já configurados.

  1. Obtenha e instale (caminho principal oficial):
git clone https://github.com/zjgxkj/codex-cc-orchestrator.git
cd codex-cc-orchestrator
git checkout v0.4.0
uv sync
  1. Registre o serviço na configuração STDIO MCP do Codex (exemplo 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. Faça um primeiro teste de baixo risco: o serviço expõe a ferramenta ping, que permite confirmar se o canal MCP está conectado, sem nenhuma escrita em arquivos. O sinal de sucesso é o Codex listar as ferramentas do serviço e receber a resposta do ping. Atenção: o stdout transporta apenas mensagens do protocolo MCP; logs e erros vão para o stderr — para diagnosticar problemas de inicialização, observe o stderr.

A execução real de tarefas (execute_task etc.) é outra história: é obrigatório passar explicitamente um project_root em que você confia; a execução lê e escreve arquivos dentro desse diretório, o que não é uma operação somente leitura. Antes de chamar, confirme o diretório do projeto de destino.

Casos de uso

Caso 1: despachar e executar uma tarefa de codificação. Em uma sessão do Codex, chame execute_task passando a descrição da tarefa e o project_root que você autoriza explicitamente. A sessão executora usa um conjunto restrito de ferramentas (Read/Grep/Glob/Edit/Write/Bash, com rede permitida, mas sem Agents aninhados nem edição de notebooks) para realizar as alterações. O que esperar: a tarefa é executada e o estado é persistido em um SQLite local (~/.codex-claude-agent-mcp/state.db).

Caso 2: revisão independente e retomada. Chamar review_task faz com que uma sessão totalmente nova e somente leitura revise o resultado da execução e emita PASS/FAIL; em caso de FAIL, é possível chamar continue_task para continuar a partir da sessão de execução salva, levando o feedback. O que esperar: a revisão somente leitura não altera arquivos, e a retomada reutiliza o contexto da sessão. Também é possível orquestrar várias tarefas com run_job / run_jobs e consultar o progresso com get_job_status.

Limites de uso

  • Natureza de leitura e escrita: o ping é uma verificação de disponibilidade somente leitura; execute_task, run_job e run_jobs escrevem arquivos sob o project_root, ou seja, possuem efeitos colaterais reais — confirme o diretório correto antes de chamar; review_task é realizada por uma sessão somente leitura.
  • Autorização: cada tarefa pode receber um project_root, e o Codex deve passar explicitamente um workspace root confiável; o serviço não o deduz do cwd do próprio processo. ALLOWED_PROJECT_ROOTS é uma lista opcional de confiança de longo prazo.
  • Estado local: o estado, como as sessões de execução, é persistido em ~/.codex-claude-agent-mcp/state.db. A documentação oficial não menciona um caminho para exclusão ou revogação desse estado.
  • Limite de concorrência: CLAUDE_MAX_CONCURRENCY (padrão 4) vale apenas para um único processo de servidor MCP.
  • A indicação de "somente leitura" das ferramentas significa apenas que não executam escritas; não implica que não haja acesso à rede ou que não existam considerações de privacidade. Partes não documentadas oficialmente (como detalhes de gerenciamento de credenciais) não devem ser tratadas como isentas de risco.