Saltar al contenido principal
Las rutinas están en vista previa de investigación. El comportamiento, los límites y la superficie de la API pueden cambiar.
Una 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 rutinas se ejecutan en la infraestructura en la nube administrada por Anthropic, por lo que siguen funcionando cuando su portátil está cerrado. Cada rutina puede tener uno o más disparadores adjuntos:
  • Programada: se ejecuta en una cadencia recurrente como cada hora, cada noche o semanalmente
  • API: se activa bajo demanda enviando un POST HTTP a un punto final por rutina con un token de portador
  • GitHub: se ejecuta automáticamente en respuesta a eventos del repositorio como solicitudes de extracción o lanzamientos
Una única rutina puede combinar disparadores. Por ejemplo, una rutina de revisión de PR puede ejecutarse cada noche, activarse desde un script de implementación y también reaccionar a cada nuevo PR. Las rutinas están disponibles en planes Pro, Max, Team y Enterprise con Claude Code en la web habilitado. Créelas y adminístrelas en claude.ai/code/routines, o desde la CLI con /schedule. Esta página cubre la creación de una rutina, la configuración de cada tipo de disparador, la administración de ejecuciones y cómo se aplican los límites de uso.

​
Casos de uso de ejemplo

Cada ejemplo empareja un tipo de disparador con el tipo de trabajo para el que las rutinas son adecuadas: desatendido, repetible y vinculado a un resultado claro. Mantenimiento del trabajo pendiente. Un disparador de horario se ejecuta cada noche de la semana contra su rastreador de problemas a través de un conector. La rutina lee los problemas abiertos desde la última ejecución, aplica etiquetas, asigna propietarios según el área de código referenciada y publica un resumen en Slack para que el equipo comience el día con una cola organizada. Triaje de alertas. Su herramienta de monitoreo llama al punto final de la API de la rutina cuando se cruza un umbral de error, pasando el cuerpo de la alerta como text. La rutina extrae el seguimiento de pila, lo correlaciona con commits recientes en el repositorio y abre una solicitud de extracción en borrador con una corrección propuesta y un enlace de vuelta a la alerta. El personal de guardia revisa el PR en lugar de comenzar desde una terminal en blanco. Revisión de código personalizada. Un disparador de GitHub se ejecuta en pull_request.opened. La rutina aplica la lista de verificación de revisión de su equipo, deja comentarios en línea para problemas de seguridad, rendimiento y estilo, y agrega un comentario de resumen para que los revisores humanos puedan enfocarse en el diseño en lugar de verificaciones mecánicas. Verificación de implementación. Su canalización de CD llama al punto final de la API de la rutina después de cada implementación en producción. La rutina ejecuta verificaciones de humo contra la nueva compilación, escanea registros de errores en busca de regresiones y publica un sí o no al canal de lanzamiento antes de que se cierre la ventana de implementación. Desfase de documentación. Un disparador de horario se ejecuta semanalmente. La rutina escanea los PR fusionados desde la última ejecución, marca la documentación que hace referencia a API modificadas y abre PR de actualización contra el repositorio de documentación para que un editor revise. Puerto de biblioteca. Un disparador de GitHub se ejecuta en pull_request.closed filtrado a PR fusionados en un repositorio de SDK. La rutina porta el cambio a un SDK paralelo en otro idioma y abre un PR coincidente, manteniendo las dos bibliotecas sincronizadas sin que un humano reimplemente cada cambio. Las secciones a continuación le guían a través de la creación de una rutina y la configuración de cada uno de estos tipos de disparadores.

​
Crear una rutina

Cree una rutina desde la web, la aplicación de escritorio o la CLI. Las tres superficies escriben en la misma cuenta en la nube, por lo que una rutina que cree en la CLI aparece en claude.ai/code/routines inmediatamente. En la aplicación de escritorio, haga clic en Nueva tarea y elija Nueva tarea remota; elegir Nueva tarea local en su lugar crea una tarea programada local de escritorio, que se ejecuta en su máquina y no es una rutina. El formulario de creación configura el prompt de la rutina, repositorios, entorno, conectores y disparadores. Las rutinas se ejecutan de forma autónoma como sesiones completas de Claude Code en la nube: no hay selector de modo de permiso y no hay mensajes de aprobación durante una ejecución. La sesión puede ejecutar comandos de shell, usar skills comprometidas con el repositorio clonado y llamar a cualquier conector que incluya. Lo que una rutina puede alcanzar está determinado por los repositorios que seleccione y su configuración de rama-push, el acceso a la red del entorno y variables, y los conectores que incluya. Delimite cada uno de esos a lo que la rutina realmente necesita. Las rutinas pertenecen a su cuenta individual de claude.ai. No se comparten con compañeros de equipo y cuentan contra la asignación diaria de ejecuciones de su cuenta. Cualquier cosa que una rutina haga a través de su identidad de GitHub conectada o conectores aparece como usted: los commits y las solicitudes de extracción llevan su usuario de GitHub, y los mensajes de Slack, tickets de Linear u otras acciones de conectores utilizan sus cuentas vinculadas para esos servicios.

​
Crear desde la web

1

Abrir el formulario de creación

Visite claude.ai/code/routines y haga clic en Nueva rutina.
2

Nombrar la rutina y escribir el prompt

Dé a la rutina un nombre descriptivo y escriba el prompt que Claude ejecuta cada vez. El prompt es la parte más importante: la rutina se ejecuta de forma autónoma, por lo que el prompt debe ser autónomo y explícito sobre qué hacer y qué significa el éxito.La entrada del prompt incluye un selector de modelo. Claude utiliza el modelo seleccionado en cada ejecución.
3

Seleccionar repositorios

Agregue uno o más repositorios de GitHub para que Claude trabaje. Cada repositorio se clona al inicio de una ejecución, comenzando desde la rama predeterminada. Claude crea ramas con prefijo claude/ para sus cambios. Para permitir inserciones en cualquier rama, habilite Permitir inserciones de rama sin restricciones para ese repositorio.
4

Seleccionar un entorno

Elija un entorno en la nube para la rutina. Los entornos controlan a qué tiene acceso la sesión en la nube:
  • Acceso a la red: establezca el nivel de acceso a Internet disponible durante cada ejecución
  • Variables de entorno: proporcione claves de API, tokens u otros secretos que Claude pueda usar
  • Script de configuración: instale dependencias y herramientas que la rutina 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 Predeterminado. Para usar un entorno personalizado, cree uno antes de crear la rutina.
5

Seleccionar un disparador

En Seleccionar un disparador, elija cómo comienza la rutina. Puede elegir un tipo de disparador o combinar varios.
Elija una frecuencia preestablecida: cada hora, diaria, días de semana o semanal. Consulte Agregar un disparador de horario para el manejo de zonas horarias, escalonamiento e intervalos cron personalizados.
6

Revisar conectores

Todos sus conectores MCP conectados se incluyen de forma predeterminada. Elimine cualquiera que la rutina no necesite. Los conectores dan a Claude acceso a servicios externos como Slack, Linear o Google Drive durante cada ejecución.
7

Crear la rutina

Haga clic en Crear. La rutina aparece en la lista y se ejecuta la próxima vez que uno de sus disparadores coincida. Para iniciar una ejecución inmediatamente, haga clic en Ejecutar ahora en la página de detalles de la rutina.Cada ejecución crea una nueva sesión junto con sus otras sesiones, donde puede ver qué hizo Claude, revisar cambios y crear una solicitud de extracción.

​
Crear desde la CLI

Ejecute /schedule en cualquier sesión para crear una rutina programada conversacionalmente. También puede pasar una descripción directamente, como en /schedule daily PR review at 9am. Claude recorre la misma información que recopila el formulario web, luego guarda la rutina en su cuenta. /schedule en la CLI crea solo rutinas programadas. Para agregar un disparador de API o GitHub, edite la rutina en la web en claude.ai/code/routines. La CLI también admite la administración de rutinas existentes. Ejecute /schedule list para ver todas las rutinas, /schedule update para cambiar una, o /schedule run para activarla inmediatamente.

​
Crear desde la aplicación de escritorio

Abra la página Horario en la aplicación de escritorio, haga clic en Nueva tarea y elija Nueva tarea remota. La aplicación de escritorio muestra tanto tareas programadas locales como rutinas en la misma cuadrícula. Consulte Tareas programadas de escritorio para obtener detalles sobre la opción local.

​
Configurar disparadores

Una rutina comienza cuando uno de sus disparadores coincide. Puede adjuntar cualquier combinación de disparadores de horario, API y GitHub a la misma rutina, y agregarlos o quitarlos en cualquier momento desde la sección Seleccionar un disparador del formulario de edición de la rutina.

​
Agregar un disparador de horario

Un disparador de horario ejecuta la rutina en una cadencia recurrente. Elija una frecuencia preestablecida en la sección Seleccionar un disparador: cada hora, diaria, días de semana o semanal. Los tiempos se ingresan en su zona local y se convierten automáticamente, por lo que la rutina se ejecuta a esa hora de reloj de pared independientemente de dónde se encuentre la infraestructura en la nube. Las ejecuciones pueden comenzar unos minutos después de la hora programada debido al escalonamiento. El desplazamiento es consistente para cada rutina. Para un intervalo personalizado como cada dos horas o el primero de cada mes, elija el preestablecido más cercano en el formulario, luego ejecute /schedule update en la CLI para establecer una expresión cron específica. El intervalo mínimo es una hora; las expresiones que se ejecutan con más frecuencia se rechazan.

​
Agregar un disparador de API

Un disparador de API proporciona a una rutina un punto final HTTP dedicado. POSTear al punto final con el token de portador de la rutina inicia una nueva sesión y devuelve una URL de sesión. Úselo para conectar Claude Code en sistemas de alertas, canalizaciones de implementación, herramientas internas o en cualquier lugar donde pueda hacer una solicitud HTTP autenticada. Los disparadores de API se agregan a una rutina existente desde la web. La CLI actualmente no puede crear ni revocar tokens.
1

Abrir la rutina para editar

Vaya a claude.ai/code/routines, haga clic en la rutina que desea activar a través de API, luego haga clic en el icono de lápiz para abrir Editar rutina.
2

Agregar un disparador de API

Desplácese hasta la sección Seleccionar un disparador debajo del prompt, haga clic en Agregar otro disparador y elija API.
3

Copiar la URL y generar un token

El modal muestra la URL para esta rutina junto con un comando curl de ejemplo. Copie la URL, luego haga clic en Generar token y copie el token inmediatamente. El token se muestra una vez y no se puede recuperar más tarde, así que guárdelo en un lugar seguro como el almacén de secretos de su herramienta de alertas.
4

Llamar al punto final

Envíe el token en el encabezado Authorization: Bearer cuando POST a la URL. La sección Activar una rutina a continuación muestra un ejemplo completo.
Cada rutina tiene su propio token, limitado a activar solo esa rutina. Para rotarlo o revocarlo, vuelva al mismo modal y haga clic en Regenerar o Revocar.

​
Activar una rutina

Envíe una solicitud POST al punto final /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 un cuerpo de alerta o un registro fallido, pasado a la rutina junto con su prompt guardado. El valor es texto de forma libre y no se analiza: si envía JSON u otra carga útil estructurada, la rutina la recibe como una cadena literal. El ejemplo a continuación activa una rutina desde un shell: 
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 exitosa devuelve un cuerpo JSON con el nuevo ID de sesión y URL: 
{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}
Abra la URL de sesión en un navegador para ver la ejecución en tiempo real, revisar cambios o continuar la conversación manualmente.
El punto final /fire se envía bajo el encabezado beta experimental-cc-routine-2026-04-01. Las formas de solicitud y respuesta, los límites de velocidad y la semántica de tokens pueden cambiar mientras la característica está en vista previa de investigación. Los cambios importantes se envían detrás de nuevas versiones de encabezado beta con fecha, y las dos versiones de encabezado anteriores más recientes continúan funcionando para que los llamadores tengan tiempo de migrar.

​
Referencia de API

Para la referencia completa de la API, incluidas todas las respuestas de error, reglas de validación y límites de campo, consulte Activar una rutina a través de API en la documentación de la plataforma Claude. El punto final /fire está disponible solo para usuarios de claude.ai y no es parte de la superficie de la API de Claude Platform.

​
Agregar un disparador de GitHub

Un disparador de GitHub inicia una nueva sesión automáticamente cuando ocurre un evento coincidente en un repositorio conectado. Cada evento coincidente inicia su propia sesión.
Durante la vista previa de investigación, los eventos de webhook de GitHub están sujetos a límites por hora por rutina y por cuenta. Los eventos más allá del límite se descartan hasta que se reinicia la ventana. Vea sus límites actuales en claude.ai/code/routines.
Los disparadores de GitHub se configuran solo desde la interfaz de usuario web.
1

Abrir la rutina para editar

Vaya a claude.ai/code/routines, haga clic en la rutina, luego haga clic en el icono de lápiz para abrir Editar rutina.
2

Agregar un disparador de evento de GitHub

Desplácese hasta la sección Seleccionar un disparador, haga clic en Agregar otro disparador y elija Evento de GitHub.
3

Instalar la aplicación Claude GitHub

La aplicación Claude GitHub debe estar instalada en el repositorio al que desea suscribirse. La configuración del disparador le solicita que la instale si aún no está instalada.
Ejecutar /web-setup en la CLI otorga acceso al repositorio para clonar, pero no instala la aplicación Claude GitHub y no habilita la entrega de webhook. Los disparadores de GitHub requieren instalar la aplicación Claude GitHub, que la configuración del disparador le solicita que haga.
4

Configurar el disparador

Seleccione el repositorio, elija un evento de la lista de eventos admitidos y opcionalmente agregue filtros. Guarde el disparador.

​
Eventos admitidos

Los disparadores de GitHub pueden suscribirse a cualquiera de las siguientes categorías de eventos. Dentro de cada categoría, puede elegir una acción específica, como pull_request.opened, o reaccionar a todas las acciones en la categoría.
EventoSe activa cuando
Solicitud de extracciónSe abre, cierra, asigna, etiqueta, sincroniza o actualiza de otra manera un PR
LanzamientoSe crea, publica, edita o elimina un lanzamiento

​
Filtrar solicitudes de extracción

Use filtros para reducir qué solicitudes de extracción inician una nueva sesión. Todas las condiciones de filtro deben coincidir para que la rutina se active. Los campos de filtro disponibles son:
FiltroCoincide
AutorNombre de usuario de GitHub del autor del PR
TítuloTexto del título del PR
CuerpoTexto de descripción del PR
Rama baseRama a la que se dirige el PR
Rama principalRama de la que proviene el PR
EtiquetasEtiquetas aplicadas al PR
Es borradorSi el PR está en estado de borrador
Está fusionadoSi el PR ha sido fusionado
Desde bifurcaciónSi el PR proviene de una bifurcación
Cada filtro empareja 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 prueba el valor de campo completo, no una subcadena dentro de él. Para coincidir con cualquier título que contenga hotfix, escriba .*hotfix.*. Sin el .* circundante, el filtro coincide solo con un título que es exactamente hotfix sin nada antes o después. Para coincidencia de subcadena literal sin sintaxis regex, use el operador contains en su lugar. Algunos ejemplos de combinaciones de filtros:
  • Revisión del módulo de autenticación: rama base main, rama principal contiene auth-provider. Envía cualquier PR que toque autenticación a un revisor enfocado.
  • Triaje de colaborador externo: desde bifurcación es true. Enruta cada PR basado en bifurcación a través de una revisión de seguridad y estilo adicional antes de que un humano lo vea.
  • Solo listo para revisión: es borrador es false. Omite borradores para que la rutina solo se ejecute cuando el PR esté listo para revisión.
  • Retroportación controlada por etiqueta: las etiquetas incluyen needs-backport. Activa una rutina de puerto a otra rama solo cuando un mantenedor etiqueta el PR.

​
Cómo se asignan las sesiones a los eventos

Cada evento de GitHub coincidente inicia una nueva sesión. La reutilización de sesiones entre eventos no está disponible para rutinas activadas por GitHub, por lo que dos actualizaciones de PR producen dos sesiones independientes.

​
Administrar rutinas

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

​
Ver e interactuar con ejecuciones

Haga clic en cualquier ejecución para abrirla como una sesión completa. Desde allí puede ver qué hizo Claude, revisar cambios, crear una solicitud de extracción o continuar la conversación. Cada sesión de ejecución funciona como cualquier otra sesión: use el menú desplegable junto al título de la sesión para renombrar, archivar o eliminar.

​
Editar y controlar rutinas

Desde la página de detalles de la rutina puede:
  • Haga clic en Ejecutar ahora para iniciar una ejecución inmediatamente sin esperar la próxima hora programada.
  • Use el botón de alternancia en la sección Se repite para pausar o reanudar el horario. Las rutinas pausadas mantienen su configuración pero no se ejecutan hasta que las vuelva a habilitar.
  • Haga clic en el icono de lápiz para abrir Editar rutina y cambiar el nombre, prompt, repositorios, entorno, conectores o cualquiera de los disparadores de la rutina. La sección Seleccionar un disparador es donde agrega o elimina horarios, tokens de API y disparadores de eventos de GitHub.
  • Haga clic en el icono de eliminar para eliminar la rutina. Las sesiones anteriores creadas por la rutina permanecen en su lista de sesiones.

​
Repositorios y permisos de rama

Las rutinas necesitan acceso a GitHub para clonar repositorios. Cuando crea una rutina desde la CLI con /schedule, Claude verifica si su cuenta tiene GitHub conectado y le solicita que ejecute /web-setup si no es así. Consulte Opciones de autenticación de GitHub para las dos formas de otorgar acceso. Cada repositorio que agregue se clona en cada ejecución. Claude comienza desde la rama predeterminada del repositorio a menos que su prompt especifique lo contrario. De forma predeterminada, Claude solo puede insertar en ramas con prefijo claude/. Esto evita que las rutinas modifiquen accidentalmente ramas protegidas o de larga duración. Para eliminar esta restricción para un repositorio específico, habilite Permitir inserciones de rama sin restricciones para ese repositorio al crear o editar la rutina.

​
Conectores

Las rutinas pueden usar sus conectores MCP conectados para leer y escribir en servicios externos durante cada ejecución. Por ejemplo, una rutina que clasifica solicitudes de soporte podría leer de un canal de Slack y crear problemas en Linear. Cuando crea una rutina, todos sus conectores actualmente conectados se incluyen de forma predeterminada. Elimine cualquiera que no sea necesario para limitar a qué herramientas tiene acceso Claude durante la ejecución. También puede agregar conectores directamente desde el formulario de rutina. Para administrar o agregar conectores fuera del formulario de rutina, visite Configuración > Conectores en claude.ai o use /schedule update en la CLI.

​
Entornos

Cada rutina se ejecuta en un entorno en la nube que controla el acceso a la red, variables de entorno y scripts de configuración. Configure entornos antes de crear una rutina para dar a Claude acceso a API, instalar dependencias o restringir el alcance de la red. Consulte entorno en la nube para la guía de configuración completa.

​
Uso y límites

Las rutinas reducen el uso de suscripción de la misma manera que lo hacen las sesiones interactivas. Además de los límites de suscripción estándar, las rutinas tienen un límite diario de cuántas ejecuciones pueden comenzar por cuenta. Vea su consumo actual y ejecuciones diarias de rutina restantes en claude.ai/code/routines o claude.ai/settings/usage. Cuando una rutina alcanza el límite diario o el límite de uso de su suscripción, las organizaciones con uso adicional habilitado pueden continuar ejecutando rutinas en exceso medido. Sin uso adicional, las ejecuciones adicionales se rechazan hasta que se reinicia la ventana. Habilite el uso adicional desde Configuración > Facturación en claude.ai.

​
Recursos relacionados