Claude Code GitHub Actions

• Code Review: revisión automática en cada solicitud de extracción, sin escribir un flujo de trabajo
• Claude Code en la nube: sesiones de Claude Code que se ejecutan en infraestructura en la nube en lugar de su máquina
• Claude Agent SDK: automatización personalizada fuera de GitHub Actions. La GitHub Action de Claude Code se construye sobre el SDK
• GitHub Enterprise Server: Claude Code con GitHub autohospedado

​

Configuración

• Configuración rápida: ejecuta /install-github-app desde Claude Code. Claude Code instala la GitHub App, agrega tu secreto de autenticación y prepara el pull request del workflow por ti
• Configuración manual: instala la app, agrega el secreto y copia el archivo de workflow en tu repositorio tú mismo. Usa esta opción cuando no ejecutes Claude Code localmente, cuando el comando falle o cuando quieras tener control total de los archivos de workflow

​

Configuración rápida

• Si Claude Code ya tiene una clave de API, reutiliza esa clave y ofrece conservar el secreto ANTHROPIC_API_KEY existente del repositorio si ya hay uno configurado
• De lo contrario, elige entre crear un token de larga duración con tu suscripción de Claude y pegar una clave de API

• Ejecuta /install-github-app de nuevo. Cuando el repositorio ya tenga un claude.yml, selecciona Update workflow file with latest version. Claude Code sube copias nuevas de los archivos de workflow a una rama nueva y abre el pull request, igual que en una primera instalación.
• Agrega tú mismo el argumento --comment y la línea claude_args del ejemplo de workflow de revisión al archivo confirmado en el repositorio, lo que conserva cualquier otra edición que le hayas hecho.

​

Configuración manual

​

Configurar para una organización

• Instala la Claude GitHub App una sola vez a nivel de organización, eligiendo todos los repositorios o una lista seleccionada
• Guarda el secreto de autenticación como un secreto de Actions a nivel de organización para que cada repositorio no necesite su propia copia
• Agrega el archivo de workflow a cada repositorio que deba ejecutar la GitHub Action de Claude Code, o define el job una sola vez como un workflow reutilizable al que llame cada repositorio

• anthropic_federation_rule_id: el ID de la regla de federación, fdrl_...
• anthropic_organization_id: el ID de tu organización de Anthropic
• anthropic_service_account_id: el ID de la cuenta de servicio, svac_.... Es opcional, ya que la regla de federación que creas en la Console ya apunta a una cuenta de servicio
• anthropic_workspace_id: el ID del espacio de trabajo, wrkspc_.... Es opcional cuando la regla de federación apunta a un único espacio de trabajo

​

Desinstalar

• Archivos de workflow: elimina de .github/workflows/ los workflows que usan anthropics/claude-code-action. Si usaste la configuración rápida, busca claude.yml y, si seleccionaste el workflow de revisión, claude-code-review.yml. Una vez eliminados los workflows, la GitHub Action de Claude Code deja de ejecutarse
• Secretos: elimina el secreto ANTHROPIC_API_KEY o CLAUDE_CODE_OAUTH_TOKEN del repositorio, y de los secretos de Actions a nivel de organización si lo compartiste entre repositorios. Si eliminas un secreto, la credencial que contenía sigue siendo válida. Para retirar una clave de API por completo, elimina también la clave en la Claude Console
• GitHub App: desinstala la Claude GitHub App en la configuración de tu repositorio u organización, en GitHub Apps, pero solo si no la usas para otra función de Claude, como Code Review o la corrección automática web

​

Permisos de la GitHub App

​

Modos interactivo y de automatización

• Modo interactivo: cuando el flujo de trabajo no proporciona entrada prompt, Claude espera la frase de disparo, @claude por defecto, en un comentario de problema o solicitud de extracción, en una revisión de solicitud de extracción o en el cuerpo o título de un problema recién abierto, luego responde a esa solicitud. El progreso y los resultados aparecen como un comentario en el problema o PR que desencadena.
• Modo de automatización: cuando el flujo de trabajo proporciona una entrada prompt, Claude se ejecuta sin esperar una mención, sujeto solo a las comprobaciones sobre quién puede desencadenar ejecuciones. Por defecto, los resultados aparecen en el registro de ejecución del flujo de trabajo en lugar de un comentario. Claude puede publicar en el problema o solicitud de extracción cuando el mensaje lo dirige y tiene una herramienta que puede publicar, como en el ejemplo de revisión de código.

​

Quién puede desencadenar ejecuciones

• Acceso de escritura: en eventos de problema y solicitud de extracción, el usuario que desencadena debe tener acceso de escritura al repositorio. Para permitir usuarios específicos sin acceso de escritura, establezca allowed_non_write_users y pase su propia entrada github_token. Los eventos que ningún usuario crea, como un disparador schedule, omiten esta comprobación.
• Actor humano: en cada evento, la GitHub Action de Claude Code rechaza un actor bot a menos que lo enumere en allowed_bots, lo que evita que los bots desencadenen Claude en un bucle. Esta comprobación también se aplica a ejecuciones programadas, que GitHub atribuye a un usuario del repositorio, generalmente el que cambió por última vez el cronograma cron del flujo de trabajo. Si ese usuario es un bot, enumérelo en allowed_bots.

​

Casos de uso de ejemplo

​

Responder a menciones @claude

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

• id-token: write: requerido para la autenticación predeterminada de GitHub App de la GitHub Action de Claude Code
• actions: read: permite que Claude lea resultados de CI en PR
• actions/checkout: le da a Claude una copia local del repositorio para trabajar
• if: evita que los ejecutores se inicien en comentarios que no mencionen @claude. La GitHub Action de Claude Code también verifica la frase de disparo antes de responder

@claude implement this feature based on the issue description
@claude how should I implement user authentication for this endpoint?
@claude fix the TypeError in the user dashboard component

​

Ejecutar una skill

• Para una skill en el directorio .claude/skills/ de su repositorio, ejecute actions/checkout antes del paso anthropics/claude-code-action para que los archivos de skill estén disponibles en el ejecutor, luego pase /skill-name como prompt.
• Para una skill empaquetada en un plugin, instale el plugin con las entradas plugin_marketplaces y plugins, luego pase el /plugin-name:skill-name con espacio de nombres como prompt. La entrada plugins toma plugin-name@marketplace-name, donde el nombre del marketplace viene del manifiesto propio del marketplace en lugar de su URL de repositorio.

name: Code Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          plugin_marketplaces: "https://github.com/anthropics/claude-plugins-official.git"
          plugins: "code-review@claude-plugins-official"
          prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

• --comment: Claude publica su revisión en la solicitud de extracción, como un comentario en línea en cada problema que encuentra o como un comentario de resumen cuando no encuentra ninguno. Sin él, Claude no publica nada, y usted lee los hallazgos en el registro de ejecución del flujo de trabajo.
• claude_args: mantenga esta línea aunque la propia allowed-tools frontmatter de la skill nombre la misma herramienta, porque la GitHub Action de Claude Code inicia el servidor MCP que publica comentarios en línea solo cuando --allowedTools en claude_args lo nombra.

​

Ejecutar en un cronograma

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: read
      id-token: write
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Generate a summary of yesterday's commits and open issues"
          claude_args: |
            --model claude-opus-5-5
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

​

Mejores prácticas

​

Defina estándares de proyecto en CLAUDE.md

​

Proteja sus credenciales

​

Gestionar costos

• Minutos de GitHub Actions: la GitHub Action de Claude Code se ejecuta en ejecutores alojados en GitHub, que consumen sus minutos de GitHub Actions. Consulte la documentación de facturación de GitHub para precios y límites de minutos.
• Tokens de API: cada interacción consume tokens según la longitud de mensajes y respuestas, complejidad de tareas y tamaño de la base de código. Consulte la página de precios de Claude para tasas de tokens actuales. Si se autentica con un token OAuth, las ejecuciones usan su suscripción de Claude en lugar de facturación de API.

• Escriba solicitudes específicas de @claude para que Claude necesite menos turnos para terminar
• Use plantillas de problemas para proporcionar contexto por adelantado
• Mantenga su CLAUDE.md conciso, ya que Claude lo lee en cada ejecución
• Establezca --max-turns en claude_args para limitar iteraciones
• Establezca tiempos de espera a nivel de flujo de trabajo para evitar trabajos descontrolados
• Use los controles de concurrencia de GitHub para limitar ejecuciones paralelas

​

Usar un proveedor en la nube

• Amazon Bedrock: use_bedrock: "true"
• Google Cloud’s Agent Platform: use_vertex: "true"
• Microsoft Foundry: use_foundry: "true"

​

Solución de problemas

​

Claude no responde a comandos @claude

• Verifique que la GitHub App esté instalada en el repositorio
• Compruebe que los flujos de trabajo estén habilitados para el repositorio
• Asegúrese de que su clave API u token OAuth esté configurado en secretos del repositorio
• Confirme que el comentario contiene @claude como una palabra completa, no /claude o @claude-bot
• Confirme que el usuario que comenta tiene acceso de escritura al repositorio. Consulte Quién puede desencadenar ejecuciones para las excepciones

​

CI no se ejecuta en las confirmaciones de Claude

• GitHub no desencadena flujos de trabajo en confirmaciones realizadas con el GITHUB_TOKEN predeterminado. Si pasa github_token: ${{ secrets.GITHUB_TOKEN }} a la GitHub Action de Claude Code, elimínelo para que se autentique como la GitHub App de Claude, o pase un token de aplicación personalizado en su lugar
• Compruebe que los disparadores del flujo de trabajo de CI incluyan los eventos que producen los insertos de Claude, como push o pull_request

​

Errores de autenticación

• Confirme que la clave API u token OAuth sea válido probándolo localmente con claude antes de depurar el flujo de trabajo
• Para Bedrock, Agent Platform y Foundry, consulte la sección de solución de problemas de la página del proveedor en la nube

​

Configuración avanzada

​

Parámetros de acción

​

Pasar argumentos de CLI

claude_args: "--max-turns 5 --model claude-sonnet-5 --mcp-config /path/to/config.json"

• --max-turns: limitar el número de turnos de conversación
• --model: modelo a usar, por ejemplo claude-sonnet-5. Sin este argumento, la GitHub Action de Claude Code usa el modelo predeterminado de Claude Code
• --mcp-config: ruta a configuración de MCP
• --allowedTools: lista separada por comas de herramientas permitidas. El alias --allowed-tools también funciona
• --debug: habilitar salida de depuración

​

Actualizar desde beta

1. Cambie @beta a @v1 en la línea uses
2. Elimine la entrada mode, ya que la GitHub Action de Claude Code ahora detecta el modo automáticamente
3. Reemplace direct_prompt con prompt
4. Mueva opciones de CLI como max_turns y model a claude_args. custom_instructions no tiene una bandera con el mismo nombre y se convierte en --append-system-prompt

​

Qué sigue

• Usar Claude Code GitHub Actions con proveedores en la nube: enrutar la inferencia a través de Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry
• Referencia de configuración: la lista completa de entradas de acción
• Directorio de ejemplos: flujos de trabajo listos para usar para más escenarios
• Code Review: revisión automática de solicitudes de extracción sin mantener un archivo de flujo de trabajo