Skip to main content
Los dynamic workflows requieren Claude Code v2.1.154 o posterior y están disponibles en todos los planes pagos, con acceso a la API de Anthropic, y en Amazon Bedrock, Google Cloud’s Agent Platform y Microsoft Foundry. En Pro, actívelos desde la fila Dynamic workflows en /config.
Un dynamic workflow es un script de JavaScript que orquesta subagentes a escala. Claude escribe el script para la tarea que describe, y un runtime lo ejecuta en segundo plano mientras su sesión permanece receptiva. Recurra a un workflow cuando una tarea necesita más agentes de los que una conversación puede coordinar, o cuando desea que la orquestación esté codificada como un script que pueda leer y volver a ejecutar. Los ejemplos incluyen un barrido de errores en toda la base de código, una migración de 500 archivos, una pregunta de investigación que necesita que las fuentes se verifiquen mutuamente, y un plan difícil que vale la pena redactar desde varios ángulos independientes antes de comprometerse con uno.

​
Cuándo usar un workflow

Subagentes, skills, equipos de agentes y workflows pueden ejecutar una tarea de varios pasos. La diferencia es quién tiene el plan: Un workflow mueve el plan al código. Con subagentes, skills y equipos de agentes, Claude es el orquestador: decide turno a turno qué generar o asignar a continuación, y cada resultado llega a una ventana de contexto. Un script de workflow mantiene el bucle, la ramificación y los resultados intermedios en sí mismo, por lo que el contexto de Claude solo contiene la respuesta final. Mover el plan al código también permite que un workflow aplique un patrón de calidad repetible, no solo ejecutar más agentes: puede tener agentes independientes que revisen adversarialmente los hallazgos de los demás antes de que se informen, o redacten un plan desde varios ángulos y los sopesen entre sí, para obtener un resultado más confiable que una sola pasada.

​
Ejecutar un workflow incluido

La forma más rápida de ver un workflow en acción es ejecutar /deep-research, el workflow integrado que Claude Code incluye para investigar una pregunta en muchas fuentes. Verá agentes trabajar a través de un conjunto de fases en segundo plano mientras su sesión permanece libre, y obtendrá un informe al final en lugar de una transcripción turno a turno.
1

Ejecutar el workflow

Ejecute /deep-research con una pregunta que desee investigar. Distribuye búsquedas web en varios ángulos, obtiene y verifica cruzadamente las fuentes que encuentra, y sintetiza un informe citado.
2

Permitir workflows

Claude Code pregunta si permitir el workflow. Seleccione Yes para continuar. El prompt exacto depende de su modo de permiso. Consulte Aprobar el plan antes de que se ejecute para las opciones por modo.
3

Ver progreso

La ejecución comienza en segundo plano. Ejecute /workflows, use las teclas de flecha para seleccionar la ejecución y presione Enter para abrir su vista de progreso:
La vista muestra cada fase con su recuento de agentes, total de tokens y tiempo transcurrido. Profundice en cualquier fase para ver sus agentes y qué encontró cada uno. Consulte Ver la ejecución para el conjunto completo de controles.También puede ver desde el panel de tareas debajo del cuadro de entrada: aparece un resumen de progreso de una línea mientras se ejecuta. Presione la flecha hacia abajo para enfocarlo, luego Enter para expandir.
4

Leer el informe

Cuando se completa la ejecución, el informe llega a su sesión. Cita las fuentes de las que proviene cada afirmación, con afirmaciones que no sobrevivieron la verificación cruzada ya filtradas.A partir de v2.1.196, cuando los agentes verificadores no pueden verificar una afirmación, como después de un límite de velocidad o error de API, el informe enumera esa afirmación como no verificada en lugar de contarla como refutada.
Para ejecutar un workflow para su propia tarea, haga que Claude escriba uno, y una vez que una ejecución haga lo que deseaba puede guardarlo como un comando propio.

​
Workflows incluidos

Claude Code incluye /deep-research como un workflow integrado: Los workflows que guarda usted mismo se convierten en comandos de la misma manera y aparecen en el autocompletado / junto con los incluidos.

​
Ver la ejecución

Los workflows se ejecutan en segundo plano, por lo que la sesión permanece receptiva mientras los agentes trabajan. Ejecute /workflows en cualquier momento para enumerar los workflows en ejecución y completados, luego seleccione uno para abrir su vista de progreso.
La vista de progreso muestra cada fase con sus recuentos de agentes, totales de tokens y tiempo transcurrido. El pie de página enumera la clave para cada acción:

​
Hacer que Claude escriba un workflow

Puede hacer que Claude escriba un workflow para su tarea de dos formas: También puede ejecutar un comando de workflow que ya existe: un workflow incluido como /deep-research, o uno que ha guardado.

​
Pedir un workflow en su prompt

Para ejecutar una sola tarea como un workflow sin cambiar el nivel de esfuerzo de la sesión, incluya la palabra clave ultracode en su prompt. Pedir con sus propias palabras, por ejemplo “usar un workflow” o “ejecutar un workflow”, también funciona: Claude trata una solicitud directa como el mismo opt-in. Antes de v2.1.160 la palabra clave literal era workflow; las solicitudes en lenguaje natural funcionan en ambas versiones.
Claude Code resalta la palabra clave en su entrada y Claude escribe un script de workflow para la tarea en lugar de trabajar a través de ella turno a turno. Si no tenía la intención de iniciar un workflow, presione Option+W en macOS o Alt+W en Windows y Linux para descartar el resaltado para este prompt, o presione retroceso mientras el cursor está justo después de la palabra clave resaltada. Para evitar que la palabra clave se active en absoluto, desactive Ultracode keyword trigger en /config. Si ya tiene un orquestador construido de otra manera, como una carpeta de prompts de subagentes o una skill que distribuye trabajo, puede señalar a Claude hacia él y pedir un workflow que haga lo mismo.

​
Dejar que Claude decida con ultracode

Ultracode es una configuración de Claude Code que combina xhigh esfuerzo de razonamiento con orquestación automática de workflows. Con él activado, Claude planifica un workflow para cada tarea sustancial en lugar de esperar a que lo pida.
Para iniciar una sesión con ultracode ya activado, lance con claude --effort ultracode. Requiere Claude Code v2.1.203 o posterior. Con ultracode activado, Claude decide cuándo una tarea justifica un workflow. Una sola solicitud puede convertirse en varios workflows seguidos: uno para entender el código, uno para hacer el cambio y uno para verificarlo. Esto se aplica a cada tarea en la sesión, por lo que cada solicitud usa más tokens y toma más tiempo que en niveles de esfuerzo más bajos. Ultracode dura la sesión actual y se reinicia cuando comienza una nueva. Vuelva con /effort high cuando regrese al trabajo rutinario. Está disponible en modelos que admiten xhigh esfuerzo; en otros modelos el menú /effort no lo ofrece.

​
Aprobar el plan antes de que se ejecute

En la CLI, el prompt por ejecución muestra las fases planeadas y estas opciones:
  • Yes, run it: inicia la ejecución
  • Yes, and don’t ask again for <name> in <path>: inicia y omite este prompt para este workflow en este proyecto de ahora en adelante
  • View raw script: lee el script antes de decidir
  • No: cancelar
Ctrl+G abre el script en su editor. Tab le permite ajustar el prompt antes de que comience la ejecución. Si ve este prompt depende de su modo de permiso: En la aplicación de escritorio, una tarjeta de aprobación muestra el nombre del workflow, la lista de fases y una advertencia de uso de tokens, con acciones Once, Always y Deny. La vista de progreso aparece en el panel lateral Background tasks. Su modo de permiso controla solo el prompt de lanzamiento anterior. Los subagentes que genera el workflow siempre se ejecutan en modo acceptEdits y heredan su lista de permitidos de herramientas, independientemente del modo de su sesión. Las ediciones de archivos se aprueban automáticamente. Los comandos de shell, las búsquedas web y las herramientas MCP que no están en su lista de permitidos aún pueden solicitarle durante la ejecución. Para evitar esto en una ejecución larga, agregue los comandos que necesitan los agentes a su lista de permitidos antes de comenzar. En claude -p y el Agent SDK no hay nadie a quien solicitar, por lo que las llamadas de herramientas siguen sus reglas de permiso configuradas sin confirmación interactiva.

​
Guardar el workflow para reutilización

Cuando Claude escribe un workflow para una tarea que repetirá, puede guardar el script de esa ejecución como un comando. Un proceso como una revisión que ejecuta en cada rama luego ejecuta la misma orquestación cada vez. Ejecute /workflows, seleccione la ejecución que desea mantener y presione s. En el diálogo de guardado, Tab alterna entre las dos ubicaciones de guardado:
  • .claude/workflows/ en su proyecto: compartido con todos los que clonan el repositorio
  • ~/.claude/workflows/ en su directorio de inicio: disponible en cada proyecto, visible solo para usted. Si establece CLAUDE_CONFIG_DIR, esta ubicación es el directorio workflows/ bajo esa ruta.
El diálogo de guardado muestra la ruta resuelta para la ubicación personal. Antes de v2.1.208, mostraba ~/.claude/workflows/ incluso cuando CLAUDE_CONFIG_DIR estaba establecido; el archivo aún se guardaba en el directorio configurado. Presione Enter para guardar. El workflow se ejecuta como /<name> en futuras sesiones desde cualquier ubicación. En un monorepo con varios directorios .claude/, puede mantener workflows junto al paquete al que se aplican. A partir de v2.1.178, guardar en la ubicación del proyecto escribe en el directorio .claude/workflows/ más cercano que ya existe entre su directorio de trabajo y la raíz del repositorio, o en la raíz del repositorio si aún no existe ninguno. Los workflows del proyecto también se cargan desde cada .claude/workflows/ a lo largo de esa ruta, y cuando más de uno define el mismo nombre Claude Code ejecuta el más cercano al directorio de trabajo. Si un workflow de proyecto y un workflow personal comparten un nombre, se ejecuta el del proyecto.

​
Pasar entrada a un workflow guardado

Un workflow guardado puede aceptar entrada a través del parámetro args. El script lo lee como una variable global llamada args. Úselo para proporcionar una pregunta de investigación, una lista de rutas de destino o un objeto de configuración en el momento de la invocación en lugar de editar el script para cada ejecución. El siguiente prompt ejecuta un workflow guardado con una lista de números de problemas:
Claude pasa la lista como datos estructurados, por lo que el script puede llamar a métodos de matriz y objeto en args directamente sin analizarlo primero. Si se omite args, la variable global es undefined dentro del script.

​
Ejemplos de prompts de workflow

Un workflow se ajusta mejor cuando la tarea es más grande de lo que un agente puede mantener en contexto, o cuando el mismo paso necesita ejecutarse en muchos elementos. Los prompts a continuación muestran formas comunes. Cada uno pide a Claude que escriba y ejecute un workflow para esa tarea; usted no escribe el script usted mismo.

​
Auditar muchos archivos para el mismo problema

Distribuya un agente por archivo, luego recopile y verifique los hallazgos.

​
Seguir arreglando hasta que pase una verificación

Ejecute un verificador, arregle lo que falló y repita hasta que pase o deje de hacer progreso.

​
Migrar muchos archivos en paralelo

Descubra los archivos a migrar, transforme cada uno en una copia aislada para que las ediciones no entren en conflicto, y verifique cada resultado.

​
Revisar cada archivo modificado y escribir un resumen

Ejecute un revisor por archivo, luego entregue todos los hallazgos a un agente que los clasifique y deduplique.

​
Investigar un tema en muchas fuentes

Distribuya lectores en registros de cambios, problemas y documentos, luego sintetice. El workflow /deep-research incluido hace esto; también puede describir una versión más estrecha.

​
Encontrar problemas hasta que la lista deje de crecer

Siga buscando en rondas y deténgase cuando nuevas rondas no encuentren nada nuevo.

​
Cómo se ve el script guardado

Cuando guarda un workflow, el archivo en .claude/workflows/ contiene un bloque meta seguido de un cuerpo de script que orquesta subagentes. Generalmente no necesita editarlo, pero aquí está la forma de uno pequeño para que pueda reconocer lo que Claude generó:
El cuerpo es JavaScript simple con await de nivel superior. agent() genera un subagente y pipeline() ejecuta uno por elemento en una lista. Si desea editar un script a mano, pida a Claude que le guíe a través del cambio, o consulte la entrada de herramienta Workflow en la referencia del Agent SDK para el conjunto completo de opciones.

​
Cómo se ejecuta un workflow

El runtime del workflow ejecuta el script en un entorno aislado, separado de su conversación. Los resultados intermedios permanecen en variables de script en lugar de llegar al contexto de Claude. Cada ejecución escribe su script en un archivo bajo el directorio de su sesión en ~/.claude/projects/. Claude recibe la ruta cuando comienza la ejecución, por lo que puede solicitarla. Puede abrir ese archivo para leer la orquestación que Claude escribió, compararlo con el script de una ejecución anterior, o editarlo y pedir a Claude que reinicie desde la versión editada. El runtime rastrea el resultado de cada agente a medida que avanza la ejecución, lo que es lo que hace que una ejecución sea reanudable dentro de la misma sesión.

​
Comportamiento y límites

El runtime aplica las siguientes restricciones:

​
Gestionar ejecuciones

Una vez que comienza una ejecución, la gestiona desde la vista /workflows, o expandiendo su línea de progreso en el panel de tareas debajo del cuadro de entrada.

​
Reanudar después de una pausa

Si detiene una ejecución, puede reanudarla: los agentes que ya se completaron devuelven sus resultados en caché, y el resto se ejecuta en vivo. Un agente que aún se estaba ejecutando cuando detuvo no se guarda e inicia de nuevo al reanudar, por lo que un workflow que distribuye el trabajo entre muchos agentes pequeños preserva más progreso que un agente largo. Reanude una ejecución pausada desde /workflows seleccionándola y presionando p, o pida a Claude que relance el workflow con el mismo script. La reanudación funciona dentro de la misma sesión de Claude Code. Si sale de Claude Code mientras se ejecuta un workflow, la siguiente sesión inicia el workflow de nuevo.

​
Costo

Un workflow genera muchos agentes, por lo que una sola ejecución puede usar significativamente más tokens que trabajar a través de la misma tarea en conversación. Las ejecuciones cuentan hacia el uso de su plan y los límites de velocidad como cualquier otra sesión. Para evaluar el gasto antes de comprometerse con una tarea grande, ejecute el workflow en un segmento pequeño primero: un directorio en lugar de todo el repositorio, o una pregunta estrecha en lugar de una amplia. La vista /workflows muestra el uso de tokens de cada agente a medida que avanza la ejecución, y puede detener la ejecución allí en cualquier momento sin perder el trabajo completado. Los límites de agente del runtime limitan cuántos agentes puede generar una sola ejecución, lo que limita el costo de un script descontrolado. Para mantener cada ejecución más pequeña de forma predeterminada, establezca una directriz de tamaño en /config. Claude Code también marca una ejecución que crece inusualmente grande. Cuando un workflow programa más de 25 agentes, o su total de tokens proyectado supera 1,5 millones, su línea de progreso en el panel de tareas debajo del cuadro de entrada muestra una advertencia de Large workflow. La advertencia lo dirige a /workflows, donde puede detener la ejecución. Requiere Claude Code v2.1.203 o posterior. La advertencia es informativa: no pausa ni limita la ejecución. Dos configuraciones cambian cuando la ve:
  • Si establece una directriz de tamaño, el recuento de agentes de la directriz reemplaza el umbral de 25 agentes.
  • Las sesiones con ultracode activado no muestran la advertencia, porque activar ultracode ya lo incluye en ejecuciones grandes.
Cada agente en un workflow usa el modelo de su sesión a menos que el script dirija una etapa a uno diferente o la variable de entorno CLAUDE_CODE_SUBAGENT_MODEL esté configurada, que anula ambos. Para controlar el costo del modelo:
  • Verifique /model antes de una ejecución grande si generalmente cambia a un modelo más pequeño para trabajo rutinario
  • Pida a Claude que use un modelo más pequeño para etapas que no necesitan el más fuerte cuando describe la tarea

​
Establecer una directriz de tamaño

La configuración de tamaño de workflow dinámico en /config mantiene los workflows que Claude escribe en una escala más pequeña de forma predeterminada. Claude Code envía la configuración a Claude como consejo, por lo que un prompt que requiere una escala diferente aún la anula. Requiere Claude Code v2.1.202 o posterior. Cada valor establece el recuento de agentes que Claude tiene como objetivo en los scripts que escribe. Los cambios surten efecto en el siguiente prompt. Los límites de agente del runtime aún se aplican independientemente de la configuración.

​
Desactivar workflows

Los workflows están disponibles en la CLI, la aplicación de escritorio, las extensiones del IDE, modo no interactivo con claude -p y el Agent SDK. La misma configuración de desactivación se aplica en cada superficie. Para desactivar workflows para usted:
  • Desactive Dynamic workflows en /config. Persiste entre sesiones.
  • Establezca "disableWorkflows": true en ~/.claude/settings.json. Persiste entre sesiones.
  • Establezca CLAUDE_CODE_DISABLE_WORKFLOWS=1. Se lee al inicio, por lo que se aplica dondequiera que lo establezca.
Para desactivar workflows para toda su organización, establezca "disableWorkflows": true en configuración administrada, o use el botón de alternancia en la página configuración de administrador de Claude Code. Cuando los workflows están desactivados, los comandos de workflow incluidos no están disponibles, la palabra clave ultracode ya no activa una ejecución, y ultracode se elimina del menú /effort.