Cómo ejecutar varios agentes de codificación de IA en paralelo con git worktrees

Uno de los mayores cambios en el desarrollo asistido por IA a lo largo de 2026 es que ya no apuntas un único agente a una única tarea. Herramientas como Claude Code y Cursor ahora fomentan ejecutar varios agentes en paralelo — uno arreglando un error, otro escribiendo pruebas, un tercero esbozando una funcionalidad. La trampa: si todos editan el mismo directorio de trabajo, se sobrescriben los cambios unos a otros y corrompen la compilación.

La solución limpia es una vieja función de Git que resulta ser la primitiva perfecta para esto: los worktrees.

Qué es realmente un worktree

Normalmente un repositorio de Git tiene un único directorio de trabajo — la carpeta en la que editas archivos. git worktree permite que un repositorio tenga varios directorios de trabajo a la vez, cada uno con una rama distinta extraída, todos compartiendo el mismo historial .git subyacente. Cada worktree es una carpeta real en el disco con sus propios archivos, de modo que un agente que trabaja en uno no puede tocar los archivos de otro.

Piénsalo como darle a cada agente su propio escritorio en la misma oficina, en lugar de tres personas peleándose por un teclado.

El flujo de trabajo principal

Desde dentro de tu repositorio, crea un worktree para cada tarea en su propia rama:

# Create a new branch + folder for an auth bug fix
git worktree add ../myapp-auth-fix -b fix/auth-bug

# Another for a feature, in parallel
git worktree add ../myapp-search -b feat/search

# See everything you have checked out
git worktree list

Ahora tienes dos carpetas hermanas junto a tu repositorio principal: myapp-auth-fix y myapp-search. Abre una sesión de agente separada en cada una — cd ../myapp-auth-fix y arranca Claude Code ahí, luego haz lo mismo en ../myapp-search en otra pestaña de la terminal. Cada agente tiene una copia completa e independiente. Se ejecutan al mismo tiempo, confirman commits en sus propias ramas y nunca colisionan.

Cuando una tarea esté hecha, fusiona su rama y elimina el worktree para mantener el orden:

git checkout main
git merge fix/auth-bug
git worktree remove ../myapp-auth-fix

Un ejemplo concreto

Digamos que estás construyendo una pequeña aplicación web y tienes tres trabajos independientes: arreglar una redirección de login inestable, añadir paginación a una lista y actualizar una dependencia lenta. En lugar de hacerlos de uno en uno:

git worktree add ../app-login   -b fix/login-redirect
git worktree add ../app-paging  -b feat/pagination
git worktree add ../app-deps    -b chore/upgrade-deps

Lanza un agente en cada carpeta con un prompt enfocado. Mientras el agente de login traza la lógica de redirección, el agente de paginación ya está escribiendo componentes y el agente de dependencias está ejecutando la actualización y la suite de pruebas. Veinte minutos después revisas tres ramas separadas y limpias, y fusionas las que pasan.

Consejos que lo mantienen manejable

• Mantén las tareas independientes. Los worktrees evitan conflictos de archivos, pero si dos agentes editan los mismos archivos en ramas distintas, igualmente tendrás conflictos de merge al final. Divide el trabajo por costuras naturales.
• Dale a cada worktree el mismo contexto. Un CLAUDE.md (o archivo de reglas equivalente) confirmado en tu repositorio viaja automáticamente a cada worktree, de modo que cada agente hereda tus convenciones.
• Vigila las carpetas de dependencias. node_modules, los entornos virtuales y las cachés de compilación no se comparten entre worktrees. Puede que necesites ejecutar npm install una vez por worktree, o usar un gestor de paquetes con un almacén global (pnpm, uv) para evitar descargarlo todo de nuevo.
• No sobreparalelices. En la práctica, de tres a cinco agentes concurrentes es el punto óptimo. Más allá de eso, el tiempo que pasas revisando y coordinando supera la velocidad que ganas.

Las integraciones nativas de worktree han ido llegando a las principales herramientas desde finales de 2025, y ya existen lanzadores dedicados para abrir sesiones por ti. Pero no necesitas ninguno de ellos para empezar — git worktree add viene integrado en Git, funciona hoy mismo y es la forma más fiable de dejar que varios agentes de IA construyan para ti a la vez sin tropezar entre ellos.