Rutinas de Claude Code: horario frente a evento de GitHub (prueba real)

Por David Moya · · 8 min lectura · Artículo técnico

Prueba del 16 de noviembre de 2026 con claude-sonnet-5-5: dos disparadores, PR sin fusionar y una trampa con las etiquetas.

Rutinas de Claude Code por horario y por evento de GitHub

Una rutina de Claude Code puede arrancar a una hora fijada o cuando ocurre algo en GitHub, y en ambos casos puede dejar su trabajo como un pull request para que una persona lo revise. El 16 de noviembre de 2026 probamos los dos disparadores con un repositorio ficticio y el modelo claude-sonnet-5-5. Los dos funcionaron. Pero encontramos una trampa: no pudimos filtrar el evento por nombre de etiqueta, así que cualquier etiqueta habría disparado la rutina.

En este artículo

  1. Condiciones de la prueba
  2. Horario o evento: cuál elegir
  3. Qué probamos y qué pasó
  4. El cambio llega siempre para revisión
  5. La trampa: el filtro por etiqueta
  6. Límites
  7. Preguntas frecuentes

Condiciones de la prueba

Es una prueba pequeña y de una sola ejecución por disparador. Enseña el mecanismo y sus bordes, no la fiabilidad a largo plazo.

Horario o evento: cuál elegir

En su ponencia de Code with Claude 2026, Maya Nielan explica cómo decidir entre un horario y un evento, en el minuto 09:31. Nuestro resumen de la idea, con palabras propias:

La ponencia muestra una rutina programada en el 14:00 y pasa a una activada por GitHub en el 15:07. Su demostración, sobre repositorios de ejemplo, prepara cambios de documentación para revisión. Puedes ver la grabación y la ficha de la sesión. Nuestra prueba es independiente y no replica su demostración.

Qué probamos y qué pasó

PruebaDisparadorQué esperábamosResultado
T1Horario: ejecución puntual a las 22:00:00ZSe ejecuta a la hora y deja el cambio para revisión.Pasa. Sesión a las 22:00:19Z y PR a las 22:00:36Z, en una rama propia. Solo cambia docs/pendientes.md. Sin push a main.
T2Eventos ajenos: issues.opened e issue_comment.createdNo disparan la rutina.Pasa. Sin ejecuciones ocho minutos después.
T3Evento: issues.labeled con la etiqueta «documentar» (22:02:20Z)Se dispara y deja el cambio para revisión.Pasa. Sesión a las 22:02:22Z (2 s) y PR a las 22:02:35Z (15 s), en otra rama propia.

T1: el horario

La sesión arrancó 19 segundos después de la hora fijada y el PR llegó a los 36. Solo tocó docs/pendientes.md, con las tres filas correctas, y no hizo push a main.

T2: los eventos ajenos

Abrimos un issue y le añadimos un comentario. Ocho minutos después, la lista de ejecuciones seguía vacía. Esto demuestra que la rutina no se dispara con cualquier evento: solo con el tipo que configuramos. No demuestra nada sobre qué etiqueta lo dispara, y de eso trata la trampa.

Practica con módulos gratuitos

Si quieres aprender a trabajar con agentes de IA paso a paso, empieza por los módulos gratuitos de IAcademy.

Empieza gratis

T3: el evento

Etiquetamos ese mismo issue con «documentar». La sesión se creó a los 2 segundos y el PR llegó 15 segundos después de la etiqueta. La rutina identificó el issue por el contexto del evento y escribió la misma tabla que la de horario, con una línea final distinta:

-(vacía)
+| fichero:línea | etiqueta | texto |
+|---|---|---|
+| src/informe.py:5 | docs | añadir ejemplo de salida |
+| src/inventario.py:5 | docs | documentar el formato de items en docs/pendientes.md |
+| src/inventario.py:10 | validacion | rechazar listas vacías con un error claro |
+
+Generado por la rutina PV-11 · disparador: evento · issue #1

El cambio llega siempre para revisión

En las dos ejecuciones la rutina trabajó en una rama propia, abrió un PR sin fusionar y no tocó src/. Respetó el CLAUDE.md del repositorio, que es el sitio donde fijamos esas reglas (tienes una guía de CLAUDE.md). Es el mismo principio que la ponencia enseña en el minuto 13:04: dejar el cambio para intervención humana y comprobar la salida antes de aceptarla.

Un PR sin fusionar es una buena frontera. La rutina hace el trabajo repetitivo y la persona conserva la decisión. Si además tienes una puerta de CI, como contamos en Claude Code en CI/CD, el PR pasa por las mismas comprobaciones que cualquier otro. Y si quieres saber qué ocurre cuando el cambio es correcto en apariencia pero rompe un resultado, lee verificar en cuatro niveles los cambios de un agente.

La trampa: el filtro por etiqueta

Queríamos que la rutina actuara solo con la etiqueta «documentar». Desde la API, el filtro por nombre de etiqueta no se pudo configurar: el campo filter.label se rechazó con un error de validación («Extra inputs are not permitted») y un filtro vacío sí se aceptó. Tal como quedó, cualquier etiqueta dispara la rutina.

Qué significa

T2 prueba la exclusión por tipo de evento, no por etiqueta. Con el filtro vacío, añadir «urgente» o «duplicado» a cualquier issue habría lanzado una sesión igual que «documentar», con su consumo y su PR.

Cómo mitigarlo

  1. Comprobación en el prompt. Que la primera instrucción sea leer el evento y salir sin cambios si la etiqueta no es la esperada. La sesión se crea igual, pero no produce ramas ni PR. No la probamos en este ensayo, así que es una propuesta:
Antes de hacer nada, lee el evento. Si la etiqueta añadida no es
«documentar», termina sin cambios y responde «Etiqueta ajena: sin acción».
Si lo es: regenera docs/pendientes.md a partir de los TODO(...) de src/,
trabaja en una rama nueva, abre un PR y no lo fusiones.
  1. Configuración en la interfaz. Revisa en la página de rutinas de claude.ai/code si allí se ofrece un filtro por etiqueta. No lo comprobamos, por eso no lo damos por hecho.
  2. Revisión humana como red. Ya existe: el cambio es un PR sin fusionar. Una ejecución de más cuesta consumo, no un cambio no deseado en la rama principal.

Si automatizas con etiquetas, trátalas como una entrada no fiable: cualquiera con permiso para etiquetar puede iniciar una ejecución. Con pocos permisos de la rutina (aquí, sin conectores) el daño posible queda acotado.

Límites

Preguntas frecuentes

¿Qué diferencia hay entre una rutina por horario y una por evento?

La de horario arranca a una hora fijada, con un mínimo de una ejecución por hora en las recurrentes. La de evento arranca cuando GitHub notifica algo concreto, como una etiqueta añadida a un issue.

¿Una rutina de Claude Code puede cambiar directamente mi rama principal?

En nuestra prueba no lo hizo: trabajó en una rama propia y abrió un PR sin fusionar. Que no lo haga depende de las reglas del repositorio y de los permisos que le des.

¿Puedo limitar una rutina por evento a una etiqueta concreta?

Desde la API no pudimos: el filtro por etiqueta se rechazó y cualquier etiqueta la dispara. Hay que comprobar la etiqueta en el prompt o ver si la interfaz ofrece el filtro.

Llévate el checklist para evaluar agentes

17 comprobaciones sacadas de estas pruebas: qué puede tocar el agente, cómo se verifica lo que cambia, cómo se evalúa cuando no basta un test y qué hay que dejar anotado. Gratis, en PDF.

Descargar el checklist

«Claude», «Claude Code» y «Anthropic» son marcas de Anthropic, PBC. IAcademy es un proyecto educativo independiente, sin afiliación con Anthropic ni con las empresas citadas.