SpyBara
Go Premium

github-actions.md 2026-05-02 18:14 UTC to 2026-05-04 22:58 UTC

670 added, 0 removed.

2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19

Claude Code GitHub Actions

Aprenda a integrar Claude Code en su flujo de trabajo de desarrollo con Claude Code GitHub Actions

Claude Code GitHub Actions trae automatización impulsada por IA a su flujo de trabajo de GitHub. Con una simple mención @claude en cualquier PR o problema, Claude puede analizar su código, crear solicitudes de extracción, implementar características y corregir errores, todo mientras sigue los estándares de su proyecto. Para revisiones automáticas publicadas en cada PR sin un disparador, consulte GitHub Code Review.

¿Por qué usar Claude Code GitHub Actions?

  • Creación instantánea de PR: Describa lo que necesita y Claude crea un PR completo con todos los cambios necesarios
  • Implementación de código automatizada: Convierta problemas en código funcional con un único comando
  • Sigue sus estándares: Claude respeta sus directrices CLAUDE.md y patrones de código existentes
  • Configuración simple: Comience en minutos con nuestro instalador y clave API
  • Seguro por defecto: Su código permanece en los ejecutores de Github

¿Qué puede hacer Claude?

Claude Code proporciona una poderosa GitHub Action que transforma la forma en que trabaja con código:

Claude Code Action

Esta GitHub Action le permite ejecutar Claude Code dentro de sus flujos de trabajo de GitHub Actions. Puede usar esto para crear cualquier flujo de trabajo personalizado sobre Claude Code.

Ver repositorio →

Configuración

Configuración rápida

La forma más fácil de configurar esta acción es a través de Claude Code en la terminal. Solo abra claude y ejecute /install-github-app.

Este comando lo guiará a través de la configuración de la aplicación de GitHub y los secretos requeridos.

Configuración manual

Si el comando /install-github-app falla o prefiere la configuración manual, siga estas instrucciones de configuración manual:

  1. Instale la aplicación de GitHub de Claude en su repositorio: https://github.com/apps/claude

    La aplicación de GitHub de Claude requiere los siguientes permisos de repositorio:

    • Contenidos: Lectura y escritura (para modificar archivos del repositorio)
    • Problemas: Lectura y escritura (para responder a problemas)
    • Solicitudes de extracción: Lectura y escritura (para crear PR e insertar cambios)

    Para más detalles sobre seguridad y permisos, consulte la documentación de seguridad.

  2. Agregue ANTHROPIC_API_KEY a sus secretos del repositorio (Aprenda cómo usar secretos en GitHub Actions)

  3. Copie el archivo de flujo de trabajo de examples/claude.yml en el directorio .github/workflows/ de su repositorio

Actualización desde Beta

Si actualmente está usando la versión beta de Claude Code GitHub Actions, le recomendamos que actualice sus flujos de trabajo para usar la versión GA. La nueva versión simplifica la configuración mientras agrega características poderosas como la detección automática de modo.

Cambios esenciales

Todos los usuarios de beta deben hacer estos cambios en sus archivos de flujo de trabajo para actualizar:

  1. Actualice la versión de la acción: Cambie @beta a @v1
  2. Elimine la configuración de modo: Elimine mode: "tag" o mode: "agent" (ahora se detecta automáticamente)
  3. Actualice las entradas de solicitud: Reemplace direct_prompt con prompt
  4. Mueva opciones de CLI: Convierta max_turns, model, custom_instructions, etc. a claude_args

Referencia de cambios importantes

Entrada Beta antigua Nueva entrada v1.0
mode (Eliminado - se detecta automáticamente)
direct_prompt prompt
override_prompt prompt con variables de GitHub
custom_instructions claude_args: --append-system-prompt
max_turns claude_args: --max-turns
model claude_args: --model
allowed_tools claude_args: --allowedTools
disallowed_tools claude_args: --disallowedTools
claude_env settings formato JSON

Ejemplo antes y después

Versión beta:

- uses: anthropics/claude-code-action@beta
  with:
    mode: "tag"
    direct_prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    custom_instructions: "Follow our coding standards"
    max_turns: "10"
    model: "claude-sonnet-4-6"

Versión GA (v1.0):

- uses: anthropics/claude-code-action@v1
  with:
    prompt: "Review this PR for security issues"
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    claude_args: |
      --append-system-prompt "Follow our coding standards"
      --max-turns 10
      --model claude-sonnet-4-6

Casos de uso de ejemplo

Claude Code GitHub Actions puede ayudarle con una variedad de tareas. El directorio de ejemplos contiene flujos de trabajo listos para usar para diferentes escenarios.

Flujo de trabajo básico

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 }}
          # Responds to @claude mentions in comments

Usar skills

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 this pull request for code quality, correctness, and security. Analyze the diff, then post your findings as review comments."
          claude_args: "--max-turns 5"

Automatización personalizada con solicitudes

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: "Generate a summary of yesterday's commits and open issues"
          claude_args: "--model opus"

Casos de uso comunes

En comentarios de problema o PR:

@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

Claude analizará automáticamente el contexto y responderá apropiadamente.

Mejores prácticas

Configuración de CLAUDE.md

Cree un archivo CLAUDE.md en la raíz de su repositorio para definir directrices de estilo de código, criterios de revisión, reglas específicas del proyecto y patrones preferidos. Este archivo guía la comprensión de Claude de los estándares de su proyecto.

Consideraciones de seguridad

Para una guía de seguridad completa que incluya permisos, autenticación y mejores prácticas, consulte la documentación de seguridad de Claude Code Action.

Siempre use GitHub Secrets para claves API:

  • Agregue su clave API como un secreto del repositorio llamado ANTHROPIC_API_KEY
  • Haga referencia a él en flujos de trabajo: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
  • Limite los permisos de acción solo a lo necesario
  • Revise las sugerencias de Claude antes de fusionar

Siempre use GitHub Secrets (por ejemplo, ${{ secrets.ANTHROPIC_API_KEY }}) en lugar de codificar claves API directamente en sus archivos de flujo de trabajo.

Optimización del rendimiento

Use plantillas de problemas para proporcionar contexto, mantenga su CLAUDE.md conciso y enfocado, y configure tiempos de espera apropiados para sus flujos de trabajo.

Costos de CI

Al usar Claude Code GitHub Actions, tenga en cuenta los costos asociados:

Costos de GitHub Actions:

  • 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 obtener detalles de precios y límites de minutos

Costos de API:

  • Cada interacción de Claude consume tokens de API según la longitud de solicitudes y respuestas
  • El uso de tokens varía según la complejidad de la tarea y el tamaño de la base de código
  • Consulte la página de precios de Claude para obtener las tasas de tokens actuales

Consejos de optimización de costos:

  • Use comandos específicos @claude para reducir llamadas API innecesarias
  • Configure --max-turns apropiado en claude_args para evitar iteraciones excesivas
  • Establezca tiempos de espera a nivel de flujo de trabajo para evitar trabajos descontrolados
  • Considere usar controles de concurrencia de GitHub para limitar ejecuciones paralelas

Ejemplos de configuración

Claude Code Action v1 simplifica la configuración con parámetros unificados:

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: "Your instructions here" # Optional
    claude_args: "--max-turns 5" # Optional CLI arguments

Características clave:

  • Interfaz de solicitud unificada - Use prompt para todas las instrucciones
  • Skills - Invoque skills instalados directamente desde la solicitud
  • Paso de CLI - Cualquier argumento de CLI de Claude Code a través de claude_args
  • Disparadores flexibles - Funciona con cualquier evento de GitHub

Visite el directorio de ejemplos para archivos de flujo de trabajo completos.

Usar con Amazon Bedrock y Google Vertex AI

Para entornos empresariales, puede usar Claude Code GitHub Actions con su propia infraestructura en la nube. Este enfoque le da control sobre la residencia de datos y la facturación mientras mantiene la misma funcionalidad.

Requisitos previos

Antes de configurar Claude Code GitHub Actions con proveedores en la nube, necesita:

Para Google Cloud Vertex AI:

  1. Un proyecto de Google Cloud con Vertex AI habilitado
  2. Federación de identidad de carga de trabajo configurada para GitHub Actions
  3. Una cuenta de servicio con los permisos requeridos
  4. Una aplicación de GitHub (recomendado) o use el GITHUB_TOKEN predeterminado

Para Amazon Bedrock:

  1. Una cuenta de AWS con Amazon Bedrock habilitado
  2. Proveedor de identidad OIDC de GitHub configurado en AWS
  3. Un rol de IAM con permisos de Bedrock
  4. Una aplicación de GitHub (recomendado) o use el GITHUB_TOKEN predeterminado
1

Crear una aplicación de GitHub personalizada (Recomendado para proveedores de terceros)

Para el mejor control y seguridad al usar proveedores de terceros como Vertex AI o Bedrock, le recomendamos crear su propia aplicación de GitHub:

  1. Vaya a https://github.com/settings/apps/new
  2. Complete la información básica:
  • Nombre de la aplicación de GitHub: Elija un nombre único (por ejemplo, "YourOrg Claude Assistant")
  • URL de inicio: El sitio web de su organización o la URL del repositorio
  1. Configure los ajustes de la aplicación:
  • Webhooks: Desmarque "Activo" (no es necesario para esta integración)
  1. Establezca los permisos requeridos:
  • Permisos del repositorio:
  • Contenidos: Lectura y escritura
  • Problemas: Lectura y escritura
  • Solicitudes de extracción: Lectura y escritura
  1. Haga clic en "Crear aplicación de GitHub"
  2. Después de la creación, haga clic en "Generar una clave privada" y guarde el archivo .pem descargado
  3. Anote su ID de aplicación en la página de configuración de la aplicación
  4. Instale la aplicación en su repositorio:
  • Desde la página de configuración de su aplicación, haga clic en "Instalar aplicación" en la barra lateral izquierda
  • Seleccione su cuenta u organización
  • Elija "Solo repositorios seleccionados" y seleccione el repositorio específico
  • Haga clic en "Instalar"
  1. Agregue la clave privada como un secreto a su repositorio:
  • Vaya a Configuración de su repositorio → Secretos y variables → Acciones
  • Cree un nuevo secreto llamado APP_PRIVATE_KEY con el contenido del archivo .pem
  1. Agregue el ID de la aplicación como un secreto:
  • Cree un nuevo secreto llamado APP_ID con el ID de su aplicación de GitHub

Alternativa para Claude API o si no desea configurar su propia aplicación de Github: Use la aplicación oficial de Anthropic:

  1. Instale desde: https://github.com/apps/claude
  2. No se requiere configuración adicional para autenticación
2

Configurar autenticación del proveedor en la nube

Elija su proveedor en la nube y configure autenticación segura:

**Configure AWS para permitir que GitHub Actions se autentique de forma segura sin almacenar credenciales.**

Nota de seguridad: Use configuraciones específicas del repositorio y otorgue solo los permisos mínimos requeridos.

Configuración requerida:

  1. Habilitar Amazon Bedrock:
  • Solicite acceso a modelos de Claude en Amazon Bedrock
  • Para modelos entre regiones, solicite acceso en todas las regiones requeridas
  1. Configurar proveedor de identidad OIDC de GitHub:
  • URL del proveedor: https://token.actions.githubusercontent.com
  • Audiencia: sts.amazonaws.com
  1. Crear rol de IAM para GitHub Actions:
  • Tipo de entidad de confianza: Identidad web
  • Proveedor de identidad: token.actions.githubusercontent.com
  • Permisos: política AmazonBedrockFullAccess
  • Configurar política de confianza para su repositorio específico

Valores requeridos:

Después de la configuración, necesitará:

  • AWS_ROLE_TO_ASSUME: El ARN del rol de IAM que creó

Consulte la documentación de AWS para obtener instrucciones detalladas de configuración de OIDC. </Accordion>

Google Vertex AI

Configure Google Cloud para permitir que GitHub Actions se autentique de forma segura sin almacenar credenciales.

Nota de seguridad: Use configuraciones específicas del repositorio y otorgue solo los permisos mínimos requeridos.

Configuración requerida:

  1. Habilitar APIs en su proyecto de Google Cloud:
  • API de credenciales de IAM
  • API de servicio de token de seguridad (STS)
  • API de Vertex AI
  1. Crear recursos de Federación de identidad de carga de trabajo:
  • Crear un grupo de identidad de carga de trabajo
  • Agregar un proveedor OIDC de GitHub con:
  • Emisor: https://token.actions.githubusercontent.com
  • Asignaciones de atributos para repositorio y propietario
  • Recomendación de seguridad: Use condiciones de atributo específicas del repositorio
  1. Crear una cuenta de servicio:
  • Otorgue solo el rol Vertex AI User
  • Recomendación de seguridad: Cree una cuenta de servicio dedicada por repositorio
  1. Configurar enlaces de IAM:
  • Permitir que el grupo de identidad de carga de trabajo suplante la cuenta de servicio
  • Recomendación de seguridad: Use conjuntos de principios específicos del repositorio

Valores requeridos:

Después de la configuración, necesitará:

  • GCP_WORKLOAD_IDENTITY_PROVIDER: El nombre completo del recurso del proveedor
  • GCP_SERVICE_ACCOUNT: La dirección de correo electrónico de la cuenta de servicio

Para obtener instrucciones de configuración detalladas, consulte la documentación de Federación de identidad de carga de trabajo de Google Cloud.
3

Agregar secretos requeridos

Agregue los siguientes secretos a su repositorio (Configuración → Secretos y variables → Acciones):

Para Claude API (Directo):

  1. Para autenticación de API:
  1. Para aplicación de GitHub (si usa su propia aplicación):
  • APP_ID: El ID de su aplicación de GitHub
  • APP_PRIVATE_KEY: El contenido de la clave privada (.pem)

Para Google Cloud Vertex AI

  1. Para autenticación de GCP:
  • GCP_WORKLOAD_IDENTITY_PROVIDER
  • GCP_SERVICE_ACCOUNT
  1. Para aplicación de GitHub (si usa su propia aplicación):
  • APP_ID: El ID de su aplicación de GitHub
  • APP_PRIVATE_KEY: El contenido de la clave privada (.pem)

Para Amazon Bedrock

  1. Para autenticación de AWS:
  • AWS_ROLE_TO_ASSUME
  1. Para aplicación de GitHub (si usa su propia aplicación):
  • APP_ID: El ID de su aplicación de GitHub
  • APP_PRIVATE_KEY: El contenido de la clave privada (.pem)
4

Crear archivos de flujo de trabajo

Cree archivos de flujo de trabajo de GitHub Actions que se integren con su proveedor en la nube. Los ejemplos a continuación muestran configuraciones completas tanto para Amazon Bedrock como para Google Vertex AI:

**Requisitos previos:**
  • Acceso a Amazon Bedrock habilitado con permisos de modelo de Claude
  • GitHub configurado como proveedor de identidad OIDC en AWS
  • Rol de IAM con permisos de Bedrock que confía en GitHub Actions

Secretos de GitHub requeridos:

Nombre del secreto Descripción
AWS_ROLE_TO_ASSUME ARN del rol de IAM para acceso a Bedrock
APP_ID Su ID de aplicación de GitHub (de la configuración de la aplicación)
APP_PRIVATE_KEY La clave privada que generó para su aplicación de GitHub 
name: Claude PR Action

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

on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
issues:
types: [opened, assigned]

jobs:
claude-pr:
if: |
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
runs-on: ubuntu-latest
env:
AWS_REGION: us-west-2
steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Generate GitHub App token
id: app-token
uses: actions/create-github-app-token@v2
with:
app-id: ${{ secrets.APP_ID }}
private-key: ${{ secrets.APP_PRIVATE_KEY }}

- name: Configure AWS Credentials (OIDC)
uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
aws-region: us-west-2

- uses: anthropics/claude-code-action@v1
with:
github_token: ${{ steps.app-token.outputs.token }}
use_bedrock: "true"
claude_args: '--model us.anthropic.claude-sonnet-4-6 --max-turns 10'
Flujo de trabajo de Google Vertex AI

Requisitos previos:

  • API de Vertex AI habilitada en su proyecto de GCP
  • Federación de identidad de carga de trabajo configurada para GitHub
  • Cuenta de servicio con permisos de Vertex AI

Secretos de GitHub requeridos:

Nombre del secreto Descripción
GCP_WORKLOAD_IDENTITY_PROVIDER Nombre del recurso del proveedor de identidad de carga de trabajo
GCP_SERVICE_ACCOUNT Correo electrónico de la cuenta de servicio con acceso a Vertex AI
APP_ID Su ID de aplicación de GitHub (de la configuración de la aplicación)
APP_PRIVATE_KEY La clave privada que generó para su aplicación de GitHub 
name: Claude PR Action

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

on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
issues:
types: [opened, assigned]

jobs:
claude-pr:
if: |
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Generate GitHub App token
id: app-token
uses: actions/create-github-app-token@v2
with:
app-id: ${{ secrets.APP_ID }}
private-key: ${{ secrets.APP_PRIVATE_KEY }}

- name: Authenticate to Google Cloud
id: auth
uses: google-github-actions/auth@v2
with:
workload_identity_provider: ${{ secrets.GCP_WORKLOAD_IDENTITY_PROVIDER }}
service_account: ${{ secrets.GCP_SERVICE_ACCOUNT }}

- uses: anthropics/claude-code-action@v1
with:
github_token: ${{ steps.app-token.outputs.token }}
trigger_phrase: "@claude"
use_vertex: "true"
claude_args: '--model claude-sonnet-4-5@20250929 --max-turns 10'
env:
ANTHROPIC_VERTEX_PROJECT_ID: ${{ steps.auth.outputs.project_id }}
CLOUD_ML_REGION: us-east5
VERTEX_REGION_CLAUDE_4_5_SONNET: us-east5

Solución de problemas

Claude no responde a comandos @claude

Verifique que la aplicación de GitHub esté instalada correctamente, compruebe que los flujos de trabajo estén habilitados, asegúrese de que la clave API esté configurada en los secretos del repositorio y confirme que el comentario contenga @claude (no /claude).

CI no se ejecuta en los commits de Claude

Asegúrese de estar usando la aplicación de GitHub o una aplicación personalizada (no el usuario de Acciones), verifique que los disparadores de flujo de trabajo incluyan los eventos necesarios y confirme que los permisos de la aplicación incluyan disparadores de CI.

Errores de autenticación

Confirme que la clave API sea válida y tenga permisos suficientes. Para Bedrock/Vertex, verifique la configuración de credenciales y asegúrese de que los secretos tengan los nombres correctos en los flujos de trabajo.

Configuración avanzada

Parámetros de acción

Claude Code Action v1 utiliza una configuración simplificada:

Parámetro Descripción Requerido
prompt Instrucciones para Claude (texto sin formato o un nombre de skill) No*
claude_args Argumentos de CLI pasados a Claude Code No
anthropic_api_key Clave API de Claude Sí**
github_token Token de GitHub para acceso a API No
trigger_phrase Frase de disparo personalizada (predeterminado: "@claude") No
use_bedrock Usar Amazon Bedrock en lugar de Claude API No
use_vertex Usar Google Vertex AI en lugar de Claude API No

*Prompt es opcional - cuando se omite para comentarios de problema/PR, Claude responde a la frase de disparo
**Requerido para Claude API directo, no para Bedrock/Vertex

Pasar argumentos de CLI

El parámetro claude_args acepta cualquier argumento de CLI de Claude Code:

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

Argumentos comunes:

  • --max-turns: Máximo de turnos de conversación (predeterminado: 10)
  • --model: Modelo a usar (por ejemplo, claude-sonnet-4-6)
  • --mcp-config: Ruta a la 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

Métodos de integración alternativos

Aunque el comando /install-github-app es el enfoque recomendado, también puede:

  • Aplicación de GitHub personalizada: Para organizaciones que necesitan nombres de usuario personalizados o flujos de autenticación personalizados. Cree su propia aplicación de GitHub con permisos requeridos (contenidos, problemas, solicitudes de extracción) y use la acción actions/create-github-app-token para generar tokens en sus flujos de trabajo.
  • GitHub Actions manual: Configuración de flujo de trabajo directo para máxima flexibilidad
  • Configuración de MCP: Carga dinámica de servidores del Protocolo de contexto del modelo

Consulte la documentación de Claude Code Action para obtener guías detalladas sobre autenticación, seguridad y configuración avanzada.

Personalizar el comportamiento de Claude

Puede configurar el comportamiento de Claude de dos formas:

  1. CLAUDE.md: Defina estándares de codificación, criterios de revisión y reglas específicas del proyecto en un archivo CLAUDE.md en la raíz de su repositorio. Claude seguirá estas directrices al crear PR y responder a solicitudes. Consulte nuestra documentación de Memory para más detalles.
  2. Solicitudes personalizadas: Use el parámetro prompt en el archivo de flujo de trabajo para proporcionar instrucciones específicas del flujo de trabajo. Esto le permite personalizar el comportamiento de Claude para diferentes flujos de trabajo o tareas.

Claude seguirá estas directrices al crear PR y responder a solicitudes.