Claude Code en GitHub: la App, la Action y @claude

1. Instala la aplicación de GitHub

claude
/install-github-app

El comando te guía para instalar la aplicación en el repositorio, guardar la clave API como secreto del repositorio y abrir una solicitud de incorporación de cambios que añade el archivo del flujo de trabajo. También puedes hacer las tres cosas manualmente.

2. El flujo de trabajo

name: Claude
on:
  issue_comment: { types: [created] }
  pull_request_review_comment: { types: [created] }
  issues: { types: [opened, assigned] }

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude') || github.event_name == 'issues'
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 1 }
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
        env:
          ANTHROPIC_BASE_URL: https://aiprimetech.io

Con la línea de variables de entorno, todas las ejecuciones de CI pasan por la pasarela: el secreto de tu repositorio es una clave de la pasarela, y el uso se carga a tu saldo de la pasarela o a tu plan ilimitado. Elimina esa línea para facturar el uso a una cuenta de Anthropic.

3. Cómo usarlo

• Comenta @claude fix the failing test in auth.py en una incidencia: abre una solicitud de incorporación de cambios.
• Comenta @claude en un hilo de revisión de una solicitud de incorporación de cambios: responde y sube cambios a esa rama.
• Asigna una incidencia a la aplicación para que implemente lo solicitado sin necesidad de un comentario.
• Prográmalo: un flujo de trabajo activado por cron con una instrucción fija (auditoría de dependencias, borrador del registro de cambios).

Costes en CI

Cada activación supone una ejecución completa del agente: obtener una copia del repositorio, leer los archivos relevantes, planificar, editar, probar y subir los cambios. En un repositorio real, cabe esperar decenas de miles de tokens por ejecución. Los equipos que integran @claude en cada PR son precisamente los usuarios para los que un plan de tarifa plana resulta más ventajoso que la facturación por token; consulta la guía de precios.

Permisos y seguridad

• Concede al trabajo solo los permisos que necesita la tarea; contents: write es necesario para subir cambios.
• Restringe los activadores a colaboradores de confianza en los repositorios públicos; de lo contrario, cualquiera que pueda comentar puede gastar tus tokens.
• Usa allowed_tools en los parámetros de entrada de la acción para delimitar lo que el agente puede ejecutar.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Preguntas frecuentes

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.