APREX · EST. 2026
Tienes una sola instancia de Claude. Se supone que debe entender tu código, verificar la seguridad, escribir pruebas, actualizar la documentación y revisar pull requests — todo a la vez. Eso no es un colega de IA inteligente. Es una persona sobrecargada con demasiados sombreros y poco café.
Los subagentes de Claude Code son la respuesta a ese problema.
¿Qué es exactamente un subagente?
Un subagente no es un programa separado ni un nivel de suscripción distinto. Es una instancia de Claude con un rol específico, definida en un simple archivo Markdown con frontmatter YAML. Los archivos se guardan en la carpeta .claude/agents/ de tu proyecto, y Claude Code los carga automáticamente.
Según la documentación oficial de Anthropic (docs.anthropic.com), cada subagente tiene su propia ventana de contexto. Eso significa que tu revisor de código no necesita saber nada sobre la exploración de diseño que hiciste ayer — menos ruido, análisis más preciso.
> HIGHLIGHT
> La separación de contexto no es solo un detalle técnico. Es la razón por la que un agente de seguridad dedicado encuentra vulnerabilidades que un asistente general pasa por alto — no se pierde en el bosque de información no relacionada.
Los subagentes integrados
Claude Code viene con tres subagentes integrados que puedes usar sin ninguna configuración:
| Subagente | Modelo | Acceso | Caso de uso |
|---|---|---|---|
| Explore | Claude Haiku | Solo lectura | Búsqueda y navegación rápida del código |
| Plan | Claude (completo) | Lectura + análisis | Investigación y planificación |
| General-purpose | Claude (completo) | Acceso completo a herramientas | Tareas complejas de múltiples pasos |
Explore usa Haiku por velocidad — el modelo adecuado para búsquedas rápidas. Plan es tu agente de investigación. General-purpose es el comodín con acceso completo a herramientas.
Cómo definir tu propio subagente
Un subagente personalizado no es más complejo que esto:
`markdown
name: security-checker
description: Analiza el código en busca de vulnerabilidades de seguridad
tools: [read, search]
model: claude-opus-4
Eres un auditor de seguridad. Buscas inyección SQL,
puntos de acceso no autenticados y secretos hardcodeados.
Informa los hallazgos con nivel de gravedad y número de línea.
`
Tu agente de documentación solo necesita Read y Edit en archivos Markdown. Tu agente de despliegue necesita acceso al shell, pero absolutamente no acceso a los secretos. El control de permisos a este nivel no es paranoia — es sentido común.
Según Nimbalyst (nimbalyst.com), la mejor práctica es mantener los subagentes "aburridos y específicos": code-reviewer, test-runner, frontend-qa, docs-maintainer, security-checker, migration-planner. No personas vagas de "ingeniero senior" que hacen todo y nada.
> PULLQUOTE
> «Los subagentes aburridos y específicos superan a los creativos y vagos en todo momento. Un agente que sabe exactamente qué hacer, lo hace mejor.»
Agent Teams: El siguiente nivel
Los subagentes siguen una jerarquía padre-hijo: una sesión principal llama a sus especialistas. Agent Teams es algo completamente diferente.
Lanzado en vista previa de investigación en febrero de 2026 (versión 2.1.32, Opus 4.6+), Agent Teams permite que múltiples instancias independientes de Claude trabajen en paralelo y se envíen mensajes a través de un sistema de buzón. Entre pares, no jerárquico.
> KEYFIGURE
> - 9.000+ plugins de Claude Code disponibles a partir de febrero de 2026
> - 7x más tokens utilizados en flujos de trabajo con muchos subagentes frente a una sesión de un solo hilo
> - V2.1.32 — la versión que introdujo Agent Teams (2026-02-05)
Ejemplo práctico: un agente escribe código frontend, otro escribe pruebas de backend, un tercero verifica el contrato de API — todo simultáneamente, con mensajes yendo y viniendo. Según Sitepoint (sitepoint.com), esto sigue siendo experimental y no se garantiza la estabilidad.
Claude Code Review: Prueba en la práctica
La evidencia más concreta de que el enfoque multiagente realmente funciona llegó el 9 de marzo de 2026: Anthropic lanzó Claude Code Review, un sistema de análisis multiagente de PR con cinco agentes dedicados:
- Correctness Agent — errores lógicos y bugs
- Security Agent — vulnerabilidades y secretos expuestos
- Performance Agent — cuellos de botella y código ineficiente
- Style & Consistency Agent — estilo de código y convenciones
- Test Coverage Agent — pruebas faltantes y casos límite
El resultado, según Lushbinary (lushbinary.com): la cobertura interna de revisión de código de Anthropic saltó del 16 por ciento al 54 por ciento. No es una mejora marginal. Es una transformación.
Hooks: Automatización con válvula de seguridad
Los hooks son automatización basada en eventos que se ejecuta alrededor de las acciones del agente. Cinco tipos:
- PreToolUse — se ejecuta antes de usar una herramienta (puede bloquear la acción)
- PostToolUse — se ejecuta después de usar una herramienta
- Notification — alertas sobre eventos importantes
- UserPromptSubmit — se ejecuta cuando envías un prompt
- Stop — se ejecuta cuando un agente termina
Un hook PreToolUse puede bloquear un force-push a main. Un hook PostToolUse puede formatear automáticamente los archivos después de editarlos. Según la documentación de hooks de Anthropic (code.claude.com), esta es la válvula de seguridad que impide que los agentes cometan errores irreversibles.
> CAJA DE DATOS: Cómo se activan las Skills automáticamente
> Las Skills son paquetes de instrucciones reutilizables almacenados como archivos SKILL.md con frontmatter YAML. Claude Code lee el contexto y activa la skill correcta automáticamente — sin que necesites pedirlo explícitamente. Con más de 9.000 plugins disponibles en el ecosistema de Claude Code, es muy probable que alguien ya haya construido lo que necesitas.
Agent View y supervivencia al cierre del terminal
Agent View es el centro de control para tus sesiones en segundo plano. El comando claude agents muestra todos los agentes activos y pendientes. Lo más importante: las sesiones sobreviven si cierras el terminal. Tus agentes siguen trabajando mientras tú almuerzas.
Errores que debes evitar
Los subagentes no son gratuitos — ni cognitivamente ni económicamente. CloudZero, la primera plataforma de costos con integración de la API Anthropic Usage and Cost Admin, advierte que los flujos de trabajo con muchos subagentes pueden usar hasta siete veces más tokens que una sesión estándar (cloudzero.com). Agent Teams es aún más caro, ya que cada mensaje entre agentes es un round trip completo.
Los errores comunes son conocidos:
CONCLUSIÓN
Los subagentes de Claude Code no son magia — son división disciplinada del trabajo. Un agente específico con contexto limitado y permisos precisos hace su trabajo mejor que un asistente general con demasiada responsabilidad. La prueba está ahí: del 16 al 54 por ciento de cobertura de revisión de código en la propia Anthropic. Empieza con los agentes integrados, mantenlos aburridos y específicos, y permanece atento a los costos de tokens. Agent Teams es prometedor — pero sigue siendo experimental.
Verificado contra 5 fuentes primarias abiertas y 5 análisis independientes.