Subagentes: delega como un desarrollador senior
Asigna tareas enfocadas a instancias especializadas de Claude
⏱ Estim. ~6 min
01 · Leer
Los desarrolladores senior no hacen todo solos: delegan. Cuando un junior le pide a un senior que investigue un bug, el senior no abandona su trabajo actual. Manda a alguien a investigar y reportar.
Los subagentes te dejan hacer lo mismo con Claude Code. En vez de una sola conversación gigante intentando manejar todo (leer archivos, correr tests, investigar arquitectura), puedes asignar tareas enfocadas a subagentes especializados que trabajan en su propia ventana de contexto.
Beneficio clave: los subagentes mantienen limpia tu conversación principal. Un subagente puede leer 50 archivos para entender tu sistema de validación, pero solo te devuelve un resumen corto a tu ventana de contexto.
💡 Imagínalo asíPiensa en un subagente como mandar a un asistente de investigación a la biblioteca. Tú no vas en persona ni llenas tu escritorio de libros: él va, lo lee todo y vuelve con un resumen de una página. Tu escritorio queda libre para el trabajo importante.
Puntos clave
- Los subagentes corren en una ventana de contexto separada de tu conversación principal
- Investigan, analizan y ejecutan tareas de forma independiente
- Solo devuelven un resumen a tu contexto, no todos los archivos que leyeron
- Tu conversación principal se mantiene enfocada en la implementación
02 · Leer
Claude Code trae varios tipos de subagentes integrados, cada uno diseñado para tareas específicas: - Explore: investigación de solo lectura. Busca archivos, lee código, responde preguntas sobre el codebase. No puede editar. - Plan: diseño de arquitectura. Explora el codebase y propone un plan de implementación. Es de solo lectura hasta que apruebes. - Bash: experto en comandos. Corre comandos de terminal. Úsalo para tests, builds, chequeos del sistema.
Claude genera subagentes automáticamente cuando reconoce una tarea que conviene aislar, como investigar un codebase grande o correr una suite de tests. También puedes pedirlo de forma explícita.
Puntos clave
- Explore: investigación de solo lectura y análisis del codebase
- Plan: diseño de arquitectura y planificación de la implementación
- Bash: comandos de terminal y operaciones del sistema
- Claude genera subagentes automáticamente cuando corresponde
03 · Ejemplo de código
Le puedes pedir a Claude directamente que use un subagente. Abajo hay un prompt que dispara la delegación a un subagente.
Prompt que dispara un subagente
"Use a subagent to investigate how auth works in this codebase"
"Explore the database schema and summarize what tables we have"
"Run the test suite and report which tests fail"
"Analyze the API routes and list all endpoints"
Cuando le pides a Claude que «investigue», «explore», «analice» o «corra tests», muchas veces delega automáticamente a un subagente. El subagente hace el trabajo pesado en su propio contexto y devuelve un resumen conciso a tu conversación.
04 · Leer
Puedes crear tus propios subagentes personalizados escribiendo un SKILL.md con frontmatter YAML. Eso define un agente especializado con sus propias instrucciones, restricciones de herramientas y elección de modelo.
Los agentes personalizados son potentes porque puedes limitar sus capacidades. Un code reviewer solo necesita leer archivos, no debería editar ni correr comandos. Un test runner necesita Bash pero no Edit. Las restricciones de herramientas hacen al agente más seguro y enfocado.
Puntos clave
- Los agentes personalizados se definen en un SKILL.md con frontmatter YAML
- El campo tools: limita lo que el agente puede hacer
- Un reviewer necesita Read/Grep/Glob, no Edit ni Bash
- Las restricciones hacen al agente más seguro y enfocado
05 · Ejemplo de código
Abajo está cómo crear un subagente code-reviewer personalizado. El frontmatter YAML configura su comportamiento.
.claude/skills/code-reviewer/SKILL.md
---
name: code-reviewer
description: Expert code review specialist. Use after code changes.
tools: Read, Grep, Glob
model: sonnet
---
Review code for:
1. Bug risks and logic errors
2. Security vulnerabilities (injection, auth bypass)
3. Performance issues (N+1 queries, unnecessary loops)
4. Style inconsistencies with the existing codebase
Provide specific line references and severity ratings.
Este agente solo puede leer código, no puede editar archivos ni correr comandos. La restricción tools: Read, Grep, Glob asegura que se mantenga enfocado en la revisión. model: sonnet significa que usa Sonnet (rápido y costo-efectivo) en vez del modelo que usa tu conversación principal.
06 · Quiz
Estás implementando una funcionalidad nueva y necesitas entender cómo funciona el sistema de validación actual. Implica leer más de 20 archivos. ¿Cuál es la manera más eficiente en uso de contexto?
- Leer tú mismo los 20 archivos en la conversación principal
- Pedirle a Claude que explique la validación sin leer los archivos
- Abrir una sesión nueva de Claude para la investigación
- Usar un subagente para investigar y devolver un resumen
07 · Emparejar
Empareja cada tipo de subagente con su mejor uso.
(Esta sección es interactiva — activa JavaScript para usarla.)
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.