Automatizar tu repo de GitHub con Claude

Al terminar vas a poder mencionar a @claude en cualquier issue o Pull Request y que actúe solo: implementa el cambio, abre un PR y te lo deja listo para revisar. Tu repositorio pasa a tener un colaborador que trabaja en la nube de GitHub Actions, sin que tú tengas que abrir la terminal ni mantener una máquina encendida. Es la diferencia entre tener un asistente que solo vive en tu portátil y tener un compañero que responde desde el repositorio donde el equipo trabaja todos los días.

El problema concreto que cierra esta lección es el de la fricción entre “lo discutimos en el issue” y “alguien tiene que sentarse a programarlo”. Cuando @claude entra al equipo, esa fricción desaparece para tareas pequeñas y medianas: describes el cambio en lenguaje natural en el issue, lo mencionas, y la Action arranca, lee el código, escribe el cambio, abre el PR y se queda esperando tu revisión. Sigue habiendo revisión humana (el PR no se mergea solo), pero el tramo de “escribir el código” lo cubre el agente.

Treinta minutos suele bastar si vas por el camino fácil (la GitHub App instalada con /install-github-app). Si prefieres el camino manual o tu repo vive en una organización con permisos restringidos, súmale otro rato para coordinar con quien administre.

Antes de empezar

Necesitas ser admin del repositorio para poder instalar la GitHub App, crear workflows y cargar secretos. Si el repo es personal, no hay problema; si pertenece a una organización, pide a quien administre que apruebe la app antes de empezar. Si te falta alguno de los requisitos listados (Claude Code en local, API key con crédito) repasa primero la lección de Claude Code y abre tu cuenta de Anthropic con un plan que incluya crédito disponible.

Conviene probar todo esto en un repositorio privado o de juguete antes de soltarlo en producción. Como cualquier persona con permiso de comentar en el repositorio puede invocar la Action mencionando a @claude, en un repositorio público te puedes gastar crédito muy deprisa si no afinas los disparadores. Empieza pequeño, observa el comportamiento un par de días y luego amplía.

El recorrido completo

El primer paso, el comando /install-github-app desde Claude Code, es el atajo recomendado. Cuando lo ejecutas dentro de un repositorio, Claude se encarga del setup completo: te abre el navegador para instalar la GitHub App de Claude en tu cuenta u organización, te pide elegir el repositorio donde lo activas, crea el archivo de workflow en .github/workflows/ y carga el secreto con la API key. Lo que harías a mano en quince minutos lo resuelve en uno. Lo único que tienes que hacer es ejecutarlo desde la sesión de Claude Code abierta dentro de la carpeta del repositorio, no desde una cualquiera, porque necesita el contexto del repo.

La alternativa manual es útil si quieres entender qué pasa por debajo o si el comando automático te falla. Consiste en crear el archivo .github/workflows/claude.yml con la configuración mínima que se ve en el frontmatter: la Action escucha el evento issue_comment (es decir, comentarios nuevos en issues y PRs), corre en un runner de Ubuntu y delega el trabajo a la Action oficial de Anthropic. El bloque with es donde le pasas la API key como variable secreta. Para producción real, revisa el README del repo oficial de la Action: hay inputs adicionales (filtros por usuario, restricciones por etiqueta, parámetros del modelo) que conviene conocer.

Cargar el secreto con tu API key es trivial pero importante. En GitHub, dentro del repositorio, vas a Settings, luego a Secrets and variables, después Actions y “New repository secret”. El nombre debe ser exactamente ANTHROPIC_API_KEY (mayúsculas y guión bajo) porque es el que el workflow espera por defecto. El valor es tu API key de Anthropic; si todavía no la tienes, créala desde el dashboard de la API en console.anthropic.com. Si has usado el camino del paso 1, la app suele dejar esto hecho automáticamente, pero conviene confirmar que el secreto está cargado antes de probar.

Usar @claude es la prueba de fuego. Crea un issue o un PR de prueba, escribe un comentario que empiece mencionando a @claude (por ejemplo: “@claude lee el archivo README y propón mejoras en la sección de instalación, abre un PR con los cambios”). Al publicar el comentario, GitHub dispara el evento, la Action arranca y Claude lee el repositorio entero como contexto. En cuestión de minutos verás aparecer una respuesta en el hilo, o directamente un PR nuevo si pediste cambios concretos. La primera vez tarda más porque el runner se levanta desde cero; las siguientes son más ágiles.

El detalle que hace o rompe el flujo es la calidad del comentario inicial. Un “@claude arregla esto” sin más obliga al agente a adivinar; un “@claude el campo email del formulario en src/components/Contact.jsx no valida correos con punto antes del @, añade validación regex y un test unitario” deja claras las fronteras de la tarea. Como en cualquier interacción con un agente, cuanto más contexto le des en el comentario, mejor sale el resultado y menos crédito se gasta.

A medida que te acostumbres, vas a querer afinar los disparadores. La configuración mínima del frontmatter dispara la Action en cualquier issue_comment, pero la Action oficial soporta más eventos: aperturas de issues con cierta etiqueta, comentarios en PRs, etc. Cuanto más selectivos sean los disparadores, menos sorpresas y menos consumo. Revisa el README de la Action para conocer todos los on: que admite.

Cómo saber que cada parte funciona

Tras instalar la GitHub App (camino automático o manual), en Settings → Integrations o equivalente del repositorio debe aparecer la app de Claude con permiso sobre el repo. Tras crear el secreto, en Settings → Secrets and variables → Actions debe aparecer ANTHROPIC_API_KEY en la lista (no se muestra el valor, solo el nombre). Tras crear el workflow, ese archivo debe estar en .github/workflows/claude.yml y aparecer en la pestaña Actions del repositorio como un workflow disponible.

La prueba definitiva es comentar @claude di hola en un issue de prueba. En menos de un minuto debes ver actividad en la pestaña Actions (una corrida en curso o terminada). Si la corrida termina en verde, Claude debería haber respondido en el hilo. Si termina en rojo, abre la corrida y mira los logs: los errores más típicos están listados abajo.

Errores frecuentes y cómo salir de ellos

• /install-github-app no hace nada. Corre el comando desde Claude Code parado dentro de la carpeta del repo, no en una carpeta cualquiera, y con la sesión de Claude ya iniciada. Si sigue sin reaccionar, verifica que tu Claude Code esté actualizado.
• @claude no responde al comentario. Ve a la pestaña Actions del repositorio y mira si el workflow se disparó. Si no aparece corrida, revisa que el archivo del workflow esté en .github/workflows/ y que el evento configurado (issue_comment) coincida con dónde estás comentando.
• La Action corre pero falla con error de autenticación. Verifica que el secreto se llame exactamente ANTHROPIC_API_KEY y que tu cuenta de Anthropic tenga crédito disponible. Errores 401 o 403 en los logs apuntan casi siempre a esto.
• Claude abre el PR pero contra la rama equivocada. Indícale en el comentario contra qué rama base quieres el PR (“@claude abre el PR contra develop, no contra main”). El agente respeta lo que le pides cuando lo dejas claro.
• Tarda mucho en arrancar. La primera corrida del día levanta el runner desde cero; las siguientes son más rápidas. Si tarda más de cinco minutos sin avanzar, revisa el estado de GitHub Actions en su página de estado.
• Cualquiera puede invocar a @claude y se dispara la cuota. En repos públicos, esto es un riesgo real. Restringe el evento por etiqueta, por usuario que comenta o por rama; la Action oficial admite filtros para esto. Mientras tanto, cambia a repositorio privado o de prueba.

Variaciones útiles

Si trabajas solo, el setup automático es suficiente y no necesitas más sofisticación: invocar a @claude desde issues y PRs te cubre. Si trabajas en equipo, considera limitar la Action a usuarios concretos del equipo o a etiquetas específicas, para evitar disparos no deseados; añade también revisión obligatoria del PR antes de mergear, así nadie acepta a ciegas lo que Claude propone.

Si tu repositorio es público y temes el consumo, restringe la Action a comentarios de personas del equipo (la Action soporta un input para eso). Si tu equipo combina Claude con Codex como segunda opinión, conecta esta lección con la de “Usa Claude y Codex en equipo”: deja a Claude implementar en los PRs y haz que Codex audite antes de mergear. Para flujos más complejos, conecta la Action con otros workflows (tests, despliegues) usando outputs y dependencias entre jobs.

Siguiente paso

Una vez que tengas @claude operativo, configúrale tareas recurrentes: que reaccione también a aperturas de issues con cierta etiqueta, no solo a comentarios; que revise automáticamente cada PR nuevo antes de pedir revisión humana; que actualice dependencias en una rama dedicada cuando lo solicites. El siguiente salto natural es integrar el deploy continuo: cuando un PR generado por Claude se mergea, que se despliegue solo (la lección “Automatizar tus despliegues en Render” cubre ese tramo). Y si quieres elevar la calidad del código que Claude produce, combínalo con la revisión cruzada de la lección “Usa Claude y Codex en equipo”, para tener dos modelos mirando el mismo cambio antes de aprobarlo.