Tutorial de uso de Claude Code GitHub Actions

Claude Code es una herramienta de Agentic Coding lanzada por Anthropic, también conocida como uno de los agentes de programación más poderosos del mundo. Claude Code GitHub Actions puede integrar la capacidad de programación de IA en tu flujo de trabajo de GitHub; solo necesitas mencionar @claude en un PR o Issue, y Claude analizará automáticamente el código, creará PR, implementará funciones y corregirá errores. Este documento describe principalmente cómo configurar y usar Claude Code GitHub Actions a través del servicio proxy de AceData Cloud.

Proceso de solicitud

Para usar Claude Code, primero puedes ir a la página del servicio Claude Messages y hacer clic en el botón “Acquire” para obtener las credenciales necesarias para la solicitud:

Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invita a registrarte e iniciar sesión; después de registrarte e iniciar sesión, serás devuelto automáticamente a la página actual. En la primera solicitud, se te otorgará un crédito gratuito para que puedas experimentar el servicio de Claude Code de forma gratuita.

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

Ve a https://github.com/apps/claude para instalar la aplicación Claude GitHub en tu repositorio. Página de instalación de la aplicación GitHub Claude

Página de instalación de la aplicación GitHub Claude

Esta aplicación requiere los siguientes permisos de repositorio:

Permiso	Nivel	Descripción
Contents	Read & Write	Modificar archivos del repositorio
Issues	Read & Write	Responder a Issues
Pull requests	Read & Write	Crear PR y enviar cambios

Paso dos: Agregar la clave API

Agrega la clave API de AceData Cloud como un secreto del repositorio:

Ve a Settings del repositorio → Secrets and variables → Actions
Haz clic en New repository secret
En el campo Name escribe ANTHROPIC_API_KEY, y en Value ingresa el token API que obtuviste en AceData Cloud
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

Crea el archivo .github/workflows/claude.yml en el repositorio:

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 }}

Si necesitas usar el punto final de la API proxy de AceData Cloud, también debes configurar la variable de entorno en el Workflow:

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

Una vez configurado, en cualquier comentario de Issue o PR menciona @claude, y Claude responderá automáticamente:

@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

Crea un Workflow que ejecute automáticamente la revisión de código al abrir un PR:

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

Crea una tarea automatizada que se ejecute de forma programada:

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ámetro	Descripción	Requerido
`anthropic_api_key`	Clave API	Sí
`prompt`	Instrucción para Claude (texto o Skill como `/review`)	No
`claude_args`	Parámetros pasados a Claude Code CLI	No
`github_token`	Token de GitHub	No
`trigger_phrase`	Frase de activación personalizada (por defecto `@claude`)	No

Parámetros comunes de claude_args

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

Parámetro	Descripción
`--max-turns`	Número máximo de turnos de conversación (por defecto 10)
`--model`	Modelo a utilizar
`--mcp-config`	Ruta del archivo de configuración MCP
`--allowed-tools`	Herramientas permitidas (separadas por comas)
`--debug`	Habilitar salida de depuración

Mejores prácticas

Configurar CLAUDE.md

Crea un archivo CLAUDE.md en la raíz del repositorio, definiendo las pautas de estilo de código, estándares de revisión y normas del proyecto; Claude seguirá automáticamente estas reglas.

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?

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

¿Error de autenticación?

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

¿Cómo ver el saldo restante?

Inicie sesión en AceData Cloud Console para ver el saldo restante y el uso actual de la cuenta.

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.

​Proceso de solicitud

​Características

​Pasos de configuración

​Paso uno: Instalar la aplicación Claude GitHub

​Paso dos: Agregar la clave API

​Paso tres: Crear el archivo Workflow

​Modo de uso

​Usar en comentarios de Issue o PR

​Revisión automática de código

​Automatización de tareas programadas

​Descripción de parámetros de Action

​Parámetros comunes de claude_args

​Mejores prácticas

​Configurar CLAUDE.md

​Consideraciones de seguridad

​Control de costos

​Preguntas frecuentes

​¿Claude no responde al comando @claude?

​¿Error de autenticación?

​¿Cómo ver el saldo restante?

​Más información