Cómo Usar Claude Code con Acciones de GitHub

¿Estás listo para potenciar tu flujo de trabajo con Claude Code y GitHub Actions? Imagina tener un compañero de equipo con IA que revise solicitudes de extracción (pull requests), corrija errores o incluso escriba nuevas funcionalidades directamente en tu repositorio de GitHub. Suena a magia, ¿verdad? Claude Code de Anthropic hace esto realidad al integrarse a la perfección con GitHub Actions, automatizando tareas con una simple mención @claude. Me topé con esta joya en la documentación de Anthropic y el repositorio de GitHub, y es un cambio radical para los desarrolladores. En este tutorial, te guiaré a través de la configuración de Claude Code en GitHub Actions, la creación de un flujo de trabajo para revisar PRs y la exploración de sus capacidades. ¡Vamos a sumergirnos y hacer que tu repositorio sea más inteligente!

💡

¿Trabajas con APIs o documentas proyectos? Descarga APIdog para optimizar el diseño, prueba y compartición de documentación de API, ¡perfecto para tus proyectos con Claude Code!

button

¿Por qué Claude Code y GitHub Actions son Geniales?

Claude Code es la herramienta de codificación agéntica de Anthropic que vive en tu terminal o IDE, entendiendo tu base de código como un profesional. Cuando se combina con GitHub Actions, se convierte en un compañero de equipo virtual que automatiza revisiones de código, implementa funcionalidades y gestiona incidencias directamente en tu repositorio. Está en beta (a partir de mayo de 2025), pero ya destaca para tareas como:

Revisiones de Código: Analiza PRs en busca de errores, estilo y estándares.
Implementación de Funcionalidades: Convierte descripciones de incidencias en código funcional.
Corrección de Errores: Detecta y corrige errores con PRs listas para fusionar.

El repositorio de GitHub anthropics/claude-code-action destaca su capacidad para activarse con comentarios @claude, haciéndolo interactivo y amigable para el desarrollador. ¡Vamos a configurarlo!

Configurando Claude Code para GitHub Actions

Antes de automatizar tu repositorio, preparemos tu entorno. Esto es amigable para principiantes, ¡y lo haré rápido!

1. Verifica los Requisitos:

Repositorio de GitHub: Necesitas acceso de administrador para añadir secretos y aplicaciones.
Clave de API de Anthropic: Consigue una en console.anthropic.com. Las cuentas gratuitas funcionan, pero los planes de pago (Pro/Max) ofrecen más uso.
Sistema: Cualquier sistema operativo (macOS, Linux, Windows con WSL2) con Git y un terminal.
CLI de Claude Code (opcional para la configuración): Instálalo vía npm install -g @anthropic-ai/claude-code.

2. Instala la Aplicación de GitHub de Claude:

Abre tu terminal y ejecuta:

claude
/install-github-app

Esto te guiará para instalar la Aplicación de GitHub de Claude (github.com/apps/claude) en tu repositorio. Sigue las indicaciones para seleccionar tu repositorio y autorizar permisos.
Si encuentras un error 404, actualiza tu token gh: gh auth refresh -h github.com -s workflow e inténtalo de nuevo.
Nota: Esta guía rápida es para usuarios de la API de Anthropic. Para AWS Bedrock o Google Vertex AI, consulta la configuración manual en la documentación de Anthropic.

3. Añade Tu Clave de API:

Después de la instalación, la CLI crea un PR con un archivo de flujo de trabajo (.github/workflows/claude.yml). Antes de fusionar, añade tu clave de API de Anthropic como un secreto de GitHub:
Ve a Settings > Secrets and variables > Actions de tu repositorio.
Añade un secreto llamado ANTHROPIC_API_KEY con tu clave de la consola de Anthropic.
Fusiona el PR para activar el flujo de trabajo.

Configuré esto en 10 minutos en un repositorio de prueba, súper sencillo.

Nota: ¡Usa siempre Secretos de GitHub para las claves de API!

Creando un Flujo de Trabajo de Claude Code en GitHub Actions

Ahora, vamos a crear un flujo de trabajo de GitHub Actions para que Claude Code revise automáticamente los PRs. Usaremos anthropics/claude-code-action del repositorio de GitHub.

1. Crea el Archivo del Flujo de Trabajo:

Si /install-github-app no lo creó, añade manualmente .github/workflows/claude.yml en tu repositorio:

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Run Claude Code Review
        uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          direct_prompt: |
            Review the PR changes. Focus on code quality, potential bugs, and adherence to project standards. Suggest improvements and provide a detailed explanation.

Esto activa Claude Code en PRs nuevos o actualizados, revisando el código en busca de calidad y errores.

2. Prueba el Flujo de Trabajo:

Envía un cambio a una rama y abre un PR. Claude Code se ejecutará, publicando un comentario con su revisión (por ejemplo, "Encontrado un posible puntero nulo en main.py. Considera añadir una verificación...").
Probé esto en un repositorio de Python, y Claude detectó una pista de tipo (type hint) faltante, ¡exacto!

3. Personaliza el Activador:

¿Quieres control manual? Modifica el flujo de trabajo para que se active con comentarios:

on:
  issue_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Ahora, comenta @claude review this PR para activarlo.

Usando Claude Code para Tareas Avanzadas

Claude Code en GitHub Actions no es solo para revisiones, puede implementar funcionalidades o corregir errores. Así es como puedes subir de nivel:

1. Implementa una Funcionalidad:

Crea una incidencia: "Añadir autenticación de usuario al endpoint de login."
Comenta: @claude implement this feature based on the issue description.
Claude analiza la incidencia, escribe código y crea un PR. Lo probé para una API REST, y añadió una configuración básica de autenticación JWT, impresionante.

2. Corrige un Error:

En una incidencia, describe el error: "TypeError en dashboard.js."
Comenta: @claude fix the TypeError in the user dashboard component.
Claude localiza la incidencia, envía una corrección y abre un PR.

3. Añade Estándares de Proyecto:

Crea un archivo CLAUDE.md en la raíz de tu repositorio para definir estándares de codificación (por ejemplo, "Usar PEP 8 para Python"). Claude respeta estas directrices durante las revisiones e implementaciones.

Ejemplo de implementación:

1. Primero, un usuario deja un comentario etiquetando a @Claude, pidiéndole que aborde un feedback, lo que activa la respuesta automatizada de Claude a través de GitHub Actions.

2. Luego, Claude responde automáticamente al comentario, realiza las acciones solicitadas (por ejemplo, manejo de errores de API, eliminación de duplicados) y proporciona una lista de verificación de las tareas completadas.

3. Finalmente, un revisor (por ejemplo, un ingeniero frontend) aprueba los cambios realizados por Claude, la solicitud de extracción se fusiona y cierra con éxito, indicando que los cambios de Claude pasaron la revisión.

Explorando las Características de Claude Code en GitHub Actions

¿Quieres llevar Claude Code más allá? Aquí tienes algunos trucos geniales:

Análisis de Imágenes: Sube una captura de pantalla en un comentario (por ejemplo, @claude fix this UI bug [screenshot]), y Claude la analiza para sugerir correcciones. Genial para errores visuales.
Herramientas Personalizadas: Habilita herramientas como Bash(git:*), GlobTool o servidores MCP (Model Control Protocol) para tareas avanzadas (por ejemplo, obtener datos). Consulta el repositorio de GitHub para ejemplos.
Runners Más Rápidos: Usa runners de Depot (runs-on: depot-ubuntu-latest) para una ejecución más rápida y económica en comparación con los runners predeterminados de GitHub.
Integración con SDK: Construye flujos de trabajo personalizados con el SDK de Claude Code para tareas más allá de GitHub Actions.

Experimenté con el análisis de imágenes para un error de CSS, y Claude acertó con la corrección, ¡alucinante!

Conclusión: Domina Claude Code con GitHub Actions

¡Buen trabajo! ¡Acabas de desbloquear Claude Code en GitHub Actions para automatizar revisiones de código, implementar funcionalidades y corregir errores! Desde la instalación de la Aplicación de GitHub hasta la creación de flujos de trabajo, ahora estás listo para hacer de tu repositorio una potencia de productividad. Intenta añadir herramientas MCP, ajustar CLAUDE.md o documentar tus APIs con APIdog. Comparte tus éxitos con Claude Code en X o Reddit, ¡estoy emocionado de ver brillar tus PRs! ¡Feliz codificación!

button