¿Qué son las Acciones de GitHub de Claude Code?

¿Te gustaría potenciar tu flujo de trabajo de desarrollo con IA? Conoce la Acción de GitHub Claude Code, un cambio radical que lleva la IA Claude de Anthropic a tus repositorios de GitHub. Simplemente menciona @claude en una solicitud de extracción o incidencia, y ¡listo! Claude genera código, corrige errores o refactoriza como un profesional, todo a través de las Acciones de GitHub. Lo configuré en 15 minutos, ¡y es increíblemente eficiente! En este tutorial, te guiaré a través de la instalación, configuración y uso de la Acción de GitHub Claude Code para automatizar tus tareas de codificación. ¿Listo para dejar que la IA haga el trabajo pesado? ¡Vamos allá!

💡

¿Trabajando con APIs o documentando tus proyectos? Consigue APIdog para optimizar el diseño y las pruebas de API. ¡Es un compañero perfecto para tus flujos de trabajo de Acciones de GitHub!

button

Por qué la Acción de GitHub Claude Code es Genial

La Acción de GitHub Claude Code es como tener un programador genio en tu equipo, 24/7. Basada en la IA Claude de Anthropic, escucha las menciones de @claude en tu repositorio y entra en acción, impulsada por las Acciones de GitHub. Aquí te explicamos por qué es increíble:

Solicitudes de Extracción Instantáneas: Describe una característica, y Claude crea una PR con todos los cambios.
Corrección de Errores en Piloto Automático: Reporta un error, y Claude codifica la solución, sin necesidad de trabajo manual.
Consistencia del Código: Sigue el estilo de tu proyecto (por ejemplo, a través de CLAUDE.md) para un código limpio y uniforme.
Seguro y Privado: Se ejecuta en tus ejecutores de GitHub, manteniendo tu código seguro.
Configuración Rápida: Listo para usar en minutos con una configuración mínima.

El repositorio de GitHub cuenta con un flujo de trabajo elegante, y vi cómo generaba una función refactorizada en segundos. ¡Pongámoslo en marcha!

Cómo Funciona la Acción de GitHub Claude Code

Claude Code se integra con las Acciones de GitHub para monitorizar tu repositorio en busca de menciones de @claude en incidencias, solicitudes de extracción o comentarios de revisión. Cuando se activa, hace lo siguiente:

Analiza tu base de código o el contexto de la incidencia.
Genera o ajusta código basándose en tu solicitud.
Crea una solicitud de extracción con los cambios o publica comentarios.
Ejecuta múltiples agentes Claude en paralelo para mayor velocidad.

Es como tener un compañero de programación que nunca duerme, todo impulsado por los ejecutores de las Acciones de GitHub. ¿Listo para configurarlo? ¡Aquí te explicamos cómo!

Configuración Paso a Paso: Acción de GitHub Claude Code

Pongamos en marcha Claude Code en tu repositorio. Lo probé en un proyecto Node.js, pero funciona para cualquier base de código. Sigue estos pasos para automatizar tu flujo de trabajo en ~15 minutos.

1. Instala la Aplicación de GitHub Claude

Necesitarás derechos de administrador para tu repositorio.

Dirígete a la página de la Aplicación de GitHub Claude.
Instálala en tu repositorio u organización, otorgando permisos para contenidos, incidencias y solicitudes de extracción.
La instalé en mi repositorio de prueba y tardó 2 minutos, ¡sin problemas!

2. Añade tu Clave de API de Anthropic

Claude necesita una clave de API para hacer su magia.

Ve a Settings > Secrets and variables > Actions de tu repositorio.
Haz clic en New repository secret.
Nómbrala ANTHROPIC_API_KEY y pega tu clave de API de Anthropic (consigue una en console.anthropic.com).
Esto mantiene tu clave segura para los flujos de trabajo de las Acciones de GitHub.

3. Añade el Archivo de Flujo de Trabajo de Claude

Ahora, configuremos el flujo de trabajo de las Acciones de GitHub.

Copia el ejemplo claude.yml de grll/claude-code-action.
Crea una carpeta .github/workflows/ en tu repositorio.
Pega lo siguiente en .github/workflows/claude.yml:

# .github/workflows/claude.yml
name: Claude PR Assistant

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request_review:
    types: [submitted]

jobs:
  claude-code-action:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Run Claude PR Action
        uses: grll/claude-code-action@beta
        with:
          use_oauth: true
          claude_access_token: ${{ secrets.CLAUDE_ACCESS_TOKEN }}
          claude_refresh_token: ${{ secrets.CLAUDE_REFRESH_TOKEN }}
          claude_expires_at: ${{ secrets.CLAUDE_EXPIRES_AT }}

          timeout_minutes: "60"
          # Optional: add custom trigger phrase (default: @claude)
          # trigger_phrase: "/claude"
          # Optional: add assignee trigger for issues
          # assignee_trigger: "claude"
          # Optional: add custom environment variables (YAML format)
          # claude_env: |
          #   NODE_ENV: test
          #   DEBUG: true
          #   API_URL: https://api.example.com

Este flujo de trabajo escucha las menciones de @claude en comentarios o incidencias y ejecuta Claude en los ejecutores de las Acciones de GitHub.

4. Configura los Secretos de la Aplicación de GitHub

Para que el flujo de trabajo genere tokens de aplicación:

Obtén el APP_ID y APP_PRIVATE_KEY de tu Aplicación de GitHub desde la configuración de la aplicación (después de la instalación).
Añádelos como secretos en Settings > Secrets and variables > Actions:
APP_ID: El ID de tu Aplicación de GitHub.
APP_PRIVATE_KEY: El contenido del archivo de clave privada.

5. Activa a Claude con @claude

¡Ahora, pruébalo!

Abre una incidencia o comenta en una PR con algo como:

@claude Por favor, refactoriza la lógica de obtención de datos en `api.js` para un mejor manejo de errores.

Claude analiza tu solicitud, crea una PR con el código refactorizado y añade comentarios.
Lo probé, ¡y Claude entregó un api.js más limpio con bloques try-catch en un instante!

Personalizando la Acción de GitHub Claude Code

¿Quieres ajustar el comportamiento de Claude? El flujo de trabajo de las Acciones de GitHub es súper flexible. Aquí te explicamos cómo hacerlo a tu medida:

Prompts Personalizados: Añade un archivo CLAUDE.md con directrices del proyecto (por ejemplo, "Usa async/await, evita console.log"). Claude lo sigue como una guía de estilo.
Tiempos de Espera: Ajusta timeout_minutes en claude.yml (por ejemplo, "30" para ejecuciones más cortas).
Selección de Modelo: Cambia los modelos en el flujo de trabajo (por ejemplo, claude-3-5-sonnet en lugar de claude-3-7-sonnet).
Autenticación: Usa AWS Bedrock o Google Vertex AI actualizando use_vertex y las variables de entorno.
Acceso a Herramientas: Limita las operaciones de archivo de Claude o las llamadas a la API de GitHub a través de la configuración del flujo de trabajo para mayor seguridad.

Añadí un CLAUDE.md con "preferir TypeScript", ¡y las PRs de Claude coincidieron perfectamente con mi estilo!

Casos de Uso Reales: Claude Code en Acción

Claude Code destaca por acelerar las tareas de desarrollo. Esto es lo que probé y lo que puedes hacer con las Acciones de GitHub:

Corrección de Errores: Publiqué una incidencia: “@claude Corrige el error nulo en user.js.” Claude creó una PR con una verificación de nulos, ¡hecho en 2 minutos!
Construcción de Características: Comenté: “@claude Añade un endpoint de inicio de sesión a server.js.” Obtuve una PR con rutas Express y autenticación JWT.
Refactorización de Código: Pregunté: “@claude Optimiza utils.js para rendimiento.” Claude reescribió bucles y almacenó resultados en caché.
Revisiones de Código: Claude revisó mi PR, sugiriendo mejores nombres de variables y manejo de errores.

resultados de corrección de acciones de github

Consejos para Dominar la Acción de GitHub Claude Code

Para sacar el máximo provecho de Claude Code con las Acciones de GitHub:

Sé Específico: Escribe comentarios @claude claros (por ejemplo, "Añade manejo de errores a fetchData en api.js").
Usa CLAUDE.md: Define estándares de codificación (por ejemplo, tabulaciones vs. espacios, nombres de funciones) para una salida consistente.
Monitoriza las Ejecuciones: Revisa la pestaña Actions en GitHub para depurar flujos de trabajo o ver los registros de Claude.
Combina con VS Code: Empareja con la extensión de Anthropic para VS Code para codificación local con Claude, sincronizándose con las Acciones de GitHub.
Prueba Pequeño: Empieza con tareas sencillas (por ejemplo, "@claude Añade un README") para aprender el estilo de Claude.

Descubrí que los prompts detallados reducen el tiempo de respuesta de Claude a la mitad: ¡la precisión vale la pena!

Por qué la Acción de GitHub Claude Code Destaca

La Acción de GitHub Claude Code es una bestia de productividad. Es más rápida que la codificación manual, respeta el estilo de tu proyecto y se ejecuta de forma segura en los ejecutores de las Acciones de GitHub. En comparación con otras herramientas de IA, la capacidad de Claude para crear PRs completas a partir de un solo comentario es inigualable. La configuración es rápida y la integración con GitHub se siente nativa. Pequeño inconveniente: las tareas complejas pueden necesitar ajustes en el prompt, pero los ejemplos del repositorio ayudan.

Ya seas un desarrollador individual o parte de un equipo, Claude Code hace que codificar parezca magia. ¡Asegúrate de probarlo!

button