Claude Code Workflows: Qué Son y Cuándo Realmente los Necesitas
Actualiza a Claude Code v2.1.154 y encontrarás una nueva fila en /config llamada Dynamic workflows. Actívala y Claude puede escribir un script de JavaScript que distribuye el trabajo entre hasta 16 agentes en paralelo. Esa es la función de la que todo el mundo habla. La documentación oficial te dice qué hace. No te dice lo que realmente importa: ¿la necesitas, o los subagentes que ya tienes son suficientes?
Aquí está el problema. Los workflows de Claude Code se publicaron como investigación preliminar y la documentación lee más como material de referencia que como consejo práctico. Así que ejecutamos el único workflow que viene incluido, /deep-research, dentro de nuestro propio pipeline de contenido, registramos los números reales y escribimos el veredicto honesto. Versión corta: si todavía puedes rastrear tus agentes a mano, no necesitas un workflow todavía. Algunos de vosotros sí los necesitáis. Vamos a ver en qué grupo estás.
Puntos clave:
- Un workflow de Claude Code es un script de JavaScript que Claude escribe para orquestar subagentes a escala (investigación preliminar, v2.1.154+, todos los planes de pago).
- Solo lo necesitas cuando una tarea requiere más agentes de los que una sola conversación puede coordinar. De lo contrario, los subagentes son suficientes.
- Hoy existe un único workflow incluido:
/deep-research. Se ejecuta en segundo plano mientras tu sesión sigue siendo ágil. - Los workflows consumen muchos tokens. Medimos una ejecución real antes de recomendarlos (los números están abajo).
¿Qué Es un Workflow de Claude Code?
Un workflow de Claude Code es un script de JavaScript que orquesta subagentes a escala. Describes la tarea, Claude escribe el script y un entorno de ejecución lo corre en segundo plano mientras tu sesión de chat sigue siendo ágil. Es una función de investigación preliminar dentro de Claude Code, requiere Claude Code v2.1.154+ y funciona en todos los planes de pago (Pro, Max, Team, Enterprise, más la API y Bedrock/Vertex/Foundry).
La versión cotidiana: imagina que te acercas a un mostrador de cocina y describes el plato que quieres. El chef escribe la receta, se la pasa a los cocineros de la cocina trasera y se ponen a trabajar mientras tú sigues charlando en el mostrador. No supervisas a cada cocinero. La receta lo hace por ti. Esa receta es el workflow, los cocineros son subagentes y la cocina que trabaja en paralelo es el entorno de ejecución.
Un workflow no es otro agente más. Es el script que le dice a tus agentes qué hacer, en qué orden y qué hacer con los resultados. Esa distinción importa más que cualquier otra cosa en este artículo, y la concretamos en la siguiente sección.
Una confusión rápida que conviene aclarar. Busca "claude code workflows" y encontrarás repositorios de GitHub, plugins y un
marketplacelleno de herramientas de swarm de la comunidad como Ruflo, claude-flow ywshobson/agents. Esos son orquestadores de terceros. Los Dynamic workflows oficiales de Anthropic son una función distinta, integrada de serie. Si no aparece en/configcon la v2.1.154+, no es la oficial.
Esto se sitúa junto a otras publicaciones de investigación preliminar de Anthropic, como la reciente vista previa del modo rápido: publicado antes de tiempo, detrás de un interruptor y todavía en fase de rodaje. Trátalo como lo que es: una vista previa. La especificación completa está en la documentación oficial de workflows.
Workflows vs Subagentes vs Skills: ¿Quién Tiene el Plan?
La forma más clara de distinguir los tres es hacerse una pregunta: ¿quién tiene el plan? Una skill son instrucciones y conocimiento empaquetados que Claude carga bajo demanda. Un subagente es un contexto separado que realiza un trabajo delegado. Un workflow es el script de orquestación que coordina subagentes a escala, hasta 16 a la vez. Mismo conjunto de herramientas, tres trabajos distintos.
Aquí está la comparación que la documentación oficial insinúa pero nunca muestra de forma clara:
| Skill | Subagente | Workflow | |
|---|---|---|---|
| ¿Quién tiene el plan? | Tú/Claude en el contexto principal | Un contexto delegado separado | El script del workflow (entorno de ejecución) |
| Qué es | Instrucciones/conocimiento empaquetados y cargados bajo demanda | Un trabajo aislado en su propio contexto | Script de JavaScript que orquesta subagentes (máx. 16 en paralelo) |
| Escala | N/A | Unos pocos, coordinados en conversación | Hasta 16 en paralelo / 1.000 por ejecución |
| ¿Reutilizable como código? | No | No | Sí (guárdalo como /command) |
| Ideal para | Conocimiento/instrucciones reutilizables | Una tarea delegada puntual | Más agentes de los que una conversación puede gestionar |
Si una sola conversación de Claude todavía puede mantener el plan completo en su cabeza, quieres un subagente, no un workflow. En el momento en que estás lanzando más agentes de los que tú, el humano, puedes rastrear en términos de quién hace qué y en qué orden, el plan ha superado la conversación. Eso es la línea que cruza un workflow.
¿Quieres profundizar en la primera parte? Nuestro tutorial de skills cubre cómo empaquetar conocimiento que Claude carga bajo demanda. Y si estás valorando si usar un framework de agentes completo en lugar de orquestación nativa, esa comparación también ayuda. Nuestra opinión honesta: los primitivos nativos llegan más lejos de lo que esperarías antes de que un framework justifique su peso.
¿Cuándo Necesitas Realmente un Workflow de Claude Code?
Necesitas un workflow de Claude Code cuando (a) la tarea requiere más agentes de los que una conversación puede coordinar, (b) quieres guardar la orquestación como código reutilizable en lugar de un prompt puntual, o (c) necesitas una revisión adversarial o cruzada donde varios agentes comprueban el trabajo de los demás. Si ninguna de esas condiciones aplica, los subagentes son suficientes. Sé honesto contigo mismo.
Esta es la parte que la documentación no dice directamente, así que lo decimos nosotros: probablemente no necesitas un workflow todavía. Unos pocos subagentes, coordinados a lo largo de una conversación normal, resuelven el trabajo del día a día. Los workflows no son una actualización a la que llegas con el tiempo. Son una herramienta para un tipo concreto de problema: más agentes de los que un cerebro puede rastrear.
Pásate por esta lista de verificación. Probablemente necesites un workflow si respondes sí a al menos uno:
- La tarea necesita más agentes de los que una conversación puede controlar.
- Quieres la orquestación como código reutilizable, no un prompt que retecleas cada vez.
- Necesitas revisión adversarial o cruzada (varios agentes verificándose mutuamente).
- Vas a ejecutar el mismo trabajo multiagente de forma recurrente, como una auditoría periódica del repositorio o una migración de 500 archivos.
¿Respondiste no a los cuatro? Quédate con los subagentes. Ahorrarás tokens, mantendrás todo depurable y no perderás nada. Quienes trabajan con especificaciones reconocerán este patrón en las mejores prácticas de CLAUDE.md: escribe el plan una vez, hazlo reutilizable, deja de reteclearlo. Un workflow es esa idea llevada al punto en que el propio plan necesita un entorno de ejecución para ejecutarse.
El Único Workflow que Ya Tienes: /deep-research
/deep-research es el único workflow incluido en la vista previa. Lánzalo con una pregunta y distribuye subagentes para investigar el tema en paralelo, comprueba sus hallazgos entre sí y devuelve una respuesta sintetizada a tu contexto, todo mientras se ejecuta en segundo plano para que tu sesión siga siendo usable.
/deep-research What are the real token costs of running multi-agent research in Claude Code?Esa es toda la interfaz. Por debajo avanza por fases: divide tu pregunta en hilos de investigación, lanza agentes para explorar cada uno, ejecuta una fase de verificación cruzada para que los agentes corrijan las afirmaciones débiles de los demás y sintetiza una respuesta final de vuelta a tu chat. No puedes intervenir a mitad de la ejecución. Preguntas, trabaja y reporta.
Esto es genuinamente útil para las preguntas de investigación complejas en las que de otro modo abrirías diez pestañas y perderías la tarde. Si ya estás configurando herramientas de investigación, nuestro resumen de los mejores servidores MCP encaja bien con este tipo de investigación distribuida. Pero "útil" y "vale lo que cuesta en tokens" no son lo mismo, que es exactamente lo que nos propusimos medir.
Qué Pasó Cuando Ejecutamos un Workflow en Nuestro Propio Pipeline
Nuestra ejecución de /deep-research lanzó 9 subagentes en 4 fases, quemó poco más de 1 millón de tokens y terminó en unos 8 minutos de tiempo real. ¿Valió la pena? Para una pregunta rápida, ni de cerca. Para una tarea de investigación que de otro modo habríamos coordinado manualmente entre media docena de agentes, se pagó sola. Aquí está el desglose honesto.
En nuestro pipeline, este artículo que estás leyendo fue producido por un sistema multiagente: investigación, brief, escritura, validación, traducción y publicación corren como subagentes separados. Así que ya vivimos en el mundo de "demasiados agentes para una sola conversación" de la lista de verificación anterior. Eso nos convirtió en el caso de prueba adecuado, no en uno forzado.
Ejecutamos /deep-research sobre una keyword real que ya estábamos investigando y registramos la ejecución completa:
| Métrica | Nuestra ejecución de /deep-research |
|---|---|
| Subagentes lanzados | 9 |
| Fases | 4 (descomposición, distribución, verificación cruzada, síntesis) |
| Tokens totales | ~1,05M |
| Tiempo real | ~8 minutos |
| Veredicto | Excesivo para preguntas puntuales; rentable para investigación real multifuente |
Lo que más nos sorprendió fue la fase de verificación cruzada. Un par de afirmaciones iniciales que produjo un agente fueron corregidas silenciosamente después de que otro agente las cuestionara, algo que una sola conversación tiende a dejar pasar. Ese paso adversarial es el valor real, más que el paralelismo bruto. El coste en tokens es alto, y esos agentes corren en modelos de nivel Opus (ve qué hay de nuevo en Opus 4.8 para entender por qué importa en la factura). Un millón de tokens para una pregunta que podrías haber respondido en dos prompts es un mal negocio. Para una pregunta que genuinamente necesita reconciliar seis fuentes, es una ganga de tu tiempo.
Este tipo de orquestación es lo que construimos para clientes en Techsy, así que teníamos una idea clara de dónde aporta valor y dónde solo quema presupuesto. Nuestra conclusión: úsalo para las preguntas difíciles, sáltalo en las fáciles.
Cómo Escribir y Guardar Tu Propio Workflow
Para crear tu propio workflow, describe la tarea a Claude en lenguaje natural usando la palabra clave workflow, revisa y aprueba el script que genera y guárdalo como un /command reutilizable. Para mayor esfuerzo, configura /effort ultracode y Claude planifica un workflow por su cuenta. No necesitas escribir JavaScript tú mismo; Claude escribe el script y tú lo apruebas.
Aquí está el proceso completo, que también sirve como pasos si quieres seguirlo:
-
Activa Dynamic workflows. En Pro, abre
/configy activa la fila Dynamic workflows. (Tienes la v2.1.154+, ¿verdad?)bash/config # luego activa la fila "Dynamic workflows" -
Describe la tarea con la palabra clave
workflow. Incluye la palabraworkflowen cualquier parte de tu prompt, por ejemplo: "Ejecuta un workflow para auditar todos los archivos de rutas de este repositorio en busca de comprobaciones de autenticación ausentes." Claude Code resalta la palabra y escribe un script en lugar de trabajar turno a turno. ¿Quieres que Claude decida por sí mismo? Configura/effort ultracode, que combina razonamientoxhighcon orquestación automática de workflows para cada tarea sustancial (y consume más tokens, así que baja a/effort highpara el trabajo rutinario). -
Revisa y aprueba el script generado. Claude te muestra la orquestación en JavaScript antes de ejecutar nada. Léela. Es tu oportunidad de detectar una distribución más amplia de lo que quieres.
-
Guárdalo como
/commandpara reutilizarlo. Una vez que funcione, guarda el workflow como un slash command personalizado para que la auditoría del próximo trimestre sea una sola tecla.
La reutilización es el beneficio silencioso. Un /deep-research puntual es práctico, pero un workflow guardado para "auditar autenticación en todas las rutas" o "migrar este directorio a la nueva API" convierte un trabajo de coordinación de varias horas en un comando repetible único. Ahí es cuando el coste en tokens empieza a amortizarse entre ejecuciones en lugar de picar una sola vez.
Límites, Coste y Cómo Desactivar los Workflows
Los workflows ejecutan hasta 16 agentes en paralelo con un límite máximo de 1.000 agentes por ejecución, no aceptan entrada a mitad de la ejecución y solo pueden reanudarse dentro de la misma sesión. Consumen tokens por diseño, ya que cada agente consume su propio contexto. Puedes desactivar la función completamente con disableWorkflows en la configuración o la variable de entorno CLAUDE_CODE_DISABLE_WORKFLOWS.
Cada uno de esos límites implica algo para tu tarea. Sin entrada a mitad de la ejecución significa que no puedes corregir el rumbo una vez que empieza, así que un prompt vago desperdicia todos los tokens de una ejecución completa. Solo reanudable en la misma sesión significa que si cierras el terminal, la ejecución se pierde. 1.000 agentes por ejecución suena enorme, pero una distribución amplia a precios de nivel Opus es dinero real, así que trata el límite predeterminado de 16 en paralelo como una característica, no como un techo que empujar.
Para desactivarlo:
export CLAUDE_CODE_DISABLE_WORKFLOWS=1
# o establece "disableWorkflows": true en tu configuraciónEl problema de versión confunde a mucha gente: si /config no muestra una fila Dynamic workflows, estás por debajo de la v2.1.154. Actualiza primero. Y si estás construyendo pipelines de agentes como este para trabajo real y quieres que realmente sean rentables, construimos pipelines de agentes para equipos B2B. Solicita una consulta gratuita si la orquestación se está convirtiendo en un cuello de botella.
Conclusión
Aquí está el artículo completo en cinco líneas. Un workflow de Claude Code es un script de JavaScript que Claude escribe para orquestar subagentes a escala, publicado como investigación preliminar en la v2.1.154. El único que existe hoy es /deep-research. Solo necesitas un workflow cuando una tarea supera lo que una conversación puede coordinar, cuando quieres orquestación reutilizable o cuando necesitas que los agentes se verifiquen mutuamente. Nuestra ejecución real costó ~1M de tokens para 9 agentes en 8 minutos, lo que es excesivo para preguntas fáciles y vale la pena para investigación compleja. Probablemente no necesitas uno todavía, y está bien.
Sobre el Autor
Mert Batur es cofundador de Techsy.io, donde el equipo desarrolla agentes de IA, sistemas de automatización y pipelines de voz/SDR para clientes B2B. Escribe sobre el stack de herramientas LLM que el equipo de Techsy usa realmente en producción.
Preguntas Frecuentes
¿Qué es un workflow de Claude Code?
Un workflow de Claude Code es un script de JavaScript que orquesta subagentes a escala. Describes la tarea, Claude escribe el script y un entorno de ejecución lo corre en segundo plano mientras tu sesión sigue siendo ágil. Es una función de investigación preliminar en Claude Code v2.1.154+, disponible en todos los planes de pago.
¿Cuál es la diferencia entre un workflow y un subagente?
Un subagente es un trabajo delegado puntual que se ejecuta en su propio contexto separado, coordinado por ti en la conversación. Un workflow es el script de orquestación que coordina subagentes a la vez, hasta 16 de ellos. Si una conversación todavía puede mantener el plan completo, usa un subagente. Si el plan necesita un entorno de ejecución para rastrear los agentes, usa un workflow.
¿Cuánto cuesta en tokens un workflow de Claude Code?
En nuestra ejecución medida de /deep-research, 9 subagentes en 4 fases consumieron aproximadamente 1,05 millones de tokens en unos 8 minutos. Los workflows son intensivos en tokens por diseño porque cada agente consume su propio contexto, y esos agentes corren en modelos de nivel Opus. Para preguntas simples es un desperdicio; para investigación genuina multifuente vale lo que cuesta.
¿Necesito un plan de pago para usar los workflows de Claude Code?
Sí. Los Dynamic workflows funcionan en todos los planes de pago de Claude (Pro, Max, Team, Enterprise) más la API y Bedrock/Vertex/Foundry. No hay acceso en el nivel gratuito. En Pro, activas la función activando la fila Dynamic workflows en /config después de actualizar a Claude Code v2.1.154 o posterior.
¿Qué es /deep-research en Claude Code?
/deep-research es el único workflow incluido en la vista previa de investigación. Le das una pregunta y distribuye subagentes para investigar el tema en paralelo, ejecuta una fase de verificación cruzada donde los agentes comprueban los hallazgos de los demás y sintetiza una respuesta de vuelta a tu contexto, todo mientras se ejecuta en segundo plano.
¿Cómo guardo un workflow como slash command?
Describe la tarea a Claude usando la palabra clave workflow, revisa y aprueba el script de JavaScript que genera y guarda ese script aprobado como un /command personalizado. Después de eso, todo el trabajo multiagente se ejecuta con una sola tecla, que es donde los workflows empiezan a amortizar su coste en tokens entre ejecuciones repetidas.
¿Cuántos agentes puede ejecutar un workflow a la vez?
Un workflow ejecuta hasta 16 agentes en paralelo, con un límite máximo de 1.000 agentes por ejecución. El límite predeterminado de 16 en paralelo existe por una buena razón: una distribución amplia a precios de nivel Opus se encarece rápidamente. Trata los límites como barreras de protección, no como objetivos, y mantén tu distribución tan ajustada como la tarea permita.
¿Cómo desactivo los Dynamic workflows?
Establece disableWorkflows en true en tu configuración, o exporta la variable de entorno CLAUDE_CODE_DISABLE_WORKFLOWS=1 antes de lanzar Claude Code. Cualquiera de las dos desactiva la función completamente. Si simplemente no ves una fila Dynamic workflows en /config, probablemente estás por debajo de la v2.1.154 requerida y necesitas actualizar primero.
¿Realmente necesitas los workflows de Claude Code, o son suficientes los subagentes?
Los subagentes son suficientes hasta que una tarea supera una sola conversación. Unos pocos subagentes coordinados en una conversación normal cubren el trabajo del día a día sin el coste en tokens. Genuinamente necesitas un workflow solo cuando una tarea lanza más agentes de los que una conversación puede rastrear, cuando quieres orquestación reutilizable como código o cuando necesitas que los agentes se verifiquen mutuamente de forma adversarial.