Cómo ejecutar varios agentes de Claude Code en paralelo

Un agente es útil. Tres agentes trabajando en tareas distintas mientras tú revisas el diff del primero es donde los agentes de terminal de verdad compensan. Pero también se tuerce rápido: dos agentes editando el mismo archivo, un servidor de desarrollo peleándose por un puerto o un límite de uso agotado a media tarde.

Esta guía explica una configuración que evita esos problemas. Si prefieres que sea un agente quien reparta y revise el trabajo, consulta Un equipo de agentes de IA para programar. Funciona con Claude Code, Codex, Gemini CLI y cualquier otra CLI de agentes.

Resumen rápido

1. Dale a cada agente su propia tarea y, si va a cambiar código, su propia copia de trabajo (un git worktree).
2. Ten todos los agentes de un proyecto a la vista en una cuadrícula, para darte cuenta cuando uno te necesita.
3. Usa un segundo agente como revisor, no como segundo autor del mismo código.
4. Vigila tus límites de uso, porque los agentes en paralelo también los gastan en paralelo.

Paso 1: divide el trabajo en tareas independientes

Los agentes en paralelo funcionan cuando sus tareas no tocan los mismos archivos. Buenas divisiones:

• Una funcionalidad en una zona y un bug fix en otra
• Implementar un cambio y escribir tests para código existente
• Un agente programando y otro escribiendo documentación o un plan de migración
• Investigar o leer código, que no cambia nada

Las malas divisiones son dos agentes en el mismo componente, o un agente refactorizando código que otro está ampliando. Si no puedes describir los archivos de cada tarea sin que se solapen, ejecútalas una detrás de otra.

Paso 2: dale a cada agente su propio worktree

Dos agentes en la misma carpeta comparten un único árbol de trabajo. Cuando editan los dos, acabas con cambios a medias, conflictos inesperados y diffs que no sabes de quién son. La solución es un git worktree por tarea: una segunda copia del mismo repositorio en su propia carpeta, en su propio branch.

git worktree add ../atlas-auth -b feat/auth
git worktree add ../atlas-search -b feat/search

Cada agente trabaja en su carpeta y fusionas los branches cuando terminan. Claude Code también puede hacerlo en un solo paso con claude --worktree feature-auth. Nuestra guía de git worktrees para Claude Code y Codex entra en detalle, incluidas las dependencias, los archivos .env y la limpieza.

Los agentes de solo lectura (revisión, investigación, preguntas sobre la documentación) pueden compartir la carpeta principal.

Paso 3: todos los agentes en una sola pantalla

El fallo típico con agentes en paralelo no es el código, es la atención. Un agente pide permiso en una pestaña en segundo plano y se queda esperando veinte minutos.

En Vibe Console, cada proyecto puede tener hasta 10 terminales, en pestañas o en una cuadrícula de 1×2 a 3×3. Una distribución que funciona bien para tres agentes:

Cada terminal puede ejecutar un agente distinto: elige uno junto al botón Iniciar y pulsa ⌘K. Para arrancar un agente dentro de un worktree, entra primero con cd; también puedes arrastrar un worktree desde el panel Control de código fuente hasta una terminal para pegar su ruta. Renombra las terminales (Renombrar…) según su tarea para que la cuadrícula se lea como una lista de tareas.

Cada pestaña muestra un punto que indica si su agente está trabajando o inactivo. Cuando un agente termina, o se para a esperar tu respuesta, la app reproduce un sonido y abre la muesca en esa sesión, así que puedes desentenderte. Consulta Notificaciones de Claude Code en Mac para ver los detalles y una alternativa gratuita con hooks.

Paso 4: usa un segundo agente como revisor

Cada modelo detecta errores distintos. Un patrón barato y eficaz:

1. Claude Code implementa un cambio en su worktree.
2. Cuando termina, arranca Codex (u otra sesión de Claude Code) en la misma carpeta con un prompt de revisión guardado, por ejemplo: «Revisa el diff sin commit en busca de bugs, tests que falten y problemas de seguridad. No edites archivos; enumera los hallazgos con archivo y línea.»
3. Pega los hallazgos en la conversación del primer agente.

Guarda el prompt de revisión una sola vez en Prompts guardados (⌘⇧S) y pégalo con un clic en cualquier terminal.

Paso 5: vigila tus límites de uso

Los planes de Claude Code y Codex miden el uso por ventanas, entre ellas una ventana móvil de 5 horas y un límite semanal. Tres agentes la gastan más o menos tres veces más rápido, y agotar un límite a mitad de una tarea deja el trabajo a medias.

Vibe Console muestra anillos de cuota de Claude Code y Codex en la muesca y en la barra de herramientas de la terminal, con la hora de restablecimiento, y te avisa al 80 % y al 100 %. Nuestra guía de límites de uso de Claude Code explica las ventanas y cómo organizarte en torno a ellas.

Paso 6: fusiona y limpia

Cuando una tarea está lista:

1. Revisa el diff del branch (Control de código fuente, ⌘⇧G).
2. Ejecuta los tests en ese worktree.
3. Fusiona el branch y elimina el worktree (Eliminar worktree en Control de código fuente, o git worktree remove ../atlas-auth).

¿Cuántos agentes son demasiados?

Para la mayoría, dos o tres agentes programando más un revisor es el máximo útil. A partir de ahí, el cuello de botella es la revisión, no los agentes. Añade más agentes en paralelo solo para tareas independientes, bien definidas y con buenos tests.

Preguntas frecuentes

¿Puedo ejecutar Claude Code y Codex en el mismo proyecto a la vez?

Sí. Dale a cada uno su propio worktree si los dos cambian código, o deja a uno en el papel de revisor de solo lectura.

¿Las sesiones de Claude Code en paralelo comparten contexto?

No. Cada sesión tiene su propia conversación. Comparte las decisiones mediante archivos que lean los agentes, como CLAUDE.md, AGENTS.md o las notas del proyecto.

¿Ejecutar agentes en paralelo cuesta más?

Gasta los límites de tu plan más rápido, porque cada agente consume uso por su cuenta. El trabajo total es parecido; simplemente se hace en menos tiempo.

¿Quieres probarlo? Descarga Vibe Console gratis durante 14 días.