≡En resumen
- /loop repite un prompt o una skill mientras la sesión de Claude Code sigue abierta.
- Con intervalo («/loop 5m …») se ejecuta con un horario fijo; sin intervalo, Claude elige la espera entre 1 minuto y 1 hora.
- Un /loop sin prompt ejecuta una tarea de mantenimiento o el contenido de tu archivo loop.md.
- Las tareas recurrentes caducan a los 7 días y no se ejecutan con la sesión cerrada.
- Para tareas que deben correr sin tu ordenador, usa rutinas en la nube o GitHub Actions.
01 ¿Qué es el comando /loop de Claude Code?
Muchas tareas de desarrollo consisten en esperar y comprobar: ¿ha terminado el despliegue?, ¿ha pasado la integración continua?, ¿hay comentarios nuevos en la revisión? /loop automatiza ese ir y venir. Es una skill incluida en Claude Code que vuelve a lanzar un prompt de forma periódica, sin que tengas que escribirlo cada vez.
Por dentro, /loop crea tareas programadas con expresiones cron dentro de la sesión. Cada vez que toca, el prompt se ejecuta entre tus turnos, nunca en mitad de una respuesta de Claude: si está ocupado, espera a que termine.
02 Sintaxis de /loop y sus tres modos
Tanto el intervalo como el prompt son opcionales. Lo que escribas determina cómo se comporta el bucle.
| Qué escribes | Ejemplo | Qué ocurre |
|---|---|---|
| Intervalo y prompt | /loop 5m revisa el despliegue | El prompt se ejecuta con un horario fijo |
| Solo prompt | /loop revisa si pasó la CI y atiende los comentarios | Claude elige la espera tras cada iteración, entre 1 minuto y 1 hora |
| Solo intervalo o nada | /loop o /loop 15m | Se ejecuta el prompt de mantenimiento incluido o tu archivo loop.md |
| Una skill como prompt | /loop 20m /review-pr 1234 | Se repite esa skill en cada iteración |
03 Ritmo automático, prompt de mantenimiento y loop.md
Ritmo que decide Claude
Sin intervalo, Claude espera poco mientras algo está en marcha y más cuando no hay novedades. Al final de cada iteración muestra la espera elegida y el motivo.
Prompt de mantenimiento
Un /loop sin prompt continúa el trabajo pendiente, atiende el pull request de la rama actual (comentarios, CI fallida, conflictos) y, si no hay nada, hace pasadas de limpieza.
Sin iniciativas nuevas
En modo mantenimiento Claude no empieza trabajos fuera de ese alcance, y las acciones irreversibles solo siguen si continúan algo ya autorizado.
Tu propio loop.md
Un archivo .claude/loop.md (proyecto) o ~/.claude/loop.md (usuario) sustituye el prompt de mantenimiento. Los cambios se aplican en la siguiente iteración.
04 Cómo ver, cancelar y parar un /loop
-
1
Lista las tareas
Pregunta en lenguaje natural «¿qué tareas programadas tengo?». Claude usa la herramienta CronList y te muestra identificadores, horarios y prompts.
-
2
Cancela una tarea
Pide «cancela la comprobación del despliegue». Claude usa CronDelete con el identificador de 8 caracteres de la tarea.
-
3
Para un bucle con ritmo automático
Pulsa Esc mientras espera la siguiente iteración. Claude también puede terminarlo solo cuando la tarea está completa.
-
4
Recordatorios de una sola vez
No necesitas /loop: escribe «recuérdame a las 15:00 subir la rama» y se crea una tarea única que se borra al ejecutarse.
-
5
Desactiva el programador
La variable de entorno CLAUDE_CODE_DISABLE_CRON=1 desactiva /loop y las herramientas de cron por completo.
Las horas se interpretan en tu zona horaria local. Para no saturar la API, Claude Code desplaza ligeramente la hora real de cada ejecución; el caso especial es el bucle de cada cinco minutos, que se adelanta unos segundos para aprovechar la caché de prompts de cinco minutos antes de que caduque.
05 Limitaciones de /loop que debes conocer
- ✓Solo se ejecuta mientras Claude Code está abierto y libre; si cierras la sesión, se detiene.
- ✓No recupera ejecuciones perdidas: si Claude estaba ocupado, se ejecuta una sola vez al quedar libre.
- ✓Las tareas recurrentes caducan a los 7 días: se ejecutan una última vez y se borran.
- ✓Al reanudar con --resume o --continue se restauran las tareas con horario, pero no los bucles de ritmo automático.
- ✓Una sesión admite como máximo 50 tareas programadas a la vez.
- ✓Los comandos integrados como /clear o /model no se ejecutan desde un bucle: llegan a Claude como texto.
06 /loop frente a rutinas, tareas de Desktop y GitHub Actions
/loop es la opción rápida para vigilar algo durante una sesión. Si la tarea debe funcionar con el ordenador apagado, necesitas otra herramienta: las rutinas programadas de Claude en la nube o un flujo con Claude Code en GitHub Actions. En los proyectos de desarrollo web a medida solemos combinar las tres: /loop mientras se trabaja, rutinas para lo periódico y Actions para lo que depende del repositorio.
| /loop | Tareas de Desktop | Rutinas en la nube | |
|---|---|---|---|
| Dónde se ejecuta | Tu equipo | Tu equipo | Nube de Anthropic |
| Necesita el equipo encendido | Sí | Sí | No |
| Necesita una sesión abierta | Sí | No | No |
| Sobrevive a reinicios | Solo al reanudar la sesión, con excepciones | Sí | Sí |
| Acceso a archivos locales | Sí | Sí | No (clona el repositorio) |
| Intervalo mínimo | 1 minuto | 1 minuto | 1 hora |
07 Ejemplos prácticos de /loop
/loop revisa si la CI ha pasado y responde a los comentarios de revisión. Mientras la integración continua corre, Claude comprueba cada pocos minutos; cuando el pull request se queda en silencio, espacia las comprobaciones. Si un test falla, lee el log, propone el arreglo y lo sube según los permisos de tu sesión.
Despliegues
Comprobar cada 5 minutos si un despliegue ha terminado y resumir los errores si falla.
Builds largos
Esperar a que acabe una compilación o una batería de tests y continuar con el siguiente paso.
Revisión de código
Repetir una skill de revisión sobre un pull request mientras el equipo sigue subiendo cambios.
Mantenimiento de rama
Un /loop sin prompt para que Claude cuide la rama actual mientras trabajas en otra cosa.
Este tipo de automatización encaja en cualquier equipo que quiera automatizar procesos con IA sin montar infraestructura nueva. Y si buscas más extensiones para Claude Code, revisa nuestro directorio de herramientas para Claude.
Preguntas frecuentes sobre Comando /loop de Claude Code
Repite un prompt o una skill de forma automática mientras la sesión de Claude Code está abierta, con un intervalo fijo o con un ritmo que Claude decide según lo que observa.
Escribe /loop 5m seguido de la tarea, por ejemplo «/loop 5m comprueba si el despliegue ha terminado». Claude lo convierte en una expresión cron y te confirma el horario y el identificador.
Si el bucle usa ritmo automático, pulsa Esc mientras espera. Para los bucles con intervalo fijo, pide a Claude que cancele la tarea; también caducan solos a los 7 días.
No. Las tareas de /loop solo se ejecutan con la sesión abierta. Para tareas que deben correr sin tu equipo, usa rutinas en la nube, tareas programadas de Desktop o GitHub Actions.
Un archivo en .claude/loop.md o ~/.claude/loop.md que sustituye el prompt de mantenimiento que se ejecuta cuando lanzas /loop sin indicar ninguna tarea.
Sí. Cada iteración es una petición más a Claude y cuenta para tu plan o tu cuenta de API, así que conviene usar el intervalo más largo que te sirva.
Fuentes consultadas
Sobre el autor
Germán Gutiérrez
Development Manager en appyweb
Dirige el equipo de desarrollo de appyweb: aplicaciones web y móviles, SaaS, integraciones y arquitectura de software.
Ver perfil en LinkedIn ↗