Las tareas programadas requieren Claude Code v2.1.72 o posterior. Verifique su versión con claude --version.
Comparar opciones de programación
Claude Code offers three ways to schedule recurring work:
| Cloud | Desktop | /loop |
|---|
| Runs on | Anthropic cloud | Your machine | Your machine |
| Requires machine on | No | Yes | Yes |
| Requires open session | No | No | Yes |
| Persistent across restarts | Yes | Yes | No (session-scoped) |
| Access to local files | No (fresh clone) | Yes | Yes |
| MCP servers | Connectors configured per task | Config files and connectors | Inherits from session |
| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |
| Customizable schedule | Via /schedule in the CLI | Yes | Yes |
| Minimum interval | 1 hour | 1 minute | 1 minute |
Use cloud tasks for work that should run reliably without your machine. Use Desktop tasks when you need access to local files and tools. Use /loop for quick polling during a session.
Programar un prompt recurrente con /loop
El skill /loop bundled skill es la forma más rápida de programar un prompt recurrente. Pase un intervalo opcional y un prompt, y Claude configura un trabajo cron que se ejecuta en segundo plano mientras la sesión permanece abierta.
/loop 5m check if the deployment finished and tell me what happened
Sintaxis de intervalo
Los intervalos son opcionales. Puede colocarlos al principio, al final o dejarlos fuera completamente.
| Forma | Ejemplo | Intervalo analizado |
|---|
| Token inicial | /loop 30m check the build | cada 30 minutos |
Cláusula every final | /loop check the build every 2 hours | cada 2 horas |
| Sin intervalo | /loop check the build | por defecto cada 10 minutos |
s para segundos, m para minutos, h para horas y d para días. Los segundos se redondean al minuto más cercano ya que cron tiene una granularidad de un minuto. Los intervalos que no se dividen uniformemente en su unidad, como 7m o 90m, se redondean al intervalo más limpio y Claude le dice cuál eligió.
Bucle sobre otro comando
El prompt programado puede ser en sí mismo una invocación de comando o skill. Esto es útil para volver a ejecutar un flujo de trabajo que ya ha empaquetado.
/loop 20m /review-pr 1234
/review-pr 1234 como si lo hubiera escrito.
Establecer un recordatorio único
Para recordatorios únicos, describa lo que desea en lenguaje natural en lugar de usar /loop. Claude programa una tarea de un solo disparo que se elimina a sí misma después de ejecutarse.
remind me at 3pm to push the release branch
in 45 minutes, check whether the integration tests passed
Gestionar tareas programadas
Pida a Claude en lenguaje natural que enumere o cancele tareas, o haga referencia directamente a las herramientas subyacentes.
what scheduled tasks do I have?
cancel the deploy check job
| Herramienta | Propósito |
|---|
CronCreate | Programar una nueva tarea. Acepta una expresión cron de 5 campos, el prompt a ejecutar y si se repite o se ejecuta una sola vez. |
CronList | Enumerar todas las tareas programadas con sus IDs, horarios y prompts. |
CronDelete | Cancelar una tarea por ID. |
CronDelete. Una sesión puede contener hasta 50 tareas programadas a la vez.
Cómo se ejecutan las tareas programadas
El programador verifica cada segundo si hay tareas vencidas y las encola con baja prioridad. Un prompt programado se ejecuta entre sus turnos, no mientras Claude está en medio de una respuesta. Si Claude está ocupado cuando vence una tarea, el prompt espera hasta que termine el turno actual.
Todos los tiempos se interpretan en su zona horaria local. Una expresión cron como 0 9 * * * significa las 9am donde está ejecutando Claude Code, no UTC.
Jitter
Para evitar que cada sesión golpee la API en el mismo momento de reloj de pared, el programador agrega un pequeño desplazamiento determinista a los tiempos de disparo:
- Las tareas recurrentes se ejecutan hasta un 10% de su período tarde, limitado a 15 minutos. Un trabajo por hora podría ejecutarse en cualquier momento desde
:00 hasta :06.
- Las tareas únicas programadas para la parte superior o inferior de la hora se ejecutan hasta 90 segundos antes.
El desplazamiento se deriva del ID de la tarea, por lo que la misma tarea siempre obtiene el mismo desplazamiento. Si el tiempo exacto es importante, elija un minuto que no sea :00 o :30, por ejemplo 3 9 * * * en lugar de 0 9 * * *, y el jitter único no se aplicará.
Vencimiento de tres días
Las tareas recurrentes expiran automáticamente 3 días después de su creación. La tarea se ejecuta una última vez y luego se elimina a sí misma. Esto limita cuánto tiempo puede ejecutarse un bucle olvidado. Si necesita que una tarea recurrente dure más, cancele y recree antes de que expire, o utilice tareas programadas de Cloud o tareas programadas de Desktop para programación duradera.
Referencia de expresión cron
CronCreate acepta expresiones cron estándar de 5 campos: minute hour day-of-month month day-of-week. Todos los campos admiten comodines (*), valores únicos (5), pasos (*/15), rangos (1-5) y listas separadas por comas (1,15,30).
| Ejemplo | Significado |
|---|
*/5 * * * * | Cada 5 minutos |
0 * * * * | Cada hora en punto |
7 * * * * | Cada hora a los 7 minutos |
0 9 * * * | Todos los días a las 9am local |
0 9 * * 1-5 | Días de semana a las 9am local |
30 14 15 3 * | 15 de marzo a las 2:30pm local |
0 o 7 para domingo hasta 6 para sábado. La sintaxis extendida como L, W, ? y alias de nombres como MON o JAN no se admiten.
Cuando tanto el día del mes como el día de la semana están restringidos, una fecha coincide si cualquiera de los campos coincide. Esto sigue la semántica estándar de vixie-cron.
Deshabilitar tareas programadas
Establezca CLAUDE_CODE_DISABLE_CRON=1 en su entorno para deshabilitar completamente el programador. Las herramientas cron y /loop dejan de estar disponibles, y cualquier tarea ya programada deja de ejecutarse. Consulte Variables de entorno para la lista completa de banderas de deshabilitación.
Limitaciones
La programación con alcance de sesión tiene limitaciones inherentes:
- Las tareas solo se ejecutan mientras Claude Code está ejecutándose e inactivo. Cerrar la terminal o dejar que la sesión salga cancela todo.
- Sin recuperación de disparos perdidos. Si el tiempo programado de una tarea pasa mientras Claude está ocupado en una solicitud de larga duración, se ejecuta una vez cuando Claude queda inactivo, no una vez por intervalo perdido.
- Sin persistencia entre reinicios. Reiniciar Claude Code borra todas las tareas con alcance de sesión.
Para la automatización impulsada por cron que necesita ejecutarse sin supervisión:
