Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Los dynamic workflows están en vista previa de investigación. 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 Vertex AI y Microsoft Foundry. En Pro, actívelos desde la fila Dynamic workflows en
/config.- Decidir cuándo usar un workflow en lugar de subagentes o skills
- Ejecutar un workflow incluido con
/deep-research - Hacer que Claude escriba un workflow para su tarea y guardarlo
- Entender cómo se ejecuta un workflow y gestionar ejecuciones
Cuándo usar un workflow
Los subagentes, los skills y los workflows pueden ejecutar una tarea de varios pasos. La diferencia es quién tiene el plan:| Subagentes | Skills | Workflows | |
|---|---|---|---|
| Qué es | Un Claude trabajador que genera | Instrucciones que Claude sigue | Un script que ejecuta el runtime |
| Quién decide qué se ejecuta a continuación | Claude, turno a turno | Claude, siguiendo el prompt | El script |
| Dónde viven los resultados intermedios | Ventana de contexto de Claude | Ventana de contexto de Claude | Variables del script |
| Qué es repetible | La definición del trabajador | Las instrucciones | La orquestación en sí |
| Escala | Algunas tareas delegadas por turno | Igual que los subagentes | Docenas a cientos de agentes por ejecución |
| Interrupción | Reinicia el turno | Reinicia el turno | Reanudable en la misma sesión |
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.
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.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.
Ver progreso
La ejecución comienza en segundo plano. Ejecute 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.
/workflows, use las teclas de flecha para seleccionar la ejecución y presione Enter para abrir su vista de progreso: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 |
/ 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.
| 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:- Pedir un workflow en su prompt con la palabra
workflow, y Claude escribe uno para la tarea. - Dejar que Claude decida con ultracode: establezca
/effort ultracodey Claude planifica un workflow para cada tarea sustancial en la sesión.
/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 palabraworkflow en cualquier lugar de su prompt.
alt+w para ignorarla en este prompt.
Dejar que Claude decida con ultracode
Ultracode es una configuración de Claude Code que combinaxhigh 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 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 |
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
/<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.
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. 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. Puede detener un workflow en ejecución desde/workflows en cualquier momento sin perder el trabajo completado.
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
/modelantes 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 conclaude -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": trueen~/.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.
"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 workflow ya no activa una ejecución, y ultracode se elimina del menú /effort.
Recursos relacionados
- Ejecutar agentes en paralelo: comparar subagentes, vista de agente, equipos de agentes y workflows
- Crear subagentes personalizados: la primitiva de trabajador que orquestan los workflows
- Gestionar costos: cómo las ejecuciones de múltiples agentes cuentan hacia los límites de uso