SpyBara
Go Premium

routines.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 271 additions and 288 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Tue 6 23:59 Wed 7 23:59 Thu 8 22:58 Sat 10 23:01 Wed 14 22:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Sun 25 23:58 Tue 27 22:59 Fri 30 23:01

Automatizar el trabajo con tareas programadas

Pon Claude Code en piloto automático. Crea tareas programadas, antes llamadas rutinas, que se ejecutan en la nube según un horario, mediante llamadas a la API o ante eventos de GitHub.

[!NOTE]

Las tareas programadas están en vista previa de investigación. El comportamiento, los límites y la superficie de la API pueden cambiar.

Una tarea programada en la nube, antes llamada rutina, es una configuración guardada de Claude Code: un prompt, uno o más repositorios y un conjunto de conectores, empaquetados una vez y ejecutados automáticamente. Las tareas programadas se ejecutan en la infraestructura en la nube administrada por Anthropic, o en el entorno autohospedado de tu organización cuando se enrutan allí, por lo que siguen funcionando cuando tu portátil está cerrada.

Cada tarea programada puede tener uno o más disparadores adjuntos:

  • Horario: se ejecuta con una cadencia recurrente, como cada hora, cada noche o cada semana, o una sola vez en un momento futuro específico
  • API: se activa bajo demanda enviando un POST HTTP al endpoint propio de la tarea con un token de portador
  • GitHub: se ejecuta automáticamente en respuesta a eventos del repositorio, como pull requests o lanzamientos

Una sola tarea programada puede combinar disparadores. Por ejemplo, una tarea de revisión de PR puede ejecutarse cada noche, activarse desde un script de despliegue y también reaccionar a cada nuevo PR.

Una tarea programada no necesita un horario:

  • Una tarea con solo un disparador de API se ejecuta cuando llamas a su endpoint.
  • Una tarea con solo un disparador de GitHub se ejecuta cuando ocurre un evento coincidente en el repositorio.

Las tareas programadas están disponibles en los planes Pro, Max, Team y Enterprise. Créalas y adminístralas en claude.ai/code/routines, o desde la CLI con /schedule. El nombre anterior, rutinas, todavía aparece en la dirección web, la CLI y la API.

[!NOTE]

Otras dos funciones programan trabajo en tu máquina en lugar de en la nube: las tareas programadas de escritorio y /loop. Para elegir entre las tres, consulta Comparar opciones de programación.

Los Owners de Team y Enterprise pueden desactivar las tareas programadas para todos los miembros con el interruptor Scheduled tasks (Was Routines) en Organization settings > Capabilities > Remote sessions. Cuando el interruptor está desactivado, las tareas programadas existentes dejan de ejecutarse y los miembros no pueden crear nuevas.

Casos de uso de ejemplo

Cada ejemplo combina un tipo de disparador con el tipo de trabajo para el que las tareas programadas son adecuadas: desatendido, repetible y vinculado a un resultado claro.

  • Mantenimiento del backlog: un disparador de horario se ejecuta cada noche entre semana en tu repositorio, con tu gestor de incidencias agregado como conector. La tarea programada lee las incidencias abiertas desde la última ejecución, aplica etiquetas y asigna responsables según el área de código referenciada. Luego publica un resumen en Slack para que el equipo empiece el día con una cola organizada.
  • Triaje de alertas: tu herramienta de monitoreo llama al endpoint de la API de la tarea programada cuando se supera un umbral de errores, pasando el cuerpo de la alerta como text. El prompt de la tarea le indica a Claude que investigue la alerta del payload de activación, así que extrae el stack trace y lo correlaciona con commits recientes en el repositorio. Luego abre un pull request en borrador con una corrección propuesta y un enlace a la alerta. La persona de guardia revisa el PR en lugar de empezar desde una terminal en blanco.
  • Revisión de código a medida: un disparador de GitHub se ejecuta en pull_request.opened. La tarea programada aplica la lista de verificación de revisión propia de tu equipo y deja comentarios en línea sobre problemas de seguridad, rendimiento y estilo. También agrega un comentario de resumen para que los revisores humanos puedan enfocarse en el diseño en lugar de en verificaciones mecánicas.
  • Verificación de despliegue: tu pipeline de CD llama al endpoint de la API de la tarea programada después de cada despliegue en producción. La tarea ejecuta pruebas de humo contra la nueva compilación, revisa los registros de errores en busca de regresiones y publica un sí o no en el canal de lanzamientos antes de que se cierre la ventana de despliegue.
  • Desfase de documentación: un disparador de horario se ejecuta cada semana. La tarea programada revisa los PR fusionados desde la última ejecución, marca la documentación que hace referencia a API modificadas y abre PR de actualización en el repositorio de documentación para que un editor los revise.
  • Portado de bibliotecas: un disparador de GitHub se ejecuta en pull_request.closed, filtrado a PR fusionados en un repositorio de SDK. La tarea programada porta el cambio a un SDK paralelo en otro lenguaje y abre un PR equivalente, manteniendo ambas bibliotecas sincronizadas sin que una persona reimplemente cada cambio.

Crear una tarea programada

Crea una tarea programada desde la web en claude.ai/code/routines, desde la aplicación de escritorio o desde la CLI. Las tres superficies escriben en la misma cuenta en la nube, por lo que una tarea programada que creas en una aparece en las otras de inmediato. En la pestaña Code de la aplicación de escritorio, haz clic en Scheduled en la barra lateral o en el menú More de la barra lateral, luego en New task, y continúa con Crear desde la web.

Las tareas programadas se ejecutan de forma autónoma como sesiones completas de Claude Code en la nube. No eliges un modo de permisos. La sesión ejecuta comandos de shell, usa los skills incluidos en commits del repositorio clonado y llama a cualquier conector que incluyas, todo sin detenerse a pedir aprobación, salvo en algunas acciones de artefactos.

Lo que una tarea programada puede alcanzar está determinado por:

  • Los repositorios que selecciones
  • El acceso a la red y las variables del entorno
  • Los conectores que incluyas

Limita cada uno de ellos a lo que la tarea necesita.

Las tareas programadas pertenecen a tu cuenta individual de claude.ai. No se comparten con tus compañeros de equipo y sus ejecuciones cuentan contra los límites y el uso de tu cuenta. Todo lo que una tarea programada hace a través de tu identidad de GitHub conectada o de tus conectores aparece como hecho por ti. Los commits y los pull requests llevan tu usuario de GitHub, y los mensajes de Slack, los tickets de Linear u otras acciones de conectores usan tus cuentas vinculadas en esos servicios.

Crear desde la web

1. Abrir el diálogo de creación

Ve a claude.ai/code/routines y haz clic en New task. Si primero se abre un menú, selecciona Set up manually. Se abre el diálogo New scheduled task. La otra opción del menú, Create with Claude, te permite describir la tarea en un chat y que Claude la cree por ti.

Si Repositories y Environment ya aparecen al abrirse el diálogo, consulta en qué se diferencia ese diálogo. En caso contrario, este diálogo también crea tareas programadas para el chat de claude.ai. Para que la tuya sea lo que el diálogo llama una tarea de Claude Code, selecciona un repositorio o agrega un disparador de evento de GitHub o de API en los pasos siguientes. Ese tipo de tarea ejecuta Claude Code en una sesión en la nube.

2. Nombrar la tarea y escribir el prompt

Dale a la tarea programada un nombre descriptivo y escribe el prompt que Claude ejecuta cada vez. El prompt es la parte más importante: la tarea se ejecuta de forma autónoma, por lo que el prompt debe ser autosuficiente y explícito sobre qué hacer y cómo se ve el éxito. Selecciona un modelo en el selector de modelo de la entrada del prompt. Claude lo usa en cada ejecución.

Cuando se activa un disparador, la sesión recibe el prompt guardado como su tarea asignada y la lleva a cabo, en lugar de tratarlo como contenido no confiable que llegó a mitad de la conversación. El disparador solo atestigua que el prompt fue almacenado con anticipación por una sesión autorizada en tu cuenta. Por lo tanto, el prompt activado no es entrada de usuario en vivo y no puede actuar como aprobación o consentimiento para acciones durante la ejecución. El contenido que la sesión obtiene durante la ejecución mantiene su tratamiento normal.

3. Seleccionar un disparador

En la fila Trigger, elige cómo se inicia la tarea. Para combinar varios disparadores, haz clic en + al final de la fila.

Schedule

Elige una frecuencia preestablecida para una ejecución recurrente. Consulta Agregar un disparador de horario para conocer el manejo de zonas horarias, los inicios con retraso, los intervalos cron personalizados y las ejecuciones únicas.

GitHub event

Selecciona el repositorio, el evento al que reaccionar y filtros opcionales. Consulta Agregar un disparador de GitHub para ver la lista completa de eventos admitidos y campos de filtro.

API

Selecciona API aquí. Cuando hagas clic en Create, el diálogo API token muestra el token una sola vez, así que cópialo antes de cerrar el diálogo. Consulta Agregar un disparador de API para copiar la URL o generar un nuevo token.

4. Seleccionar repositorios

Expande Advanced settings. En Repository, en la pestaña General, selecciona uno o más repositorios de GitHub para que Claude trabaje en ellos.

Cada repositorio se clona al inicio de una ejecución. Claude crea ramas con el prefijo claude/ para sus cambios.

5. Seleccionar un entorno

Después de seleccionar un repositorio, aparece Cloud environment debajo. Elige un entorno en la nube para la tarea. Los entornos controlan a qué tiene acceso la sesión en la nube:

  • Network access: establece el nivel de acceso a Internet disponible durante cada ejecución
  • Environment variables: proporciona valores que Claude puede usar durante cada ejecución. Son visibles para cualquiera que use el entorno, por lo que en un entorno alojado por Anthropic, almacena las claves de las API que Claude llama durante una ejecución como secretos de red en su lugar. Esa sección también enumera las solicitudes que nunca reciben un secreto
  • Setup script: instala las dependencias y herramientas que la tarea necesita. El resultado se almacena en caché, por lo que el script no se vuelve a ejecutar en cada sesión

Se proporciona un entorno Default con acceso a la red Trusted, que permite solo la lista de permitidos predeterminada de registros de paquetes, API de proveedores de nube, registros de contenedores y dominios de desarrollo comunes a través de la red de la sesión. Los conectores que agregas a la tarea llegan a sus servicios a través de los servidores de Anthropic, por lo que no necesitan cambios en la lista de permitidos.

Si tu tarea necesita llegar directamente a tus propios servicios, o a un dominio fuera de esa lista, edita el acceso a la red del entorno antes de ejecutarla. Para usar un entorno separado, crea uno primero.

6. Revisar conectores

Cambia a la pestaña Connectors de Advanced settings. Todos tus conectores MCP conectados se incluyen de forma predeterminada. Elimina los que la tarea no necesite: Claude puede usar todas las herramientas de un conector incluido, incluidas las escrituras, sin pedir permiso durante una ejecución.

7. Crear la tarea

Haz clic en Create. El diálogo se cierra y se abre la página de detalles de la nueva tarea. La tarea se ejecuta la próxima vez que uno de sus disparadores coincida. Para iniciar una ejecución de inmediato, haz clic en Run now en la página de detalles.

Cada ejecución crea una nueva sesión junto a tus otras sesiones, donde puedes ver qué hizo Claude, revisar los cambios y crear un pull request.

Diálogo con Repositories y Environment en la vista principal

Sigue los pasos para crear desde la web y completa cada campo en la vista principal del diálogo en lugar de en Advanced settings. Este diálogo crea solo tareas de Claude Code.

Selecciona el repositorio antes de agregar un disparador de evento de GitHub, porque ese disparador no está disponible hasta que se selecciona un repositorio.

Crear desde la CLI

Ejecuta /schedule en cualquier sesión para crear una tarea programada de forma conversacional. También puedes pasar una descripción directamente, para una tarea recurrente como /schedule daily PR review at 9am o una única como /schedule clean up feature flag in one week. Claude recorre la misma información que recopila el diálogo web y luego guarda la tarea en tu cuenta. El comando también está disponible con el alias /routines.

Un inicio correcto se ve como una conversación: Claude hace preguntas de seguimiento sobre el horario, los repositorios y el prompt antes de guardar. Si en cambio Claude responde que necesitas autenticarte o que no puede conectarse a tu cuenta remota de claude.ai, no se creó ninguna tarea programada; consulta Solución de problemas.

Una tarea que creas con /schedule tiene un disparador de horario. También puedes agregar los otros tipos de disparadores:

  • Disparador de API: edita la tarea en la web en claude.ai/code/routines
  • Disparador de GitHub: edita la tarea en la web, o pídeselo a Claude en la CLI. Agregarlo desde la CLI requiere Claude Code v2.1.225 o posterior

Una tarea programada sin disparador de horario, como una que solo se inicia mediante llamadas a la API o eventos de GitHub, no tiene hora de próxima ejecución. La CLI no muestra ninguna cuando Claude la guarda o la actualiza. Antes de v2.1.211, la CLI informaba una hora de próxima ejecución en el año 1 para estas tareas.

Configurar disparadores

Una tarea programada se inicia cuando uno de sus disparadores coincide. Agrega o elimina los disparadores de una tarea en cualquier momento en la fila Trigger del diálogo de edición de la tarea.

Cuando una tarea tiene dos o más disparadores, cada uno tiene un icono de papelera en ese diálogo. Para eliminar un disparador de horario o de evento de GitHub, haz clic en su icono de papelera y luego en Save changes. Para eliminar un disparador de API, elimina su token en su lugar.

Agregar un disparador de horario

Un disparador de horario ejecuta la tarea con una cadencia recurrente, o una sola vez en un momento futuro específico. En el diálogo de creación o edición de la tarea en la web, elige una frecuencia preestablecida, como cada hora, diaria o semanal:

  • Zona horaria: las horas se ingresan en tu zona local y se convierten automáticamente, por lo que la tarea se ejecuta a esa hora de reloj independientemente de dónde se encuentre la infraestructura en la nube.
  • Ejecuciones en punto: si programas una ejecución exactamente en punto, como a las 9:00, puede comenzar varios minutos tarde. Para comenzar cerca de la hora programada, elige unos minutos después de la hora, por ejemplo 9:07.
  • Intervalos personalizados: para un intervalo personalizado, como cada dos horas, elige el preestablecido más cercano en el diálogo y luego ejecuta /schedule update en la CLI para establecer una expresión cron específica. El intervalo mínimo es de una hora; las expresiones que se ejecutan con más frecuencia se rechazan.

Programar una ejecución única

Una programación única ejecuta la tarea una sola vez en una marca de tiempo específica. Por ejemplo, úsala para:

  • Recordarte algo más adelante en la semana
  • Abrir un PR de limpieza después de que termine un despliegue gradual
  • Iniciar trabajo de seguimiento después de que se publique un cambio upstream

Después de que la tarea se ejecuta, se desactiva sola y la interfaz web la marca como Completed. Para ejecutarla de nuevo, abre el diálogo de edición de la tarea en la web, que ofrece One-time para una tarea única, y establece una nueva hora.

Crea una ejecución única desde la CLI describiendo la hora en lenguaje natural. Claude interpreta la frase en relación con la hora actual y confirma la marca de tiempo absoluta antes de guardar.

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

La misma conversión de zona local a UTC que en las programaciones recurrentes se aplica a las marcas de tiempo únicas.

Las ejecuciones únicas cuentan contra el mismo límite por hora que otras ejecuciones programadas. Consulta Uso y límites para obtener detalles.

Agregar un disparador de API

Un disparador de API le da a una tarea programada un endpoint HTTP dedicado. Enviar un POST al endpoint con el token de portador de la tarea inicia una nueva sesión y devuelve una URL de sesión. Úsalo para conectar Claude Code a sistemas de alertas, pipelines de despliegue, herramientas internas o cualquier lugar desde el que puedas hacer una solicitud HTTP autenticada.

Agrega un disparador de API en la web, ya sea mientras creas la tarea o más tarde con los pasos siguientes. No puedes agregar un disparador de API ni administrar su token desde la CLI.

1. Abrir la tarea para editarla

Ve a claude.ai/code/routines, haz clic en la tarea programada que quieres activar mediante la API, luego abre el menú junto a su nombre y selecciona Edit. Se abre el diálogo Edit scheduled task.

2. Agregar un disparador de API

En la fila Trigger, haz clic en + y selecciona API en el menú que se abre. Aparece un panel con la Fire URL y el Token de esta tarea.

3. Copiar la URL y generar un token

Copia la Fire URL. Haz clic en Generate token y copia de inmediato el token del diálogo Token generated. El token se muestra una sola vez y no se puede recuperar más tarde, así que guárdalo en un lugar seguro, como el almacén de secretos de tu herramienta de alertas.

El disparador de API entra en vigor en cuanto generas el token. No necesitas hacer clic en Save changes, así que cierra el diálogo cuando termines.

4. Llamar al endpoint

Envía el token en el encabezado Authorization: Bearer cuando hagas POST a la URL. Activar una tarea programada muestra un ejemplo completo.

Cada tarea programada tiene su propio token, limitado a activar solo esa tarea. Para desactivar el acceso por API o rotar el token, abre de nuevo el diálogo Edit scheduled task de la tarea. Ambos controles están junto al token en el panel del disparador de API y entran en vigor de inmediato:

  • Desactivar el acceso por API: haz clic en Delete token, el icono de papelera junto a Regenerate. Esto elimina el disparador de API
  • Rotar el token: haz clic en Regenerate. El token anterior deja de funcionar y el diálogo Token generated muestra el nuevo una sola vez

Activar una tarea programada

Envía una solicitud POST al endpoint /fire con el token de portador en el encabezado Authorization. El cuerpo de la solicitud acepta un campo text opcional para contexto específico de la ejecución, como el cuerpo de una alerta o un registro con fallos, que se pasa a la tarea junto con su prompt guardado. El valor es texto libre y no se analiza: si envías JSON u otro payload estructurado, la tarea lo recibe como una cadena literal.

El valor text no llega a la rutina como un mensaje sin más. Llega envuelto en un bloque <routine-fire-payload> que lo etiqueta como datos no confiables y le indica a Claude que no siga instrucciones dentro de él a menos que el propio prompt de la rutina lo indique. El mismo envoltorio se aplica al texto proporcionado con Run now en la interfaz web.

Esto significa que el prompt guardado de una rutina debe habilitar explícitamente la actuación sobre el texto de activación: escribe el prompt para que haga referencia explícita al payload, por ejemplo "Investiga la alerta descrita en el bloque routine-fire-payload", o la rutina tratará el texto como contexto inerte. Cualquiera que tenga el token de portador puede enviar text, así que el envoltorio hace que el texto de activación enviado con un token filtrado llegue etiquetado como datos no confiables en lugar de como instrucciones directas para tu rutina.

El ejemplo siguiente activa una tarea programada desde un shell. El ID de la tarea y el token mostrados son marcadores de posición: reemplázalos por la URL y el token que copiaste al agregar el disparador de API, o la solicitud fallará con un error de autenticación 401:

curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
  -H "Authorization: Bearer sk-ant-oat01-xxxxx" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'

Una solicitud correcta devuelve un cuerpo JSON con el ID y la URL de la nueva sesión:

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}

Abre la URL de la sesión en un navegador para ver la ejecución en tiempo real, revisar los cambios o continuar la conversación manualmente.

[!WARNING]

El endpoint /fire se publica bajo el encabezado beta experimental-cc-routine-2026-04-01. Las formas de solicitud y respuesta, los rate limits y la semántica de los tokens pueden cambiar mientras la función está en vista previa de investigación. Los cambios incompatibles se publican bajo nuevas versiones fechadas del encabezado beta, y las dos versiones anteriores más recientes del encabezado siguen funcionando para que quienes llaman tengan tiempo de migrar.

Referencia de la API

Para la referencia completa de la API, incluidas todas las respuestas de error, reglas de validación y límites de campos, consulta Trigger a routine through the API en la documentación de Claude Platform.

El endpoint /fire está disponible solo para usuarios de claude.ai y no forma parte de la superficie de la API de Claude Platform.

Agregar un disparador de GitHub

Un disparador de GitHub inicia automáticamente una nueva sesión cuando ocurre un evento coincidente en un repositorio conectado. Claude Code no reutiliza sesiones entre eventos, por lo que dos actualizaciones de un PR producen dos sesiones independientes.

[!NOTE]

Los eventos de webhook de GitHub están sujetos a límites por hora por tarea y por cuenta. Los eventos que superan el límite se descartan hasta que se reinicia la ventana.

La aplicación Claude GitHub App debe estar instalada en el repositorio al que quieres suscribirte, sea cual sea la superficie desde la que configures el disparador.

  • Configura los disparadores de GitHub desde la interfaz web, que te pide instalar la aplicación cuando falta. Sigue los pasos siguientes para configurar uno en la web.
  • Desde la CLI, instala primero la aplicación desde la página de la GitHub App y luego pídele a Claude que adjunte un disparador de GitHub a una tarea programada existente, por ejemplo /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp. La vía de la CLI requiere Claude Code v2.1.225 o posterior. Cuando Claude agrega el disparador, responde con un enlace a la tarea que activa el disparador.

1. Abrir la tarea para editarla

Ve a claude.ai/code/routines, haz clic en la tarea programada, luego abre el menú junto a su nombre y selecciona Edit. Se abre el diálogo Edit scheduled task.

2. Agregar un disparador de evento de GitHub

En la fila Trigger, haz clic en + y selecciona GitHub event en el menú que se abre.

[!NOTE]

Ejecutar /web-setup en la CLI otorga acceso al repositorio para clonarlo, pero no instala la Claude GitHub App ni habilita la entrega de webhooks.

3. Configurar el disparador

Cambia el repositorio si es necesario, elige un evento de la lista de eventos admitidos y, opcionalmente, agrega filtros. Luego haz clic en Save changes en la parte inferior del diálogo para aplicar el disparador.

Eventos admitidos

Los disparadores de GitHub pueden suscribirse a cualquiera de las siguientes categorías de eventos. Dentro de cada categoría, puedes elegir una acción específica, como pull_request.opened, o reaccionar a todas las acciones de la categoría.

Evento Se activa cuando
Pull request Se abre, cierra, asigna, etiqueta, sincroniza o actualiza de otra manera un PR
Lanzamiento Se crea, publica, edita o elimina un lanzamiento

Filtrar pull requests

Usa filtros para acotar qué pull requests inician una nueva sesión. Todas las condiciones de filtro deben coincidir para que la tarea programada se active. Los campos de filtro disponibles son:

Filtro Coincide con
Autor Nombre de usuario de GitHub del autor del PR
Título Texto del título del PR
Cuerpo Texto de la descripción del PR
Rama base Rama a la que apunta el PR
Rama head Rama de la que proviene el PR
Etiquetas Etiquetas aplicadas al PR
Es borrador Si el PR está en estado de borrador
Está fusionado Si el PR ha sido fusionado

Cada filtro combina un campo con un operador: es igual a, contiene, comienza con, es uno de, no es uno de o coincide con regex.

El operador matches regex evalúa el valor completo del campo, no una subcadena dentro de él. Para coincidir con cualquier título que contenga hotfix, escribe .*hotfix.*. Sin los .* alrededor, el filtro solo coincide con un título que sea exactamente hotfix, sin nada antes ni después. Para buscar una subcadena literal sin sintaxis de regex, usa el operador contains en su lugar.

Algunos ejemplos de combinaciones de filtros:

  • Revisión del módulo de autenticación: rama base main, rama head contiene auth-provider. Envía cualquier PR que toque la autenticación a un revisor especializado.
  • Solo listos para revisión: es borrador es false. Omite los borradores para que la tarea solo se ejecute cuando el PR esté listo para revisión.
  • Backport condicionado por etiqueta: las etiquetas incluyen needs-backport. Activa una tarea de portado a otra rama solo cuando un mantenedor etiqueta el PR.

Administrar tareas programadas

Haz clic en una tarea programada de la lista para abrir su página de detalles. La página de detalles muestra los repositorios, conectores, prompt, horario, tokens de API y disparadores de GitHub de la tarea, y una lista de ejecuciones anteriores.

Ver e interactuar con ejecuciones

Haz clic en cualquier ejecución para abrirla como una sesión completa. Desde allí puedes ver qué hizo Claude, revisar los cambios, crear un pull request o continuar la conversación. Cada sesión de ejecución funciona como cualquier otra sesión: usa el menú desplegable junto al título de la sesión para cambiarle el nombre, archivarla o eliminarla.

[!NOTE]

Un estado verde en la lista de ejecuciones significa que la sesión se inició y terminó sin un error de infraestructura. No significa que el trabajo que describe tu prompt haya tenido éxito. Abre la ejecución para leer la transcripción y confirmar qué hizo realmente Claude. Las solicitudes de red bloqueadas, las herramientas de conectores faltantes y los fallos en el propio trabajo aparecen allí y no en el indicador de estado.

Editar y controlar tareas programadas

Desde la página de detalles puedes:

  • Hacer clic en Run now para iniciar una ejecución de inmediato sin esperar a la próxima hora programada.
  • Usar el interruptor de encendido/apagado en la parte superior de la página para pausar o reanudar el horario. Las tareas pausadas conservan su configuración, pero no se ejecutan hasta que las vuelvas a activar.
  • Abrir el menú junto al nombre de la tarea y seleccionar Edit para cambiar el nombre, el prompt, los repositorios, el entorno, los conectores o cualquiera de los disparadores de la tarea. El diálogo Edit scheduled task se abre con el mismo diseño que el diálogo de creación. Para agregar un disparador, haz clic en + en la fila Trigger. Haz clic en Save changes para aplicar tus cambios. Las acciones sobre tokens de API entran en vigor de inmediato, sin Save changes.
  • Abrir el mismo menú y seleccionar Delete para eliminar la tarea.

Administrar tareas programadas desde la CLI

Ejecuta /schedule list para ver tus tareas programadas, /schedule update para cambiar una o /schedule run para iniciar una de inmediato.

También puedes preguntar por el historial de ejecuciones de una tarea programada, por ejemplo /schedule why did my nightly review do nothing this morning?. Claude enumera las ejecuciones recientes de la tarea con su estado y un enlace para abrir cada ejecución en la web. También lee el registro de una ejecución para explicar qué sucedió, incluidos errores de herramientas, denegaciones de permisos y el resultado final. Requiere Claude Code v2.1.227 o posterior.

Repositorios y permisos de rama

Las tareas programadas necesitan acceso a GitHub para clonar repositorios. Cuando creas una tarea programada desde la CLI con /schedule, Claude verifica si tu cuenta tiene acceso a GitHub para el repositorio desde el que la ejecutaste. Si no lo tiene, Claude agrega una nota de configuración indicando cómo otorgarlo.

[!NOTE]

Consulta Opciones de autenticación de GitHub para conocer las dos formas de otorgar acceso. En los planes Team y Enterprise, un Owner de tu organización de Claude tiene que activar cada método antes de que puedas usarlo; consulta Conectar GitHub.

Si tu conexión a GitHub falta o ha caducado cuando corresponde una ejecución, la tarea programada omite ejecuciones hasta que vuelvas a conectarte, durante un máximo de 72 horas. Vuelve a conectar GitHub dentro de ese plazo y la tarea se reanuda sola. Después de 72 horas sin conexión, la tarea se desactiva, y tú la vuelves a activar después de reconectar GitHub.

Cada repositorio que agregas se clona en cada ejecución. Claude comienza desde la rama predeterminada del repositorio a menos que tu prompt indique lo contrario. Si un evento de pull request de GitHub dispara la ejecución y el repositorio del pull request es el primer repositorio de la tarea, ese repositorio comienza en cambio desde el commit head del pull request.

Claude envía su trabajo a una rama con el prefijo claude/ a menos que tu prompt le indique enviarlo a otra rama. Para controlar a qué ramas puede enviar una ejecución, usa reglas de protección de ramas o rulesets en GitHub. Para las ejecuciones en infraestructura administrada por Anthropic, y para las ejecuciones autohospedadas que envían a través del proxy de git de Anthropic, GitHub las aplica al acceso a GitHub que conectaste, por lo que una regla que ese acceso puede omitir no bloquea el envío de una ejecución. Una ejecución autohospedada que envía con las credenciales de git que proporciona tu despliegue se verifica en cambio contra esas credenciales. Consulta Configurar git.

Conectores

Las tareas programadas pueden usar tus conectores MCP conectados para leer y escribir en servicios externos durante cada ejecución. Por ejemplo, una tarea que clasifica solicitudes de soporte podría leer de un canal de Slack y crear incidencias en Linear.

Los conectores son las integraciones de claude.ai de tu cuenta. Los servidores MCP que agregaste localmente en la CLI con claude mcp add se almacenan en tu máquina y no en tu cuenta de claude.ai, por lo que no aparecen en la lista de conectores. Para usar uno de esos servidores en una tarea programada:

  • Como conector: agrégalo como conector en claude.ai/customize/connectors
  • En el repositorio: para una tarea programada con un solo repositorio, puedes en cambio declarar el servidor en un .mcp.json incluido en un commit para que forme parte del repositorio clonado

Cuando creas una tarea programada, todos tus conectores conectados actualmente se incluyen de forma predeterminada. Elimina los que no sean necesarios para limitar a qué herramientas tiene acceso Claude durante la ejecución. También puedes agregar conectores directamente desde el diálogo de creación o edición de la tarea.

Para administrar o agregar conectores fuera de ese diálogo, visita claude.ai/customize/connectors o usa /schedule update en la CLI.

Cuando una ejecución publica un artefacto sin preguntar

Cuando el horario de una tarea programada o Run now inicia una ejecución, Claude puede publicar un nuevo artefacto sin preguntar. El nuevo artefacto solo es visible para ti hasta que lo compartas. Si la publicación declara capacidades de tiempo de ejecución para la página, como llamadas a conectores o descargas de archivos, Claude pregunta primero.

En esas ejecuciones, Claude vuelve a publicar un artefacto existente sin preguntar solo cuando se cumplen todas estas condiciones:

  • Puedes editar el artefacto y pertenece a tu propia organización
  • Si la publicación incluye más que la página, como archivos de soporte, eres propietario del artefacto
  • El artefacto no está compartido públicamente
  • Si el artefacto está compartido con personas específicas o con tu organización, sus lectores no ven automáticamente cada nueva versión
  • La publicación no sobrescribe forzosamente una versión más reciente
  • La publicación no declara capacidades de tiempo de ejecución para la página
  • La página existente no tiene ningún permiso concedido que vaya más allá de la página, como llamadas a conectores

En cualquier otro caso, incluida una ejecución iniciada por un disparador de API o de GitHub, Claude pregunta primero.

Cuando el trabajo de una tarea programada es mantener una página actualizada, dale un artefacto que ya hayas publicado.

Entornos y acceso a la red

Cada tarea programada usa un entorno en la nube que controla el acceso a la red, las variables de entorno y los scripts de configuración. La tarea hereda la política de red del entorno en cada ejecución.

El entorno Default usa acceso a la red Trusted, que permite solo la lista de permitidos predeterminada a través de la red de la sesión. Las solicitudes por esa vía a hosts fuera de la lista de permitidos fallan con 403 y x-deny-reason: host_not_allowed. El tráfico de los conectores MCP se enruta a través de los servidores de Anthropic y no por esa vía, por lo que los conectores que agregas a la tarea funcionan sin agregar sus hosts a Allowed domains. Elimina los conectores que no necesites en Conectores.

Para permitir dominios adicionales en uno de tus propios entornos, sigue estos pasos. Un entorno compartido por la organización se abre en modo de solo lectura aquí, por lo que un Owner cambia su acceso a la red desde la página Cloud environments en la configuración de administración en su lugar.

1. Abrir la tarea para editarla

Ve a claude.ai/code/routines, haz clic en la tarea programada, luego abre el menú junto a su nombre y selecciona Edit. Se abre el diálogo Edit scheduled task.

2. Abrir el selector de entorno

Ve a Advanced settings > General > Cloud environment, expandiendo primero Advanced settings si está contraído. Haz clic en el icono de nube que muestra el nombre de tu entorno, como Default.

3. Abrir la configuración del entorno

Pasa el cursor sobre el entorno en la lista y haz clic en el icono de configuración que aparece a la derecha.

4. Cambiar el nivel de acceso a la red

En el diálogo Edit cloud environment, cambia Network access a Custom e ingresa tus dominios en Allowed domains. Marca Also include default list of common package managers para mantener la lista de permitidos predeterminada junto con tus dominios personalizados. Selecciona Full en su lugar para tener acceso sin restricciones.

5. Guardar

Haz clic en Save changes en el diálogo Edit cloud environment y luego cierra el diálogo Edit scheduled task que está detrás. La nueva política se aplica desde la próxima ejecución.

Consulta Acceso a la red para obtener detalles sobre los niveles de acceso y la lista de permitidos predeterminada.

Uso y límites

Las tareas programadas consumen el uso de la suscripción de la misma manera que las sesiones interactivas. Consulta tu consumo actual en claude.ai/settings/usage.

Aparte del uso de la suscripción, cada forma de iniciar una ejecución tiene un límite por hora:

Acción Límite Se cuenta para Por encima del límite
Ejecuciones programadas, incluidas las ejecuciones únicas 100 por hora Tu cuenta La ejecución espera hasta que se reinicie el límite
Run now, activaciones por API y configurar una tarea única para que se ejecute de nuevo 30 por hora Cada tarea programada, un conteo compartido por las tres La acción falla hasta que se reinicie el límite
Run now y configurar una tarea única para que se ejecute de nuevo 100 por hora Tu cuenta Igual
Activaciones por API 100 por hora Tu cuenta, contadas por separado de Run now Igual
Eventos de GitHub Consulta Agregar un disparador de GitHub

Ninguno de estos límites por hora admite excedentes.

Cuando una tarea programada alcanza el límite de uso de tu suscripción, las organizaciones con créditos de uso activados pueden seguir ejecutando tareas programadas con excedente medido. Sin créditos de uso, las ejecuciones adicionales se rechazan hasta que se reinicie tu ventana de uso. Activa los créditos de uso en claude.ai/settings/usage. En los planes Team y Enterprise, un administrador los activa para la organización en claude.ai/admin-settings/usage.

Mientras tu suscripción está en pausa, tus tareas programadas quedan en espera y no se ejecutan. Cuando tu suscripción vuelva a estar activa, vuelve a activarlas.

Dónde sigue apareciendo el nombre rutinas

Las tareas programadas se llamaban antes rutinas, y estos lugares conservan el nombre anterior. Cada uno se refiere a la misma función:

  • Dirección web: claude.ai/code/routines
  • CLI: el alias /routines de /schedule, la descripción del comando y las respuestas de Claude mientras configura una tarea
  • API: la ruta del endpoint /fire, su encabezado beta, el type de su respuesta, la etiqueta <routine-fire-payload> y la página de referencia Trigger a routine through the API
  • Configuración de la organización: el interruptor Scheduled tasks (Was Routines)

Solución de problemas

/schedule devuelve "Unknown command"

La CLI oculta /schedule cuando no se cumple alguno de sus requisitos: el menú de comandos muestra No commands match "/schedule" mientras escribes. Enviarlo devuelve Unknown command: /schedule, excepto en los casos siguientes en los que se indica una respuesta diferente.

La causa suele ser una de las siguientes:

  • Te autenticaste con una clave de API de Console, un perfil de Anthropic o una credencial de federación, o un proveedor de nube como Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry. /schedule requiere un inicio de sesión con suscripción de claude.ai. Con una clave de API de Console o un perfil, y con la obtención de feature flags habilitada, enviar /schedule muestra en su lugar /schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access. Con un inicio de sesión de un proveedor de nube, sigues viendo Unknown command: /schedule. Si ANTHROPIC_API_KEY o ANTHROPIC_AUTH_TOKEN están definidos en tu shell, o apiKeyHelper está definido en settings.json, elimínalos primero, ya que tienen prioridad sobre un inicio de sesión de claude.ai. Un perfil o una credencial de federación también tiene prioridad, así que desactívalo también
  • Cerraste sesión por completo, sin clave de API ni otra credencial. Con la obtención de feature flags habilitada, enviar /schedule muestra /schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account. Antes de v2.1.268, una sesión sin iniciar mostraba el mismo mensaje de Claude for Enterprise que una clave de API de Console
  • Estás dentro de una sesión en la nube, donde enviar /schedule responde que el comando no está disponible en ese entorno. Administra las tareas programadas desde la interfaz web en su lugar
  • La política de tu organización desactiva las sesiones en la nube, que las tareas programadas requieren. En este caso, enviar /schedule responde Cloud sessions are disabled by your organization's policy en su lugar. Antes de v2.1.268, devolvía Unknown command: /schedule
  • Un Owner desactivó las tareas programadas para tu organización de Team o Enterprise. Antes de v2.1.227, el comando seguía apareciendo en este caso, y claude.ai rechazaba la tarea cuando Claude intentaba crearla o ejecutarla

A menos que la política de tu organización desactive las tareas programadas o las sesiones en la nube, puedes crear y administrar tareas programadas en claude.ai/code/routines sin importar cómo esté configurada la CLI.

"Routines are disabled by your organization's policy"

Probablemente un Owner de tu organización de Team o Enterprise desactivó el interruptor Scheduled tasks (Was Routines) en Organization settings > Capabilities > Remote sessions. En Claude Code v2.1.227 o posterior, el mismo interruptor también oculta /schedule en la CLI. Es una configuración de la organización del lado del servidor, por lo que no se puede anular desde tu configuración local. Pídele a un Owner que vuelva a activar las tareas programadas para tu organización.

Recursos relacionados

  • /loop y programación dentro de la sesión: programa tareas locales dentro de una sesión de CLI abierta
  • Tareas programadas de escritorio: tareas programadas locales que se ejecutan en tu máquina con acceso a archivos locales
  • Entornos en la nube: configura el acceso a la red, las variables de entorno y los scripts de configuración para sesiones en la nube
  • Proyectos: trabajo continuo que Claude coordina entre sesiones en la nube paralelas; las tareas programadas creadas desde un proyecto aparecen en su pestaña Scheduled tasks
  • Conectores MCP: conecta servicios externos como Slack, Linear y Google Drive
  • GitHub Actions: ejecuta Claude en tu pipeline de CI ante eventos del repositorio