≡En resumen
- La acción anthropics/claude-code-action@v1 ejecuta Claude Code dentro de GitHub Actions.
- Con /install-github-app se instala la app de GitHub, se guarda el secreto y se prepara el flujo en un pull request.
- Sin prompt, responde a menciones de @claude; con prompt, se ejecuta sola ante cualquier evento, incluido un cron.
- Solo usuarios con permiso de escritura pueden activarla y los bots están bloqueados salvo que los autorices.
- Cada ejecución consume minutos de GitHub Actions y tokens de Claude: limita turnos y tiempos.
01 ¿Qué es Claude Code GitHub Actions?
Claude Code GitHub Actions es una acción oficial de Anthropic que lleva Claude Code a los flujos de trabajo de GitHub. En lugar de abrir una terminal, escribes @claude en un comentario de una issue o de un pull request y Claude trabaja directamente sobre el repositorio en un runner de GitHub: lee el código, propone o implementa cambios, sube commits y responde en el mismo hilo.
También funciona sin mención: le das un prompt en el archivo del flujo de trabajo y se ejecuta ante cualquier evento de GitHub, por ejemplo cada vez que se abre un pull request o cada mañana a las 9. Por dentro está construida sobre el Claude Agent SDK, el mismo motor que el modo headless de Claude Code.
02 Cómo instalar Claude Code GitHub Actions
Hay dos caminos y ambos requieren permisos de administrador en el repositorio. La instalación rápida solo funciona con repositorios de github.com y necesita la CLI de GitHub autenticada con gh auth login.
-
1
Instalación rápida
Abre Claude Code en el repositorio y ejecuta /install-github-app. Instala la app de GitHub de Claude, guarda el secreto de autenticación y abre un pull request con los archivos del flujo.
-
2
Instalación manual: la app
Instala la app de Claude para GitHub en el repositorio. La acción usa sus permisos de contenido, issues y pull requests de lectura y escritura.
-
3
Instalación manual: el secreto
Añade ANTHROPIC_API_KEY con una clave de la Claude Console, o CLAUDE_CODE_OAUTH_TOKEN generado con claude setup-token si usas una suscripción Pro, Max, Team o Enterprise.
-
4
Instalación manual: el flujo
Copia el ejemplo claude.yml del repositorio oficial de la acción en .github/workflows/.
-
5
Prueba
Fusiona el pull request y menciona @claude en una issue o un comentario de pull request.
03 Modo interactivo y modo automatización
La acción decide cómo trabajar según el archivo del flujo: si incluye o no un prompt.
| Modo | Cuándo se activa | Dónde aparece el resultado |
|---|---|---|
| Interactivo (sin prompt) | Cuando alguien escribe @claude en un comentario, una revisión o el título o cuerpo de una issue nueva | En un comentario de la issue o del pull request, que Claude va actualizando |
| Automatización (con prompt) | Ante el evento configurado: pull request, push, cron u otro | En el registro de la ejecución, salvo que el prompt indique publicar un comentario |
En modo automatización con un prompt de texto, Claude no tiene acceso a la shell ni a la API de GitHub hasta que le das las herramientas necesarias con --allowedTools en claude_args. Si el prompt invoca una skill, puede usar las herramientas que la propia skill declare.
04 Ejemplos de flujos con Claude Code GitHub Actions
Responder a @claude
El flujo básico escucha comentarios en issues y pull requests y se activa solo si contienen @claude. Sirve para implementar funciones, responder dudas o corregir errores.
Revisión de código
Al abrir o actualizar un pull request, la acción instala el plugin oficial code-review y publica comentarios en línea, o un resumen si no encuentra problemas.
Informe programado
Con un disparador schedule y un prompt, Claude resume cada mañana los commits del día anterior y las issues abiertas.
Skills del repositorio
Si tienes skills en .claude/skills/, haz checkout del código y pasa /nombre-de-la-skill como prompt.
El archivo .github/workflows/claude.yml se dispara con issue_comment y pull_request_review_comment, filtra con if: contains(github.event.comment.body, '@claude'), concede permisos de escritura sobre contenidos, pull requests e issues más id-token: write, hace checkout del repositorio y ejecuta anthropics/claude-code-action@v1 con anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}. Nada más: con eso, Claude responde en el propio hilo.
05 Parámetros principales de la acción
| Parámetro | Para qué sirve |
|---|---|
| prompt | Instrucciones en texto o la invocación de una skill; si falta, la acción espera la mención |
| claude_args | Argumentos de la CLI de Claude Code, como --max-turns, --model, --allowedTools o --mcp-config |
| anthropic_api_key | Clave de la API de Claude |
| claude_code_oauth_token | Token para usar una suscripción de Claude |
| trigger_phrase | Frase que activa a Claude; por defecto, @claude |
| plugin_marketplaces y plugins | Instalan plugins antes de ejecutar |
| settings | Configuración de Claude Code en JSON o ruta a un archivo |
| use_bedrock, use_vertex, use_foundry | Usar Amazon Bedrock, Google Cloud o Microsoft Foundry en lugar de la API de Claude |
06 Seguridad y costes
Antes de arrancar, la acción comprueba quién la activa: en eventos de issues y pull requests, el usuario debe tener permiso de escritura en el repositorio, y en cualquier evento rechaza a los bots salvo que los incluyas en allowed_bots, para evitar bucles entre automatizaciones.
- ✓Cada ejecución gasta minutos de GitHub Actions y tokens de Claude (o uso de tu suscripción si usas token OAuth).
- ✓Limita las iteraciones con --max-turns en claude_args.
- ✓Fija tiempos máximos en el flujo para evitar trabajos desbocados.
- ✓Usa los controles de concurrencia de GitHub para limitar ejecuciones en paralelo.
- ✓Escribe peticiones concretas y usa plantillas de issue para dar contexto desde el principio.
- ✓Mantén breve el CLAUDE.md del repositorio: Claude lo lee en cada ejecución.
07 Alternativas y productos relacionados
| Opción | Cuándo elegirla |
|---|---|
| Code Review | Quieres revisiones automáticas de cada pull request sin mantener un archivo de flujo |
| Rutinas con disparador de GitHub | Prefieres que la tarea corra en la nube de Anthropic, con conectores y sin gastar minutos de Actions |
| claude -p en tu propio CI | Usas otro sistema de integración continua o necesitas control total del comando |
| Claude Code en GitLab CI/CD | Tu código está en GitLab |
Las rutinas programadas de Claude también reaccionan a pull requests y releases. Elegir entre ellas y la acción depende de dónde quieras ejecutar y pagar el trabajo. En proyectos de desarrollo de SaaS B2B combinamos ambas con revisión humana obligatoria antes de fusionar, y lo aplicamos como empresa de desarrollo web en los repositorios que mantenemos. Más integraciones de la comunidad en nuestro directorio de herramientas para Claude Code.
Preguntas frecuentes sobre Claude Code GitHub Actions
Es la acción oficial de Anthropic que ejecuta Claude Code dentro de GitHub Actions. Responde a menciones de @claude en issues y pull requests o ejecuta un prompt ante cualquier evento del repositorio.
La forma rápida es ejecutar /install-github-app desde Claude Code en el repositorio. También puedes instalar a mano la app de Claude para GitHub, añadir el secreto y copiar el archivo claude.yml de ejemplo.
Sí. Con planes Pro, Max, Team o Enterprise puedes generar un token con claude setup-token y guardarlo como secreto CLAUDE_CODE_OAUTH_TOKEN. Las ejecuciones consumirán tu suscripción.
Por defecto, solo usuarios con permiso de escritura en el repositorio. Los bots están bloqueados salvo que los añadas a allowed_bots, para evitar bucles.
Pagas los minutos de los runners de GitHub Actions y los tokens de Claude que consuma cada ejecución, o el uso de tu suscripción si te autenticas con token. Consulta las páginas oficiales de precios porque cambian.
Sí. La acción admite Amazon Bedrock, Google Cloud y Microsoft Foundry con autenticación por federación de identidad OIDC, sin guardar credenciales estáticas en el repositorio.
Con GitHub Actions configuras tú el flujo, el prompt y los disparadores. Code Review hace revisiones automáticas de pull requests sin que tengas que mantener ningún archivo de flujo.
Fuentes consultadas
Sobre el autor
Germán Gutiérrez
Development Manager en appyweb
Dirige el equipo de desarrollo de appyweb: aplicaciones web y móviles, SaaS, integraciones y arquitectura de software.
Ver perfil en LinkedIn ↗