SpyBara
Go Premium

desktop-scheduled-tasks.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 85 additions and 47 deletions.

2026
Sat 3 23:57 Tue 6 23:59 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Tue 27 22:59

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.

Comparar opciones de programación

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

Cloud Desktop /loop
Se ejecuta en Cloud, administrado por Anthropic de forma predeterminada Su máquina Su máquina
Requiere máquina encendida No Sí Sí
Requiere sesión abierta No No Sí
Persistente entre reinicios Sí Sí Restaurado en --resume, con excepciones
Acceso a archivos locales No (clon nuevo) Sí Sí
Servidores MCP Conectores configurados por tarea Archivos de configuración y conectores Heredado de la sesión
Solicitudes de permiso No (se ejecuta de forma autónoma) Configurable por tarea Heredado de la sesión
Programación personalizable A través de /schedule en la CLI Sí Sí
Intervalo mínimo 1 hora 1 minuto 1 minuto

[!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.

2. Inicia una nueva tarea

Haz clic en New task. Si se abre un menú con Create with Claude y Set up manually, selecciona Set up manually. Se abre el cuadro de diálogo New scheduled task. 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.

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, y la tarjeta Trigger ofrece los ajustes preestablecidos que se indican en Opciones de programación.

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.

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. Custom acepta una expresión cron. Para los demás ajustes preestablecidos, consulta Opciones de programación.

Haz clic en Create. 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. El formulario Edit de la tarea también ofrece Manual.

  • 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

Para intervalos que el selector no ofrece, como cada 15 minutos, el primero de cada mes, o una única ejecución en un momento futuro específico, pídale a Claude en cualquier sesión de Desktop que configure la programación. Use lenguaje natural; por ejemplo, "programa una tarea para ejecutar todas las pruebas cada 6 horas."

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 > 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.

Cuando se activa una tarea local, aparece una nueva sesión bajo una sección Scheduled en la barra lateral. Ábrela para ver qué hizo Claude, revisar cambios o 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 permiso, que establece al crear o editar la tarea. Las reglas de permiso de ~/.claude/settings.json también se aplican a sesiones de tareas programadas. Si una tarea se ejecuta en Manual mode y necesita ejecutar una herramienta para la que no tiene permiso, la ejecución se detiene hasta que la apruebe. La sesión permanece abierta en la barra lateral para que pueda responder más tarde.

Para evitar detenciones, haga clic en Run now después de crear una tarea, observe las solicitudes de permiso y seleccione "always allow" para cada una. Las ejecuciones futuras de esa tarea aprueban automáticamente las mismas herramientas sin solicitar. Puede revisar y revocar estas aprobaciones desde la página de detalles de la tarea.

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: elimine la tarea y archive todas las sesiones que creó. Aparece una casilla de verificación Also delete files on disk en el diálogo de confirmación; márquela para eliminar también el archivo SKILL.md de la tarea y los datos asociados de ~/.claude/scheduled-tasks/.

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.

Una tarea programada también puede modificar su propia programación o prompt desde dentro de una sesión en ejecución usando la herramienta MCP update_scheduled_task. Esto permite que una tarea se reprograme a sí misma según lo que encuentre, por ejemplo, reprogramar una revisión de código para ejecutarse antes cuando detecta que se ha creado una rama de lanzamiento.

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