Los subagentes son una de las funciones mas poderosas de Claude Code. Te permiten delegar tareas a agentes especializados que corren en paralelo, protegiendo tu contexto principal y multiplicando tu velocidad.
Que es un subagente
Un subagente es un agente de Claude que se lanza desde el agente principal para ejecutar una tarea concreta. Recibe una descripcion detallada, opera con su propio contexto, y devuelve un resultado. El agente principal no se contamina con los detalles de la investigacion o el trabajo del subagente.
Cuando usar subagentes
- Investigaciones amplias: "busca todos los usos de esta funcion en el codebase" — un Explore hace el trabajo pesado sin llenar tu contexto de resultados.
- Tareas paralelas: revisar 3 archivos independientes al mismo tiempo.
- Segundas opiniones: pedir a un code-reviewer que valide una decision de forma independiente.
- Trabajo largo: dejar corriendo una tarea de 10 minutos mientras sigues con otra cosa.
Subagentes que vienen incluidos
- general-purpose: el catch-all para tareas que no encajan en otros.
- Explore: agente rapido de solo lectura para buscar codigo y responder "donde esta X".
- Plan: arquitecto de software que diseña planes de implementacion.
- code-reviewer: revisa cambios y devuelve findings estructurados.
- statusline-setup: configuracion de la barra de estado.
Como invocar un subagente
En Claude Code, el agente principal decide cuando delegar. Puedes pedirlo explicitamente:
"Lanza un subagente Explore para encontrar todos los archivos que usan la libreria X mientras nosotros seguimos con el refactor de Y".
Y el agente principal ejecuta el subagente en paralelo, retomando la conversacion contigo.
Como crear un subagente propio
Los subagentes viven en .claude/agents/*.md con este formato:
---
name: revisor-copy
description: Especialista en revisar copy de marketing.
model: sonnet
tools: [Read, Grep, Write]
---
# Instrucciones
Eres un revisor senior de copy con 10 anos de experiencia...
Buenas practicas
- Descripciones especificas: para que el agente principal sepa cuando invocarte.
- Tools minimos: cada subagente solo con las herramientas que necesita.
- Output estructurado: pide al subagente que devuelva formatos claros, no texto libre.
- No abuses: si la tarea es sencilla, el agente principal la resuelve mas rapido.
Ejemplos de subagentes utiles del ecosistema
- db-migrator: valida migraciones de base de datos antes de aplicarlas.
- security-scanner: revisa un diff en busca de vulnerabilidades OWASP.
- test-writer: genera tests unitarios completos para una funcion dada.
- doc-generator: crea documentacion tecnica desde codigo comentado.
- changelog-updater: actualiza el CHANGELOG con los commits del ultimo release.
Conclusion
Los subagentes convierten Claude Code de asistente a orquestador. Bien usados, cambian tu productividad de "hago cosas con IA" a "coordino agentes que hacen cosas". Empieza creando uno para tu tarea mas repetitiva y expande desde ahi.