Varios agentes compensan en Claude Code cuando las tareas no dependen unas de otras

1El problema

Tienes un trabajo grande, como revisar un repositorio entero, migrar cien ficheros o encontrar un fallo que no sabes de dónde viene. Una sola sesión de Claude Code lo hace pieza a pieza, y por el camino va llenando su ventana de contexto, el espacio de texto que el modelo tiene delante y que tiene un tope. Lo natural es pensar en lanzar varios agentes a la vez, cada uno con su trozo.

Cada trabajador que se lanza es una sesión de Claude entera, con su propio contexto, y lo que gasta sale de la misma cuota que tu sesión principal. V Si las piezas dependen unas de otras o tocan los mismos ficheros, la propia documentación de Claude Code recomienda una sola sesión o subagentes en lugar de un equipo. V Esta guía sirve para saber en cuál de los dos casos estás antes de gastar.

2Qué es repartir el trabajo, y las cinco formas de Claude Code

Partir un trabajo entre varios agentes y coordinar lo que devuelve cada uno es lo que se llama orquestar. Claude Code tiene cinco formas de hacerlo, y se diferencian en cuánto te quedas tú encima y en si el trabajo corre en tu máquina o en la nube. V

• Subagentes. Trabajadores que Claude lanza dentro de tu sesión. Cada uno hace una tarea aparte en su propia ventana y te devuelve un resumen. Claude decide, turno a turno, qué delega. V Los contamos en la guía de subagentes del 7 de octubre.
• Vista de agentes. Una pantalla que se abre con claude agents, desde la que lanzas sesiones que corren en segundo plano y ves de un vistazo cuál te necesita. Aquí coordinas tú. Está en fase de prueba. V
• Equipos de agentes. Una sesión hace de jefa: parte el trabajo, lo asigna a varias sesiones compañeras y junta lo que devuelven. Los compañeros se escriben entre sí y comparten una lista de tareas. Es experimental y viene apagado. V
• Flujos dinámicos. Un programa corto en JavaScript que Claude escribe para tu tarea y que un motor aparte ejecuta en segundo plano, lanzando de decenas a cientos de subagentes. V Se parece a lo que en este sitio llamamos flujo fijo, porque el plan está escrito en código, con dos diferencias: el programa lo escribe Claude para cada tarea, y cada paso es un agente entero y no una llamada suelta al modelo.
• Proyectos. Una conversación larga en claude.ai/code o en la aplicación de escritorio, desde la que Claude abre sesiones en paralelo, en la nube o en tu equipo, para trabajos de días o semanas. Está en beta pública para Pro y Max. V

En las cinco, los trabajadores son sesiones de Claude. V Lo que cambia es dónde se guardan los resultados intermedios. Con subagentes, todo lo que devuelven entra en la ventana de Claude. Un equipo los deja en su lista de tareas compartida. Un flujo dinámico los guarda en las variables de su programa, y a la ventana de Claude solo llega la respuesta final. V

3Cómo se elige: tres preguntas

La documentación propone elegir con tres preguntas. V

• ¿Quién lleva el plan? Si quieres que Claude delegue y recoja dentro de tu conversación, subagentes. Si prefieres repartir tú tareas independientes y volver más tarde, la vista de agentes. Si quieres que Claude planifique, asigne y supervise a un grupo, un equipo. Si quieres que el plan esté escrito y no dependa del criterio de Claude en cada turno, un flujo dinámico. V
• ¿Tienen que hablar entre ellos? Los subagentes devuelven su resultado a quien los lanzó, y las sesiones de la vista de agentes solo te informan a ti. Los compañeros de un equipo se escriben directamente. V Si necesitas que discutan o se rebatan, es un equipo.
• ¿Tocan los mismos ficheros? Entonces hay que separarlos. Los subagentes y las sesiones que lanzas tú pueden trabajar cada uno en un worktree, que es una copia de trabajo de git aparte, con sus propios ficheros. Los equipos no se separan así, y dos compañeros que editan el mismo fichero se sobrescriben: hay que repartir el trabajo para que cada uno sea dueño de ficheros distintos. V

Una cosa más antes de encender los equipos. Se activan poniendo CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS a 1 en tu entorno o en el apartado env de settings.json, y eso cambia también la delegación de siempre: Claude puede poner nombre a un subagente por su cuenta, y con los equipos activados un subagente con nombre arranca como compañero de equipo. V Es decir, puede formarse un equipo sin que lo hayas pedido, con el gasto de un equipo. Actívalos para la tarea que los necesita, no para siempre.

4Tres formas de repartir

Los ejemplos de la documentación caen en tres formas. Los nombres son nuestros, los mismos del bloque 5 del camino al examen.

• En abanico. La misma tarea, un agente por elemento: revisar cada fichero de una carpeta en busca del mismo fallo, o migrar cada componente en su propia copia para que las ediciones no choquen. Al final, un agente junta los resultados, los ordena y quita los repetidos. V Es el caso para el que están hechos los flujos dinámicos.
• Con revisor. Varios agentes independientes trabajan sobre lo mismo y otros intentan rebatir lo que encuentran antes de dártelo. Para un fallo de causa desconocida, la documentación propone que cada compañero de un equipo defienda una hipótesis e intente desmontar las de los demás, porque un solo agente tiende a quedarse con la primera explicación que encaja. V Para revisar un cambio, propone tres revisores con tres miradas distintas: seguridad, rendimiento y pruebas. V
• En cadena. Cada paso usa el resultado del anterior: un comprobador corre, un agente arregla lo que falló y se vuelve a comprobar, hasta que pasa o hasta que dos rondas seguidas no avanzan. V Aquí los agentes no trabajan a la vez. Lo que se gana es que el bucle está escrito y no depende de que tú te acuerdes de repetirlo.

5Cuánto cuesta

Todo sale de la misma cuota. Un flujo dinámico puede gastar bastante más tokens, la unidad en que se mide el texto, que hacer la misma tarea conversando, y cuenta para los límites de tu plan. V Un equipo gasta bastante más que una sola sesión, porque cada compañero tiene su propia ventana, y el gasto crece en línea con el número de compañeros activos. V Con suscripción eso no te llega como factura: te llega como el aviso de que has gastado el límite de la sesión o de la semana antes de lo previsto.

La documentación da cifras de tamaño, y cada una sirve para decidir algo:

• Equipos. Se recomienda empezar con 3 a 5 compañeros y unas 5 o 6 tareas por compañero; con 15 tareas independientes, 3 compañeros son un buen punto de partida. V Cada compañero de más añade gasto y coordinación sin acelerar en la misma proporción. V Si el gasto crece en línea, pasar de 3 a 5 compañeros lo sube cerca de dos tercios, y lo que avanzas sube menos que eso.
• El aviso de los flujos dinámicos. Cuando un flujo programa más de 25 agentes, o cuando prevé gastar más de 1,5 millones de tokens, aparece un aviso de ejecución grande. No para nada: te lleva a /workflows, donde ves lo que gasta cada agente y puedes pararlo tú. V Si lo ves, es el momento de mirar si el trozo que lleva hecho justifica el resto.
• El tamaño por defecto. Claude apunta a menos de 5 agentes con la guía de tamaño small, a menos de 10 con medium y a menos de 50 con large. Por defecto es medium, y small si entras con el plan Pro desde la versión 2.1.271. V Es un consejo para Claude, no un tope. Los topes son 16 agentes a la vez por defecto y 1.000 por ejecución. V Si tu cuota va justa, fija small en /config antes de pedir el primero.
• Si llegas al límite a mitad. Con suscripción, la ejecución se para a esperar el reinicio en lugar de fallar, siempre que se cumplan cuatro cosas: que la sesión sea interactiva y con cuenta de claude.ai, que esté activado el ajuste autoContinueAtUsageLimit, que el límite se reinicie en menos de 24 horas y que no haya esperado ya dos veces. V Un límite semanal puede reiniciarse más tarde, y entonces los agentes que choquen con él fallan. V

Para saber cuánto te cuesta a ti, la documentación aconseja probar primero sobre un trozo pequeño, una carpeta y no el repositorio entero, y mirar el gasto de cada agente en /workflows. Si lo paras, normalmente no pierdes lo que ya se había terminado. V

6Cuándo no conviene

Para tareas en secuencia, ediciones del mismo fichero o trabajo con muchas dependencias, la documentación recomienda una sola sesión o subagentes en lugar de un equipo. Y para tareas rutinarias, una sola sesión sale más a cuenta. V Además de eso, hay cuatro casos en que un equipo da problemas propios:

• Si no vas a mirar mientras corre. Se aconseja revisar cómo van, corregir lo que no funciona e ir juntando lo que sale; dejar un equipo solo demasiado tiempo aumenta el riesgo de trabajo tirado. V
• Si cuentas con retomar la sesión. Con los compañeros en el mismo proceso, /resume y /rewind no los recuperan, y al retomar la jefa puede intentar escribir a compañeros que ya no existen. V Un flujo dinámico, en cambio, se puede reanudar en la misma sesión. V
• Si lo lanzas desde un programa. Con claude -p o el Agent SDK no se crean compañeros de equipo: un subagente con nombre corre como un subagente normal. V
• Si necesitas más de un equipo. Hay uno por sesión, los compañeros no pueden crear su propio equipo y la jefa no se puede cambiar. V

Por dónde empezar. Esto es propuesta nuestra. La documentación aconseja estrenar los equipos con tareas que no escriben código: revisar un cambio, investigar una biblioteca o buscar la causa de un fallo. V Antes de eso, prueba /deep-research, el flujo dinámico que trae Claude Code de serie, con una pregunta pequeña, y mira en /workflows cuánto gasta cada agente. V Si trabajas con Pro, antes tienes que activar los flujos dinámicos en /config. V Así sabes lo que cuesta un reparto en tu cuota antes de montar uno tuyo.

7Pruébalo

8Llévatelo a tu caso

9Fuentes

1. Claude Code — Run agents in parallel · consultado 25-oct-2026
2. Claude Code — Orchestrate teams of Claude Code sessions · consultado 25-oct-2026
3. Claude Code — Orchestrate subagents at scale with dynamic workflows · consultado 25-oct-2026