APREX · EST. 2026
La herramienta para desarrolladores Claude Code de Anthropic ha incorporado una funcionalidad que hace que la programación en pareja tradicional parezca anticuada. En lugar de una sola IA que lo hace todo, ahora puedes ensamblar un equipo completo de agentes especializados: uno que revisa la seguridad, otro que escribe pruebas, otro que asegura que el código sigue la guía de estilo. Trabajan mientras duermes. Y la factura puede ser sorprendente.
¿Qué es exactamente un subagente?
Un subagente en Claude Code no es simplemente un nombre elegante para un chatbot con un mensaje de sistema diferente. Es un asistente autónomo con su propia ventana de contexto, sus propios permisos de herramientas y su propio rol definido, completamente aislado de los demás agentes del flujo de trabajo.
Piénsalo así: un revisor de código no necesita saber nada sobre la discusión de diseño que tuviste hace dos horas. Eso es solo ruido. La separación de contexto es una premisa central de toda la arquitectura, según la documentación oficial de Anthropic.
Los subagentes se definen como archivos Markdown con frontmatter YAML dentro de la carpeta .claude/agents/ de tu proyecto. Allí estableces el nombre, la descripción, las herramientas a las que tiene acceso el agente y lo que debe hacer exactamente.
Comparativa de los principales tipos de agentes
| Tipo | Arquitectura | Coordinación | Estabilidad | Costo |
|---|---|---|---|---|
| Subagentes | Jerarquía padre-hijo | Sesión única | Estable | ~7x tokens |
| Agent Teams | Peer-to-peer | Sesiones independientes | Experimental | Mayor |
| Integrado: Explore | Búsqueda de solo lectura | Modelo Haiku | Estable | Bajo |
| Integrado: Plan | Orientado a investigación | Sesión única | Estable | Medio |
| Integrado: General | Acceso completo | Sesión única | Estable | Medio/Alto |
Los tres agentes integrados
Claude Code incluye tres subagentes listos para usar desde el principio, según la documentación de Anthropic:
Explore está diseñado para búsquedas rápidas en la base de código y utiliza el modelo Haiku para mantener la velocidad. Solo tiene acceso de lectura: no puede modificar nada.
Plan es un agente de investigación que te ayuda a estructurar el trabajo antes de comenzar la implementación.
General-purpose es el más potente de los tres, con acceso completo a herramientas y soporte para tareas complejas de múltiples pasos.
> "Los subagentes deben ser aburridos y específicos. No construyas una vaga persona de 'ingeniero senior': construye un 'revisor de código que solo analiza seguridad en Python'."
> — Buenas prácticas de la documentación de Anthropic
Agent Teams: el gran experimento
En febrero de 2026, Anthropic lanzó lo que probablemente sea la funcionalidad más ambiciosa de Claude Code hasta la fecha: Agent Teams, disponible como versión preliminar de investigación para Opus 4.6 y versiones posteriores (versión 2.1.32, lanzada el 5 de febrero de 2026).
Mientras que los subagentes siguen una jerarquía padre-hijo dentro de una única sesión, Agent Teams operan como pares en sesiones independientes. Se comunican a través de un sistema de mensajería integrado, algo parecido a un sistema de correo interno entre instancias de IA, y pueden coordinar trabajo en paralelo sin pasar por un proceso principal.
Sitepoint y nxcode.io describen la arquitectura como una red peer-to-peer donde cada mensaje entre agentes constituye una solicitud de API independiente. Eso significa que los costos de coordinación aumentan rápidamente.
KEYFIGURE
| Métrica clave | Valor |
|---|---|
| Consumo de tokens en flujos de trabajo intensivos | ~7x más que sesión de un solo hilo |
| Cobertura interna de revisión de código en Anthropic, antes | 16% |
| Cobertura interna de revisión de código en Anthropic, después | 54% |
| Plugins de Claude Code a febrero de 2026 | 9.000+ |
Claude Code Review: la prueba en los números
El 9 de marzo de 2026, Anthropic lanzó Claude Code Review, un sistema multi-agente para el análisis automatizado de pull requests. Según lushbinary.com, la cobertura interna de revisión de código de Anthropic saltó del 16% al 54% tras implementar el sistema internamente.
El sistema utiliza cinco agentes especializados:
- Correctness Agent busca errores de lógica
- Security Agent detecta vulnerabilidades
- Performance Agent evalúa el rendimiento
- Style & Consistency Agent verifica el cumplimiento de la guía de estilo
- Test Coverage Agent evalúa la cobertura de pruebas
Ninguno de ellos necesita saber lo que encontraron los demás. Ese es el punto.
Hooks y Skills: automatización bajo el capó
La arquitectura de subagentes se vuelve aún más potente cuando se combina con dos funciones adicionales: Hooks y Skills.
Hooks son automatizaciones basadas en eventos que se pueden activar en cinco momentos del flujo de trabajo: PreToolUse, PostToolUse, Notification, UserPromptSubmit y Stop. Un ejemplo práctico de la documentación oficial de hooks de Anthropic: un hook puede bloquear automáticamente los intentos de hacer force-push a la rama principal, o ejecutar un formateador en los archivos justo después de ser modificados.
Skills se definen en archivos SKILL.md con frontmatter YAML y se activan automáticamente según el contexto. A febrero de 2026, hay más de 9.000 plugins en el ecosistema de Claude Code, según developersdigest.tech.
FACTBOX: Cómo se configuran los permisos
El principio es el mínimo privilegio:
- Agente de documentación: Lectura + Edición de archivos Markdown. Nada más.
- Agente de despliegue: Acceso a shell. Sin acceso a secretos.
- Agente de seguridad: Leer código, reportar hallazgos. No puede modificar nada.
Los permisos se configuran en el frontmatter YAML del archivo del agente. La configuración incorrecta de permisos es uno de los errores más comunes entre los nuevos usuarios, según nimbalyst.com.
Agent View: el centro de control para sesiones en segundo plano
Con el comando claude agents, accedes a Agent View, un centro de control donde puedes monitorear y gestionar todas las sesiones activas en segundo plano. Las sesiones sobreviven al cierre del terminal, lo que significa que los agentes pueden seguir trabajando mientras haces otra cosa.
Esto es especialmente útil para tareas de larga duración, como la refactorización de grandes bases de código o la revisión de muchos pull requests en paralelo.
¿Cuánto te costará?
Aquí viene la verdad incómoda. Según nimbalyst.com, los flujos de trabajo con uso intensivo de subagentes consumen aproximadamente siete veces más tokens que una sesión estándar de un solo hilo. Agent Teams cuesta aún más, ya que cada mensaje entre agentes constituye una solicitud de API independiente.
Cloudzero, la primera plataforma de costos con integración en la API de administración de uso y costos de Anthropic, advierte que los costos de tokens pueden escalar sorprendentemente rápido en configuraciones multi-agente.
Consenso de expertos: la mayoría de las tareas no necesitan cinco agentes. Comienza con uno y añade otro solo cuando aporte valor real.
Errores que debes evitar
Basándonos en la documentación combinada de Anthropic, nimbalyst.com y developersdigest.tech, estos son los errores más comunes:
BOTTOM LINE
Los subagentes de Claude Code son una herramienta genuinamente poderosa para equipos de desarrollo que quieren automatizar controles de calidad repetitivos, paralelizar revisiones de pull requests y mantener el contexto limpio. Los números del uso interno de Anthropic, del 16% al 54% de cobertura de revisión de código, son impresionantes. Pero la arquitectura exige disciplina: mantén los agentes específicos, los permisos mínimos y vigila los costos de tokens. Agent Teams es prometedor, pero sigue siendo experimental. Úsalo por lo que es: una vista previa, no una solución lista para producción.
Verificado contra 7 fuentes primarias abiertas.