@claude dans n’importe quel PR ou problème, Claude peut analyser votre code, créer des demandes de tirage, implémenter des fonctionnalités et corriger des bogues - tout en respectant les normes de votre projet.
Claude Code GitHub Actions est construit sur le Claude Code
SDK, qui permet l’intégration programmatique de
Claude Code dans vos applications. Vous pouvez utiliser le SDK pour créer des
flux de travail d’automatisation personnalisés au-delà de GitHub Actions.
Claude Opus 4.5 est maintenant disponible. Claude Code GitHub Actions utilise par défaut Sonnet. Pour utiliser Opus 4.5, configurez le paramètre de modèle pour utiliser
claude-opus-4-5-20251101.Pourquoi utiliser Claude Code GitHub Actions ?
- Création instantanée de PR : Décrivez ce dont vous avez besoin, et Claude crée un PR complet avec tous les changements nécessaires
- Implémentation de code automatisée : Transformez les problèmes en code fonctionnel avec une seule commande
- Respecte vos normes : Claude respecte vos directives
CLAUDE.mdet les modèles de code existants - Configuration simple : Commencez en quelques minutes avec notre programme d’installation et votre clé API
- Sécurisé par défaut : Votre code reste sur les exécuteurs de Github
Que peut faire Claude ?
Claude Code fournit une puissante action GitHub qui transforme votre façon de travailler avec le code :Action Claude Code
Cette action GitHub vous permet d’exécuter Claude Code dans vos flux de travail GitHub Actions. Vous pouvez l’utiliser pour créer n’importe quel flux de travail personnalisé sur Claude Code. Voir le référentiel →Configuration
Configuration rapide
Le moyen le plus simple de configurer cette action est via Claude Code dans le terminal. Ouvrez simplement claude et exécutez/install-github-app.
Cette commande vous guidera dans la configuration de l’application GitHub et des secrets requis.
- Vous devez être administrateur du référentiel pour installer l’application GitHub et ajouter des secrets
- L’application GitHub demandera des autorisations de lecture et d’écriture pour les contenus, les problèmes et les demandes de tirage
- Cette méthode de démarrage rapide n’est disponible que pour les utilisateurs directs de l’API Claude. Si vous utilisez AWS Bedrock ou Google Vertex AI, veuillez consulter la section Utilisation avec AWS Bedrock et Google Vertex AI.
Configuration manuelle
Si la commande/install-github-app échoue ou si vous préférez une configuration manuelle, veuillez suivre ces instructions de configuration manuelle :
-
Installez l’application Claude GitHub sur votre référentiel : https://github.com/apps/claude
L’application Claude GitHub nécessite les autorisations de référentiel suivantes :
- Contenus : Lecture et écriture (pour modifier les fichiers du référentiel)
- Problèmes : Lecture et écriture (pour répondre aux problèmes)
- Demandes de tirage : Lecture et écriture (pour créer des PR et pousser les changements)
- Ajoutez ANTHROPIC_API_KEY à vos secrets de référentiel (Apprenez à utiliser les secrets dans GitHub Actions)
-
Copiez le fichier de flux de travail depuis examples/claude.yml dans le répertoire
.github/workflows/de votre référentiel
Mise à niveau depuis la version bêta
Si vous utilisez actuellement la version bêta de Claude Code GitHub Actions, nous vous recommandons de mettre à jour vos flux de travail pour utiliser la version GA. La nouvelle version simplifie la configuration tout en ajoutant de puissantes nouvelles fonctionnalités comme la détection automatique du mode.Changements essentiels
Tous les utilisateurs bêta doivent apporter ces modifications à leurs fichiers de flux de travail pour passer à la version bêta :- Mettez à jour la version de l’action : Changez
@betaen@v1 - Supprimez la configuration du mode : Supprimez
mode: "tag"oumode: "agent"(maintenant détecté automatiquement) - Mettez à jour les entrées d’invite : Remplacez
direct_promptparprompt - Déplacez les options CLI : Convertissez
max_turns,model,custom_instructions, etc. enclaude_args
Référence des modifications qui cassent la compatibilité
| Ancienne entrée bêta | Nouvelle entrée v1.0 |
|---|---|
mode | (Supprimée - détection automatique) |
direct_prompt | prompt |
override_prompt | prompt avec variables GitHub |
custom_instructions | claude_args: --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 format JSON |
Exemple avant et après
Version bêta :Exemples de cas d’utilisation
Claude Code GitHub Actions peut vous aider avec une variété de tâches. Le répertoire d’exemples contient des flux de travail prêts à l’emploi pour différents scénarios.Flux de travail de base
Utilisation de commandes slash
Automatisation personnalisée avec des invites
Cas d’utilisation courants
Dans les commentaires de problème ou de PR :Meilleures pratiques
Configuration CLAUDE.md
Créez un fichierCLAUDE.md à la racine de votre référentiel pour définir les directives de style de code, les critères d’examen, les règles spécifiques au projet et les modèles préférés. Ce fichier guide la compréhension de Claude des normes de votre projet.
Considérations de sécurité
Pour des conseils complets en matière de sécurité, y compris les autorisations, l’authentification et les meilleures pratiques, consultez la documentation de sécurité de Claude Code Action. Utilisez toujours les secrets GitHub pour les clés API :- Ajoutez votre clé API en tant que secret de référentiel nommé
ANTHROPIC_API_KEY - Référencez-la dans les flux de travail :
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} - Limitez les autorisations d’action à ce qui est nécessaire uniquement
- Examinez les suggestions de Claude avant de fusionner
${{ secrets.ANTHROPIC_API_KEY }}) plutôt que de coder en dur les clés API directement dans vos fichiers de flux de travail.
Optimisation des performances
Utilisez des modèles de problème pour fournir du contexte, gardez votreCLAUDE.md concis et ciblé, et configurez les délais d’expiration appropriés pour vos flux de travail.
Coûts CI
Lorsque vous utilisez Claude Code GitHub Actions, soyez conscient des coûts associés : Coûts de GitHub Actions :- Claude Code s’exécute sur des exécuteurs hébergés par GitHub, qui consomment vos minutes GitHub Actions
- Consultez la documentation de facturation de GitHub pour les tarifs détaillés et les limites de minutes
- Chaque interaction Claude consomme des jetons API en fonction de la longueur des invites et des réponses
- L’utilisation des jetons varie selon la complexité de la tâche et la taille de la base de code
- Consultez la page de tarification de Claude pour les tarifs actuels des jetons
- Utilisez des commandes
@claudespécifiques pour réduire les appels API inutiles - Configurez
--max-turnsapproprié dansclaude_argspour éviter les itérations excessives - Définissez les délais d’expiration au niveau du flux de travail pour éviter les tâches qui s’exécutent indéfiniment
- Envisagez d’utiliser les contrôles de concurrence de GitHub pour limiter les exécutions parallèles
Exemples de configuration
L’action Claude Code v1 simplifie la configuration avec des paramètres unifiés :- Interface d’invite unifiée - Utilisez
promptpour toutes les instructions - Commandes slash - Invites prédéfinies comme
/reviewou/fix - Passage CLI - N’importe quel argument CLI de Claude Code via
claude_args - Déclencheurs flexibles - Fonctionne avec n’importe quel événement GitHub
Utilisation avec AWS Bedrock et Google Vertex AI
Pour les environnements d’entreprise, vous pouvez utiliser Claude Code GitHub Actions avec votre propre infrastructure cloud. Cette approche vous donne le contrôle sur la résidence des données et la facturation tout en maintenant les mêmes fonctionnalités.Conditions préalables
Avant de configurer Claude Code GitHub Actions avec des fournisseurs cloud, vous avez besoin de :Pour Google Cloud Vertex AI :
- Un projet Google Cloud avec Vertex AI activé
- Workload Identity Federation configuré pour GitHub Actions
- Un compte de service avec les autorisations requises
- Une application GitHub (recommandée) ou utilisez le GITHUB_TOKEN par défaut
Pour AWS Bedrock :
- Un compte AWS avec Amazon Bedrock activé
- Fournisseur d’identité OIDC GitHub configuré dans AWS
- Un rôle IAM avec les autorisations Bedrock
- Une application GitHub (recommandée) ou utilisez le GITHUB_TOKEN par défaut
1
Créer une application GitHub personnalisée (recommandée pour les fournisseurs tiers)
Pour un meilleur contrôle et une meilleure sécurité lors de l’utilisation de fournisseurs tiers comme Vertex AI ou Bedrock, nous recommandons de créer votre propre application GitHub :Alternative pour l’API Claude ou si vous ne voulez pas configurer votre propre application Github : Utilisez l’application Anthropic officielle :
- Allez à https://github.com/settings/apps/new
- Remplissez les informations de base :
- Nom de l’application GitHub : Choisissez un nom unique (par exemple, « YourOrg Claude Assistant »)
- URL de la page d’accueil : Le site Web de votre organisation ou l’URL du référentiel
- Configurez les paramètres de l’application :
- Webhooks : Décochez « Actif » (non nécessaire pour cette intégration)
- Définissez les autorisations requises :
- Autorisations du référentiel :
- Contenus : Lecture et écriture
- Problèmes : Lecture et écriture
- Demandes de tirage : Lecture et écriture
- Autorisations du référentiel :
- Cliquez sur « Créer une application GitHub »
- Après la création, cliquez sur « Générer une clé privée » et enregistrez le fichier
.pemtéléchargé - Notez votre ID d’application à partir de la page des paramètres de l’application
- Installez l’application sur votre référentiel :
- À partir de la page des paramètres de votre application, cliquez sur « Installer l’application » dans la barre latérale gauche
- Sélectionnez votre compte ou organisation
- Choisissez « Seulement les référentiels sélectionnés » et sélectionnez le référentiel spécifique
- Cliquez sur « Installer »
- Ajoutez la clé privée en tant que secret à votre référentiel :
- Allez aux paramètres de votre référentiel → Secrets et variables → Actions
- Créez un nouveau secret nommé
APP_PRIVATE_KEYavec le contenu du fichier.pem
- Ajoutez l’ID de l’application en tant que secret :
- Créez un nouveau secret nommé
APP_IDavec l’ID de votre application GitHub
Cette application sera utilisée avec l’action actions/create-github-app-token pour générer des jetons d’authentification dans vos flux de travail.
- Installez depuis : https://github.com/apps/claude
- Aucune configuration supplémentaire nécessaire pour l’authentification
2
Configurer l'authentification du fournisseur cloud
Choisissez votre fournisseur cloud et configurez l’authentification sécurisée :
AWS Bedrock
AWS Bedrock
Configurez AWS pour permettre à GitHub Actions de s’authentifier de manière sécurisée sans stocker les identifiants.
Note de sécurité : Utilisez des configurations spécifiques au référentiel et accordez uniquement les autorisations minimales requises.Configuration requise :
-
Activez Amazon Bedrock :
- Demandez l’accès aux modèles Claude dans Amazon Bedrock
- Pour les modèles inter-régions, demandez l’accès dans toutes les régions requises
-
Configurez le fournisseur d’identité OIDC GitHub :
- URL du fournisseur :
https://token.actions.githubusercontent.com - Audience :
sts.amazonaws.com
- URL du fournisseur :
-
Créez un rôle IAM pour GitHub Actions :
- Type d’entité de confiance : Identité Web
- Fournisseur d’identité :
token.actions.githubusercontent.com - Autorisations : politique
AmazonBedrockFullAccess - Configurez la politique de confiance pour votre référentiel spécifique
- AWS_ROLE_TO_ASSUME : L’ARN du rôle IAM que vous avez créé
Google Vertex AI
Google Vertex AI
Configurez Google Cloud pour permettre à GitHub Actions de s’authentifier de manière sécurisée sans stocker les identifiants.
Note de sécurité : Utilisez des configurations spécifiques au référentiel et accordez uniquement les autorisations minimales requises.Configuration requise :
-
Activez les API dans votre projet Google Cloud :
- API des identifiants IAM
- API du service de jetons de sécurité (STS)
- API Vertex AI
-
Créez des ressources Workload Identity Federation :
- Créez un pool d’identités de charge de travail
- Ajoutez un fournisseur OIDC GitHub avec :
- Émetteur :
https://token.actions.githubusercontent.com - Mappages d’attributs pour le référentiel et le propriétaire
- Recommandation de sécurité : Utilisez des conditions d’attribut spécifiques au référentiel
- Émetteur :
-
Créez un compte de service :
- Accordez uniquement le rôle
Vertex AI User - Recommandation de sécurité : Créez un compte de service dédié par référentiel
- Accordez uniquement le rôle
-
Configurez les liaisons IAM :
- Autorisez le pool d’identités de charge de travail à emprunter l’identité du compte de service
- Recommandation de sécurité : Utilisez des ensembles de principaux spécifiques au référentiel
- GCP_WORKLOAD_IDENTITY_PROVIDER : Le nom complet de la ressource du fournisseur
- GCP_SERVICE_ACCOUNT : L’adresse e-mail du compte de service
3
Ajouter les secrets requis
Ajoutez les secrets suivants à votre référentiel (Paramètres → Secrets et variables → Actions) :
Pour l’API Claude (Direct) :
-
Pour l’authentification API :
ANTHROPIC_API_KEY: Votre clé API Claude depuis console.anthropic.com
-
Pour l’application GitHub (si vous utilisez votre propre application) :
APP_ID: L’ID de votre application GitHubAPP_PRIVATE_KEY: Le contenu de la clé privée (.pem)
Pour Google Cloud Vertex AI
-
Pour l’authentification GCP :
GCP_WORKLOAD_IDENTITY_PROVIDERGCP_SERVICE_ACCOUNT
-
Pour l’application GitHub (si vous utilisez votre propre application) :
APP_ID: L’ID de votre application GitHubAPP_PRIVATE_KEY: Le contenu de la clé privée (.pem)
Pour AWS Bedrock
-
Pour l’authentification AWS :
AWS_ROLE_TO_ASSUME
-
Pour l’application GitHub (si vous utilisez votre propre application) :
APP_ID: L’ID de votre application GitHubAPP_PRIVATE_KEY: Le contenu de la clé privée (.pem)
4
Créer des fichiers de flux de travail
Créez des fichiers de flux de travail GitHub Actions qui s’intègrent à votre fournisseur cloud. Les exemples ci-dessous montrent des configurations complètes pour AWS Bedrock et Google Vertex AI :
Flux de travail AWS Bedrock
Flux de travail AWS Bedrock
Conditions préalables :
- Accès AWS Bedrock activé avec autorisations de modèle Claude
- GitHub configuré en tant que fournisseur d’identité OIDC dans AWS
- Rôle IAM avec autorisations Bedrock qui fait confiance à GitHub Actions
| Nom du secret | Description |
|---|---|
AWS_ROLE_TO_ASSUME | ARN du rôle IAM pour l’accès à Bedrock |
APP_ID | Votre ID d’application GitHub (à partir des paramètres de l’application) |
APP_PRIVATE_KEY | La clé privée que vous avez générée pour votre application GitHub |
Flux de travail Google Vertex AI
Flux de travail Google Vertex AI
Conditions préalables :
- API Vertex AI activée dans votre projet GCP
- Workload Identity Federation configurée pour GitHub
- Compte de service avec autorisations Vertex AI
| Nom du secret | Description |
|---|---|
GCP_WORKLOAD_IDENTITY_PROVIDER | Nom de ressource du fournisseur d’identité de charge de travail |
GCP_SERVICE_ACCOUNT | E-mail du compte de service avec accès à Vertex AI |
APP_ID | Votre ID d’application GitHub (à partir des paramètres de l’application) |
APP_PRIVATE_KEY | La clé privée que vous avez générée pour votre application GitHub |
Dépannage
Claude ne répond pas aux commandes @claude
Vérifiez que l’application GitHub est correctement installée, vérifiez que les flux de travail sont activés, assurez-vous que la clé API est définie dans les secrets du référentiel et confirmez que le commentaire contient@claude (pas /claude).
CI ne s’exécute pas sur les commits de Claude
Assurez-vous que vous utilisez l’application GitHub ou une application personnalisée (pas l’utilisateur Actions), vérifiez que les déclencheurs de flux de travail incluent les événements nécessaires et vérifiez que les autorisations de l’application incluent les déclencheurs CI.Erreurs d’authentification
Confirmez que la clé API est valide et dispose des autorisations suffisantes. Pour Bedrock/Vertex, vérifiez la configuration des identifiants et assurez-vous que les secrets sont nommés correctement dans les flux de travail.Configuration avancée
Paramètres d’action
L’action Claude Code v1 utilise une configuration simplifiée :| Paramètre | Description | Requis |
|---|---|---|
prompt | Instructions pour Claude (texte ou commande slash) | Non* |
claude_args | Arguments CLI passés à Claude Code | Non |
anthropic_api_key | Clé API Claude | Oui** |
github_token | Jeton GitHub pour l’accès API | Non |
trigger_phrase | Phrase de déclenchement personnalisée (par défaut : « @claude ») | Non |
use_bedrock | Utilisez AWS Bedrock au lieu de l’API Claude | Non |
use_vertex | Utilisez Google Vertex AI au lieu de l’API Claude | Non |
**Requis pour l’API Claude directe, pas pour Bedrock/Vertex
Passer les arguments CLI
Le paramètreclaude_args accepte n’importe quel argument CLI de Claude Code :
--max-turns: Nombre maximum de tours de conversation (par défaut : 10)--model: Modèle à utiliser (par exemple,claude-sonnet-4-5-20250929)--mcp-config: Chemin vers la configuration MCP--allowed-tools: Liste séparée par des virgules des outils autorisés--debug: Activer la sortie de débogage
Méthodes d’intégration alternatives
Bien que la commande/install-github-app soit l’approche recommandée, vous pouvez également :
- Application GitHub personnalisée : Pour les organisations ayant besoin de noms d’utilisateur de marque ou de flux d’authentification personnalisés. Créez votre propre application GitHub avec les autorisations requises (contenus, problèmes, demandes de tirage) et utilisez l’action actions/create-github-app-token pour générer des jetons dans vos flux de travail.
- GitHub Actions manuel : Configuration directe du flux de travail pour une flexibilité maximale
- Configuration MCP : Chargement dynamique des serveurs du protocole de contexte de modèle
Personnalisation du comportement de Claude
Vous pouvez configurer le comportement de Claude de deux façons :- CLAUDE.md : Définissez les normes de codage, les critères d’examen et les règles spécifiques au projet dans un fichier
CLAUDE.mdà la racine de votre référentiel. Claude suivra ces directives lors de la création de PR et de la réponse aux demandes. Consultez notre documentation sur la mémoire pour plus de détails. - Invites personnalisées : Utilisez le paramètre
promptdans le fichier de flux de travail pour fournir des instructions spécifiques au flux de travail. Cela vous permet de personnaliser le comportement de Claude pour différents flux de travail ou tâches.