Enjambre de agentes Codex: ejecuta varios agentes de Codex CLI en paralelo

Un enjambre de agentes Codex no es más que varios agentes de Codex CLI trabajando en paralelo en lugar de uno detrás de otro. Como cada sesión de Codex es su propio proceso, nada te impide tener un puñado funcionando a la vez, cada uno con su tarea. El truco no está en arrancar los procesos. Está en no perderles la pista cuando ya tienes tres o cuatro agentes editando archivos, pidiendo aprobaciones y terminando en momentos distintos. Ahí es donde suelen romperse los enjambres mal montados. En esta guía te explico las tres formas reales de ejecutar un enjambre de Codex, las comparo de forma honesta y te muestro dónde empieza a doler cada una. Si quieres la foto completa de todas las CLI, empieza por la visión general del enjambre de agentes CLI de IA, y si tu agente principal es Claude Code mira cómo ejecutar varias sesiones de Claude Code.

La respuesta corta: sí, puedes montar un enjambre de Codex

Seis terminales de OpenAI Codex CLI ejecutándose en paralelo en un único espacio de trabajo de CodeAgentSwarm, cada uno una sesión de Codex independiente — Un enjambre de agentes Codex: seis sesiones de Codex CLI independientes ejecutándose a la vez en una sola ventana de CodeAgentSwarm.

Una sesión de Codex CLI es solo un proceso. La arrancas con el comando codex, inicias sesión una vez con codex login y, a partir de ahí, cada sesión tiene su propia conversación, su propio contexto y su propio directorio de trabajo. Dos sesiones no saben nada la una de la otra.

Así que un enjambre de agentes Codex no es un modo especial que desbloqueas. Es simplemente más de un agente de Codex CLI funcionando al mismo tiempo. Abre un segundo terminal, ejecuta codex otra vez y ya tienes dos agentes independientes. Uno puede estar migrando una capa de base de datos mientras el otro escribe tests de integración. Añade un tercero y un cuarto y tienes un pequeño enjambre.

Y no te limita a Codex. Como cada agente es su propio proceso, puedes poner Codex CLI en algunos terminales y Claude Code o Gemini CLI en otros, todos trabajando sobre el mismo repositorio.

Cada agente de Codex usa tu cuenta de OpenAI de forma independiente. No hay un plan "de enjambre" aparte ni un sobrecoste por tener varios agentes en paralelo. Pagas por lo que cada agente hace en realidad.

El trabajo de verdad es gestionar el enjambre cuando crece. Los agentes de Codex se paran para pedir aprobaciones, terminan en momentos distintos y a veces tocan los mismos archivos. Los tres métodos de abajo resuelven esa coordinación con muy distinta cantidad de fricción.

Método 1: varias ventanas de terminal (gratis, básico)

La forma más obvia de montar un enjambre de Codex es abrir varias pestañas de terminal, entrar en tu proyecto en cada una y arrancar Codex CLI. No hay nada que instalar más allá del propio Codex.

bash

# Pestaña 1
cd ~/mi-proyecto
codex

# Pestaña 2
cd ~/mi-proyecto
codex

# Pestaña 3
cd ~/mi-proyecto
codex

Cada pestaña es ahora un agente de Codex independiente. Puedes darle una tarea distinta a cada uno e ir cambiando entre ellos mientras trabajan. Si ejecutas Codex en un modo de aprobación en lugar de full auto, cada pestaña se detendrá a esperar tu aprobación, lo que te obliga a saltar de pestaña en pestaña para que sigan avanzando.

Ventajas

Gratis, nada que configurar más allá de Codex CLI
Funciona al instante con herramientas que ya tienes
Fácil de razonar: una pestaña es un agente

Desventajas

Pierdes la pista de qué pestaña hace qué casi de inmediato
Sin aviso cuando un agente de Codex termina o se para a pedir una aprobación
Sin vista compartida: tienes que entrar en cada pestaña para ver el progreso
No hay forma de buscar en el historial de conversación de los distintos agentes
Si dos agentes editan el mismo archivo, desliarlo es cosa tuya
Con tres pestañas o más todas se ven iguales

Para dos agentes va bien. A partir de ahí, el tiempo que pasas buscando la pestaña que necesita una aprobación empieza a comerse la velocidad que ganaste al ir en paralelo.

Método 2: tmux o screen (gratis, avanzado)

Si vives en el terminal, tmux te deja dividir una ventana en paneles y mantener sesiones vivas en segundo plano. Puedes ver varios agentes de Codex a la vez sin cambiar de pestaña.

bash

# Inicia una sesión nueva de tmux
tmux new-session -s codex-swarm

# Divide en horizontal
tmux split-window -h

# Divide el panel derecho en vertical
tmux split-window -v

# Ahora tienes 3 paneles - ejecuta codex en cada uno

tmux también te deja desconectarte y volver a conectarte, así que tus agentes de Codex siguen funcionando aunque cierres la ventana del terminal. Eso es muy útil para migraciones o refactors largos que corren en full auto.

Ventajas

Gratis y disponible en casi cualquier máquina Unix
Ves varios paneles a la vez, sin cambiar de pestaña
Las sesiones sobreviven a las desconexiones, ideal para tiradas largas en full auto
Programable y configurable hasta el último atajo de teclado

Desventajas

Curva de aprendizaje real si nunca has usado tmux
Sigue sin haber aviso de escritorio cuando un agente termina o pide aprobación
Sin historial de conversación ni búsqueda entre agentes
Los paneles de solo texto se quedan estrechos pasando de tres o cuatro agentes de Codex
No hay tablero de tareas ni capa de organización encima
Rehaces el layout a mano en cada sesión, salvo que lo programes
Los conflictos entre agentes que tocan el mismo archivo siguen siendo tu problema

tmux es un gran multiplexor de propósito general y muchos developers ya lo usan. Pero nunca se diseñó para supervisar agentes de IA en concreto. En el momento en que un agente de Codex en el panel 3 se para en silencio a pedir una aprobación mientras tú lees el panel 1, notas el hueco.

Método 3: CodeAgentSwarm (visual, completo)

CodeAgentSwarm es una app de escritorio hecha justo para esto: ejecutar y supervisar un enjambre de agentes CLI de IA en un solo sitio. Funciona en macOS y en Windows, te da hasta seis terminales en un mismo espacio de trabajo y te deja elegir el agente por terminal. Para un enjambre de Codex solo tienes que elegir "codex cli" en el selector SELECT AI AGENT de cada terminal que quieras con Codex.

Un terminal de CodeAgentSwarm mostrando el selector SELECT AI AGENT con claude-code, gemini cli y codex cli, además de un interruptor Enable Turbo Mode — En CodeAgentSwarm eliges el agente por terminal. Pon cada uno en codex cli para montar un enjambre de Codex, con un interruptor de Turbo Mode para el modo full-auto.

Esto es lo que ganas cuando todos los agentes son Codex (o una mezcla):

Hasta 6 agentes de Codex en paralelo

Pon cada terminal en "codex cli" para un enjambre 100% Codex, o mezcla Claude Code y Gemini CLI donde encajen mejor. Cada terminal es un proceso de Codex totalmente independiente, con su propia conversación y contexto de proyecto. CodeAgentSwarm funciona por encima de tus suscripciones actuales, así que no es un proveedor de modelos: solo orquesta los agentes que ya pagas.

Visibilidad en tiempo real con títulos dinámicos

Cada terminal actualiza su propio título para reflejar lo que está haciendo su agente de Codex en ese momento. En lugar de seis pestañas etiquetadas todas como "codex", lees títulos como "Migrando esquema de usuarios", "Escribiendo tests de API" o "Refactorizando auth". Sabes qué agente lleva qué tarea sin entrar en ninguno.

Notificaciones de escritorio

Esto es lo que más arregla un enjambre. Cuando un agente de Codex termina su tarea o se para a pedir una aprobación, recibes una notificación nativa de escritorio. Dejas de vigilar paneles y dejas que los agentes te llamen cuando de verdad te necesitan, que es justo el sentido de tenerlos en paralelo.

Historial completo de conversaciones, con búsqueda

Cada conversación de cada terminal se guarda y se puede buscar, también entre agentes distintos. Puedes volver atrás y encontrar qué decidió ayer un agente de Codex, retomarlo o rastrear exactamente qué agente hizo un cambio concreto. Con un enjambre en marcha, ese rastro es lo que mantiene legible todo el conjunto.

Tablero de tareas integrado

Un tablero kanban de tareas vive junto a tus terminales, y los propios agentes lo actualizan por MCP. Creas tareas, se las pasas a los terminales y ves moverse las tarjetas a medida que cada agente de Codex coge, trabaja y termina. Cuando varios agentes avanzan sobre funcionalidades relacionadas, el tablero mantiene el plan a la vista en lugar de solo en tu cabeza.

Turbo Mode y permisos granulares

Codex tiene sus propios modos de aprobación, desde solo-sugerir hasta full auto con --full-auto, además de un sandbox. CodeAgentSwarm se coloca por encima con Turbo Mode y permisos por terminal, así que puedes dejar que los agentes corran en full auto en las operaciones seguras mientras frenas las peligrosas. Esa es la forma práctica de tener un enjambre de Codex rápido sin dejarlo sin supervisión. La guía de Turbo Mode cubre la configuración.

Diffs de archivos en vivo por terminal

Puedes ver en tiempo real los cambios de archivos que va haciendo cada agente de Codex, por terminal y a nivel de proyecto. Cuando dos agentes editan el mismo archivo, lo ves mientras pasa en lugar de descubrirlo más tarde en un diff hecho un lío. Git sigue encargándose del merge, pero esa visibilidad hace que las ediciones solapadas nunca te pillen por sorpresa.

¿Es la primera vez que ejecutas varios terminales a la vez? La guía de múltiples terminales repasa el layout y el flujo de trabajo, y se aplica igual tanto si el agente es Codex como Claude Code.

Comparativa rápida

Así quedan las tres formas de ejecutar un enjambre de Codex en lo que de verdad molesta cuando pasas de dos agentes:

Coste

Pestañas de terminal: Gratis
tmux/screen: Gratis
CodeAgentSwarm: Plan gratuito disponible, Pro para funciones avanzadas. Tu uso de Codex lo factura OpenAI como siempre.

Tiempo de configuración

Pestañas de terminal: Cero, solo abrir pestañas y ejecutar codex
tmux/screen: De 10 a 30 minutos para lo básico, más para programar un layout reutilizable
CodeAgentSwarm: Un par de minutos para descargar, abrir y elegir codex cli por terminal

Notificaciones

Pestañas de terminal: Ninguna
tmux/screen: Ninguna salvo que programes algo a medida
CodeAgentSwarm: Notificaciones nativas de escritorio cuando un agente termina o necesita una aprobación

Historial de conversaciones

Pestañas de terminal: Se pierde al cerrar la pestaña
tmux/screen: Se mantiene mientras la sesión viva, sin búsqueda
CodeAgentSwarm: Guardado de forma permanente y con búsqueda entre todos los agentes

Supervisión en full-auto

Pestañas de terminal: Todo recae en ti, pestaña a pestaña
tmux/screen: Visible en paneles, pero sin guardarraíles ni política por agente
CodeAgentSwarm: Turbo Mode más permisos granulares para que el full-auto siga siendo seguro

Curva de aprendizaje

Pestañas de terminal: Ninguna
tmux/screen: De media a pronunciada, con atajos y archivos de configuración
CodeAgentSwarm: Baja, una interfaz visual con patrones familiares

Si nunca necesitas más de dos agentes de Codex a la vez, las pestañas de terminal van perfectamente. Si ya pasas el día dentro de tmux, meter unas cuantas sesiones de Codex en tus paneles es lo natural. Pero en cuanto ejecutas tres o más agentes de Codex en full auto de forma habitual y quieres ver de verdad qué hace cada uno, CodeAgentSwarm te quita la carga de coordinación que las otras dos te dejan encima.

Preguntas frecuentes

Un enjambre de agentes Codex es simplemente varios agentes de OpenAI Codex CLI funcionando en paralelo en lugar de uno detrás de otro. Cada agente es su propio proceso con su propia conversación y contexto, así que pueden trabajar en tareas distintas dentro del mismo repositorio al mismo tiempo. No es una función especial de Codex, solo una forma de trabajar que puedes montar con pestañas de terminal, con tmux o con una herramienta como CodeAgentSwarm.

Sí. Cada vez que ejecutas el comando codex obtienes una sesión independiente, así que puedes abrir varios terminales y ejecutar Codex CLI en cada uno. No comparten contexto ni se pisan entre sí salvo que editen los mismos archivos. CodeAgentSwarm admite hasta 6 terminales para que supervises todo el enjambre en una sola ventana.

Sí. Como cada agente es solo un proceso aparte, puedes ejecutar Codex CLI en algunos terminales y Claude Code o Gemini CLI en otros, todos sobre el mismo proyecto. En CodeAgentSwarm eliges el agente por terminal con el selector SELECT AI AGENT, así que un enjambre mixto es lo normal y no un apaño.

No hay recargo por ejecutar agentes en paralelo. Cada agente de Codex usa tu cuenta de OpenAI y se te factura por el trabajo que cada uno hace en realidad, igual que si los ejecutaras uno tras otro. Hacerlo a la vez termina antes, no cambia el coste por agente.

tmux puede alojar perfectamente un enjambre de Codex en paneles divididos, y es gratis. Lo que le falta es todo lo pensado para agentes de IA: ningún aviso de escritorio cuando un agente termina o pide una aprobación, ningún historial con búsqueda entre agentes, ningún título dinámico, ningún tablero de tareas y ninguna capa de permisos para las tiradas en full auto. CodeAgentSwarm añade todo eso por encima, que es lo que más importa justo cuando ejecutas varios agentes de Codex a la vez.

Ejecuta tu enjambre de agentes Codex en CodeAgentSwarm. Varios terminales de Codex CLI en full-auto, con Turbo Mode y permisos por terminal para mantenerlos a raya.

Probar CodeAgentSwarm

También te puede interesar

Enjambre de agentes CLI de IA: ejecuta varios agentes de código en paralelo

Un enjambre de agentes CLI de IA es lo que tienes cuando dejas de pensar en un solo agente de código en un terminal y empiezas a ejecutar varios a la vez. Claude Code en un terminal, Codex CLI en otro, Gemini CLI en un tercero, todos trabajando en el mismo proyecto al mismo tiempo.

Leer guía

Ver todas las guías