> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Tutorial de uso de Claude Code GitHub Actions

> Claude Code 集成指南 - Ace Data Cloud

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](https://platform.acedata.cloud/documents/claude-messages) y hacer clic en el botón "Acquire" para obtener las credenciales necesarias para la solicitud:

![](https://cdn.acedata.cloud/nyq0xz.png)

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](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](https://cdn.acedata.cloud/ba4b8df66d.png)

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:

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](https://platform.acedata.cloud/console).

### Paso tres: Crear el archivo Workflow

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

```yaml theme={null}
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:

```yaml theme={null}
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:

```yaml theme={null}
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:

```yaml theme={null}
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

```yaml theme={null}
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?

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?

Inicie sesión en [AceData Cloud Console](https://platform.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](https://code.claude.com/docs/en/github-actions)
* 📂 [Repositorio claude-code-action](https://github.com/anthropics/claude-code-action)
* 📋 [Ejemplos de Workflow](https://github.com/anthropics/claude-code-action/tree/main/examples)
* 🔧 [Servicio Claude Code de AceData Cloud](https://platform.acedata.cloud/documents/claude-messages)
* 💬 Si tiene alguna pregunta, no dude en contactarnos a través del servicio al cliente de la plataforma.