Flujos de trabajo dinámicos de Claude Code: Guía oficial paso a paso

Qué se lanzó

El 28 de mayo de 2026, Claude presentó flujos de trabajo dinámicos en Claude Code. La publicación oficial del lanzamiento los describe como ejecuciones paralelas de larga duración donde Claude escribe código de orquestación, distribuye el trabajo a muchos subagentes y verifica los resultados antes de informar. El hilo verificado de ClaudeDevs describió el comportamiento del producto de forma más directa: usa la palabra workflow en un prompt para comenzar.

La forma útil de interpretar este lanzamiento: los flujos de trabajo no son otra plantilla de prompt. Son una nueva ruta de orquestación dentro de Claude Code para tareas demasiado grandes para un solo ciclo de conversación: auditorías de bases de código, búsqueda de errores en todo el servicio, migraciones a gran escala, investigación con verificación cruzada y planes que deben abordarse desde varios ángulos antes de que los aceptes.

The workflow shape:

Your prompt
  -> Claude writes workflow JavaScript
  -> Runtime starts background phases
  -> Subagents investigate, edit, test, or review
  -> Results are cross-checked
  -> One coordinated answer returns to the session

Definición

Un flujo de trabajo dinámico de Claude Code es un script de orquestación en JavaScript que Claude escribe para tu tarea, y luego un entorno de ejecución independiente lo procesa en segundo plano.Los agentes realizan el trabajo real de lectura, escritura, ejecución de shell, investigación y revisión. El script coordina la ejecución y almacena los resultados intermedios fuera del contexto principal del chat.

Esa distinción es la esencia de la funcionalidad. En un chat normal, Claude decide qué hacer a continuación turno por turno, y cada resultado debe encajar dentro de la conversación. En un workflow, el plan, los bucles, las ramas y los valores intermedios residen en el script del workflow. La sesión principal permanece receptiva y recibe el resultado coordinado.

Requisitos y disponibilidad

La fuente de información operativa es la documentación de workflows de Claude Code. Esta indica que los workflows dinámicos se encuentran en vista previa de investigación, requieren Claude Code v2.1.154 o posterior, y están disponibles en planes de pago y a través de despliegues compatibles de API/proveedores. El blog de lanzamiento y el hilo de ClaudeDevs también mencionan Claude Code CLI, Desktop, VS Code, la Claude API, Amazon Bedrock, Google Cloud Vertex AI y Microsoft Foundry.

# Check your version
claude --version

# Update if needed
claude update

# Inside Claude Code, open settings and confirm Dynamic workflows
/config

Existe un matiz en el día del lanzamiento: el blog y el hilo en X enfatizan la disponibilidad para Max, Team y Enterprise, mientras que la documentación actual ofrece la nota de configuración más específica para planes de pago y menciona la habilitación de Pro a través de /config. Para la configuración real, siga la página de documentación y la pantalla de configuración de su cuenta.

Modelo mental: Subagentes, Skills y Workflows

Claude Code ya contaba con varias formas de paralelizar o reutilizar el trabajo. Los Dynamic workflows se sitúan por encima de los subagentes: utilizan subagentes, pero la coordinación se traslada a un script. Por eso esta funcionalidad es útil para patrones de fan-out y verificación repetibles.

Utiliza subagentes cuando necesites una o dos investigaciones aisladas. Utiliza skills cuando el know-how deba ser reutilizable. Utiliza workflows cuando la orquestación en sí deba ser repetible: hacer fan-out, comparar hallazgos, reiniciar agentes fallidos, guardar la ejecución exitosa y reutilizarla como un comando.

Inicio rápido: Ejecuta el workflow integrado

La prueba segura más rápida es /deep-research, el flujo de trabajo incluido y documentado por Claude Code. Este distribuye las búsquedas desde varios ángulos, obtiene fuentes, verifica afirmaciones y devuelve un informe con citas. Elige primero una pregunta delimitada para que puedas observar el uso y el comportamiento antes de intentar una migración a gran escala.

Paso 1: Inicia Claude Code en un proyecto

cd /path/to/your/project
claude

Paso 2: Ejecuta un flujo de trabajo de investigación con alcance definido

/deep-research What changed in the Node.js permission model between v20 and v22?

Paso 3: Aprueba el flujo de trabajo

Claude Code muestra el flujo de trabajo planificado antes de ejecutarlo. Elige Yes, run itsi las fases coinciden con tu intención. Si deseas inspeccionar la orquestación generada, elige View raw script. Si el prompt es demasiado amplio, cancélalo y delimítalo mejor.

Paso 4: Obsérvalo desde /workflows

/workflows

La vista de flujo de trabajo muestra las fases, el número de agentes, el total de tokens y el tiempo transcurrido. Profundiza en una fase para inspeccionar el prompt de cada agente, las llamadas a herramientas recientes y el resultado. Cuando la ejecución finaliza, Claude inserta el informe en tu sesión actual.

Crea un flujo de trabajo personalizado con un solo prompt

Para ejecutar tu propia tarea como un flujo de trabajo sin cambiar toda la sesión, incluye la palabra workflow en cualquier parte del prompt. Claude Code resaltará la palabra y dirigirá la tarea a través de la creación del flujo de trabajo.

Run a workflow to audit every API endpoint under src/routes for missing auth checks.

Scope:
- read-only first pass
- group findings by endpoint
- verify each finding with an independent reviewer agent
- return only confirmed issues
- do not edit files unless I approve a follow-up workflow

La documentación menciona una pequeña vía de escape: si Claude Code resalta workflowy no tenías la intención de activar la función, presiona alt+w para ignorarlo en ese prompt.

Patrón de prompt

Usa Ultracode cuando quieras que Claude tome las decisiones

ultracode no es un nivel de esfuerzo de modelo convencional. La documentación de configuración del modelo lo define como un ajuste de sesión de Claude Code: utiliza xhigh reasoning effort

# Turn on automatic workflow orchestration for this session
/effort ultracode

# Return to normal high effort for routine work
/effort high

Usa ultracode para sesiones donde la mayoría de las tareas sean grandes, ambiguas o de alto riesgo: migraciones, auditorías profundas, pruebas de estrés de diseño o limpieza de todo el repositorio. No lo dejes activado para ediciones rutinarias. La documentación de workflows indica que ultracode se aplica a cada tarea sustancial de la sesión, consume más tokens, tarda más tiempo y se restablece al iniciar una nueva sesión.

Flujo de aprobación: lee antes de ejecutar

El prompt de aprobación de la CLI muestra las fases planificadas y ofrece cuatro acciones. Considéralo como el último punto de control antes de que la ejecución pueda consumir un uso significativo o realizar ediciones de archivos aprobadas a través de agentes.

Dos detalles del teclado son importantes. Ctrl+G abre el script generado en tu Tab te permite ajustar el prompt antes de que comience la ejecución. En Desktop, Una vez, Siempre, y Denegar acciones.

Guardar un Workflow como un Slash Command

Cuando un workflow genera un proceso repetible útil, guárdalo. Los workflows guardados se convierten en / autocomplete como comandos integrados.

/workflows

# Select the completed run
# Press s
# Choose project or user location
# Press Enter to save

# Later:
/api-auth-audit

Si un flujo de trabajo de proyecto y uno personal comparten el mismo nombre, el del proyecto tiene prioridad.

Monitorear, Pausar, Reanudar, Reiniciar y Detener ejecuciones

Los flujos de trabajo se ejecutan en segundo plano. Usa /workflows para inspeccionar las ejecuciones en curso y

La reanudación tiene un alcance de sesión. Si pausas o detienes una ejecución, los agentes completados pueden devolver resultados en caché y los agentes restantes pueden ejecutarse en tiempo real cuando reanudes la sesión en la misma sesión de Claude Code. Si sales de Claude Code mientras un flujo de trabajo está en ejecución, la siguiente sesión iniciará el flujo de trabajo desde cero.

Comportamiento y límites del tiempo de ejecución

El tiempo de ejecución del flujo de trabajo está aislado de la conversación. El script del flujo de trabajo coordina a los agentes; los agentes realizan el trabajo de archivos, shell, web y MCP. La documentación enumera límites concretos para que los usuarios puedan evaluar el uso de recursos.

Control de costos y uso

Tanto la documentación como el hilo de ClaudeDevs advierten que los flujos de trabajo pueden consumir mucho más uso que una conversación normal de Claude Code. Un flujo de trabajo puede iniciar muchos agentes, y cada agente utiliza el modelo de tu sesión a menos que el script dirija una fase a otro modelo.

# Before a large workflow
/model
/usage

# In your prompt
Use a smaller model for indexing and low-risk classification phases.
Use the strongest model only for final verification and architectural judgment.

• Comienza con una ejecución de alcance limitado, no con todo el monorepo.
• Verifica /model antes de lanzar tareas costosas.
• Usa /usage para inspeccionar el uso actual de la sesión y el impacto del plan-limit.
• Pide a Claude que derive las etapas de bajo riesgo a un modelo más pequeño cuando sea apropiado.
• Detén ejecuciones fuera de control o con un alcance incorrecto desde /workflows.
• Reserva ultracode para sesiones donde la mayoría de las tareas justifiquen la orquestación de flujos de trabajo.

Detalles de permisos y seguridad

Tu modo de permisos controla el prompt de inicio del flujo de trabajo, pero no todas las acciones de los subagentes acceptEdits modo y heredan tu lista de permitidos de herramientas. Las ediciones de archivos se

Para trabajos de alto riesgo, utiliza un patrón de dos etapas: el primer flujo de trabajo produce solo hallazgos confirmados; el segundo flujo de trabajo aplica los cambios aprobados. Esto coincide con la nota de la documentación que indica que los flujos de trabajo no aceptan entradas arbitrarias del usuario durante la ejecución.

Desactivar Workflows

Los workflows dinámicos pueden desactivarse a nivel de usuario u organización. Cuando están desactivados, los comandos de workflow integrados no están disponibles, el workflow keyword ya no ultracode se elimina del /effortmenú.

# Option 1: interactive setting
/config
# Toggle Dynamic workflows off

# Option 2: user settings
{
  "disableWorkflows": true
}

# Option 3: environment variable, read at startup
CLAUDE_CODE_DISABLE_WORKFLOWS=1 claude

Los administradores de la organización también pueden configurar "disableWorkflows": true en los ajustes gestionados o utilizar la página de configuración de administrador de Claude Code. Utilízalo para entornos donde el uso de tokens multi-agente o las ediciones de archivos auto-aprobadas requieran una política centralizada.

Ejemplos de workflows que puedes adaptar

La publicación de lanzamiento de Anthropic enumera la búsqueda de errores en todo el codebase, la optimización guiada por perfilador, auditorías de seguridad, migraciones, trabajos de modernización y verificaciones de alta prioridad como usos iniciales de los workflows. La misma publicación cita una migración de Bun de Zig a Rust como un ejemplo a gran escala, con la advertencia de que no estaba en producción en el momento de la publicación.

Ejemplo 1: Auditoría de autenticación de API

Run a workflow to audit src/routes and src/api for missing authentication checks.

Rules:
- read files only
- group endpoints by auth pattern
- have one agent find issues and another verify them
- exclude test fixtures and generated files
- return confirmed findings with file paths and suggested fixes

Ejemplo 2: Plan de migración antes de realizar ediciones

Run a workflow to plan the migration from the old payments client to the new billing SDK.

Do not edit files.
Map every call site, classify risk, propose phases, and have reviewer agents challenge the plan.
Return a phased migration plan with test commands for each phase.

Ejemplo 3: Investigación con verificación cruzada

/deep-research Compare the official migration paths for React 19 Server Actions and Next.js 16 forms.

Focus on official docs.
Return only claims that are supported by source links.

Ejemplo 4: Guardar un comando de revisión de equipo

Run a workflow to review this branch for correctness bugs.

Scope:
- current git diff only
- no style-only feedback
- verify each finding against code
- include test commands that would catch the bug

# After the run succeeds:
/workflows
# press s and save to .claude/workflows/branch-correctness-review

Errores comunes

Lista de verificación de lanzamiento

• Confirma que claude --version sea al menos v2.1.154.
• Abre /config y confirma que los Dynamic workflows estén habilitados.
• Ejecuta un pequeño /deep-research flujo de trabajo antes de realizar ediciones de código.
• Usa /workflows para inspeccionar fases, totales de tokens y la salida del agente.
• Para flujos de trabajo personalizados, incluye el alcance de la ruta, el formato de salida, la regla de verificación y la política de edición.
• Usa /effort ultracode solo para sesiones donde la mayoría de las tareas lo justifiquen.
• Guarda los flujos de trabajo repetibles en .claude/workflows/ para comandos de equipo.
• Usa /usage, /modely el enrutamiento a modelos más pequeños para el control de costos.
• Deshabilita los flujos de trabajo a través de /config, settings, variables de entorno o configuraciones gestionadas cuando la política lo requiera.

FAQ

Glosario

Fuentes oficiales

Esta publicación utiliza intencionalmente solo fuentes oficiales de Claude, Claude Code, propiedad de Anthropic y de ClaudeDevs verificados.

• Blog de Claude: Introducción a los flujos de trabajo dinámicos en Claude Code
• Documentación de Claude Code: Orquestación de subagentes a escala con flujos de trabajo dinámicos
• Hilo oficial de X de ClaudeDevs: Lanzamiento de flujos de trabajo dinámicos
• Documentación de Claude Code: Comandos
• Documentación de Claude Code: Ejecuta agentes en paralelo
• Documentación de Claude Code: Configuración del modelo y niveles de esfuerzo
• Documentación de Claude Code: Ajustes
• Documentación de Claude Code: Gestiona los costos de manera efectiva
• Documentación de Claude Code: Inicio rápido

Relacionado: el desglose del lanzamiento oficial de claude-opus-4-8 y la guía de migración de la API de claude-opus-4-8.