Dynamic Workflows en Claude Code: cómo orquestar 100+ agentes en paralelo

Claude Code siempre tuvo la capacidad de delegar trabajo a subagentes. Un agente principal, varios subagentes especializados, handoffs entre ellos. Funciona. Lo usamos.

Pero tiene un límite de escala. Con Opus 4.8, Anthropic lanzó algo que rompe ese límite: Dynamic Workflows.

Esta nota es el breakdown técnico: qué son exactamente, cómo funcionan por dentro, en qué se diferencian de los subagentes normales, cómo activarlos desde Claude Code y desde la API, y cuándo tiene sentido usarlos.

El problema que resuelven

Los subagentes normales de Claude Code funcionan así: el agente principal descompone una tarea, delega partes a subagentes, los subagentes reportan de vuelta, y el orquestador consolida.

Funciona bien hasta cierto punto. El cuello de botella aparece cuando la tarea requiere coordinación a escala:

50 archivos que hay que migrar en paralelo
Tests que se tienen que generar para módulos sin cobertura mientras otro agente refactoriza
Análisis de deuda técnica en una codebase de 300k líneas

Un workflow manual de 5-10 agentes ya es complejo de diseñar. Escalar a 50 o 100 agentes coordinados con verificación cruzada no era práctico — tenías que diseñar vos la arquitectura entera, coordinar manualmente los handoffs, y manejar los errores uno por uno.

Dynamic Workflows resuelve exactamente eso.

¿Qué son los Dynamic Workflows?

Un Dynamic Workflow es un sistema donde Claude planifica y ejecuta automáticamente el trabajo distribuido entre múltiples agentes, sin que vos tengas que diseñar la arquitectura de agentes.

Le pedís la tarea. Claude decide cuántos agentes necesita, cómo dividir el trabajo, cómo verificar resultados, cómo manejar errores. Vos ves el progreso y recibís el resultado final.

La diferencia fundamental con subagentes normales: vos no diseñás el sistema multi-agente. Claude lo diseña.

El flujo completo:

Input: le pedís una tarea compleja a Claude Code
Planning: Claude genera el plan de ejecución automáticamente — cuántos agentes, cómo se divide el trabajo, cuál es el criterio de calidad
Spawn: lanza los agentes necesarios en background (pueden ser decenas o cientos)
Ejecución paralela: los agentes trabajan simultáneamente con sus propios contextos independientes
Verificación cruzada: los outputs se validan antes de consolidar — un agente puede revisar el trabajo de otro
Reporte: Claude te informa cuando termina con el resultado consolidado

Vos seguís trabajando mientras esto sucede. Los workflows corren completamente en background.

El motor detrás: el parámetro effort

Para entender Dynamic Workflows, primero hay que entender effort.

Anthropic introdujo con Opus 4.7/4.8 un parámetro que controla cuántos tokens Claude usa al responder. Tiene 5 niveles:

Nivel	Tokens	Uso ideal
`low`	Mínimo	Subagentes simples, clasificaciones
`medium`	Balanceado	Tareas agenticas estándar
`high`	Alto (default)	Coding complejo, análisis
`xhigh`	Muy alto — millones de tokens	Trabajo de 30+ minutos, Dynamic Workflows
`max`	Sin límite	Problemas de frontera

Dynamic Workflows requiere xhigh. Sin ese nivel de presupuesto de tokens, Claude no tiene margen para planificar, lanzar y coordinar docenas de agentes simultáneos con verificación cruzada.

Ultracode: cómo Claude Code lo expone

En Claude Code, el nivel xhigh aparece en el menú de effort como ultracode. No es un nivel adicional de la API — es cómo Claude Code combina xhigh con permisos explícitos para lanzar workflows multi-agente.

Cuando activás ultracode, Claude Code recibe:

Effort level xhigh (presupuesto de tokens en millones)
Permiso para lanzar subagentes en background sin pedir confirmación por cada uno
Acceso a Dynamic Workflows

Esto es lo que lo diferencia de simplemente correr xhigh en la API — el permiso de orquestación está integrado.

Cómo activar Dynamic Workflows en Claude Code

Opción 1: desde el menú de effort

Abrí Claude Code y seleccioná ultracode en el selector de effort. Claude opera en xhigh con permisos multi-agente activados.

Opción 2: por comando

/effort xhigh

Después pedile la tarea directamente:

Migrá toda la base de código de Express a Fastify.
Usá los tests existentes como criterio de calidad.
Commiteá en branches separados por módulo.

Claude va a analizar la codebase, preguntar lo que necesita confirmar, y después lanzará el workflow.

Monitorear el progreso

/workflows

Esto muestra todas las ejecuciones activas con:

Estado de cada agente
Cuántos están corriendo en paralelo
Progreso por módulo
Errores o bloqueos detectados

Podés seguir trabajando en otras cosas mientras el workflow corre. Claude te notifica cuando termina.

El caso de uso oficial de Anthropic

Anthropic muestra Dynamic Workflows con migraciones de codebase completas:

Cientos de miles de líneas de código
De kickoff hasta merge en un solo workflow
La suite de tests existente como criterio de calidad (no hay que definir tests nuevos)
Orquestado de forma autónoma

Lo que antes requería días de coordinación manual — diseñar el plan, dividir el trabajo entre agentes secuenciales, manejar dependencias, consolidar resultados — Dynamic Workflows lo comprime en horas con trabajo paralelo real.

El modelo asigna agentes por módulo, los corre en paralelo, verifica que los tests pasen en cada uno, y consolida solo cuando todo está limpio.

Dynamic Workflows vs subagentes normales

	Subagentes normales	Dynamic Workflows
Escala típica	1–10 agentes	10–100+ agentes
Diseño de arquitectura	Manual (vos lo diseñás)	Automático (Claude lo diseña)
Corre en background	No — bloquea la sesión	Sí — completamente en background
Verificación de outputs	Manual	Automática y cruzada
Scope ideal	Tarea específica y acotada	Codebase completo, migración masiva
Coordinación de handoffs	Diseñada por vos	Diseñada por Claude
Effort requerido	`high` (default)	`xhigh` mínimo
Disponibilidad	Todos los planes	Enterprise, Team, Max

La diferencia no es solo de escala. Es de quién diseña el sistema: en subagentes normales, vos definís la arquitectura multi-agente. En Dynamic Workflows, Claude define todo — vos definís el objetivo y el criterio de calidad.

Cómo usarlo desde la API

Si querés construir Dynamic Workflows propios sin Claude Code, la documentación oficial describe el patrón como "orchestration mode" usando mid-conversation system messages.

El setup básico para un workflow orquestado:

import anthropic

client = anthropic.Anthropic()

# Mensaje inicial con la tarea de alto nivel
response = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=64000,  # Empezá con 64k, ajustá según la tarea
    messages=[
        {
            "role": "user",
            "content": """
            Tarea: migrá el módulo de autenticación de JWT a Sessions.
            
            Criterio de calidad: todos los tests en /tests/auth/ deben pasar.
            Scope: solo /src/auth/ y sus dependencias directas.
            Formato de output: PR-ready, con descripción de cambios.
            """
        }
    ],
    output_config={"effort": "xhigh"},
    thinking={"type": "adaptive"},
)

Para orquestación más compleja, podés inyectar permisos de subagentes via system messages a mitad de la conversación — esto es lo que Claude Code hace internamente con ultracode. La doc oficial está en Build an orchestration mode.

Nota sobre max_tokens: A effort xhigh, poné un max_tokens grande desde el principio. Anthropic recomienda empezar en 64k y ajustar. Si el modelo se queda sin tokens durante un workflow largo, el resultado se trunca.

Casos de uso validados

Migraciones de stack:

Migrá el ORM de Sequelize a Prisma. 
Mantené el comportamiento de todos los queries existentes. 
Generá migrations de Prisma desde el schema actual.

Refactors masivos:

Aplicá el patrón Repository en todos los controllers.
Criterio: los endpoints existentes no deben cambiar su interface.

Generación de test coverage:

Generá tests unitarios para todos los módulos en /src/services/ 
que tengan menos del 60% de coverage.
Usá el patrón de los tests existentes en /tests/services/user.test.ts.

Auditorías de seguridad:

Auditá la codebase para vulnerabilidades OWASP Top 10.
Generá un reporte por módulo con severidad y recomendación de fix.

Actualizaciones de dependencias con breaking changes:

Actualizá React 18 a React 19.
Resolvé todos los breaking changes en componentes.
Criterio: el build de producción debe completar sin errores.

Disponibilidad y requisitos

Dynamic Workflows está en Research Preview desde el 28 de mayo de 2026.

Requisito	Detalle
Modelo	Claude Opus 4.8 (obligatorio)
Effort	`xhigh` mínimo
Plan claude.ai	Enterprise, Team o Max
API	Acceso directo (cualquier tier)
Waitlist	No — disponible desde ya si cumplís los requisitos

Como está en Research Preview: la feature está disponible ahora, pero puede cambiar mientras Anthropic itera sobre el comportamiento. No es una beta cerrada con acceso restringido.

Cuándo tiene (y no tiene) sentido usarlo

Tiene sentido para:

Migraciones de stack (cambiar framework, ORM, versión de lenguaje) en codebases medianas a grandes
Refactors masivos que afectan múltiples módulos en paralelo
Generación de tests exhaustivos para módulos sin cobertura
Actualizaciones de dependencias con breaking changes en muchos archivos
Auditorías de seguridad o deuda técnica en codebases grandes

No tiene sentido para:

Tareas de 1-3 archivos — un agente solo es más eficiente y más barato
Prototipos rápidos — la overhead de planning no vale la pena
Tareas que requieren decisiones humanas frecuentes — Dynamic Workflows asume alta autonomía
Trabajo donde necesitás control granular sobre cada decisión del agente

La señal más clara de cuándo usarlo: si el scope de la tarea haría que vos mismo pensaras "esto lo tendría que dividir entre varios agentes y coordinarlos", Dynamic Workflows lo hace por vos.

El cambio real que representa

La métrica más honesta no es los benchmarks. Es esta:

Lo que antes era trabajo de días de coordinación manual de agentes secuenciales — diseñar la arquitectura, dividir el trabajo, manejar dependencias, consolidar resultados — Dynamic Workflows lo convierte en trabajo de horas con paralelismo automático.

Para equipos pequeños con codebases grandes, esto cambia lo que es posible hacer sin escalar el equipo.

Para quien construye sistemas con Claude Code, el cambio de paradigma es más profundo: empezás a pensar en términos de objetivos y criterios de calidad, no en términos de arquitectura de agentes. El "cómo se hace" lo resuelve Claude.

Preguntas frecuentes

¿Qué es Dynamic Workflows en Claude Code?

Es una feature (Research Preview) que permite orquestar automáticamente cientos de agentes en paralelo para tareas a gran escala. Claude diseña la arquitectura de agentes, los lanza en background, verifica los outputs, y te reporta el resultado. Requiere Opus 4.8 con effort xhigh.

¿Cómo activo Dynamic Workflows?

En Claude Code: seleccioná ultracode en el menú de effort, o escribí /effort xhigh. Después pedile la tarea de alto nivel. Para ver el estado: /workflows.

¿Qué diferencia hay entre ultracode y xhigh?

xhigh es el nivel de effort de la API. Ultracode es cómo Claude Code expone xhigh más permisos de orquestación multi-agente integrados. Son técnicamente lo mismo con la capa de permisos encima.

¿Cuánto cuesta usar Dynamic Workflows?

Depende del trabajo que haga Claude. A xhigh, el presupuesto de tokens es alto — podés esperar consumo de millones de tokens en una migración grande. A $5/MTok de input y $25/MTok de output, una migración de codebase complejo puede costar entre $50 y $500 dependiendo del scope. Empezá con algo acotado.

¿Funciona con cualquier plan de Claude?

No. Dynamic Workflows en claude.ai requiere plan Enterprise, Team o Max. Vía API directa, funciona con cualquier tier de acceso.

¿Puedo usarlo desde la API sin Claude Code?

Sí. Usá claude-opus-4-8 con output_config: {"effort": "xhigh"}. Para orquestación avanzada con subagentes, la documentación oficial describe el patrón en Build an orchestration mode.

¿Dynamic Workflows reemplaza los subagentes que ya uso?

No. Son complementarios. Subagentes normales siguen siendo la opción para tareas específicas y acotadas donde vos querés control granular. Dynamic Workflows es para trabajo a escala donde querés que Claude diseñe y ejecute la coordinación.

Anthropic anunció Dynamic Workflows junto con Claude Opus 4.8 el 28 de mayo de 2026. Disponible en Research Preview para planes Enterprise, Team y Max en claude.ai, y vía API directa. Fuentes: Anthropic effort docs, Models overview.