Home / Glossary / Sub-Agentes

Definition

Sub-Agentes

Los sub-agentes son procesos hijos paralelos generados por un agente principal de programación con IA para manejar partes independientes de una tarea compleja simultáneamente. En lugar de procesar todo secuencialmente, el agente principal delega sub-tareas a agentes hijos especializados que se ejecutan en paralelo y reportan resultados al padre.

Cómo funcionan los sub-agentes

Cuando un agente principal encuentra una tarea con múltiples partes independientes, puede generar sub-agentes para manejarlas en paralelo. Por ejemplo, si pides "refactoriza los módulos de autenticación, pago y notificaciones para usar el nuevo patrón de manejo de errores," el agente principal podría generar tres sub-agentes—uno para cada módulo. Cada sub-agente lee los archivos relevantes, hace cambios y ejecuta pruebas de forma independiente. El agente principal recoge los resultados y asegura la consistencia entre los cambios.

Cuándo son útiles los sub-agentes

  • +Tareas de refactorización grandes que abarcan múltiples módulos independientes
  • +Investigar diferentes partes de un código base simultáneamente
  • +Ejecutar múltiples tareas de análisis (auditoría de seguridad, revisión de rendimiento, revisión de estilo) en paralelo
  • +Generar código para múltiples componentes independientes a la vez
  • +Investigar errores complejos que pueden tener múltiples causas raíz

Los sub-agentes son más efectivos cuando las sub-tareas son verdaderamente independientes—no modifican los mismos archivos ni dependen de la salida del otro. Cuando las tareas tienen dependencias, la ejecución secuencial por un solo agente es más apropiada para evitar conflictos.

Claude Code soporta sub-agentes a través de su herramienta Task. El agente principal puede generar agentes hijos con instrucciones específicas y permisos delimitados, luego sintetizar sus resultados en una respuesta coherente.

¿Los sub-agentes comparten contexto con el agente principal?+
Los sub-agentes reciben contexto del agente principal cuando se crean, pero no comparten una ventana de contexto en vivo. Cada sub-agente opera independientemente con su propio contexto. El agente principal recibe su salida final y la sintetiza.
¿Cuántos sub-agentes pueden ejecutarse a la vez?+
Esto depende de la herramienta y los recursos disponibles. Claude Code puede ejecutar múltiples sub-agentes en paralelo, típicamente 2-5 dependiendo de la complejidad de cada tarea. El límite práctico está determinado por el uso de tokens y los límites de tasa de la API.
¿Los sub-agentes pueden generar sus propios sub-agentes?+
En principio, sí—esto crea un árbol de agentes. En la práctica, la mayoría de las tareas se manejan bien con un solo nivel de delegación. El anidamiento profundo añade complejidad sin beneficio proporcional para la mayoría de las tareas de programación.
¿Cuándo debería evitar usar sub-agentes?+
Evita los sub-agentes cuando las tareas tienen dependencias entre sí, cuando modificarían los mismos archivos (arriesgando conflictos de merge), o cuando la tarea es lo suficientemente pequeña como para que el procesamiento secuencial sea más rápido que la sobrecarga de generar y coordinar múltiples agentes.

Related terms

Programación AgénticaClaude CodeAgente de ProgramaciónAgente de IA Headless

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS