Ir al contenido
Mastering Claude

Inicio / Varios agentes y verificación adversa

Varios agentes y verificación adversa8 minApplication

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.

Figure 1

El paso a segundo plano por defecto, fecha exacta

2.1.232versión de Claude Code
a partir de la cual un agente que no es compañero de equipo lanzado en sesión interactiva se ejecuta por defecto en segundo plano
Claude Code, registro de cambios, 2026-08-13
El cambio afecta a los agentes que no son compañeros de equipo lanzados en sesión interactiva, no a todo lanzamiento de agente en cualquier circunstancia.
Figure 2

El bucle en seco, ciclo por ciclo

01
Lanzar el ciclo
El ciclo relanza la misma búsqueda sobre el estado actual del sistema observado.
02
Comparar con lo ya visto
Cada elemento encontrado se compara con el conjunto acumulado desde el primerísimo ciclo, no solo con el ciclo anterior.
03
Contar las novedades
Solo un elemento ausente de ese conjunto acumulado cuenta como novedad en ese turno.
04
Decidir
Si este turno comporta al menos una novedad, un nuevo ciclo arranca de inmediato.
05
Detener
Tras dos turnos consecutivos sin la menor novedad, el bucle se detiene y el conjunto acumulado se convierte en el resultado retenido.
Cada ciclo relanza la misma búsqueda y compara su resultado con el conjunto ya conocido, el bucle solo se detiene tras dos turnos consecutivos sin novedad.
Calíbralo tú mismo

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 hay que recordar
  • 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.
Hazlo ahora

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.

Lo que queda por verificar

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.
Verificar en la fuente

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.