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
Condiciones de la prueba
- Fecha: 16 de noviembre de 2026.
- Entorno: rutinas en la nube de Claude Code, que corren sesiones aisladas en la infraestructura de Anthropic. Entorno por defecto, modelo
claude-sonnet-5-5, con suscripción y sin API. - Permisos: sin conectores. La rutina solo tenía las herramientas Bash, Read, Write, Edit, Glob y Grep.
- Repositorio: privado y de prueba, con tres comentarios
TODO(etiqueta)ficticios ensrc/y undocs/pendientes.mdvacío. Sin datos personales. - Tarea de la rutina: convertir los TODO en una tabla dentro de
docs/pendientes.md.
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:
- Horario cuando el trabajo es periódico y no depende de nada concreto: un resumen semanal, una limpieza, un informe. La programación recurrente admite como mínimo una ejecución por hora, con cron en UTC. En nuestra prueba usamos una ejecución puntual a una hora exacta.
- Evento cuando algo concreto debe provocar el trabajo: una etiqueta en un issue, un PR abierto. Aquí el disparador fue
issues.labeledde GitHub.
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ó
| Prueba | Disparador | Qué esperábamos | Resultado |
|---|---|---|---|
| T1 | Horario: ejecución puntual a las 22:00:00Z | Se 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. |
| T2 | Eventos ajenos: issues.opened e issue_comment.created | No disparan la rutina. | Pasa. Sin ejecuciones ocho minutos después. |
| T3 | Evento: 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 gratisT3: 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
- 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.
- 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.
- 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
- Un modelo, una versión y una ejecución por disparador, con un repositorio minúsculo y datos ficticios.
- La API de disparadores por evento no está documentada en la skill que usamos. Dedujimos los campos de los errores de validación, y hace falta que la app de GitHub de Claude tenga acceso al repositorio.
- La prueba de horario usó una ejecución puntual, no una programación recurrente.
- Las rutinas no se pueden borrar por API: se eliminan desde la página de rutinas. La de horario ya había terminado y la de evento la desactivamos al acabar.
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