Claude Code GitHub Actions

​

Pourquoi utiliser Claude Code GitHub Actions ?

• Création instantanée de PR : Décrivez ce dont vous avez besoin, et Claude crée une PR complète avec tous les changements nécessaires
• Implémentation de code automatisée : Transformez les issues en code fonctionnel avec une seule commande
• Respecte vos normes : Claude respecte vos directives CLAUDE.md et les modèles de code existants
• Configuration simple : Commencez en quelques minutes avec notre installateur et votre clé API
• Sécurisé par défaut : Votre code reste sur les runners de Github

​

Que peut faire Claude ?

​

Claude Code Action

​

Configuration

​

Configuration rapide

​

Configuration manuelle

1. Installez l’application Claude GitHub dans votre repository : https://github.com/apps/claude L’application Claude GitHub nécessite les permissions de repository suivantes :
   • Contents : Lecture et écriture (pour modifier les fichiers du repository)
   • Issues : Lecture et écriture (pour répondre aux issues)
   • Pull requests : Lecture et écriture (pour créer des PRs et pousser les changements)
   Pour plus de détails sur la sécurité et les permissions, consultez la documentation de sécurité.
2. Ajoutez ANTHROPIC_API_KEY à vos secrets de repository (Apprenez comment utiliser les secrets dans GitHub Actions)
3. Copiez le fichier de flux de travail depuis examples/claude.yml dans le répertoire .github/workflows/ de votre repository

​

Mise à niveau depuis la version bêta

​

Changements essentiels

1. Mettez à jour la version de l’action : Changez @beta en @v1
2. Supprimez la configuration du mode : Supprimez mode: "tag" ou mode: "agent" (maintenant détecté automatiquement)
3. Mettez à jour les entrées de prompt : Remplacez direct_prompt par prompt
4. Déplacez les options CLI : Convertissez max_turns, model, custom_instructions, etc. en claude_args

​

Référence des changements majeurs

​

Exemple avant et après

- 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-5"

- 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-5

​

Exemples de cas d’usage

​

Flux de travail basique

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

​

Utilisation de skills

• Pour un skill dans le répertoire .claude/skills/ de votre référentiel, exécutez actions/checkout avant l’étape d’action et passez /skill-name.
• Pour un skill empaqueté dans un plugin, installez le plugin avec les entrées plugin_marketplaces et plugins et passez le /plugin-name:skill-name avec espace de noms.

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 }}
          plugin_marketplaces: "https://github.com/anthropics/claude-code.git"
          plugins: "code-review@claude-code-plugins"
          prompt: "/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"

​

Automatisation personnalisée avec prompts

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"

​

Cas d’usage courants

@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

​

Bonnes pratiques

​

Configuration CLAUDE.md

​

Considérations de sécurité

• Ajoutez votre clé API en tant que secret de repository nommé ANTHROPIC_API_KEY
• Référencez-la dans les flux de travail : anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
• Limitez les permissions de l’action à ce qui est nécessaire uniquement
• Examinez les suggestions de Claude avant de fusionner

​

Optimisation des performances

​

Coûts CI

• Claude Code s’exécute sur les runners 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 tokens API en fonction de la longueur des prompts et des réponses
• L’utilisation des tokens 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 tokens

• Utilisez des commandes @claude spécifiques pour réduire les appels API inutiles
• Configurez --max-turns approprié dans claude_args pour éviter les itérations excessives
• Définissez les délais d’attente au niveau du flux de travail pour éviter les jobs 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

- 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

• Interface de prompt unifiée - Utilisez prompt pour toutes les instructions
• Skills - Invoquez les skills installés directement depuis le prompt
• Passthrough CLI - N’importe quel argument Claude Code CLI via claude_args
• Déclencheurs flexibles - Fonctionne avec n’importe quel événement GitHub

​

Utilisation avec Amazon Bedrock et Google Cloud

​

Prérequis

​

Pour Google Cloud’s Agent Platform :

1. Un projet Google Cloud avec Google Cloud’s Agent Platform activé
2. Workload Identity Federation configuré pour GitHub Actions
3. Un compte de service avec les permissions requises
4. Une application GitHub (recommandée) ou utilisez le GITHUB_TOKEN par défaut

​

Pour Amazon Bedrock :

1. Un compte AWS avec Amazon Bedrock activé
2. GitHub OIDC Identity Provider configuré dans AWS
3. Un rôle IAM avec les permissions Amazon Bedrock
4. Une application GitHub (recommandée) ou utilisez le GITHUB_TOKEN par défaut

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'

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

​

Dépannage

​

Claude ne répond pas aux commandes @claude

​

CI ne s’exécute pas sur les commits de Claude

​

Erreurs d’authentification

​

Configuration avancée

​

Paramètres de l’action

​

Passer les arguments CLI

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

• --max-turns : Nombre maximum de tours de conversation (par défaut : 10)
• --model : Modèle à utiliser (par exemple, claude-sonnet-5)
• --mcp-config : Chemin vers la configuration MCP
• --allowedTools : Liste séparée par des virgules des outils autorisés. L’alias --allowed-tools fonctionne également.
• --debug : Activer la sortie de débogage

​

Méthodes d’intégration alternatives

• 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 permissions requises (contents, issues, pull requests) et utilisez l’action actions/create-github-app-token pour générer des tokens dans vos flux de travail.
• GitHub Actions manuel : Configuration directe du flux de travail pour une flexibilité maximale
• Configuration MCP : Chargement dynamique des serveurs Model Context Protocol

​

Personnalisation du comportement de Claude

1. CLAUDE.md : Définissez les normes de codage, les critères de révision et les règles spécifiques au projet dans un fichier CLAUDE.md à la racine de votre repository. Claude suivra ces directives lors de la création de PRs et de la réponse aux demandes. Consultez notre documentation Memory pour plus de détails.
2. Prompts personnalisés : Utilisez le paramètre prompt dans 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.