SpyBara
Go Premium

workflows.md 2026-06-09 06:34 UTC to 2026-06-10 23:57 UTC

289 added, 0 removed.

2026
Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

Orquestar subagentes a escala con flujos de trabajo dinámicos

Los dynamic workflows orquestan muchos subagentes a partir de un script que Claude escribe y que puede volver a ejecutar. Úselos para auditorías de base de código, migraciones grandes e investigación con verificación cruzada.

{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}

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.

Esta página cubre cómo:

Cuándo usar un workflow

Los subagentes, los skills, los equipos de agentes y los workflows pueden ejecutar una tarea de varios pasos. La diferencia es quién tiene el plan:

Subagentes Skills Equipos de agentes Workflows
Qué es Un Claude trabajador que genera Instrucciones que Claude sigue Un agente líder supervisando sesiones entre pares Un script que ejecuta el runtime
Quién decide qué se ejecuta a continuación Claude, turno a turno Claude, siguiendo el prompt El agente líder, turno a turno El script
Dónde viven los resultados intermedios Ventana de contexto de Claude Ventana de contexto de Claude Una lista de tareas compartida Variables del script
Qué es repetible La definición del trabajador Las instrucciones La definición del equipo La orquestación en sí
Escala Algunas tareas delegadas por turno Igual que los subagentes Un puñado de pares de larga duración Docenas a cientos de agentes por ejecución
Interrupción Reinicia el turno Reinicia el turno Los compañeros de equipo siguen ejecutándose Reanudable 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 redactar un plan desde varios ángulos y sopesarlos 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.

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:

Comando Qué 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:

Clave Acció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
Esc Retroceder un nivel
j / k Desplazarse dentro del detalle del agente cuando se desborda
p Pausar o reanudar la ejecución
x Detener el agente seleccionado, o detener todo el workflow cuando el enfoque está en la ejecución
r Reiniciar el agente en ejecución seleccionado
s Guardar 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.

Si la ejecución hace lo que deseaba, puede guardarla como un comando después.

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

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 permiso Cuándo se le solicita
Predeterminado, aceptar ediciones Cada ejecución, a menos que haya seleccionado Yes, and don't ask again para ese workflow en este proyecto
Auto Solo 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 SDK Nunca. 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.

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.

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ón Por qué
Sin entrada de usuario a mitad de ejecución Solo 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 limitados Limita el uso de recursos locales
1.000 agentes totales por ejecución Previene 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.

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

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.