Guía31 de agosto de 2026

Cómo ejecutar varios agentes Codex en paralelo

Usa el CLI real de Codex en un workspace aislado por tarea y revisa cada resultado antes de que llegue a main.

Para ejecutar varios agentes Codex de forma segura, aísla cada tarea independiente en su propio Git worktree. La aplicación oficial de Codex puede gestionar worktrees para un flujo solo con Codex. Agentastic ejecuta el mismo CLI junto a Claude Code, Gemini, Cursor y otros agentes, y añade contenedores, hosts remotos, pruebas de navegador y revisión multiproveedor.

Un desarrollador ejecuta cuatro agentes de OpenAI Codex en Git worktrees separados

Elige el flujo adecuado#

FlujoÚsalo cuando
Worktrees de la app CodexQuieres una experiencia oficial y solo usas Codex
Worktrees manuales + CLIQuieres control total sin otra aplicación
AgentasticQuieres varios proveedores, contenedores, navegador o ejecución remota

La documentación oficial de OpenAI describe los chats paralelos, worktrees administrados, .worktreeinclude, handoff y limpieza.

Por qué hace falta un checkout por tarea#

Las conversaciones de Codex son independientes, pero los archivos no. Dos sesiones en el mismo checkout comparten cambios sin confirmar, artefactos generados, dependencias y el índice de Git. Un worktree convierte cada resultado en un diff independiente que puedes conservar, corregir o descartar.

Worktrees manuales#

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

Esta ruta es universal. También te hace responsable de nombres, preparación, aprobaciones, puertos, pruebas, revisión y limpieza.

Codex en paralelo con Agentastic#

1. Instala y verifica Codex#

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

Inicia sesión en Codex antes de abrirlo desde Agentastic. Agentastic conserva la autenticación, configuración, skills y servidores MCP del proveedor.

2. Crea un workspace aislado#

En Agent Home selecciona repositorio, rama base, Codex y modo Worktree. Da a la tarea un nombre reconocible y exige evidencia concreta:

text
Corrige la prueba inestable de refresh token. No cambies la API pública de sesión ni el límite de reintentos. Ejecuta primero el target de autenticación y luego la suite completa si pasa. Resume la condición de carrera y todos los archivos modificados.

Repite el proceso para tareas que puedan convertirse en pull requests independientes.

3. Mantén las reglas en AGENTS.md#

markdown
# Instrucciones del repositorio - Ejecuta `npm test -- auth` para cambios de autenticación. - No edites clientes generados dentro de `src/generated`. - Mantén compatibilidad hacia atrás en APIs públicas. - Nunca ejecutes migraciones de producción.

Las restricciones de una tarea van en su prompt. Las reglas duraderas del repositorio deben estar versionadas.

4. Prepara el entorno automáticamente#

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

Guárdalo como .agentastic/setup.sh y hazlo ejecutable. El agente debería empezar con un proyecto que ya puede compilar y probar.

5. Verifica y revisa con contexto nuevo#

Cuando Codex termina:

  1. Lee la evidencia de pruebas.
  2. Inspecciona el diff completo.
  3. Arranca la aplicación desde ese worktree.
  4. Verifica la interfaz en el navegador integrado cuando corresponda.
  5. Pasa el diff a un Codex nuevo, Claude, CodeRabbit o Greptile para una segunda opinión.

El agente que implementó la solución comparte las suposiciones que la produjeron. Una revisión con contexto nuevo ayuda a detectar errores normalizados durante la implementación.

Worktree, contenedor o remoto#

  • Worktree: cambios locales normales.
  • Contenedor: paquetes, servicios, montajes o red necesitan límites propios.
  • SSH remoto: ejecución en tu propia máquina o servidor.
  • Cloud: tareas persistentes en proveedores conectados.

Empieza con un worktree y aumenta el aislamiento solo cuando exista una razón concreta.

Errores comunes#

  • Enviar una feature vaga a cinco agentes no crea claridad.
  • Compartir una base de datos mutable elimina gran parte del aislamiento.
  • Abrir más tareas de las que puedes revisar crea deuda, no velocidad.
  • Después de fusionar una dependencia, vuelve a actualizar y validar los worktrees que dependían de ella.

Descarga Agentastic para macOS o visita la integración de Codex.

Fuentes#