Enjambre de agentes CLI de IA: ejecuta varios agentes de código en paralelo
¿Qué es un enjambre de agentes CLI de IA?
Un enjambre de agentes CLI de IA son varios agentes de código por línea de comandos, independientes, ejecutándose en paralelo en un solo sitio, con visibilidad compartida de lo que hace cada uno. En vez de un único agente en un único terminal, tienes un puñado de ellos, cada uno con su propio proceso, su propia conversación y su propio contexto, trabajando en tareas a la vez.
Los agentes son herramientas de línea de comandos que seguramente ya usas: Claude Code de Anthropic, Codex CLI de OpenAI y Gemini CLI de Google. Cada uno ejecuta claude, codex o gemini en su propio terminal. No saben unos de otros. El enjambre es la capa que pones alrededor para poder ejecutarlos juntos sin perder el hilo.
Un enjambre de verdad es más que "varios terminales abiertos". Lo que lo hace usable es el contexto compartido: un sitio donde ves en qué trabaja cada agente, recibes un aviso cuando uno termina o necesita tu respuesta, buscas en el historial de todos, observas los cambios de archivos que hace cada uno y controlas qué pueden hacer sin tu confirmación. Sin esa capa solo tienes muchos terminales y mucho adivinar.
Un enjambre funciona sobre las suscripciones que ya pagas. Cada terminal usa tu plan de Claude, OpenAI o Google de forma independiente. No hay un plan especial de "enjambre" ni un coste extra por agente por ejecutarlos en paralelo.
Si solo te interesa un proveedor, las guías por herramienta entran en más detalle: ejecutar varias sesiones de Claude Code, el enjambre de agentes Codex y el enjambre de agentes Gemini. Esta página es la vista entre proveedores, donde los mezclas.
¿Qué CLI de código conviene para cada cosa?
La respuesta honesta es que ningún agente es el mejor en todo, y por eso compensa ejecutar un enjambre. Asignas cada trabajo al agente que suele hacerlo bien, en lugar de forzar a una sola herramienta a cubrirlo todo. Así suelo repartirlo yo.
Claude Code para refactors profundos y razonamiento
A Claude Code recurro cuando un cambio toca muchos archivos y necesita razonar con cuidado: refactorizar un módulo, seguir un bug a través de varias capas o reescribir algo donde me importa la estructura del resultado. Tiende a mantener un modelo mental coherente en un cambio grande y gestiona bien los conflictos de Git cuando comparte proyecto con otros agentes.
Codex CLI para tareas concretas y acotadas
Codex CLI encaja bien en trabajos bien delimitados: implementa esta función, añade este endpoint, escribe tests para este archivo, arregla este fallo concreto. Cuando la tarea está acotada y la especificación es clara, llega rápido a un resultado que funciona. Suelo darle las piezas que ya tengo decididas mientras Claude está ocupado con el refactor grande.
Gemini CLI para trabajo de mucho contexto
En Gemini CLI me apoyo cuando hay mucho que leer de golpe: entender una base de código que no conozco, resumir un conjunto grande de archivos o responder preguntas que necesitan una visión amplia del proyecto. Su gran ventana de contexto te deja meterle más antes de tener que empezar a recortar lo que ve.
No tienes que elegir una vez y quedarte ahí. Por cada tarea, pregúntate cuál es la forma más barata y fiable de obtener un resultado correcto, y mándala a ese agente. Un enjambre solo ayuda si de verdad aprovechas la diferencia entre los agentes.
Nada de esto es una regla fija, los modelos cambian de un mes a otro. Tómalo como un sesgo inicial, no como una ley, y ajústalo según lo que veas en tus propios proyectos.
Dos preguntas que aparecen las primeras
¿Necesito git worktrees para ejecutar agentes en paralelo?
No, los worktrees son opcionales. Una preocupación habitual es que varios agentes en el mismo repo se pisen entre ellos, así que la gente recurre a los git worktrees para dar a cada agente su propio checkout. Eso puede venir bien cuando dos agentes hacen cambios grandes y en conflicto sobre la misma rama. Pero no hace falta para empezar.
En la práctica puedes ejecutar varios terminales contra un mismo workspace y un mismo checkout. Cuando los agentes editan archivos distintos no hay conflicto. Cuando tocan el mismo archivo, Git gestiona el merge y los agentes resuelven los conflictos bastante bien. Los worktrees son una herramienta para los casos raros en los que quieres aislamiento total, no un requisito para montar un enjambre.
¿Es lo mismo que los agent teams de Claude Code?
No, son cosas distintas. Los agent teams de Anthropic son subagentes dentro de una sola sesión de Claude Code: un agente principal lanza ayudantes que le reportan, todo dentro de un proceso y un proveedor. Un enjambre de agentes CLI de IA son varios agentes independientes que supervisas tú directamente, cada uno en su terminal, posiblemente de proveedores distintos (Claude Code, Codex, Gemini). Uno es delegación dentro de una sesión, el otro eres tú ejecutando y vigilando varias sesiones reales a la vez. Pueden convivir, pero resuelven problemas diferentes.
Método 1: varias ventanas de terminal (gratis, básico)
El enjambre más simple es el que puedes montar ahora mismo. Abre unas cuantas pestañas de terminal, ve a tu proyecto en cada una y arranca un agente distinto en cada pestaña.
# Pestaña 1 - refactor profundo
cd ~/mi-proyecto
claude
# Pestaña 2 - tarea concreta
cd ~/mi-proyecto
codex
# Pestaña 3 - leer la base de código
cd ~/mi-proyecto
geminiEso ya es un enjambre de tres agentes funcionando. Cada pestaña es un agente independiente sobre el mismo proyecto, y cambias entre ellas para dar instrucciones.
A favor
- Gratis, no necesitas herramientas extra
- Funciona al momento, sin configuración
- Puedes mezclar proveedores desde el primer minuto
En contra
- Pierdes rápido la cuenta de qué pestaña ejecuta qué agente y qué tarea
- Sin aviso cuando un agente termina o se para a preguntarte algo
- Sin vista compartida, tienes que entrar en cada pestaña para ver el estado
- Sin búsqueda en el historial de los distintos agentes
- Las ediciones que se solapan entre agentes te pillan por sorpresa
- Con tres o más pestañas todas empiezan a parecer iguales
Bien para dos agentes. A partir de ahí, el tiempo que pasas cambiando y comprobando empieza a comerse el que te ahorró el paralelismo.
Método 2: tmux o screen (gratis, avanzado)
Si vives en el terminal, tmux te da paneles divididos y sesiones persistentes, así que ves varios agentes a la vez sin saltar entre pestañas.
# Inicia una sesión de tmux para el enjambre
tmux new-session -s swarm
# Divide en paneles
tmux split-window -h
tmux split-window -v
# Ejecuta un agente distinto en cada panel: claude, codex, geminiTambién puedes desconectarte y volver a conectarte, así que el enjambre sobrevive a cerrar la ventana del terminal. Para un montaje multiproveedor hecho a mano, esto es casi lo mejor que vas a conseguir gratis.
A favor
- Gratis y disponible casi en cualquier sitio
- Ves varios paneles a la vez, sin cambiar de pestaña
- Las sesiones persisten aunque te desconectes
- Muy automatizable si quieres montar tu propio diseño
En contra
- Curva de aprendizaje pronunciada si tmux es nuevo para ti
- Sigue sin haber notificaciones de escritorio cuando un agente termina
- Sin historial buscable entre los distintos agentes
- Solo texto, los paneles se quedan estrechos pasando de tres o cuatro agentes
- Sin tablero de tareas ni capa de organización
- Montas el diseño a mano cada vez
- Vigilar conflictos entre agentes queda enteramente de tu lado
tmux es un gran multiplexor de propósito general, pero nunca se hizo para supervisar agentes de código de IA. Las carencias salen en cuanto ejecutas un enjambre mixto de tres o más agentes de forma habitual.
Método 3: CodeAgentSwarm (visual, completo)
CodeAgentSwarm es una app de escritorio hecha justo para esto: ejecutar un enjambre de agentes CLI de IA con visibilidad y control de verdad. Funciona en macOS y Windows, te da hasta seis terminales en un solo workspace y te deja elegir el agente por terminal. Funciona sobre tus suscripciones, no es un proveedor de modelos, así que tus planes de Claude, OpenAI y Google siguen funcionando tal cual.
Esto es lo que te da el workspace para gestionar un enjambre mixto:
Hasta 6 agentes en paralelo, tú eliges por terminal
Cada terminal tiene un selector SELECT AI AGENT que ofrece claude-code, codex cli y gemini cli. Pon un terminal en Claude Code para un refactor, otro en Codex para una tarea acotada y otro en Gemini para lectura de mucho contexto, todo en el mismo workspace y sobre el mismo proyecto. Tú decides la mezcla y puedes cambiarla por terminal cuando quieras.
Visibilidad en tiempo real con títulos dinámicos
Cada terminal actualiza su título para reflejar lo que está haciendo su agente en ese momento. En lugar de tres terminales idénticos, ves "Refactorizando Auth", "Escribiendo tests de API", "Leyendo módulo de pagos", y de un vistazo sabes qué agente está en qué tarea sin entrar.
Notificaciones de escritorio de todos los agentes
Cuando cualquier agente termina su tarea o se para a preguntarte algo, recibes una notificación de escritorio nativa. Puedes centrarte en un terminal y dejar que el resto te avise cuando te necesite, que es justo el sentido de ejecutar un enjambre. La guía del sistema de notificaciones entra en el detalle.
Historial buscable de todos los agentes
Cada conversación, de cada agente y cada proveedor, se guarda y se puede buscar en un solo sitio. Puedes encontrar lo que hizo Codex ayer, retomar una sesión de Gemini o rastrear qué agente hizo un cambio en todo el enjambre. La guía del historial de conversaciones explica cómo funciona.
Diffs de archivos en vivo por terminal
Puedes observar en tiempo real los cambios de archivos que hace cada agente, por terminal y a nivel de proyecto. En un enjambre mixto esto es lo que evita que las ediciones solapadas te sorprendan: ves cuándo dos agentes van hacia el mismo archivo antes de que se convierta en un problema de merge. Más en la guía de cambios en tiempo real.
Modo Turbo con permisos granulares
Más agentes significa más acciones ocurriendo a la vez, así que el control de permisos importa más, no menos. El Modo Turbo aprueba automáticamente las operaciones seguras y mantiene bajo control las peligrosas, con control granular sobre qué puede hacer cada terminal sin supervisión. La guía del Modo Turbo tiene la configuración completa.
Un tablero de tareas compartido y herramientas de proyecto
Un tablero kanban se sitúa sobre el enjambre, y los agentes lo actualizan ellos mismos por MCP a medida que trabajan. Suma los accesos directos a proyectos, un marketplace de skills, un marketplace de MCP y mensajes de commit de Git generados por IA, y el workspace se convierte en el único sitio desde el que coordinas todo el enjambre, en lugar de hacer malabares con pestañas.
Para el paso a paso de cómo abrir y organizar terminales, mira la guía de varios terminales. El mismo workspace ejecuta también terminales de Codex y Gemini.
Comparativa rápida
Cómo se comparan las tres formas de ejecutar un enjambre en lo que de verdad importa cuando varios agentes trabajan a la vez:
Coste
- Pestañas de terminal: Gratis
- tmux/screen: Gratis
- CodeAgentSwarm: Plan gratuito disponible, Pro para funciones avanzadas, funciona sobre tus suscripciones de agentes
Mezclar proveedores
- Pestañas de terminal: Posible, pero recuerdas de memoria qué agente está dónde
- tmux/screen: Posible, los paneles no están etiquetados por agente
- CodeAgentSwarm: Selector de agente por terminal, con el agente activo visible en todo momento
Notificaciones
- Pestañas de terminal: Ninguna
- tmux/screen: Ninguna salvo que la programes tú
- CodeAgentSwarm: Notificaciones de escritorio nativas cuando cualquier agente termina o necesita tu respuesta
Historial entre agentes
- Pestañas de terminal: Se pierde al cerrar la pestaña
- tmux/screen: Se mantiene mientras vive la sesión, sin búsqueda
- CodeAgentSwarm: Guardado de forma permanente y buscable entre todos los agentes y proveedores
Visibilidad de cambios de archivos
- Pestañas de terminal: Lo que imprima cada agente, nada compartido
- tmux/screen: Igual, sin vista entre agentes
- CodeAgentSwarm: Diffs en vivo por terminal y a nivel de proyecto, así las ediciones solapadas se ven pronto
Curva de aprendizaje
- Pestañas de terminal: Ninguna
- tmux/screen: De moderada a pronunciada (atajos, configuración, gestión de paneles)
- CodeAgentSwarm: Baja, una interfaz visual con patrones familiares
Si solo vas a ejecutar dos agentes, las pestañas del terminal están bien y no le des más vueltas. Si ya vives en tmux, añadir un par de agentes a tu montaje es natural. Pero en cuanto ejecutes un enjambre mixto de tres o más agentes de forma habitual, y quieras ver qué hace cada uno, que te avisen cuando te necesiten y cazar las ediciones solapadas antes de que muerdan, un workspace hecho a propósito quita la fricción que los otros métodos dejan ahí.
Preguntas frecuentes
Son varios agentes de código por línea de comandos, independientes (como Claude Code, Codex CLI y Gemini CLI), ejecutándose en paralelo en un solo sitio, con visibilidad compartida de lo que hace cada uno. Cada agente es su propio proceso, con su conversación y su contexto, y el enjambre es la capa a su alrededor que añade notificaciones, historial buscable, visibilidad de cambios de archivos y control de permisos.
Sí. Cada agente se ejecuta como un proceso CLI independiente, así que puedes tener Claude Code, Codex CLI y Gemini CLI a la vez sobre el mismo proyecto. CodeAgentSwarm te deja elegir el agente por terminal y ejecutar hasta seis a la vez en un solo workspace, así que mezclas proveedores con total libertad.
No hay un único agente mejor, y por eso ayuda un enjambre. Como sesgo inicial: Claude Code para refactors profundos y cambios que necesitan razonar con cuidado entre muchos archivos, Codex CLI para tareas concretas y bien delimitadas como implementar una función o arreglar un fallo específico, y Gemini CLI para trabajo de mucho contexto como entender una base de código desconocida. Los modelos cambian a menudo, así que tómalo como punto de partida y ajústalo según tus propios resultados.
No, los worktrees son opcionales. Puedes ejecutar varios agentes contra un mismo workspace y un mismo checkout. Cuando editan archivos distintos no hay conflicto, y cuando tocan el mismo archivo Git gestiona el merge y los agentes lo resuelven bastante bien. Los git worktrees son útiles cuando quieres aislamiento total para cambios grandes y en conflicto, pero no son un requisito para montar un enjambre.
No. Los agent teams de Claude Code son subagentes dentro de una sola sesión de Claude Code, todo dentro de un proceso y un proveedor. Un enjambre de agentes CLI de IA son varios agentes independientes que supervisas tú directamente, cada uno en su terminal, posiblemente de proveedores distintos. Uno es delegación dentro de una sesión, el otro es ejecutar y vigilar varias sesiones reales a la vez. Resuelven problemas diferentes y pueden convivir.
Ejecuta Claude Code, Codex y Gemini en paralelo en un solo workspace de CodeAgentSwarm. Hasta seis agentes, visibilidad compartida y un único sitio desde el que vigilarlos.
Probar CodeAgentSwarm