Tutorial de uso de Claude Code GitHub Actions

​

Proceso de solicitud

​

Características

• Creación instantánea de PR: Describe tus necesidades, y Claude creará automáticamente un Pull Request completo.
• Implementación automática de código: En un Issue, menciona @claude para convertir el Issue en código ejecutable.
• Cumplimiento de normas del proyecto: Lee automáticamente CLAUDE.md y sigue tu estilo de código y normas del proyecto.
• Seguro y confiable: El código se ejecuta en el Runner de GitHub, garantizando la seguridad de los datos.

​

Pasos de configuración

​

Paso uno: Instalar la aplicación Claude GitHub

​

Paso dos: Agregar la clave API

1. Ve a Settings del repositorio → Secrets and variables → Actions
2. Haz clic en New repository secret
3. En el campo Name escribe ANTHROPIC_API_KEY, y en Value ingresa el token API que obtuviste en AceData Cloud
4. Haz clic en Add secret para guardar

Consejo: El token API se puede ver en el panel de control de AceData Cloud.

​

Paso tres: Crear el archivo Workflow

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request:
    types: [opened, synchronize]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

​

Modo de uso

​

Usar en comentarios de Issue o PR

@claude Implementa la funcionalidad según la descripción de este Issue
@claude Revisa la seguridad del código de este PR
@claude Corrige el TypeError en el componente del dashboard de usuario
@claude ¿Cómo debería implementarse la autenticación de usuarios en este endpoint?

​

Revisión automática de código

name: Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "/review"
          claude_args: "--max-turns 5"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

​

Automatización de tareas programadas

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"

jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Genera un resumen de los commits de ayer y un informe de Issues no cerrados"
        env:
          ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

​

Descripción de parámetros de Action

​

Parámetros comunes de claude_args

claude_args: "--max-turns 5 --model claude-sonnet-4-5-20250929"

​

Mejores prácticas

​

Configurar CLAUDE.md

​

Consideraciones de seguridad

• Nunca escribas la clave API directamente en el archivo Workflow.
• Siempre usa GitHub Secrets (como ${{ secrets.ANTHROPIC_API_KEY }}).
• Limita los permisos de Action al mínimo necesario.
• Revisa manualmente las sugerencias de Claude antes de fusionar.

​

Control de costos

• Usa instrucciones claras de @claude para reducir llamadas API innecesarias.
• Configura un límite razonable de --max-turns para las conversaciones.
• Establece un tiempo de espera a nivel de Workflow.
• Usa el control de concurrencia de GitHub para limitar el número de ejecuciones paralelas.

​

Preguntas frecuentes

​

¿Claude no responde al comando @claude?

1. Asegúrate de que la aplicación Claude GitHub esté instalada correctamente.
2. Verifica si el Workflow está habilitado.
3. Confirma que la clave API esté configurada como un secreto del repositorio.
4. Asegúrate de que en el comentario se use @claude (no /claude).

​

¿Error de autenticación?

1. Confirme que la clave API sea válida y tenga suficientes permisos.
2. Verifique que el nombre del secreto sea correcto (ANTHROPIC_API_KEY).
3. Si se utiliza ANTHROPIC_BASE_URL, confirme que la URL sea correcta.

​

¿Cómo ver el saldo restante?

​

Más información

• 📖 Documentación oficial de Claude Code GitHub Actions
• 📂 Repositorio claude-code-action
• 📋 Ejemplos de Workflow
• 🔧 Servicio Claude Code de AceData Cloud
• 💬 Si tiene alguna pregunta, no dude en contactarnos a través del servicio al cliente de la plataforma.