GitHub Actions de Claude Code
Claude Code GitHub Actions apporte une automatisation pilotée par l'IA à vos workflows GitHub.
En le mentionnant simplement dans une PR ou une Issue@claude, Claude peut analyser le code, créer des Pull Requests, implémenter des fonctionnalités et corriger des bugs tout en suivant les directives standard de votre projet.
Pourquoi utiliser Claude Code GitHub Actions
- Création instantanée de PR: Décrivez vos besoins, et Claude peut créer une Pull Request complète
- Implémentation automatisée du code: Transformez les Issues en code fonctionnel avec une seule commande
- Suit les normes du projet: Respecte vos
CLAUDE.mddirectives et modèles de code existants - Simple and fast: Démarrez en quelques minutes
- Secure and reliable: Le code reste en cours d'exécution sur les runners de GitHub
Démarrage rapide
Méthode 1 : Installation automatique (recommandée)
Exécutez dans le terminal Claude Code :
/install-github-app
Cela vous guidera à travers :
- Configuration d'une application GitHub
- Ajout des secrets requis
Prérequis : Vous devez être administrateur du dépôt. L'application GitHub doit disposer d'autorisations de lecture/écriture pour Contents, Issues et Pull requests. S'applique uniquement aux utilisateurs qui utilisent directement l'API Claude (AWS Bedrock et Google Vertex AI ne sont pas pris en charge).
Méthode 2 : Installation manuelle
Étape 1 : Installez l'application Claude GitHub
Visit:https://github.com/apps/claude
Autorisations requises :
- Contenu: Permissions de lecture/écriture
- Problèmes: Permissions de lecture/écriture
- Demandes de tirage: Permissions de lecture/écriture
Étape 2 : Ajouter la clé API
Ajouter aux Secrets du dépôtANTHROPIC_API_KEY
Étape 3 : Créer un fichier de workflow
Copier depuis le fichier d'exemple :examples/claude.ymlà.github/workflows/
Configuration du workflow
Workflow de base (Répondre aux mentions @claude)
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 }}
Revue de code automatique
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."
claude_args: "--max-turns 5"
Tâches planifiées
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"
Commandes courantes @claude
Utilisation dans les commentaires de PR ou d'Issue :
@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 review this PR for security issues
@claude add tests for this new function
Paramètres d'action expliqués
| Paramètre | Description | Requis |
|---|---|---|
prompt |
Instructions pour Claude (texte brut ou nom de compétence) | 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 à l'API) | non |
trigger_phrase |
Mot déclencheur personnalisé (par défaut :@claude) |
non |
use_bedrock |
Utiliser AWS Bedrock au lieu de l'API Claude | non |
use_vertex |
Utiliser Google Vertex AI au lieu de l'API Claude | non |
*Omettre le prompt lorsqu'il est utilisé dans les commentaires d'issue/PR ; Claude répond au mot déclencheur
**Requis lors de l'utilisation directe de l'API, non nécessaire pour Bedrock/Vertex
Paramètres CLI courants
| Paramètre | Description |
|---|---|
--max-turns |
Nombre maximum de tours de conversation (par défaut 10) |
--model |
Modèle à utiliser (par ex.claude-sonnet-4-6) |
--mcp-config |
Fichier de configuration MCP |
--allowedTools |
Outils autorisés (séparés par des virgules) |
--append-system-prompt |
Ajouter l'invite système |
--debug |
Activer la sortie de débogage |
Paramètres de la CLI claude
claude_args: | --max-turns 5 --model claude-sonnet-4-6 --mcp-config /path/to/config.json --append-system-prompt "Follow our coding standards"
Intégration AWS Bedrock
Prérequis
- Intégration AWS Bedrock
- GitHub configuré comme fournisseur d'identité OIDC dans AWS
- IAM avec autorisations Bedrock
Secrets requis
| Nom du secret | Description |
|---|---|
AWS_ROLE_TO_ASSUME |
ARN du rôle IAM pour l'accès à Bedrock |
APP_ID |
ID de l'application GitHub |
APP_PRIVATE_KEY |
Clé privée de l'application GitHub |
Exemple de workflow Bedrock
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]
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'))
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'
Intégration de Google Vertex AI
Prérequis
- API Vertex AI activée dans le projet GCP
- Workload Identity Federation configurée pour GitHub
- Compte de service avec autorisations Vertex AI
Secrets requis
| Nom du secret | Description |
|---|---|
GCP_WORKLOAD_IDENTITY_PROVIDER |
Nom de ressource du fournisseur Workload Identity |
GCP_SERVICE_ACCOUNT |
Adresse e-mail du compte de service avec accès à Vertex AI |
APP_ID |
ID de l'application GitHub |
APP_PRIVATE_KEY |
Clé privée de l'application GitHub |
Exemple de workflow Vertex AI
name: Claude PR Action
permissions:
contents: write
pull-requests: write
issues: write
id-token: write
on:
issue_comment:
types: [created]
jobs:
claude-pr:
if: github.event_name == 'issue_comment' && contains(github.event.comment.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
Mise à niveau depuis la bêta (changements majeurs de la v1.0)
| Entrée bêta | Nouvelle entrée v1.0 |
|---|---|
mode |
(Supprimé - détecté automatiquement) |
direct_prompt |
prompt |
override_prompt |
avec des variables GitHubprompt |
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 |
Comparaison avant et après la mise à niveau
Version bêta :
- 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"
Version 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
Dépannage
Claude ne répond pas aux commandes @claude
- Confirmer que l'application GitHub est correctement installée
- Vérifier que le workflow est activé
- Assurez-vous que la clé API est définie dans les Secrets du dépôt
- Confirmez que le commentaire contient
@claude(pas/claude)
La CI ne s'exécute pas sur les commits de Claude
- Utilisez l'application GitHub ou une application personnalisée (n'utilisez pas l'utilisateur Actions)
- Vérifiez que les déclencheurs de workflow incluent les événements nécessaires
- Confirmez 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
- Assurez-vous que les noms de Secret sont corrects dans le workflow
Considérations de sécurité
- Ne committez jamais les clés API directementdans le dépôt
- Utilisez GitHub Secrets pour stocker les clés d'API :
${{ secrets.ANTHROPIC_API_KEY }} - Limitez les autorisations d'action ; accordez uniquement les autorisations nécessaires
- Examinez les suggestions de Claude avant la fusion
- Pour AWS/GCP : utilisez des fournisseurs d'identité OIDC au lieu d'identifiants statiques
- Créez des comptes de service dédiés pour chaque dépôt
Considérations sur les coûts
Détail des coûts
- Coûts de GitHub Actions: L'exécution sur des runners hébergés par GitHub consomme des minutes GitHub Actions
- Coûts d'API: Chaque interaction avec Claude consomme des jetons d'API en fonction de la longueur de l'invite/de la réponse
Suggestions d'optimisation des coûts
- Utilisez des
@claudecommandes spécifiques, réduisez les appels d'API inutiles - Configurer de manière appropriée
--max-turnsLimiter le nombre de tours de conversation - Définir des délais d'expiration de workflow pour éviter que les tâches ne deviennent incontrôlables
- Utiliser les contrôles de concurrence GitHub pour limiter les exécutions parallèles
Bonnes pratiques
1. Créer CLAUDE.md
Créer à la racine du dépôtCLAUDE.mdfichier, définir le guide de style de code et les règles spécifiques au projet :
# 项目开发规范 ## 代码风格 - 使用 TypeScript 4.x - 遵循 ESLint 配置 - 函数必须有 JSDoc 注释 ## PR 要求 - 必须通过所有 CI 检查 - 至少一个代码审查 - 更新相关文档 ## 禁止事项 - 不要修改 `migrations/` 目录 - 不要提交 `.env` 文件
2. Utiliser des commandes @claude spécifiques
@claude review this PR for SQL injection vulnerabilities
@claude add unit tests for the new validateEmail function
3. Configurer des limites appropriées
jobs:
claude:
runs-on: ubuntu-latest
timeout-minutes: 15 # 设置超时
steps:
- uses: anthropics/claude-code-action@v1
with:
claude_args: "--max-turns 5 --allowedTools Read,Grep,Glob,Bash,Write,Edit"
4. Scénarios d'automatisation CI/CD
- Revue automatique des PR: Déclencher automatiquement une revue lorsqu'une PR est ouverte ou mise à jour
- Classification automatique des Issues: Ajouter automatiquement des étiquettes et des personnes assignées lorsqu'une nouvelle Issue est créée
- Rapports planifiés: Générer des statistiques de code quotidiennes ou des rapports de sécurité
- Corrections automatisées: Analyser automatiquement et tenter des corrections lorsque la CI échoue