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 vosCLAUDE.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
Autres extensions