Subagentes: delegar en un contexto aislado

Un subagente ejecuta una tarea en su propia ventana de contexto, separada de la conversación principal. Cuando termina, solo su conclusión vuelve a tu hilo: los archivos leídos, los registros recorridos y los callejones sin salida explorados se quedan en su propio contexto. Una buena delegación da un objetivo completo y un perímetro de escritura nombrado.

Un subagente ejecuta una tarea en su propia ventana de contexto, separada de la conversación principal. Cuando termina, solo su conclusión vuelve al hilo que tú sigues: los archivos leídos, los registros recorridos y los callejones sin salida explorados se quedan en su propio contexto.

Lo que se carga al arrancar, y lo que no llega hasta ahí

Un subagente estándar recibe su propio prompt de sistema, el mensaje de delegación que tú escribiste, la jerarquía de archivos CLAUDE.md del repositorio y una instantánea del estado de git leída al arrancar el subagente (salvo los agentes Explore y Plan), el contenido de cada skill nombrada en su campo skills, y la lista de los demás agentes nombrados de la sesión cuando dispone de SendMessage. El estilo de salida de la sesión principal y la memoria automática no le llegan.

Los límites de concurrencia y la red de seguridad

Una sesión no ejecuta un número ilimitado de subagentes a la vez: el límite por defecto es de veinte subagentes simultáneos, ajustable mediante CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS, y un subagente solo puede engendrar otro hasta tres niveles de profundidad por defecto bajo la conversación principal, ajustable mediante CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH.

Objetivo : listar los archivos de configuracion de un repositorio ficticio
y resumir en una linea el papel de cada uno.
Perimetro de escritura autorizado : ninguno.
Prohibicion explicita : ningun commit, ningun push, ningun comando destructivo.
Modelo : sonnet.

Una buena instrucción de delegación da un objetivo completo, un perímetro de escritura nombrado, prohibiciones explícitas y un modelo elegido en vez de heredado: un subagente no puede volver a hacerte una pregunta a mitad de tarea.

Claude Code escanea el informe final de un subagente antes de que el modelo principal lo lea, porque una fuente que el subagente leyó (un archivo, una página web, la salida de un comando) puede llevar una instrucción dirigida a la conversación principal. Ningún subagente se libra de ello.

El fork, una variante que no aísla nada

Una variante distinta, el fork, invocada con /subtask, no parte de un contexto vacío: hereda toda la conversación en curso hasta el instante de la llamada. Solo su resultado final se reincorpora después al hilo principal, igual que en un subagente estándar, pero todo lo que precedía a la llamada ya era conocido por el fork desde el principio.

Un subagente sigue siendo una delegación que tú decides cuando la tarea lo justifica. Un hook, presentado en la lección siguiente, obedece a otra lógica: a diferencia de un subagente, nunca decide llamar al modelo, reacciona a un evento del ciclo de vida decidido por el arnés.

Lo que cambió en octubre de 2026

La herramienta Agent acepta un parámetro effort: Claude lanza el subagente al nivel que tú pidas, bajo para una tarea simple. Un subagente puede declarar autoCompactWindow para compactar antes que la conversación principal. Los forks están activados por defecto en claude -p, el SDK, la aplicación de escritorio y VS Code, y los forks lanzados a la vez saben cuál es el suyo. Un subagente no siempre es la herramienta adecuada: el artículo de Anthropic del 22 de octubre de 2026 los reserva para el contexto saturado, las tareas paralelas y la elección de herramientas.

Un subagente solo detiene sus propios procesos

Detener node o python por su nombre, o con un filtro sobre la línea de comandos, también mata los servidores de herramientas de las demás sesiones de la máquina. Cuando el encargo de un subagente le hace lanzar un servidor o un navegador, debe decir tres cosas: anotar el pid de cada proceso lanzado, detenerlos por esos pid, y no detener nunca un proceso cuyo pid no se anotó. Si una herramienta desapareció de todos modos, /mcp permite restablecerla.

Figure 1

El ciclo completo de una delegación

Tarea secundaria detectada

Una búsqueda, una lectura de registros o un recorrido de archivos que ya no servirá después en la conversación principal.

Instrucción autónoma escrita

Objetivo completo, perímetro de escritura, prohibiciones explícitas y modelo elegido, sin nada que dependa de un intercambio posterior.

Ejecución en contexto aislado

El subagente lee, escribe y llama a herramientas en su propia ventana, sin que el detalle llegue a la conversación principal.

Informe escaneado

Claude Code examina el informe final antes de que el modelo principal lo lea, para neutralizar una instrucción deslizada en una fuente externa.

Solo la conclusión se integra

Solo el resumen se reincorpora al hilo principal, los archivos leídos y los callejones sin salida explorados permanecen en el contexto del subagente.

La secuencia muestra lo que permanece en el contexto del subagente y lo único que se reincorpora a la conversación principal, la conclusión, tras el control de seguridad.

Figure 2

Lo que llega a un subagente al arrancar

Lo que se carga al arrancar	Contexto de partida	Estilo de salida de la sesión	Ventana de contexto	Invocación
Subagente estándar	Su propio prompt de sistema, la jerarquía CLAUDE.md y el estado de git salvo para Explore y Plan, las skills nombradas	No llega al subagente	Dimensionada por su propio modelo, no por el del padre	Herramienta Agent, contexto vacío al partir
Fork	Toda la conversación en curso, ya iniciada en el momento de la llamada	También hereda la conversación en curso	Dimensionada por su propio modelo	Comando /subtask

La tabla aísla cuatro elementos y compara un subagente estándar, que parte de cero, con el fork, que hereda toda la conversación en curso hasta la llamada.

Calíbralo tú mismo

Un desarrollador delega a un subagente la lectura de una documentación publicada en una página web, con la instrucción de resumir sus puntos clave. Después recibe el resumen mostrado en pantalla y lo lee.

Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.

Tu respuesta, antes de ver la corrección

Lo que hay que recordar

Un subagente aísla su propio contexto desde el arranque, no comparte nada de la conversación principal antes de que lo solicites.
Lo que hereda es fijo: prompt de sistema propio, jerarquía CLAUDE.md, estado de git, salvo para los agentes Explore y Plan, skills nombradas, pero el estilo de salida y la memoria automática no forman parte de ello.
Un subagente debe detener solo los procesos cuyo pid anotó, nunca los que un filtro por nombre atrapa en el resto de la máquina.
El informe final de un subagente se escanea antes de que lo lea el modelo principal, porque una fuente externa consultada por el subagente puede llevar una instrucción oculta.
Un fork hereda toda la conversación en curso en lugar de partir de cero, y solo su resultado final se reincorpora después al hilo principal.

Hazlo ahora

Elige una búsqueda sin consecuencias en un repositorio que conozcas, por ejemplo contar los archivos de más de trescientas líneas, escribe una instrucción de delegación completa siguiendo el modelo del ejemplo anterior, y lánzala como subagente para comparar su conclusión con lo que tú mismo habrías encontrado.

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.

Claude Code, subagentes: parámetro effort y autoCompactWindow consultée le 2026-10-24
Anthropic, cuándo integrar los subagentes en el bucle principal consultée le 2026-10-24
Registro de cambios de Claude Code: forks por defecto, forks informados de su lanzamiento consultée le 2026-10-24