El comando /loop de Claude Code: cómo usarlo para flujos de programación más inteligentes en 2026

Si has usado Claude Code en más de unas pocas sesiones, probablemente te habrás encontrado con un momento en el que deseabas que la IA simplemente siguiera adelante (vigilando una compilación, comprobando un cambio, volviendo a ejecutar algo cada pocos minutos) sin tener que estar pendiente de ella. Para eso sirve exactamente /loop.

Esta guía explica cómo funciona /loop, cuándo tiene sentido usarlo y cómo integrarlo en flujos de desarrollo reales: desde vigilar ejecuciones de CI hasta hacer refactorizaciones iterativas en una base de código grande.

¿Qué es /loop en Claude Code?

/loop es un comando de barra integrado en Claude Code que le indica al agente que repita una tarea con una periodicidad, o que marque su propio ritmo de iteraciones, en lugar de detenerse tras un turno. Está pensado para situaciones en las que necesitas que algo ocurra de forma repetida: comprobar un estado, continuar una refactorización larga, consultar un sistema externo o esperar a que se cumpla una condición.

En su forma más sencilla, el comando tiene este aspecto:

/loop <interval_in_seconds> <your prompt here>

Por ejemplo, para comprobar el estado de una ejecución de CI cada 60 segundos:

/loop 60 Check if the GitHub Actions workflow has finished. Report the status and stop looping if it passed or failed.

Claude volverá a ejecutar ese prompt cada 60 segundos, usando todas sus herramientas disponibles (Bash, lectura de archivos, consultas web), hasta que se resuelva la condición o lo interrumpas.

Los dos modos: intervalo fijo frente a ritmo propio

Hay dos formas de usar /loop, y entender la diferencia importa a la hora de redactar tus prompts.

Bucle de intervalo fijo

Pasa un número de segundos como primer argumento. Claude se despierta con ese intervalo, ejecuta tu prompt y vuelve a dormir. Es el modo adecuado para consultar sistemas externos (pipelines de CI, estados de despliegue, endpoints de salud de una API), donde hay un reloj del mundo real que marca cuándo cambian las cosas.

/loop 120 Run npm test and report which tests are failing. Stop if all tests pass.

Bucle de ritmo propio (dinámico)

Omite el intervalo y Claude decide su propia cadencia según el contexto: cuánto trabajo queda, cuánto tarda cada iteración y qué tiene sentido para la tarea. Es útil para trabajo agéntico abierto en el que quieres que Claude siga adelante sin un reloj fijo; por ejemplo, refactorizar una lista de archivos uno por uno o avanzar por una lista de incidencias pendientes.

/loop Go through each file in src/components/ and add missing TypeScript types. Work through them one at a time, commit after each file, and stop when all are done.

5 escenarios reales de desarrollo en los que /loop brilla

1. Vigilar una ejecución de CI

Subes una rama y necesitas saber cuándo termina el pipeline, sin cambiar de ventana a GitHub cada cinco minutos. Configura un bucle con un intervalo razonable (las ejecuciones de CI rara vez cambian más rápido que cada 2–3 minutos) y haz que Claude informe del resultado y se detenga automáticamente.

/loop 90 Run: gh run list --branch my-feature --limit 1 --json status,conclusion,url
Report the status. If conclusion is "success" or "failure", report the full result and stop looping.

2. Refactorización iterativa en una base de código grande

Cuando tienes 40 archivos que necesitan el mismo tratamiento (añadir tipos a las props, migrar a una API nueva, renombrar una constante), hacerlo a mano es tedioso. Con un bucle de ritmo propio, Claude recorre la lista en orden, hace un commit tras cada archivo e informa del progreso para que puedas retomarlo si algo sale mal.

/loop Find all .tsx files that still use the old useAuth hook from @/hooks/auth-v1.
Migrate them one at a time to the new useSession hook from @/hooks/session.
Run TypeScript after each file to confirm no errors, then commit. Stop when none remain.

3. Vigilar un despliegue

Los despliegues a producción pueden tardar entre 5 y 15 minutos y tienen la costumbre de fallar de formas evidentes si estás mirando, pero fáciles de pasar por alto si te alejas. Pon a Claude en bucle contra tu endpoint de salud o la CLI de despliegue mientras vas a por un café.

/loop 60 Run: curl -s https://myapp.example.com/api/health | jq '.status'
If status is "ok", tell me the deploy succeeded and stop.
If you see errors three times in a row, stop and show me the last response.

4. Arreglar pruebas de forma progresiva

Tienes una batería de pruebas que fallan y quieres que Claude las arregle poco a poco, un fallo cada vez, en lugar de intentar arreglarlo todo de golpe y crear un lío de cambios contradictorios.

/loop Run the test suite with: npm test -- --bail 1
Pick the first failing test, read the error, fix it, and run again.
Commit after each passing test. Stop when the full suite is green.

5. Esperar a un cambio en un archivo o un registro

Durante el desarrollo a veces quieres saber cuándo aparece una entrada concreta en un registro, cuándo termina de escribirse un archivo de datos iniciales o cuándo se genera un artefacto de compilación, sin montar un script real de vigilancia de archivos.

/loop 30 Check if the file dist/bundle.js exists and is larger than 10kb.
If yes, run a quick size report (ls -lh dist/) and stop looping.
If not, tell me it is not ready yet.

Cómo encaja /loop en un flujo de trabajo agéntico

/loop no es magia: es una capa de programación temporal sobre la misma sesión de Claude. Cada iteración tiene acceso completo a los archivos de tu proyecto, a los comandos de bash y a las herramientas web. La idea clave de arquitectura es que Claude también hereda el contexto de las iteraciones anteriores dentro del mismo bucle: recuerda lo que encontró la última vez, qué archivos ya procesó y cuál es el estado actual.

Eso hace que los bucles se puedan combinar con otros patrones de Claude Code:

• Con CLAUDE.md: las reglas de tu archivo CLAUDE.md se aplican automáticamente en cada iteración del bucle. Si has definido convenciones de commits o restricciones de archivos, se mantienen.
• Con subagentes: puedes pedirle a Claude que lance subagentes dentro de un bucle para trabajar en paralelo; por ejemplo, procesar varios archivos a la vez en cada iteración.
• Con hooks: los hooks de Claude Code se disparan en cada llamada a una herramienta, así que las comprobaciones de seguridad a nivel de herramienta se aplican dentro de los bucles igual que en las sesiones normales.

El calentamiento de la caché y por qué importa el intervalo

Hay una consideración práctica de rendimiento que cambia cómo eliges el intervalo: la caché de prompts de Anthropic tiene un TTL de 5 minutos. Si tu bucle duerme más de 5 minutos (300 segundos), el siguiente despertar lee todo el contexto de la conversación sin caché, lo que es más lento y consume más tokens.

Un modelo mental útil para elegir intervalos:

• 60–270 segundos: la caché se mantiene caliente. Adecuado para consultar ejecuciones de CI, endpoints de salud o cualquier estado externo que cambie rápido.
• 300+ segundos: fallo de caché en cada despertar. Solo compensa si aquello que esperas tarda de verdad tanto en cambiar. Un despliegue que tarda 12 minutos merece dos esperas de 270 s, no 12 consultas de un minuto.
• Evita exactamente 300 s: es lo peor de ambos mundos; pagas el fallo de caché sin conseguir una espera significativamente más larga.

Cuándo NO usar /loop

/loop es una herramienta potente y tiene los modos de fallo de las herramientas potentes. Algunas cosas a vigilar:

• Bucles infinitos sin condición de salida: dile siempre a Claude de forma explícita cuándo parar. «Para cuando pasen las pruebas» o «Para si ves tres fallos seguidos»; sin una condición, un bucle seguirá hasta que se llene el contexto de la sesión.
• Operaciones destructivas: los bucles que modifican archivos o suben commits amplifican los errores. Pide a Claude que te muestre primero una simulación, o limita el trabajo a una unidad por iteración con un punto de confirmación manual.
• Trabajo en segundo plano que el harness ya puede seguir: si lanzas una tarea en segundo plano con la herramienta Agent, Claude Code recibe un aviso automático cuando termina; no hace falta un bucle de consulta. Usa /loop solo para sistemas externos que el harness no puede observar.
• Tareas que necesitan tu intervención entre pasos: si necesitas revisar y aprobar cambios antes de que se ejecute la siguiente iteración, un bucle es la estructura equivocada. Usa en su lugar una conversación normal con seguimientos manuales.

Escribir buenos prompts de bucle

La calidad de tu bucle depende casi por completo de la precisión con la que describas la condición de parada y la acción de cada iteración. Un prompt de bucle débil produce un agente que hace algo cada N segundos hasta que lo interrumpes. Un prompt de bucle fuerte produce un agente que resuelve el problema y se aparta.

La foto completa: patrones de desarrollo autónomo

/loop es una pieza de un cambio más amplio en la forma de escribir software en 2026. El modelo mental está pasando de «yo escribo código y la IA me ayuda» a «la IA trabaja y yo reviso y dirijo». Los bucles hacen posible la versión de horizonte más largo de esa idea: en lugar de dirigir a Claude en cada paso, describes el resultado y dejas que itere hacia él de forma autónoma.

Esto solo funciona de forma segura si incorporas puntos de control: condiciones de parada explícitas, commits por iteración e informes de progreso que te den visibilidad sin obligarte a estar encima. Los fundadores y desarrolladores que más partido sacan a la IA agéntica no son los que dan las instrucciones más detalladas. Son los que escriben condiciones de salida precisas y confían en que la IA rellene lo de en medio.

El uso correcto de /loop no es automatizarlo todo. Es automatizar las esperas aburridas y las pasadas repetitivas, para que tu atención se quede en las partes que de verdad necesitan a una persona en el bucle.

Para empezar rápido: prueba /loop 60 Run npm test. Report how many tests pass and fail. Stop when the full suite passes. en un proyecto con una prueba inestable. Observa cómo Claude la diagnostica y la arregla sin que tengas que escribir otro prompt.

Related Posts

Claude Code en el desarrollo: la herramienta de programación con IA más potente de 202624 de junio de 2026

Por qué la IA es difícil: los problemas reales con los que chocan los fundadores cuando la demo ya funciona1 de julio de 2026

Small Language Models (SLMs): Why Smaller AI Is Winning in 2026June 23, 2026