@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.
Claude Code GitHub Actions se construye sobre el Claude Agent SDK, que permite la integración programática de Claude Code en sus aplicaciones. Puede usar el SDK para crear flujos de trabajo de automatización personalizados más allá de GitHub Actions.
Claude Opus 4.6 ya está disponible. Claude Code GitHub Actions utiliza Sonnet de forma predeterminada. Para usar Opus 4.6, configure el parámetro de modelo para usar
claude-opus-4-6.¿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.mdy 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.
- Debe ser administrador del repositorio para instalar la aplicación de GitHub y agregar secretos
- La aplicación de GitHub solicitará permisos de lectura y escritura para Contenidos, Problemas y Solicitudes de extracción
- Este método de inicio rápido solo está disponible para usuarios directos de Claude API. Si está usando AWS Bedrock o Google Vertex AI, consulte la sección Usar con AWS Bedrock y Google Vertex AI.
Configuración manual
Si el comando/install-github-app falla o prefiere la configuración manual, siga estas instrucciones de configuración manual:
-
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)
- Agregue ANTHROPIC_API_KEY a sus secretos del repositorio (Aprenda cómo usar secretos en GitHub Actions)
-
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:- Actualice la versión de la acción: Cambie
@betaa@v1 - Elimine la configuración de modo: Elimine
mode: "tag"omode: "agent"(ahora se detecta automáticamente) - Actualice las entradas de solicitud: Reemplace
direct_promptconprompt - Mueva opciones de CLI: Convierta
max_turns,model,custom_instructions, etc. aclaude_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: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
Usar skills
Automatización personalizada con solicitudes
Casos de uso comunes
En comentarios de problema o PR:Mejores prácticas
Configuración de CLAUDE.md
Cree un archivoCLAUDE.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
${{ 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 suCLAUDE.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
- 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
- Use comandos específicos
@claudepara reducir llamadas API innecesarias - Configure
--max-turnsapropiado enclaude_argspara 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:- Interfaz de solicitud unificada - Use
promptpara 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
Usar con AWS 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:
- Un proyecto de Google Cloud con Vertex AI habilitado
- Federación de identidad de carga de trabajo configurada para GitHub Actions
- Una cuenta de servicio con los permisos requeridos
- Una aplicación de GitHub (recomendado) o use el GITHUB_TOKEN predeterminado
Para AWS Bedrock:
- Una cuenta de AWS con Amazon Bedrock habilitado
- Proveedor de identidad OIDC de GitHub configurado en AWS
- Un rol de IAM con permisos de Bedrock
- Una aplicación de GitHub (recomendado) o use el GITHUB_TOKEN predeterminado
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:Alternativa para Claude API o si no desea configurar su propia aplicación de Github: Use la aplicación oficial de Anthropic:
- Vaya a https://github.com/settings/apps/new
- 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
- Configure los ajustes de la aplicación:
- Webhooks: Desmarque “Activo” (no es necesario para esta integración)
- Establezca los permisos requeridos:
- Permisos del repositorio:
- Contenidos: Lectura y escritura
- Problemas: Lectura y escritura
- Solicitudes de extracción: Lectura y escritura
- Permisos del repositorio:
- Haga clic en “Crear aplicación de GitHub”
- Después de la creación, haga clic en “Generar una clave privada” y guarde el archivo
.pemdescargado - Anote su ID de aplicación en la página de configuración de la aplicación
- 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”
- 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_KEYcon el contenido del archivo.pem
- Agregue el ID de la aplicación como un secreto:
- Cree un nuevo secreto llamado
APP_IDcon el ID de su aplicación de GitHub
Esta aplicación se usará con la acción actions/create-github-app-token para generar tokens de autenticación en sus flujos de trabajo.
- Instale desde: https://github.com/apps/claude
- No se requiere configuración adicional para autenticación
Configurar autenticación del proveedor en la nube
Elija su proveedor en la nube y configure autenticación segura:
AWS Bedrock
AWS Bedrock
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:
-
Habilitar Amazon Bedrock:
- Solicite acceso a modelos de Claude en Amazon Bedrock
- Para modelos entre regiones, solicite acceso en todas las regiones requeridas
-
Configurar proveedor de identidad OIDC de GitHub:
- URL del proveedor:
https://token.actions.githubusercontent.com - Audiencia:
sts.amazonaws.com
- URL del proveedor:
-
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
- AWS_ROLE_TO_ASSUME: El ARN del rol de IAM que creó
Google Vertex AI
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:
-
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
-
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
- Emisor:
-
Crear una cuenta de servicio:
- Otorgue solo el rol
Vertex AI User - Recomendación de seguridad: Cree una cuenta de servicio dedicada por repositorio
- Otorgue solo el rol
-
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
- 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
Agregar secretos requeridos
Agregue los siguientes secretos a su repositorio (Configuración → Secretos y variables → Acciones):
Para Claude API (Directo):
-
Para autenticación de API:
ANTHROPIC_API_KEY: Su clave de API de Claude de console.anthropic.com
-
Para aplicación de GitHub (si usa su propia aplicación):
APP_ID: El ID de su aplicación de GitHubAPP_PRIVATE_KEY: El contenido de la clave privada (.pem)
Para Google Cloud Vertex AI
-
Para autenticación de GCP:
GCP_WORKLOAD_IDENTITY_PROVIDERGCP_SERVICE_ACCOUNT
-
Para aplicación de GitHub (si usa su propia aplicación):
APP_ID: El ID de su aplicación de GitHubAPP_PRIVATE_KEY: El contenido de la clave privada (.pem)
Para AWS Bedrock
-
Para autenticación de AWS:
AWS_ROLE_TO_ASSUME
-
Para aplicación de GitHub (si usa su propia aplicación):
APP_ID: El ID de su aplicación de GitHubAPP_PRIVATE_KEY: El contenido de la clave privada (.pem)
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 AWS Bedrock como para Google Vertex AI:
Flujo de trabajo de AWS Bedrock
Flujo de trabajo de AWS Bedrock
Requisitos previos:
- Acceso a AWS 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
| 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 |
Flujo de trabajo de Google Vertex AI
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
| 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 |
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 AWS Bedrock en lugar de Claude API | No |
use_vertex | Usar Google Vertex AI en lugar de Claude API | No |
**Requerido para Claude API directo, no para Bedrock/Vertex
Pasar argumentos de CLI
El parámetroclaude_args acepta cualquier argumento de CLI de Claude Code:
--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--allowed-tools: Lista separada por comas de herramientas permitidas--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
Personalizar el comportamiento de Claude
Puede configurar el comportamiento de Claude de dos formas:- CLAUDE.md: Defina estándares de codificación, criterios de revisión y reglas específicas del proyecto en un archivo
CLAUDE.mden 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. - Solicitudes personalizadas: Use el parámetro
prompten 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.