Una guía práctica sobre subagentes en Claude Code

Si eres desarrollador, probablemente hayas oído hablar de los agentes de IA y los sistemas multiagente. Es difícil no enterarse. La idea de una IA que no solo escribe código, sino que también puede gestionar, delegar y especializar tareas parece un gran paso adelante. En Claude Code, este concepto cobra vida con los subagentes, una función que te permite dividir problemas grandes y complejos en trozos más pequeños para que una IA los maneje.

Pero, ¿son realmente la solución a todos nuestros problemas de programación? Esta guía te ofrecerá una visión directa y honesta de qué son realmente los subagentes en Claude Code, cómo funcionan, dónde se quedan cortos en el mundo real y cómo las ideas que los respaldan pueden aplicarse a otras áreas de tu negocio, como el soporte al cliente.

¿Qué son los subagentes en Claude Code?

Básicamente, los subagentes son asistentes de IA especializados e independientes que puedes crear dentro de Claude Code para abordar trabajos específicos. En lugar de tener una sola IA intentando hacerlo todo, puedes reunir un equipo de especialistas.

Una ilustración del asistente Claude Code integrado en el IDE de VS Code, donde los desarrolladores pueden gestionar subagentes para tareas especializadas.

Tienen algunas características distintivas que los diferencian:

• Trabajan en su propia burbuja. Cada subagente tiene su propia ventana de contexto separada. Esto es genial porque mantiene tu conversación principal limpia y centrada en el panorama general, para que no te veas abrumado por los detalles de cada subtarea.

• Puedes darles instrucciones personalizadas. Puedes escribir un prompt de sistema único para cada subagente, definiendo su personalidad, su trabajo y sus órdenes. Por ejemplo, podrías crear un subagente "revisor de código" que sea súper meticuloso y siga una lista de verificación estricta, o un "depurador" que sea un sabueso para cazar errores.

• Tú controlas su acceso a herramientas. Tú decides qué herramientas puede usar cada subagente. ¿Necesitas un agente que pueda revisar código pero no tocar ningún archivo? Puedes limitar sus permisos, lo que añade una buena capa de seguridad y evita que el agente se distraiga.

Configuras estos agentes especialistas en sencillos archivos Markdown, lo que significa que puedes guardarlos en el control de versiones y compartirlos con tu equipo. Claude puede entonces delegarles tareas por su cuenta, o tú puedes indicarle el subagente adecuado para un trabajo en particular.

La promesa de los subagentes en Claude Code: por qué interesan a los desarrolladores

¿A qué se debe tanto entusiasmo? Se trata de pasar de un único asistente de IA que lo hace todo a un equipo coordinado de especialistas. Como dijo un desarrollador, es como si estuvieras construyendo tu propio pequeño "equipo de desarrollo Agile" de agentes.

Aquí están las principales razones por las que la gente se está subiendo al carro.

Obtener mejores resultados a través de la especialización

Una IA de propósito general es aceptable en muchas cosas, pero un especialista es un experto en una sola cosa. Cuando creas un subagente para un rol específico, puedes cargarlo con instrucciones hiperdetalladas que una IA generalista podría pasar por alto u olvidar.

Por ejemplo, al agente "revisor de código" del ejemplo en la documentación oficial se le da una lista de verificación muy específica. Se le indica que busque cosas como código duplicado, manejo adecuado de errores y claves de API expuestas. Ese nivel de detalle casi siempre te da un resultado de mayor calidad que simplemente preguntar: "Oye, ¿puedes echarle un vistazo a este código?".

Una forma inteligente de gestionar el contexto

Cualquiera que haya pasado tiempo con los LLM conoce la frustración de alcanzar el límite de la ventana de contexto. Los subagentes ofrecen una solución bastante ingeniosa. Como señaló un usuario en Hacker News, son perfectos para tareas que consumen una gran cantidad de tokens.

Digamos que necesitas ponerte al día con una nueva biblioteca. Puedes enviar un subagente para que haga el trabajo pesado; puede leer páginas de documentación, usando miles de tokens en su propio contexto aislado. Cuando termina, simplemente informa con un resumen rápido. Tu agente principal obtiene la respuesta que necesita, pero su propia ventana de contexto no se llena con todo ese material de investigación.

Abordar tareas en paralelo

Algunos trabajos simplemente se hacen más rápido cuando puedes hacerlos al mismo tiempo. Puedes ejecutar subagentes en paralelo, lo cual es ideal para cosas como explorar una gran base de código por primera vez. Podrías tener un subagente analizando el frontend, otro investigando las API del backend y un tercero revisando el esquema de la base de datos, todo a la vez. Esta estrategia de "divide y vencerás" puede acelerar realmente la fase inicial de descubrimiento de un proyecto.

La realidad: dónde los subagentes en Claude Code pueden complicarse

Aunque el potencial de los subagentes es bastante emocionante, las cosas no siempre son tan fluidas en la práctica. A medida que más desarrolladores han ido probándolos, han comenzado a surgir algunos quebraderos de cabeza comunes. Es bueno conocerlos antes de lanzarse de lleno.

El problema del traspaso: cuando los agentes lo olvidan todo

Esta es, con diferencia, la queja más grande. Cuando se traspasa una tarea, el subagente empieza desde cero. No sabe lo que tu agente principal sabe sobre el proyecto. Si el agente principal no proporciona un resumen perfectamente detallado, el subagente está prácticamente a ciegas.

Esto lleva a lo que muchos llaman "amnesia de contexto". El subagente no tiene el conocimiento crucial del proyecto, por lo que puede desviarse fácilmente y ofrecer soluciones genéricas o simplemente incorrectas. Esto es una pesadilla particular en bases de código existentes y complejas (proyectos "brownfield") y es una de las principales razones por las que los subagentes parecen funcionar mejor en proyectos nuevos o en tareas muy autocontenidas.

Por qué los subagentes en Claude Code pueden ser sorprendentemente lentos

Uno pensaría que delegar aceleraría las cosas, pero muchos usuarios dicen que es todo lo contrario.

Un desarrollador en Reddit mencionó que los subagentes pueden ser "MUCHO MÁS LENTOS" que trabajar con un solo agente. La razón es que cada vez que llamas a un subagente, este tiene que construir su comprensión de la tarea desde cero, y eso consume tiempo y poder de procesamiento.

Gestionar subagentes en Claude Code requiere mucho trabajo

Administrar un equipo de agentes de IA no es exactamente algo que puedas "configurar y olvidar". Requiere bastante trabajo inicial escribir prompts detallados, definir roles y establecer permisos. Rápidamente puede empezar a sentirse menos como si tuvieras un equipo autónomo y más como si estuvieras microgestionando a un grupo de desarrolladores junior muy literales. Esto ha iniciado un debate en la comunidad: ¿es mejor crear agentes "basados en roles" (como un ‘desarrollador de backend’) o agentes "basados en tareas" (como un ‘escritor de endpoints de API’)? Hasta ahora, parece que los agentes definidos de manera estricta y específica para una tarea están demostrando ser más fiables.

El coste de los subagentes en Claude Code puede acumularse

También vale la pena recordar que ejecutar múltiples agentes, cada uno con su propio contexto, puede consumir tokens rápidamente. Si estás en un plan donde pagas por uso, orquestar un equipo de subagentes para una tarea grande puede volverse caro antes de que te des cuenta.

Este vídeo ofrece una clase magistral de 10 minutos sobre el uso de subagentes en Claude Code, cubriendo su configuración y aplicación.

Más allá del código: aplicando los conceptos de los subagentes de Claude Code al soporte al cliente

Aquí está la parte interesante: estos no son solo problemas de programación. Los principios fundamentales para construir un equipo de agentes eficaz (especialización, gestión de contexto y traspasos limpios) se aplican en todas partes. Y no hay mejor ejemplo que en el soporte al cliente.

Un único bot de soporte monolítico a menudo falla por la misma razón que un único agente de IA tiene dificultades con una base de código compleja: intenta hacer demasiadas cosas. Una mejor manera es usar un sistema multiagente, que es exactamente lo que los desarrolladores intentan lograr con los subagentes en Claude Code. Como mencionó uno de los miembros de nuestro propio equipo en Reddit, así es como abordamos el problema en eesel AI. En lugar de un solo bot, tenemos un especialista en "triaje" que enruta los tickets, un experto en "base de conocimientos" que responde preguntas comunes y un agente de "API" que puede buscar el estado de un pedido.

Un diagrama de flujo de trabajo que ilustra cómo un especialista en triaje de IA enruta los tickets de soporte al cliente al agente especializado apropiado.

Aquí es donde una plataforma dedicada puede resolver las mismas limitaciones con las que los desarrolladores se están topando.

• Solucionar la amnesia de contexto: En lugar de luchar con traspasos de contexto manuales, una plataforma como eesel AI conecta todas tus fuentes de conocimiento desde el principio. Aprende instantáneamente de tickets pasados, tu wiki de Confluence y tus documentos de Google, dando a cada agente especializado todo el contexto que necesita para resolver realmente un problema.

• Evitar la complejidad: Construir estos sistemas desde cero en Claude Code es un proyecto de ingeniería serio. eesel AI te ofrece esta configuración multiagente lista para usar. Nuestra plataforma de autoservicio significa que puedes empezar a funcionar en minutos, no en meses, conectándote a tu mesa de ayuda como Zendesk o Freshdesk con solo un clic.

• Probar sin conjeturas: Mientras que depurar subagentes puede parecer que estás trabajando a oscuras, el modo de simulación de eesel AI te permite probar toda tu configuración en miles de tus propios tickets históricos. Puedes ver exactamente cómo se desempeñará tu equipo de IA y obtener un pronóstico sólido de tu tasa de resolución antes de que hable con un cliente real.

El modo de simulación de eesel AI, que permite a los usuarios probar su equipo de soporte de IA con datos históricos antes de su implementación.

Precios de Claude Code

Para usar subagentes, primero necesitarás acceso a Claude Code, que viene con los planes de pago de Anthropic. La versión gratuita está bien para chatear, pero no tiene las funciones más avanzadas para desarrolladores.

Aquí tienes un vistazo rápido a los planes que incluyen Claude Code:

Plan	Precio (Mensual)	Características Clave para Desarrolladores
Gratis	0 $	Chat básico y creación de contenido. No incluye Claude Code.
Pro	20 $	Todo lo de Gratis, más acceso a más modelos, contexto extendido e incluye Claude Code.
Max	Desde 100 $	Todo lo de Pro, más 5-20 veces más uso, acceso prioritario e incluye Claude Code.

¿Merecen la pena los subagentes en Claude Code?

Los subagentes en Claude Code son una característica genuinamente interesante y poderosa para cualquier desarrollador que quiera ver lo que es posible con el desarrollo asistido por IA. Ofrecen un vistazo a un futuro en el que dirigimos equipos de agentes de IA especializados para construir software complejo.

Pero vienen con una gran contrapartida. El poder que obtienes de la especialización se ve contrarrestado por los dolores de cabeza de la amnesia de contexto, los retrasos en el rendimiento y el mero esfuerzo que se necesita para gestionarlos bien. Para los desarrolladores a la vanguardia de la creación de flujos de trabajo agénticos, son una herramienta esencial. Pero para las empresas que solo quieren aplicar estos principios inteligentes para resolver problemas del mundo real como el soporte al cliente, hay una forma mucho más fácil.

Construye tu propio equipo de soporte de IA, sin necesidad de programar

Has visto el poder y el sufrimiento de construir sistemas multiagente. Si quieres los beneficios de un equipo de IA especializado para tu soporte al cliente, sin la sobrecarga de ingeniería, echa un vistazo a eesel AI. Nuestros bots preconstruidos de Triaje, Copiloto y Agente están listos para empezar a automatizar tus flujos de trabajo en minutos.

Comienza tu prueba gratuita en eesel.ai