Subagentes y equipos de agentes en Claude Code: qué son y cuándo usar cada uno

Respuesta corta: un subagente es un asistente al que Claude Code llama para hacer una parte del trabajo en un contexto separado y devolver solo el resultado. Un equipo de agentes reúne varias sesiones completas de Claude Code que trabajan al mismo tiempo y se envían mensajes. A continuación, cómo funciona cada uno, cuánto cuesta y cuándo conviene usarlo.

Quien usa Claude Code para algo más que programar, en investigación, redacción, análisis de campañas o revisión de marca, pronto se encuentra con dos términos en la documentación de Anthropic: subagentes y equipos de agentes, llamados agent teams. Los dos reparten el trabajo entre varias instancias de IA y por eso parecen lo mismo. Resuelven problemas distintos y cuestan distinto.

En Headcore usamos subagentes todos los días. Nuestra operación de marca funciona hoy con 17 de ellos, organizados en seis plugins, desde el diagnóstico de marca hasta el análisis de medios. Esta guía explica los dos recursos a partir de la documentación oficial de Claude Code, consultada en octubre de 2026, y de lo que aprendimos al armar esos agentes.

Si la idea de agente todavía es nueva para ti, conviene empezar por nuestro texto sobre IA agéntica y agentes de IA.

Qué es un subagente

Un subagente es un asistente especializado al que Claude Code llama para hacer una parte del trabajo. Tiene instrucciones propias, una lista propia de herramientas que puede usar y una ventana de contexto separada de la conversación principal. Ese último punto es la razón de que exista.

La ventana de contexto es todo lo que el modelo tiene en cuenta a la vez: la conversación, los archivos leídos, los resultados de búsqueda. Tiene un límite, y cuanto más llena está, más se distrae el modelo con lo que ya no importa. Como mostramos en cómo usar IA en marca, buena parte de la calidad de la respuesta depende de lo que hay en esa ventana.

Un ejemplo: le pides a Claude Code que lea 40 informes de campaña. Si la conversación principal lee los 40, termina llena de números que no va a volver a usar. Con un subagente, la lectura ocurre en otro contexto, y la conversación principal recibe solo la conclusión, en pocas líneas.

Qué recibe el subagente y qué devuelve

Dos detalles explican la mayoría de los tropiezos al empezar. El subagente no ve tu conversación. Recibe el pedido que Claude escribe al llamarlo, las instrucciones de su propio archivo y el contexto del proyecto. Si una decisión se tomó diez mensajes atrás, tiene que estar escrita en el pedido, o el subagente trabajará sin ella.

De vuelta, solo llega el resultado final. Las búsquedas, lecturas e intentos quedan en el contexto del subagente. Eso ahorra espacio en la conversación principal, que pasa a confiar en el resumen. Cuando el resumen viene mal, el camino que llevó al error no aparece en la conversación, y solo quien abre el registro del subagente puede ver dónde se perdió.

Normalmente, los subagentes que crea la conversación principal funcionan en segundo plano. Sigues trabajando mientras leen y buscan, y el resultado llega como una notificación cuando terminan. Las investigaciones independientes pueden correr en paralelo, cada una en su propio subagente.

Cómo crear un subagente

Un subagente es un archivo de texto en Markdown, con un encabezado de configuración y las instrucciones justo debajo. Claude Code busca estos archivos en la carpeta .claude/agents/ del proyecto, para agentes que solo tienen sentido ahí, y en ~/.claude/agents/, para los que quieres en todos tus proyectos. Los plugins también pueden traer los suyos.

Solo dos campos son obligatorios, name y description. Un ejemplo pensado para quien se ocupa del contenido:

---
name: revisor-de-voz
description: Revisa textos de blog, pies de foto y correos según la guía de voz de la marca. Úsalo antes de publicar cualquier texto.
tools: Read, Grep, Glob
model: sonnet
---

Revisas textos de la marca. Lee la guía de voz en docs/voz.md antes de empezar.
Señala cada fragmento que se aparta de la guía, di qué regla rompe y propón
una versión nueva de ese fragmento. No reescribas el texto entero ni modifiques archivos.

El campo que más pesa es description. Claude lee esa frase para decidir si conviene delegar y a quién. Una descripción vaga, como “ayuda con textos”, hace que el agente se llame en el momento equivocado, o nunca. La que funciona dice qué hace el agente y en qué momento debe entrar.

El campo tools limita las herramientas. En el ejemplo, el revisor solo lee y busca, así que no puede editar un archivo por error. El campo model elige el modelo, y las tareas simples pueden ir a uno más barato. Un cuidado: Claude Code ignora sin aviso un campo mal escrito, así que conviene revisar la ortografía letra por letra.

Para usarlo, basta con pedirlo en lenguaje común (“usa el revisor-de-voz en este post”) o mencionar al agente con @. Claude también llama al subagente por su cuenta cuando la tarea coincide con la descripción. Si prefieres no escribir el archivo, puedes pedirle a Claude Code que lo cree.

Claude Code ya trae algunos subagentes listos. Explore solo lee y sirve para buscar en muchos archivos sin gastar el contexto principal. Plan se usa en el modo de planificación, para reunir información antes de proponer un plan. También hay uno de uso general, para tareas que exigen leer y actuar.

Qué son los equipos de agentes

Los equipos de agentes llevan la idea más lejos. En lugar de un ayudante que hace la tarea y devuelve el resultado, tienes varias sesiones completas de Claude Code trabajando al mismo tiempo. Una de ellas es la líder, que divide el trabajo, reparte las tareas y junta lo que vuelve. Las demás son las compañeras de equipo.

Lo que cambia es la comunicación. Los subagentes solo hablan con quien los llamó. En un equipo, las compañeras se envían mensajes directamente y trabajan sobre una lista de tareas compartida, en la que cada una toma la siguiente tarea libre cuando termina la suya. También puedes hablar con cualquier compañera sin pasar por la líder.

El recurso todavía es experimental y viene desactivado. Para activarlo, define la variable CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS con el valor 1, en el entorno del terminal o en el archivo settings.json. Después, describe la tarea y pide el equipo en lenguaje común. Las compañeras aparecen en un panel debajo del campo de texto, y puedes abrir cada una.

Un pedido que funciona bien, adaptado de un ejemplo de la propia documentación a un caso de marketing: “Crea un equipo de tres compañeras para revisar esta landing page. Una mira la claridad de la oferta, otra mira el SEO y la tercera hace de cliente desconfiado. Pídeles que lo discutan entre ellas antes de darme la conclusión.”

Subagentes o equipo de agentes: cuál es la diferencia

Fuente: documentación de Claude Code, octubre de 2026.

Una forma rápida de decidir: si los agentes no necesitan hablar entre sí, usa subagentes. Si tienen que discutir, cuestionar el hallazgo del otro o repartir un trabajo grande con dependencias entre las partes, el equipo empieza a compensar el costo.

Cuándo vale la pena usarlos, y cuándo no

Los dos recursos gastan más tokens que una conversación única. Cada subagente consume tokens mientras trabaja, y ese consumo cuenta en el mismo límite de uso que la conversación principal. En un equipo, el gasto crece con el número de compañeras. Para corregir un texto, ajustar una página o resolver una duda, un solo agente lo hace más rápido y por menos.

Los subagentes compensan cuando la tarea genera mucho material intermedio y poco resultado, como leer decenas de archivos, recorrer una carpeta o revisar una lista de URL. También compensan cuando quieres que la misma tarea se haga siempre igual, con las mismas reglas y las mismas herramientas.

Para equipos, la documentación recomienda empezar con tres a cinco compañeras y observa que tres enfocadas suelen rendir más que cinco dispersas. También sugiere empezar por investigación y revisión, que no exigen editar archivos. Dos compañeras editando el mismo archivo se sobrescriben el trabajo.

Las limitaciones conocidas piden que alguien esté atento. Cada sesión admite un solo equipo, y las compañeras no pueden armar equipos propios. Al retomar una sesión, las compañeras no vuelven con ella. El estado de las tareas a veces se atrasa, y la líder puede dar el trabajo por terminado antes de tiempo.

Cómo usamos subagentes en Headcore

Nuestra operación de marca funciona con Growth System™, el conjunto de seis plugins de Claude Code que armamos, con 17 subagentes en total. Cada plugin se ocupa de una etapa: construir el Brand Brain de la marca, escribir y componer piezas, diseñar páginas, producir video, analizar medios y evaluar el trabajo antes de la entrega. El Brand Brain guarda posicionamiento, voz, reglas visuales y decisiones, y los agentes leen de ahí antes de producir.

Tres decisiones de diseño ayudaron más de lo que esperábamos. La primera fue darle a cada agente una sola pregunta. El redactor escribe y no decide formato ni visual. El director de arte define el tratamiento de la pieza y no la ejecuta. Con una función por agente, la descripción queda clara y Claude acierta a quién delegar.

La segunda fue usar el contexto separado a favor del análisis. En el plugin de medios, el analista y la verificación corren en paralelo. El analista dice qué cambió en los números y por qué; la verificación confirma si la operación hizo lo que la estrategia preveía. Como ninguno lee el informe del otro, ninguno arrastra al otro hacia su propia conclusión.

La tercera fue limitar herramientas. Los agentes que solo analizan tienen acceso de lectura, sin permiso para editar archivos, lo que elimina toda una clase de accidentes. El revisor del ejemplo sigue la misma lógica y revisa textos con reglas como las de nuestro mapa de patrones de texto de IA.

También nos equivocamos. A veces un agente responde de memoria cuando debía consultar la fuente. Por eso ninguna pieza sale sin revisión humana, y cada regla nueva va al Brand Brain, para que el mismo error no vuelva con la marca siguiente. Todavía no medimos cuánto tiempo ahorra este diseño, y esa cuenta sigue abierta.

Por dónde empezar

Empieza con un subagente para una tarea que repites cada semana y que exige mucha lectura: revisar textos según la guía de voz, comprobar los enlaces de una página, resumir informes. Escribe la descripción pensando en el momento en que debe llamarse, déjale solo las herramientas que necesita y pruébalo en un caso real antes de confiar en él.

Con dos o tres subagentes funcionando, vale la pena probar un equipo en un trabajo de revisión, con tres compañeras mirando la misma pieza desde ángulos distintos. Sigue lo que hace cada una y detente cuando tu propia revisión se convierta en el cuello de botella. Si todo lo que entrega el equipo hay que rehacerlo, revisa las instrucciones antes de pensar en más agentes.

La serie completa

Este texto es parte de una serie de cinco sobre agentes de IA aplicados a la marca:

1. Subagentes y equipos de agentes en Claude Code (este texto)
2. Skills y plugins en Claude Code
3. CLAUDE.md y Brand Brain: memoria de marca para la IA
4. Cómo revisar contenido generado por IA
5. Cómo usamos la IA en la operación de Headcore

Preguntas frecuentes

Fuentes: documentación de Claude Code sobre subagentes y sobre equipos de agentes, consultadas el 21/10/2026.