Guia31 de agosto de 2026

Como executar vários agentes Codex em paralelo

Use o CLI real do Codex em um workspace isolado por tarefa e revise cada resultado antes de chegar à main.

Para executar vários agentes Codex com segurança, isole cada tarefa independente em sua própria Git worktree. O aplicativo oficial do Codex consegue administrar worktrees em um fluxo exclusivo do Codex. O Agentastic executa o mesmo CLI ao lado de Claude Code, Gemini, Cursor e outros agentes, adicionando contêineres, hosts remotos, testes no navegador e revisão multiprovedor.

Um desenvolvedor executando quatro agentes OpenAI Codex em Git worktrees separadas

Escolha o fluxo certo#

FluxoUse quando
Worktrees do app CodexVocê quer a experiência oficial e usa apenas Codex
Worktrees manuais + CLIVocê quer controle total sem outro aplicativo
AgentasticVocê quer múltiplos provedores, contêiner, navegador ou execução remota

A documentação oficial da OpenAI descreve chats paralelos, worktrees administradas, .worktreeinclude, handoff e limpeza.

Por que cada tarefa precisa de um checkout#

As conversas do Codex são independentes, mas os arquivos não. Duas sessões no mesmo checkout compartilham mudanças não commitadas, artefatos gerados, dependências e o índice do Git. Uma worktree transforma cada resultado em um diff independente que pode ser mantido, corrigido ou descartado.

Worktrees manuais#

bash
git fetch origin git worktree add -b agent/auth-tests \ ../app-auth-tests origin/main git worktree add -b agent/cache-fix \ ../app-cache-fix origin/main cd ../app-auth-tests && codex cd ../app-cache-fix && codex

Esse caminho é universal. Você também fica responsável por nomes, setup, aprovações, portas, testes, revisão e limpeza.

Codex em paralelo com Agentastic#

1. Instale e verifique o Codex#

bash
npm install -g @openai/codex which codex codex --version

Faça login no Codex antes de abri-lo no Agentastic. A autenticação, configuração, skills e servidores MCP continuam sendo os do provedor.

2. Crie um workspace isolado#

No Agent Home, escolha repositório, branch base, Codex e modo Worktree. Dê um nome claro e exija evidência:

text
Corrija o teste instável de refresh token. Não altere a API pública de sessão nem o limite de tentativas. Execute primeiro o target de autenticação e depois a suíte completa se ele passar. Resuma a condição de corrida e todos os arquivos modificados.

Repita para tarefas que possam virar pull requests independentes.

3. Mantenha regras em AGENTS.md#

markdown
# Instruções do repositório - Execute `npm test -- auth` para mudanças de autenticação. - Não edite clientes gerados em `src/generated`. - Preserve compatibilidade das APIs públicas. - Nunca execute migrações de produção.

Restrições de uma tarefa pertencem ao prompt. Regras duráveis pertencem ao repositório.

4. Prepare o ambiente automaticamente#

bash
#!/usr/bin/env bash set -euo pipefail for file in .env .env.local; do if [ -f "$AGENTASTIC_MAIN_REPO_PATH/$file" ] && [ ! -f "$file" ]; then cp "$AGENTASTIC_MAIN_REPO_PATH/$file" "$file" fi done npm ci

Salve como .agentastic/setup.sh e marque como executável. O agente deve começar com um projeto que já compila e roda testes.

5. Verifique e revise com contexto novo#

Quando Codex terminar:

  1. Leia a evidência dos testes.
  2. Inspecione o diff completo.
  3. Execute a aplicação naquela worktree.
  4. Valide a UI no navegador integrado quando necessário.
  5. Envie o diff para um Codex novo, Claude, CodeRabbit ou Greptile.

O agente que implementou compartilha as suposições que produziram a solução. Uma revisão com contexto novo ajuda a encontrar erros que se tornaram invisíveis durante a implementação.

Worktree, contêiner ou remoto#

  • Worktree: mudanças locais normais.
  • Contêiner: pacotes, serviços, mounts ou rede precisam de fronteira própria.
  • SSH remoto: execução em sua máquina ou servidor.
  • Cloud: tarefas persistentes em provedores conectados.

Comece com worktree e aumente o isolamento apenas com um motivo concreto.

Erros comuns#

  • Mandar uma feature vaga para cinco agentes não cria clareza.
  • Compartilhar um banco mutável elimina boa parte do isolamento.
  • Abrir mais tarefas do que você consegue revisar cria dívida.
  • Depois de fundir uma dependência, atualize e valide novamente as worktrees dependentes.

Baixe o Agentastic para macOS ou visite a integração do Codex.

Fontes#