Instalación

Aprende cómo instalar y configurar Claude Code Action en tu repositorio.

Requisitos Previos

Antes de instalar Claude Code Action, asegúrate de tener:

  • Un repositorio de GitHub
  • Permisos de administrador del repositorio
  • Acceso a Claude Code CLI
  • Una clave API de Anthropic o token OAuth de Claude Code

Instalación Rápida (Recomendada)

La forma más rápida de instalar Claude Code Action es usando la CLI de Claude Code:

1. Abrir Claude Code

claude

2. Ejecutar Comando de Instalación

/install-github-app

Este comando te guiará a través de:

  • Instalar la Aplicación de GitHub de Claude
  • Configurar los secretos requeridos
  • Configurar tu archivo de flujo de trabajo

Instalación Manual

Si prefieres configurar manualmente o necesitas más control:

1. Instalar la Aplicación de GitHub de Claude

Visita https://github.com/apps/claude e instala la aplicación en tu repositorio.

2. Configurar Autenticación

Agrega uno de los siguientes secretos a tu repositorio:

Opción A: Clave API de Anthropic (Recomendada)

  1. Ve a la Configuración de tu repositorio
  2. Navega a Secrets and variables → Actions
  3. Haz clic en New repository secret
  4. Nombre: ANTHROPIC_API_KEY
  5. Valor: Tu clave API de Anthropic

Opción B: Token OAuth de Claude Code

  1. Ve a la Configuración de tu repositorio
  2. Navega a Secrets and variables → Actions
  3. Haz clic en New repository secret
  4. Nombre: CLAUDE_CODE_OAUTH_TOKEN
  5. Valor: Tu token OAuth

3. Crear Archivo de Flujo de Trabajo

Crea .github/workflows/claude.yml en tu repositorio:

name: Claude Code Action

on:
  issues:
    types: [opened, labeled]
  pull_request:
    types: [opened, labeled, synchronize]
  issue_comment:
    types: [created]

permissions:
  contents: write
  issues: write
  pull-requests: write

jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          # O usar token OAuth:
          # claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

4. Confirmar y Enviar

git add .github/workflows/claude.yml
git commit -m "Add Claude Code Action workflow"
git push

Métodos Alternativos de Autenticación

Amazon Bedrock

- uses: anthropics/claude-code-action@v1
  with:
    aws_access_key_id: ${{ secrets.AWS_ACCESS_KEY_ID }}
    aws_secret_access_key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
    aws_region: us-east-1

Google Vertex AI

- uses: anthropics/claude-code-action@v1
  with:
    gcp_project_id: ${{ secrets.GCP_PROJECT_ID }}
    gcp_service_account_key: ${{ secrets.GCP_SERVICE_ACCOUNT_KEY }}
    gcp_region: us-central1

Configuración de Aplicación de GitHub Personalizada (Avanzado)

Para organizaciones que requieren una Aplicación de GitHub personalizada:

1. Crear Aplicación de GitHub

  1. Ve a Configuración de GitHub → Configuración de desarrollador → GitHub Apps
  2. Haz clic en New GitHub App
  3. Configurar permisos mínimos:
    • Contents: Read & Write
    • Issues: Read & Write
    • Pull requests: Read & Write

2. Generar Clave Privada

  1. En la configuración de tu GitHub App
  2. Desplázate hasta Private keys
  3. Haz clic en Generate a private key
  4. Descarga y asegura el archivo .pem

3. Instalar App en el Repositorio

  1. Ve a la configuración de tu GitHub App
  2. Haz clic en Install App
  3. Selecciona repositorios de destino

4. Agregar Secretos

Agrega estos secretos a tu repositorio:

  • APP_ID: Tu ID de GitHub App
  • APP_PRIVATE_KEY: Contenido del archivo .pem

5. Actualizar Flujo de Trabajo

- uses: anthropics/claude-code-action@v1
  with:
    github_app_id: ${{ secrets.APP_ID }}
    github_app_private_key: ${{ secrets.APP_PRIVATE_KEY }}
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Verificación

Después de la instalación, prueba la acción:

  1. Creando un nuevo issue o pull request
  2. Agregando la etiqueta claude (si usas activadores basados en etiquetas)
  3. Verificando la pestaña Actions para ejecuciones de flujo de trabajo

Mejores Prácticas de Seguridad

  • Nunca confirmes claves API directamente en tu repositorio
  • Usa secretos de GitHub Actions para todos los valores sensibles
  • Rota regularmente las claves API y tokens
  • Evita registrar variables sensibles en las salidas del flujo de trabajo
  • Revisa regularmente los permisos de la GitHub App

Solución de Problemas

Acción No se Activa

  • Verifica que el archivo de flujo de trabajo esté en .github/workflows/
  • Comprueba que los secretos requeridos estén configurados
  • Asegúrate de que la GitHub App esté instalada en el repositorio
  • Revisa las condiciones de activación del flujo de trabajo

Errores de Autenticación

  • Confirma que la clave API sea válida y activa
  • Verifica que los nombres de secretos coincidan con la configuración del flujo de trabajo
  • Verifica que la GitHub App tenga los permisos necesarios

Errores de Permisos

  • Asegúrate de que el flujo de trabajo tenga permiso contents: write
  • Verifica que la GitHub App tenga el acceso necesario al repositorio
  • Verifica restricciones a nivel de organización

Próximos Pasos