Saltar al contenido principal
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:
SubagentesSkillsEquipos de agentesWorkflows
Qué esUn Claude trabajador que generaInstrucciones que Claude sigueUn agente líder supervisando sesiones entre paresUn script que ejecuta el runtime
Quién decide qué se ejecuta a continuaciónClaude, turno a turnoClaude, siguiendo el promptEl agente líder, turno a turnoEl script
Dónde viven los resultados intermediosVentana de contexto de ClaudeVentana de contexto de ClaudeUna lista de tareas compartidaVariables del script
Qué es repetibleLa definición del trabajadorLas instruccionesLa definición del equipoLa orquestación en sí
EscalaAlgunas tareas delegadas por turnoIgual que los subagentesUn puñado de pares de larga duraciónDocenas a cientos de agentes por ejecución
InterrupciónReinicia el turnoReinicia el turnoLos compañeros de equipo siguen ejecutándoseReanudable en la misma sesión
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.
/deep-research What changed in the Node.js permission model between v20 and v22?
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:
/workflows
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:
ComandoQué hace
/deep-research <question>Distribuye búsquedas web en una pregunta en varios ángulos, obtiene y verifica cruzadamente las fuentes que encuentra, vota en cada afirmación y devuelve un informe citado con afirmaciones que no sobrevivieron la verificación cruzada filtradas. Requiere que la herramienta WebSearch esté disponible
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. 
/workflows
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:
ClaveAcción
↑ / ↓Seleccionar una fase o agente
Enter o →Profundizar en la fase seleccionada, luego en un agente para leer su prompt, llamadas de herramientas recientes y resultado
EscRetroceder un nivel
j / kDesplazarse dentro del detalle del agente cuando se desborda
fFiltrar la lista de agentes en la fase seleccionada por estado. Presione de nuevo para ciclar
pPausar o reanudar la ejecución
xDetener el agente seleccionado, o detener todo el workflow cuando el enfoque está en la ejecución
rReiniciar el agente en ejecución seleccionado
sGuardar el script de la ejecución como un comando

​
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. 
ultracode: audit every API endpoint under src/routes/ for missing auth checks
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. 
/effort ultracode
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:
Modo de permisoCuándo se le solicita
Predeterminado, aceptar edicionesCada ejecución, a menos que haya seleccionado Yes, and don’t ask again para ese workflow en este proyecto
AutoSolo en el primer lanzamiento. Cualquier Yes registra el consentimiento en su configuración de usuario, y los lanzamientos posteriores comienzan sin solicitar. Se omite completamente cuando ultracode está activado
Omitir permisos, claude -p, Agent SDKNunca. La ejecución comienza inmediatamente
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
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: 
> Run /triage-issues on issues 1024, 1025, and 1030
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. 
> use a workflow to audit every route handler under src/routes/ for missing authentication checks, and adversarially verify each finding before reporting it

​
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. 
> use a workflow to run npx tsc --noEmit and keep fixing the reported errors until the type check passes or two rounds in a row make no progress

​
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. 
> use a workflow to migrate every component under src/components/ from styled-components to Tailwind, working on each file in its own isolated copy

​
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. 
> use a workflow to review every file changed in this PR for correctness issues, then merge the per-file findings into one ranked summary

​
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. 
> use a workflow to research how our three competitors handle rate limiting: read their public docs and recent changelog entries in parallel, then compare the approaches

​
Encontrar problemas hasta que la lista deje de crecer

Siga buscando en rondas y deténgase cuando nuevas rondas no encuentren nada nuevo. 
> use a workflow to find flaky tests in this repo: run the suite repeatedly, record which tests fail intermittently, and stop once two rounds in a row find nothing new

​
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ó: 
export const meta = {
  name: 'audit-routes',
  description: 'Audit every route handler for missing auth checks',
}

const found = await agent('List every .ts file under src/routes/.', {
  schema: { type: 'object', required: ['files'], properties: { files: { type: 'array', items: { type: 'string' } } } },
})

const audits = await pipeline(found.files, file =>
  agent(`Audit ${file} for missing authentication checks.`, { label: file }),
)

return audits.filter(Boolean)
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:
RestricciónPor qué
Sin entrada de usuario a mitad de ejecuciónSolo los prompts de permiso del agente pueden pausar una ejecución. Para la aprobación entre etapas, ejecute cada etapa como su propio workflow
Sin acceso directo al sistema de archivos o shell desde el workflow en síLos agentes leen, escriben y ejecutan comandos. El script coordina los agentes
Hasta 16 agentes concurrentes, menos en máquinas con núcleos de CPU limitadosLimita el uso de recursos locales
1.000 agentes totales por ejecuciónPreviene bucles descontrolados

​
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. 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. 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.
ValorOrientación enviada a Claude
unrestrictedSin directriz. Este es el valor predeterminado.
smallApunte a menos de 5 agentes.
mediumApunte a menos de 15 agentes.
largeApunte a menos de 50 agentes.
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.