Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
- Programada: se ejecuta en una cadencia recurrente como cada hora, cada noche o semanalmente, o una sola vez en un momento futuro específico
- 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
/schedule.
Los administradores de Team y Enterprise pueden desactivar las rutinas para todos los miembros con el botón de alternancia Routines en claude.ai/admin-settings/claude-code. Cuando se desactivan, las rutinas existentes dejan de ejecutarse y los miembros no pueden crear nuevas.
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 comotext. 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 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 rutina que cree en una aparece en las otras inmediatamente. En la aplicación de escritorio, haga clic en Routines en la barra lateral, luego en New routine, y elija Remote; elegir Local en su lugar crea una tarea programada de escritorio, que se ejecuta en su máquina en lugar de en la nube. 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
Abrir el formulario de creación
Nombrar la rutina y escribir el prompt
Seleccionar repositorios
claude/ para sus cambios.Seleccionar un entorno
- Network access: establezca el nivel de acceso a Internet disponible durante cada ejecución
- Environment variables: proporcione claves de API, tokens u otros secretos que Claude pueda usar
- Setup script: 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
Seleccionar un disparador
- Schedule
- GitHub event
- API
Revisar conectores y permisos
claude/.Crear la rutina
Crear desde la CLI
Ejecute/schedule en cualquier sesión para crear una rutina programada conversacionalmente. También puede pasar una descripción directamente, para una rutina 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 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.
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 Select a trigger del formulario de edición de la rutina.Agregar un disparador de horario
Un disparador de horario ejecuta la rutina en una cadencia recurrente, o una sola vez en un momento futuro específico. Elija una frecuencia preestablecida en la sección Select a trigger: 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.
Programar una ejecución única
Una programación única dispara la rutina una sola vez en una marca de tiempo específica. Úsela para recordarse más adelante en la semana, para abrir un PR de limpieza después de que finalice un despliegue, o para iniciar una tarea de seguimiento cuando llega un cambio ascendente. Después de que se dispara la rutina, se desactiva automáticamente y la interfaz de usuario web la marca como Ran. Para ejecutarla nuevamente, edite la rutina y establezca una nueva hora única. Cree una ejecución única desde la CLI describiendo la hora en lenguaje natural. Claude resuelve la frase contra la hora actual y confirma la marca de tiempo absoluta antes de guardar.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.Abrir la rutina para editar
Agregar un disparador de API
Copiar la URL y generar un token
Llamar al punto final
Authorization: Bearer cuando POST a la URL. La sección Trigger a routine a continuación muestra un ejemplo completo.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:
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 Trigger a routine via 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.Abrir la rutina para editar
Agregar un disparador de evento de GitHub
Instalar la aplicación Claude GitHub
/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.Configurar 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, comopull_request.opened, o reaccionar a todas las acciones en la categoría.
| Evento | Se activa cuando |
|---|---|
| Solicitud de extracción | Se abre, cierra, asigna, etiqueta, sincroniza o actualiza de otra manera un PR |
| Lanzamiento | Se 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:| Filtro | Coincide |
|---|---|
| Autor | Nombre de usuario de GitHub del autor del PR |
| Título | Texto del título del PR |
| Cuerpo | Texto de descripción del PR |
| Rama base | Rama a la que se dirige el PR |
| Rama principal | 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 |
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 contieneauth-provider. Envía cualquier PR que toque autenticación a un revisor enfocado. - 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 Run now para iniciar una ejecución inmediatamente sin esperar la próxima hora programada.
- Use el botón de alternancia en la sección Repeats 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 Edit routine y cambiar el nombre, prompt, repositorios, entorno, conectores o cualquiera de los disparadores de la rutina. La sección Select a trigger 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 Allow unrestricted branch pushes 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. Los conectores son las integraciones de claude.ai en su cuenta. Los servidores MCP que agregó localmente en la CLI conclaude mcp add se almacenan en su máquina en lugar de su cuenta de claude.ai, por lo que no aparecen en la lista de conectores. Para usar uno de esos servidores en una rutina, agréguelo como conector en claude.ai/customize/connectors, o declárelo en un .mcp.json confirmado para que sea parte del repositorio clonado.
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 Settings > Connectors en claude.ai o use /schedule update en la CLI.
Entornos y acceso a la red
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. La rutina hereda la política de red del entorno en cada ejecución. El entorno Default utiliza acceso a la red Trusted: la lista de permitidos predeterminada de registros de paquetes, API de proveedores de nube, registros de contenedores y dominios de desarrollo comunes es accesible, pero los dominios arbitrarios no. Las solicitudes salientes a otros hosts fallan con403 y x-deny-reason: host_not_allowed. El tráfico del conector MCP se enruta a través de los servidores de Anthropic, por lo que los conectores que agregue a la rutina funcionan sin agregar sus hosts a Allowed domains. Elimine cualquier conector que no necesite en Conectores.
Para permitir dominios adicionales:
Abra la rutina para editar
Abra el selector de entorno
Abra la configuración del entorno
Cambie el nivel de acceso a la red
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 créditos de uso habilitados pueden continuar ejecutando rutinas en exceso medido. Sin créditos de uso, las ejecuciones adicionales se rechazan hasta que se reinicia la ventana. Habilite los créditos de uso desde Settings > Billing en claude.ai. Las ejecuciones únicas no cuentan contra el límite diario de ejecuciones de rutina. Reducen su uso de suscripción regular como cualquier otra sesión, pero están exentas de la asignación diaria de ejecuciones de rutina por cuenta.Solución de problemas
/schedule devuelve “Unknown command”
La CLI oculta /schedule cuando uno de sus requisitos no se cumple. La causa suele ser una de las siguientes:
- Está autenticado con una clave de API de Console o un proveedor de nube como Bedrock, Vertex o Foundry.
/schedulerequiere un inicio de sesión de suscripción de claude.ai. SiANTHROPIC_API_KEYoANTHROPIC_AUTH_TOKENestá configurado en su shell, oapiKeyHelperestá configurado ensettings.json, elimínelo primero, ya que estos tienen prioridad sobre un inicio de sesión de claude.ai DISABLE_TELEMETRY,DO_NOT_TRACK,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICoDISABLE_GROWTHBOOKestá configurado en su entorno de shell o en el bloqueenvde un archivosettings.json. Estos desactivan la obtención de indicadores de características, de la que depende/schedule- Se encuentra dentro de una sesión de Claude Code en la web. Administre rutinas desde la interfaz web en su lugar
- Su CLI es anterior a v2.1.81. Ejecute
claude update
”Routines are disabled by your organization’s policy”
Su administrador de Team o Enterprise probablemente ha desactivado el botón de alternancia Routines en claude.ai/admin-settings/claude-code. Esta es una configuración de organización del lado del servidor, por lo que no se puede anular desde su configuración local. Póngase en contacto con su administrador para solicitar que se habiliten las rutinas para su organización.Recursos relacionados
/loope programación en sesión: programe tareas locales dentro de una sesión de CLI abierta- Tareas programadas de escritorio: tareas programadas locales que se ejecutan en su máquina con acceso a archivos locales
- Entorno en la nube: configure el entorno de tiempo de ejecución para sesiones en la nube
- Conectores MCP: conecte servicios externos como Slack, Linear y Google Drive
- GitHub Actions: ejecute Claude en su canalización de CI en eventos del repositorio