Inicio / Varios agentes y verificación adversa
Aislar y ejecutar en segundo plano: worktrees y bucle en seco
Un worktree de git por agente evita que los archivos de varios agentes paralelos entren en colisión, un bucle en seco repite hasta que un ciclo ya no devuelve nada nuevo apoyándose en un conjunto ya visto, y desde el 13 de agosto de 2026 un agente que no es compañero de equipo lanzado en una sesión interactiva se ejecuta por defecto en segundo plano con notificación al final en lugar de bloquear la sesión.
Un agente que escribe en el mismo repositorio que otro agente, al mismo tiempo, corre el riesgo de sobrescribir lo que el otro acaba de producir. La solución documentada por Claude Code consiste en dar a cada agente paralelo su propia copia temporal del repositorio, un worktree de git, añadiendo isolation: worktree en su cabecera de configuración. Cada agente trabaja entonces en su propia copia, y esa copia se limpia automáticamente sola cuando el agente no ha modificado nada.
Un bucle que sabe detenerse
Un segundo gesto responde a un problema distinto, una búsqueda que no sabe cuándo ha terminado de encontrar. La documentación oficial describe este patrón para detectar pruebas inestables: relanzar la suite varias veces, anotar qué pruebas fallan de forma intermitente, y detenerse en cuanto dos pasadas consecutivas ya no señalan nada nuevo. El mismo principio se aplica a cualquier búsqueda exhaustiva, una auditoría de dependencias, un inventario de archivos huérfanos: cada ciclo compara su resultado con el conjunto ya conocido, y solo un elemento ausente de ese conjunto cuenta como novedad en ese turno.
Ciclo 1 : 4 elementos encontrados, 4 nuevos, conjunto conocido = 4
Ciclo 2 : 5 elementos encontrados, 1 nuevo, conjunto conocido = 5
Ciclo 3 : 5 elementos encontrados, 0 nuevos
Ciclo 4 : 5 elementos encontrados, 0 nuevos, dos turnos sin novedad, el bucle se detiene
El cambio del 13 de agosto de 2026
El paso a segundo plano no es un ajuste que se active, se ha convertido en el comportamiento por defecto. Desde la versión 2.1.232 de Claude Code, publicada el 13 de agosto de 2026, un agente que no es compañero de equipo de la sesión y que arranca durante una sesión interactiva se ejecuta en segundo plano en lugar de bloquear la conversación en curso; el registro de cambios no precisa si avisa mediante una notificación al final, este punto queda por verificar uno mismo. El mismo registro sitúa este cambio en la misma entrada que la activación por defecto del modo que hace que un subagente herede la caché y la conversación completa, unidos por una simple y: no establece ningún vínculo de causa y efecto entre los dos, son dos cambios simultáneos de la misma versión, no un mecanismo que desencadena al otro.
El aislamiento por worktree y la ejecución en segundo plano se combinan de forma natural: varios agentes lanzados en paralelo, cada uno en su propia copia del repositorio, se ejecutan ahora sin bloquear la sesión mientras trabajan. La lección anterior sobre la elección de la arquitectura determina si hay que lanzar esos agentes en paralelo, esta determina cómo hacerlos convivir sin colisión. La lección siguiente trata lo que ocurre cuando su número supera un puñado.
Un detalle cambia la fiabilidad del bucle en seco: el recuento de novedades se calcula contra el conjunto acumulado desde el primer ciclo, nunca contra el único ciclo anterior. Un elemento que desaparece y luego reaparece en el ciclo siguiente no debe volver a contarse como nuevo, so pena de hacer girar el bucle indefinidamente sobre un resultado inestable en lugar de sobre una búsqueda realmente incompleta.
El paso a segundo plano por defecto, fecha exacta
El bucle en seco, ciclo por ciclo
Un desarrollador lanza dos agentes al mismo tiempo desde una sesión interactiva, cada uno encargado de aplicar la misma migración de dependencia en una carpeta distinta del mismo repositorio, con el aislamiento por worktree activado en la cabecera de cada uno.
Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.
Lo que esto establece: El aislamiento por worktree garantiza que los archivos modificados por un agente durante la ejecución no pueden ser sobrescritos por los archivos modificados por el otro agente en el mismo momento.
Lo que esto no establece: No establece que la migración aplicada por cada uno de los dos agentes sea correcta, ni que sus dos copias del repositorio podrán reunirse sin conflicto una vez terminado el trabajo.
Los tres calibrados falsos más frecuentes
- Demasiado amplio El aislamiento por worktree garantiza que nunca aparecerá ningún conflicto, ni siquiera en el momento de reunir las dos copias del repositorio en una sola.
- Demasiado estrecho Esta configuración no cambia nada respecto a dos agentes escribiendo directamente en la misma carpeta de trabajo.
- Fuera de tema Esta situación muestra que la migración de dependencia elegida probablemente afecta a una biblioteca compartida por varias partes del proyecto.
- Un worktree por agente da a cada agente paralelo su propia copia temporal del repositorio, lo que impide que dos agentes escriban en el mismo sitio al mismo tiempo.
- Un worktree que no ha servido para ninguna modificación se limpia solo, sin intervención manual.
- Un bucle en seco compara cada ciclo con el conjunto acumulado desde el primer turno, y se detiene tras dos turnos consecutivos sin novedad.
- El paso por defecto a segundo plano, desde la versión 2.1.232, solo afecta a los agentes que no son compañeros de equipo lanzados en sesión interactiva, no a todo lanzamiento de agente, y el registro de cambios no lo presenta como la consecuencia de otro cambio de la misma entrada.
Abre la configuración de tu próximo subagente paralelo y añade isolation: worktree en su cabecera, luego lánzalo junto a otro agente en el mismo repositorio para verificar que ninguno de los dos toca los archivos del otro.
Estos puntos dependen de una interfaz o de una regla que puede haber cambiado desde la redacción. Verifícalos en tu propia pantalla antes de fiarte de ellos.
- Verifica en el registro de cambios de Claude Code si un número posterior a 2.1.232 ha modificado la condición que desencadena el paso a segundo plano, en particular el alcance del modo que hace que un subagente herede la conversación completa.
Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.
- Claude Code, documentación de los worktrees, consultada el 2026-09-02 consultée le 2026-09-02
- Claude Code, documentación de los workflows, consultada el 2026-09-02 consultée le 2026-09-02
- Claude Code, registro de cambios, entrada versión 2.1.232 consultée le 2026-08-13