Programar tareas recurrentes en Claude Code Desktop

Configure tareas programadas en Claude Code Desktop para ejecutar Claude automáticamente de forma recurrente para revisiones de código diarias, auditorías de dependencias o resúmenes matutinos.

Las tareas programadas inician una nueva sesión automáticamente en la hora y frecuencia que elija. Úselas para trabajos recurrentes como revisiones de código diarias, comprobaciones de actualizaciones de dependencias o resúmenes matutinos que extraigan información de su calendario e bandeja de entrada.

La página Scheduled tasks de la aplicación de escritorio muestra tanto las tareas programadas locales como las tareas programadas en la nube, anteriormente llamadas rutinas:

• Tarea local: se ejecuta en tu máquina con acceso directo a tus archivos y herramientas, pero solo se activa mientras la aplicación está abierta y tu computadora está despierta
• Tarea en la nube: se ejecuta incluso cuando tu computadora está apagada, y también puede iniciarse mediante llamadas a la API o eventos de GitHub

Esta página cubre las tareas programadas locales; para las tareas programadas en la nube y sus opciones de activación, consulta Automatizar el trabajo con tareas programadas.

[!NOTE]

Si tu aplicación muestra la función con su nombre anterior, haz clic en Routines dondequiera que esta página diga Scheduled y en New routine donde diga New task.

Comparar opciones de programación

Claude Code ofrece tres formas de programar trabajo recurrente o puntual:

[!TIP]

Utilice tareas en la nube para trabajo que debe ejecutarse de forma confiable sin su máquina. Utilice tareas de Desktop cuando necesite acceso a archivos y herramientas locales. Utilice /loop para sondeo rápido durante una sesión.

[!NOTE]

De forma predeterminada, las tareas programadas locales se ejecutan contra el estado en el que se encuentre tu directorio de trabajo, incluidos los cambios no confirmados. Para que cada ejecución tenga su propio Git worktree aislado, selecciona Worktree en el formulario Edit de la tarea después de crearla. La casilla está disponible cuando la carpeta de la tarea es un repositorio Git.

Crear una tarea programada

Las tareas programadas locales requieren Claude Desktop 1.1.5368 o posterior.

1. Abre la página de tareas programadas

En la pestaña Code, haz clic en Scheduled en la barra lateral o en el menú More de la barra lateral. Si la barra lateral muestra Routines en lugar de Scheduled, haz clic en Routines, luego haz clic en New routine y continúa con Formulario de página completa.

2. Inicia una nueva tarea

Haz clic en New task para abrir el cuadro de diálogo New scheduled task. Revisa si aparecen estas pantallas antes de continuar:

• Si se abre un menú con Create with Claude y Set up manually, selecciona Set up manually para abrir el cuadro de diálogo.
• Si Only on this computer aparece en la parte superior del cuadro de diálogo, ve a Cuadro de diálogo con Only on this computer en la parte superior antes de ingresar cualquier dato.
• Si se abre un menú con Local y Cloud, o se abre una página completa en lugar del cuadro de diálogo, ve a Formulario de página completa.

3. Ponle nombre a la tarea

Ingresa un nombre en el campo Name. Desktop lo convierte a kebab-case en minúsculas y lo usa como nombre de la carpeta de la tarea en disco, por lo que el nombre debe ser único entre todas tus tareas.

4. Escribe las instrucciones

En el cuadro debajo del nombre, ingresa lo que Claude debe hacer cuando se ejecute la tarea.

5. Activa Only on this computer

Por ahora, omite la tarjeta Trigger y expande Advanced settings debajo de ella. En la pestaña General, activa Only on this computer. Con esta opción activada, la tarea se ejecuta en tu máquina en una carpeta local.

Si el interruptor no está disponible, quita el repositorio o el disparador de evento de GitHub o de API, porque estos convierten la tarea en una tarea programada en la nube.

6. Elige la carpeta local

En la fila Local folder, selecciona una carpeta. Create permanece no disponible hasta que elijas una.

7. Configura la programación

De vuelta en la tarjeta Trigger, selecciona un ajuste preestablecido de programación.

8. Elige el modo de permisos y el modelo

En la barra de herramientas del cuadro de instrucciones, selecciona un modo de permisos y un modelo. Si no los cambias, las ejecuciones usan tu configuración de Claude Code y el modelo predeterminado.

9. Crea la tarea

Haz clic en Create. Si aún no has confiado en la carpeta, Desktop te pide que confíes en ella en este momento. Se abre la página de detalles de la tarea.

En la página de detalles, haz clic en el ícono de lápiz para abrir el formulario Edit. Ahí puedes cambiar la Description que Desktop completó a partir de tus instrucciones, seleccionar Worktree o cambiar la programación a Manual o Custom.

También puedes crear una tarea describiendo lo que deseas en cualquier sesión. Por ejemplo, "configura una revisión de código diaria que se ejecute cada mañana a las 9am" crea una tarea recurrente. Una solicitud como "recuérdame mañana a las 3pm que verifique el deploy" crea una tarea única que se desactiva después de ejecutarse.

Cuadro de diálogo con Only on this computer en la parte superior

Si Only on this computer aparece en la parte superior del cuadro de diálogo New scheduled task cuando se abre, actívalo antes de ingresar cualquier dato. Al activarlo, un formulario en blanco independiente para una tarea local reemplaza el formulario.

Luego completa los campos del formulario local:

• Name: ingresa un nombre, como en los pasos para crear una tarea programada.
• Description: ingresa una descripción. Create permanece no disponible hasta que lo hagas.
• El cuadro de instrucciones: ingresa lo que Claude debe hacer cuando se ejecute la tarea. Selecciona el modo de permisos y el modelo en los menús del cuadro.
• Working folder: selecciona la carpeta en la que se ejecuta la tarea. Create permanece no disponible hasta que selecciones una.
• Trigger: selecciona una programación. Para los ajustes preestablecidos, consulta Opciones de programación.

Haz clic en Create. Se abre la página de detalles de la tarea.

Formulario de página completa

Si se abre un menú con Local y Cloud, selecciona Local. Se abre una página titulada New local routine o New local scheduled task. Completa sus campos:

• Name: ingresa un nombre que sea único entre todas tus tareas.
• Description: ingresa una.
• Instructions: ingresa lo que Claude debe hacer cuando se ejecute la tarea. En el mismo cuadro, selecciona el modo de permisos, el modelo y la carpeta en la que se ejecuta la tarea.
• Schedule: selecciona una de las opciones de programación.

Si Create no está disponible, pasa el cursor sobre el botón para ver qué le falta todavía al formulario. Haz clic en Create y se abre la página de detalles de la tarea.

Opciones de programación

Cuando activas Only on this computer en Advanced settings, la tarjeta Trigger ofrece Hourly, Daily, Weekdays y Weekly. Para obtener Manual o Custom en una tarea así, abre su formulario Edit después de crearla. Ese formulario, el diálogo con Only on this computer en la parte superior y el formulario de página completa ofrecen estas seis opciones:

• Hourly: se ejecuta cada hora
• Daily: se ejecuta todos los días a la hora local que seleccione
• Weekdays: igual que Daily pero omite sábado y domingo
• Weekly: muestra un selector de hora y un selector de día
• Manual: sin programación, solo se ejecuta cuando haces clic en Run now. Útil para guardar un prompt que activas bajo demanda
• Custom: se ejecuta según una expresión cron que ingresas y que se evalúa en tu hora local, como 0 9 * * * para las 9:00 AM todos los días. Escribe los días de la semana y los meses como números, ya que no se aceptan sus nombres. El domingo es 0, no 7. El formulario rechaza una expresión que se ejecute con más frecuencia que una vez por hora.

También puedes pedirle a Claude en cualquier sesión de Desktop que configure la programación. Claude no está sujeto al límite de una vez por hora y puede configurar una única ejecución en un momento futuro. Por ejemplo, pide "ejecuta el conjunto de pruebas cada 30 minutos" o "el próximo lunes a las 9am, resume los pull requests fusionados desde el viernes."

Cómo se ejecutan las tareas programadas

Las tareas programadas locales se ejecutan en tu máquina. Desktop verifica la programación cada minuto mientras la aplicación está abierta e inicia una sesión nueva cuando una tarea vence, independientemente de cualquier sesión manual que tengas abierta. Cada tarea obtiene un pequeño retraso de unos pocos minutos después de la hora programada para escalonar el tráfico de API. El retraso es determinista: la misma tarea siempre comienza en el mismo desplazamiento.

Las tareas solo se ejecutan mientras la aplicación de escritorio está en ejecución y tu computadora está despierta. Si tu computadora se duerme durante una hora programada, la ejecución se omite. Para evitar el reposo por inactividad, activa Keep computer awake en Settings > Desktop app o en Settings > This computer > System. Cerrar la tapa del portátil aún lo pone en reposo.

[!NOTE]

Para tareas que necesitan ejecutarse incluso cuando tu computadora está apagada, o que deben activarse mediante una llamada a la API o un evento de GitHub, crea una tarea programada en la nube en su lugar.

Encontrar la sesión de una ejecución

Para abrir la sesión que inició una ejecución, ve a la página de detalles de la tarea y haz clic en la fila de esa ejecución en la lista History.

La lista de sesiones de la barra lateral también puede mostrar un grupo Scheduled, con una fila por tarea. Para abrir la sesión de la ejecución más reciente de una tarea, haz clic en la fila de la tarea en ese grupo. Para mostrar el grupo, comprueba qué diseño tienes:

• Diseño actual: abre el menú Group and sort, selecciona Show y luego selecciona Scheduled. El grupo comienza contraído, así que haz clic en su encabezado para expandirlo. Show incluye Scheduled cuando al menos una de tus tareas está Active, el Status que muestra la página de detalles de una tarea. Si no aparece en la lista, usa la lista History, que funciona tanto si el grupo se muestra como si no.
• Diseño anterior: el grupo está en la lista de sesiones sin que tengas que activar nada

En la sesión de una ejecución, sin importar cómo llegaste a ella, puedes ver qué hizo Claude, revisar cambios y responder a solicitudes de permiso. Claude puede editar archivos, ejecutar comandos, crear commits y abrir pull requests, lo mismo que en una sesión que inicias tú mismo.

Ejecuciones perdidas

Cuando la aplicación se inicia o su computadora se despierta, Desktop verifica si cada tarea perdió alguna ejecución en los últimos siete días. Si es así, Desktop inicia exactamente una ejecución de recuperación para el tiempo más recientemente perdido y descarta cualquier cosa más antigua. Una tarea diaria que perdió seis días se ejecuta una vez al despertar. Desktop muestra una notificación cuando comienza una ejecución de recuperación.

Ten esto en cuenta al escribir prompts. Una tarea programada para las 9am podría ejecutarse a las 11pm si tu computadora estuvo dormida todo el día. Si el tiempo es importante, agrega protecciones al prompt mismo, por ejemplo: "Solo revisa los commits de hoy. Si es después de las 5pm, omite la revisión y publica un resumen de lo que se perdió."

Permisos para tareas programadas

Cada tarea tiene su propio modo de permisos, que estableces al crear o editar la tarea. Las reglas de tipo allow de ~/.claude/settings.json también se aplican a las sesiones de tareas programadas. Cuando una ejecución está detenida en una solicitud de permiso, busca la sesión de la ejecución y responde a la solicitud allí.

Para evitar detenciones, haz clic en Run now después de crear una tarea, observa las solicitudes de permiso y selecciona "always allow" para cada una. Las ejecuciones futuras omiten la mayoría de esas solicitudes. Puedes revisar y revocar estas aprobaciones desde la página de detalles de la tarea. Si seleccionas "always allow" en una edición de archivo en la carpeta de la tarea, solo esa sesión cambia a Accept edits, así que establece el modo de permisos de la tarea en Accept edits.

Las herramientas MCP marcadas como requiresUserInteraction solicitan confirmación en cada llamada y no ofrecen una opción de permitir siempre. Las ejecuciones que llaman a estas herramientas se detienen cada vez.

Administrar tareas programadas

En la pestaña Code, haz clic en Scheduled en la barra lateral y luego haz clic en una tarea de la lista para abrir su página de detalles. Desde aquí puedes:

• Run now: inicie la tarea inmediatamente sin esperar a la próxima hora programada
• Status: alterne entre Active y Paused para pausar o reanudar ejecuciones programadas sin eliminar la tarea
• Edit: cambie las instrucciones, la programación, la carpeta u otras configuraciones
• Review history: vea cada ejecución anterior, incluidas las ejecuciones omitidas. Pase el cursor sobre una entrada omitida para ver por qué: su computadora estaba dormida, la ejecución anterior aún estaba en progreso, u otras tareas programadas ya estaban en ejecución. Haga clic en Show more para cargar entradas más antiguas.
• Review allowed permissions: vea y revoque aprobaciones de herramientas guardadas para esta tarea desde el panel Always allowed
• Delete: elimina la tarea. Las sesiones que creó la tarea se archivan, no se eliminan. La carpeta que contiene el archivo SKILL.md de la tarea permanece en disco en ~/.claude/scheduled-tasks/<task-name>/, o en scheduled-tasks/<task-name>/ bajo CLAUDE_CONFIG_DIR si configuraste esa variable. Para quitar esa carpeta, elimínala tú mismo.

También puede enumerar, crear, editar y pausar tareas pidiendo a Claude en cualquier sesión de Desktop. Por ejemplo, "pausa mi tarea dependency-audit" o "muéstrame mis tareas programadas." Para eliminar una tarea, use el botón Delete en su página de detalles.

Para permitir que una tarea cambie su propia programación o prompt con la herramienta MCP update_scheduled_task, haz clic en Run now y aprueba la llamada cada vez.

Para editar el prompt de una tarea en disco, abra ~/.claude/scheduled-tasks/<task-name>/SKILL.md (o bajo CLAUDE_CONFIG_DIR si está configurado). El archivo utiliza frontmatter YAML para name y description, con el prompt como cuerpo. Los cambios surten efecto en la próxima ejecución. La programación, carpeta, modelo y estado habilitado no están en este archivo: cámbielos a través del formulario Edit o pídale a Claude.

Recursos relacionados

• Tareas programadas en la nube: ejecuta tareas en la nube en una programación, mediante llamada API o en respuesta a eventos de GitHub, incluso cuando tu computadora está apagada
• Ejecutar prompts en una programación: programación con alcance de sesión con /loop en la CLI
• Claude Code GitHub Actions: ejecute Claude en una programación en CI en lugar de en su máquina
• Usar Claude Code Desktop: la guía completa de la aplicación de escritorio