Claude Code GitHub Actions

Exécutez Claude Code dans les workflows GitHub Actions pour répondre aux mentions @claude, automatiser les tâches et transformer les issues en pull requests

Claude Code GitHub Actions est une GitHub Action qui exécute Claude Code dans les workflows de votre repository. Mentionnez @claude dans un commentaire de pull request ou d'issue pour que Claude analyse le code, implémente des modifications et pousse des commits. Vous pouvez également donner à la GitHub Action Claude Code un prompt pour s'exécuter automatiquement sur n'importe quel événement GitHub. Utilisez-la pour transformer les issues en pull requests, corriger les bugs à partir d'un commentaire ou automatiser les tâches récurrentes.

Plusieurs produits partagent le nom Claude Code. Cette page couvre l'intégration de workflow claude-code-action, que vous configurez avec des fichiers de workflow dans votre repository. Pour les produits connexes, consultez :

• Code Review : révision automatique sur chaque pull request, sans écrire de workflow
• Claude Code dans le cloud : sessions Claude Code qui s'exécutent sur une infrastructure cloud au lieu de votre machine
• Claude Agent SDK : automatisation personnalisée en dehors de GitHub Actions. La GitHub Action Claude Code est construite sur le SDK
• GitHub Enterprise Server : Claude Code avec GitHub auto-hébergé

Configuration

Vous pouvez configurer la GitHub Action Claude Code de deux façons :

• Configuration rapide : exécutez /install-github-app depuis Claude Code. Claude Code installe la GitHub App, ajoute votre secret d'authentification et prépare la pull request de workflow pour vous
• Configuration manuelle : installez l'app, ajoutez le secret et copiez le fichier de workflow dans votre repository vous-même. Utilisez ce chemin lorsque vous n'exécutez pas Claude Code localement, lorsque la commande échoue ou lorsque vous voulez un contrôle total des fichiers de workflow

Pour l'un ou l'autre chemin, vous avez besoin d'un accès administrateur au repository.

Configuration rapide

/install-github-app fonctionne uniquement avec les repositories github.com. Si la télécommande git de votre repository se trouve sur gitlab.com ou bitbucket.org, la commande affiche un avis et se termine au lieu de démarrer la configuration. Pour exécuter Claude Code à partir des pipelines GitLab, consultez Claude Code GitLab CI/CD.

Avant de commencer, installez le GitHub CLI et authentifiez-le avec gh auth login. Claude Code le vérifie et vous avertit s'il manque.

Ouvrez claude dans le repository que vous voulez connecter, exécutez /install-github-app et suivez les invites. Claude Code installe la Claude GitHub App, puis configure un secret d'authentification pour les workflows :

• Si Claude Code a déjà une clé API, il réutilise cette clé et propose de conserver le secret ANTHROPIC_API_KEY existant du repository s'il en existe un
• Sinon, choisissez entre créer un token de longue durée avec votre abonnement Claude et coller une clé API

Claude Code enregistre les credentials en tant que secret de repository, nommé ANTHROPIC_API_KEY pour une clé API ou CLAUDE_CODE_OAUTH_TOKEN pour un token d'abonnement.

Claude Code pousse ensuite une branche avec les fichiers de workflow que vous sélectionnez, déjà configurés pour utiliser ce secret, et ouvre GitHub dans votre navigateur avec une pull request prête à créer. Créez et fusionnez cette pull request, et @claude fonctionne dans le repository.

Si vous sélectionnez le workflow de révision, Claude publie chaque révision sur la pull request elle-même, en tant que commentaire en ligne sur chaque problème qu'il trouve ou en tant qu'un commentaire de résumé lorsqu'il n'en trouve aucun. Claude ignore certaines pull requests, comme les brouillons. L'exemple de workflow de révision utilise la même skill et les énumère. Avant v2.1.229, Claude écrivait sa révision uniquement dans le journal d'exécution du workflow.

Pour mettre à jour un workflow de révision qu'une version antérieure a généré, faites l'une des choses suivantes :

• Exécutez /install-github-app à nouveau. Lorsque le repository a déjà un claude.yml, sélectionnez Mettre à jour le fichier de workflow avec la dernière version. Claude Code pousse des copies fraîches des fichiers de workflow vers une nouvelle branche et ouvre la pull request, comme une première installation.
• Ajoutez l'argument --comment et la ligne claude_args de l'exemple de workflow de révision au fichier enregistré vous-même, ce qui conserve les autres modifications que vous y avez apportées.

Après l'installation de la GitHub App, Claude Code demande si vous voulez continuer avec la configuration de GitHub Actions. Choisissez Ignorer pour l'instant pour arrêter avec seulement la GitHub App installée. Exécutez /install-github-app à nouveau plus tard pour terminer les étapes de workflow et de secret. Avant v2.1.187, Claude Code procédait directement à la sélection du workflow.

Configuration manuelle

Pour configurer la GitHub Action Claude Code sans exécuter /install-github-app, installez l'app, ajoutez un secret et copiez un fichier de workflow vous-même :

Configurer pour une organisation

Avec la configuration rapide ou manuelle, vous configurez un repository à la fois. Pour déployer la GitHub Action Claude Code dans une organisation :

• Installez la Claude GitHub App une fois au niveau de l'organisation, en choisissant tous les repositories ou une liste sélectionnée
• Stockez le secret d'authentification en tant que secret Actions au niveau de l'organisation pour que chaque repository n'ait pas besoin de sa propre copie
• Ajoutez le fichier de workflow à chaque repository qui devrait exécuter la GitHub Action Claude Code, ou définissez le job une fois en tant que workflow réutilisable que chaque repository appelle

Pour un secret partagé entre les repositories, authentifiez-vous avec une clé API de la Claude Console plutôt qu'un token OAuth, car un token OAuth est lié à l'abonnement de la personne qui a exécuté claude setup-token.

Pour éviter de stocker un secret de longue durée, authentifiez-vous via la fédération d'identité de charge de travail, où la GitHub Action Claude Code échange le token GitHub OpenID Connect (OIDC) du workflow pour l'accès à l'API Claude via un compte de service de la Claude Console. Définissez ces entrées :

• anthropic_federation_rule_id : l'ID de la règle de fédération, fdrl_...
• anthropic_organization_id : votre ID d'organisation Anthropic
• anthropic_service_account_id : l'ID du compte de service, svac_.... Optionnel, car la règle de fédération que vous créez dans la Console cible déjà un compte de service
• anthropic_workspace_id : l'ID de l'espace de travail, wrkspc_.... Optionnel lorsque la règle de fédération cible un seul espace de travail

Accordez au workflow la permission id-token: write, que la GitHub Action Claude Code nécessite pour l'échange de fédération même lorsque vous passez votre propre github_token. Consultez le guide de configuration de la GitHub Action Claude Code pour la configuration côté Console.

Pour les questions de traitement et de rétention des données dans un examen de sécurité, consultez utilisation des données et sécurité.

Désinstaller

Pour supprimer la GitHub Action Claude Code, annulez chaque partie de la configuration qui s'applique à votre installation :

• Fichiers de workflow : supprimez les workflows qui utilisent anthropics/claude-code-action de .github/workflows/. Si vous avez utilisé la configuration rapide, recherchez claude.yml et, si vous avez sélectionné le workflow de révision, claude-code-review.yml. Avec les workflows supprimés, la GitHub Action Claude Code ne s'exécute plus
• Secrets : supprimez le secret ANTHROPIC_API_KEY ou CLAUDE_CODE_OAUTH_TOKEN du repository, et des secrets Actions au niveau de l'organisation si vous l'avez partagé entre les repositories. Si vous supprimez un secret, les credentials qu'il contenait restent valides. Pour retirer complètement une clé API, supprimez également la clé dans la Claude Console
• GitHub App : désinstallez la Claude GitHub App dans les paramètres de votre repository ou organisation sous GitHub Apps, mais seulement si vous ne l'utilisez pas pour une autre fonctionnalité Claude, comme Code Review ou auto-fix web

Si vous avez configuré un fournisseur cloud, supprimez également les secrets du fournisseur, comme AWS_ROLE_TO_ASSUME, les secrets GCP_* ou les secrets AZURE_*, et désinstallez la GitHub App personnalisée ainsi que ses secrets APP_ID et APP_PRIVATE_KEY.

Permissions de la GitHub App

La Claude GitHub App est partagée par chaque fonctionnalité Claude qui s'intègre à GitHub, y compris la GitHub Action Claude Code, Code Review et auto-fix pour les pull requests dans les sessions cloud. Une GitHub App a un ensemble de permissions unique couvrant toutes ses fonctionnalités, donc l'ensemble inclut certaines permissions que la GitHub Action Claude Code n'utilise pas.

Lorsque vous installez l'app, vous accordez les permissions suivantes :

L'ensemble de permissions peut également changer avant les fonctionnalités qui l'utilisent. Lorsque l'app demande une permission qu'elle n'avait pas auparavant, GitHub demande au propriétaire du compte de l'approuver, à un propriétaire d'organisation pour une installation d'organisation, et l'installation conserve ses anciennes permissions jusqu'à ce qu'ils le fassent. Par exemple, lorsque l'accès Actions passe de lecture à écriture, l'app peut réexécuter les workflows plutôt que seulement afficher les exécutions et les journaux, donc GitHub demande au propriétaire d'approuver le changement.

Lorsque vous installez l'app, vous acceptez son ensemble de permissions complet. GitHub ne vous permet pas d'accepter un sous-ensemble. Si votre organisation nécessite uniquement les permissions que la GitHub Action Claude Code utilise, créez une GitHub App personnalisée avec Contents, Issues et Pull requests à la place, en suivant le guide de configuration de la GitHub Action Claude Code. Une app personnalisée couvre uniquement la GitHub Action Claude Code. Code Review et auto-fix web nécessitent toujours l'app officielle.

Pour plus de détails sur la façon dont la GitHub Action Claude Code limite ce que Claude peut faire avec ces permissions, consultez la documentation de sécurité.

Modes interactif et automatisation

La GitHub Action Claude Code détecte comment s'exécuter à partir de votre configuration de workflow :

• Mode interactif : lorsque le workflow ne fournit pas d'entrée prompt, Claude attend la phrase de déclenchement, @claude par défaut, dans un commentaire d'issue ou de pull request, dans une révision de pull request ou dans le corps ou le titre d'une issue nouvellement ouverte, puis répond à cette demande. La progression et les résultats apparaissent en tant que commentaire sur l'issue ou la PR de déclenchement.
• Mode automatisation : lorsque le workflow fournit une entrée prompt, Claude s'exécute sans attendre une mention, soumis uniquement aux vérifications sur qui peut déclencher les exécutions. Par défaut, les résultats apparaissent dans le journal d'exécution du workflow plutôt qu'un commentaire. Claude peut publier sur l'issue ou la pull request lorsque le prompt le dirige et qu'il a un outil qui peut publier, comme dans l'exemple de révision de code.

Qui peut déclencher les exécutions

Dans les deux modes, la GitHub Action Claude Code exécute deux vérifications sur l'acteur de déclenchement avant que Claude ne commence, et l'exécution échoue lorsque l'une des deux vérifications la rejette :

• Accès en écriture : sur les événements d'issue et de pull request, l'utilisateur de déclenchement doit avoir un accès en écriture au repository. Pour permettre à des utilisateurs spécifiques sans accès en écriture, définissez allowed_non_write_users et passez votre propre entrée github_token. Les événements qu'aucun utilisateur n'auteur, comme un déclencheur schedule, ignorent cette vérification.
• Acteur humain : sur chaque événement, la GitHub Action Claude Code rejette un acteur bot à moins que vous le listiez dans allowed_bots, ce qui empêche les bots de déclencher Claude dans une boucle. Cette vérification s'applique également aux exécutions programmées, que GitHub attribue à un utilisateur du repository, généralement celui qui a modifié en dernier le calendrier cron du workflow. Si cet utilisateur est un bot, listez-le dans allowed_bots.

Exemples de cas d'usage

Le répertoire d'exemples contient des workflows prêts à l'emploi pour différents scénarios.

Les exemples de cette page montrent l'authentification par clé API. Si vous vous authentifiez avec un abonnement Claude, remplacez la ligne anthropic_api_key dans n'importe quel exemple par claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}.

Répondre aux mentions @claude

Ce workflow exécute la GitHub Action Claude Code en mode interactif, donc Claude répond chaque fois que quelqu'un mentionne @claude dans un commentaire d'issue ou de PR.

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Les parties de ce workflow qui ne sont pas du code standard :

• id-token: write : requis pour l'authentification GitHub App par défaut de la GitHub Action Claude Code
• actions: read : permet à Claude de lire les résultats CI sur les PRs
• actions/checkout : donne à Claude une copie locale du repository pour travailler
• if : empêche les runners de démarrer sur les commentaires qui ne mentionnent pas @claude. La GitHub Action Claude Code vérifie également la phrase de déclenchement elle-même avant de répondre

Une fois le workflow en place, mentionnez @claude dans n'importe quel commentaire d'issue ou de PR avec une demande :

@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 répond dans un commentaire sur la même issue ou PR et le met à jour au fur et à mesure qu'il travaille.

Exécuter une skill

L'entrée prompt accepte une invocation de skill ainsi que du texte brut :

• Pour une skill dans le répertoire .claude/skills/ de votre repository, exécutez actions/checkout avant l'étape anthropics/claude-code-action pour que les fichiers de skill soient disponibles sur le runner, puis passez /skill-name comme prompt.
• Pour une skill emballée dans un plugin, installez le plugin avec les entrées plugin_marketplaces et plugins, puis passez le /plugin-name:skill-name avec espace de noms comme prompt. L'entrée plugins prend plugin-name@marketplace-name, où le nom de la marketplace provient du manifeste de la marketplace elle-même plutôt que de l'URL de son repository.

Le workflow suivant installe le plugin code-review et exécute sa skill lorsqu'une pull request est ouverte, mise à jour, rouverte ou marquée comme prête pour révision. Il exécute le même plugin que le workflow de révision de la configuration rapide. Utilisez un workflow comme celui-ci lorsque vous voulez contrôler le prompt, le modèle et les déclencheurs vous-même. Pour les révisions automatiques sans maintenir un fichier de workflow, consultez Code Review. Sur les repositories publics, GitHub retient les secrets des exécutions déclenchées par des pull requests de fork, donc la révision s'exécute uniquement sur les pull requests des branches du même repository.

name: Code Review
on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: read
      issues: read
      id-token: write
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - 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 --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

Deux lignes dans ce workflow contrôlent où la révision va :

• --comment : Claude publie sa révision sur la pull request, en tant que commentaire en ligne sur chaque problème qu'il trouve ou en tant qu'un commentaire de résumé lorsqu'il n'en trouve aucun. Sans cela, Claude ne publie rien, et vous lisez les résultats dans le journal d'exécution du workflow.
• claude_args : conservez cette ligne même si la frontmatter allowed-tools propre de la skill nomme le même outil, car la GitHub Action Claude Code démarre le serveur MCP qui publie les commentaires en ligne uniquement lorsque --allowedTools dans claude_args le nomme.

Claude ignore les pull requests brouillon et fermées, les pull requests qu'il juge ne pas avoir besoin d'une révision, comme les pull requests automatisées ou triviales, et les pull requests qui ont déjà un commentaire de Claude.

Exécuter selon un calendrier

Avec une entrée prompt, la GitHub Action Claude Code s'exécute en mode automatisation sur n'importe quel événement GitHub, y compris un calendrier cron. Pour un prompt en texte brut, Claude n'a pas d'accès shell ou API GitHub jusqu'à ce que vous accordiez les outils que le prompt nécessite, avec --allowedTools dans claude_args ou une règle permissions.allow dans l'entrée settings. Si vous invoquez une skill à la place, Claude peut utiliser les outils que sa frontmatter allowed-tools accorde. GitHub exécute les workflows programmés uniquement à partir de la branche par défaut et, dans les repositories publics, désactive le calendrier après 60 jours sans activité du repository.

Ce workflow génère un rapport dans le journal d'exécution du workflow à 09:00 UTC chaque jour. Sa ligne claude_args passe les arguments CLI qui sélectionnent le modèle et permettent deux outils MCP GitHub. Claude lit les commits et les issues via l'API GitHub avec ces outils, donc vous pouvez omettre l'étape de checkout :

name: Daily Report
on:
  schedule:
    - cron: "0 9 * * *"
jobs:
  report:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: read
      id-token: write
    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 claude-opus-4-8
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

Bonnes pratiques

Définir les normes du projet dans CLAUDE.md

Créez un fichier CLAUDE.md à la racine de votre repository pour définir les directives de style de code, les critères de révision, les règles spécifiques au projet et les modèles préférés. Claude suit ces directives lors de la création de PRs et de la réponse aux demandes. Consultez la documentation de mémoire pour plus de détails.

Protéger vos credentials

Accordez au workflow uniquement les permissions dont il a besoin et examinez les modifications de Claude avant de fusionner.

Pour des conseils de sécurité complets incluant les permissions et l'authentification, consultez la documentation de sécurité de la GitHub Action Claude Code.

Gérer les coûts

Chaque exécution consomme deux types de ressources :

• Minutes GitHub Actions : la GitHub Action 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 et les limites de minutes.
• Tokens API : chaque interaction consomme des tokens en fonction de la longueur des prompts et des réponses, de la complexité des tâches et de la taille de la base de code. Consultez la page de tarification de Claude pour les tarifs actuels des tokens. Si vous vous authentifiez avec un token OAuth, les exécutions utilisent votre abonnement Claude au lieu de la facturation API.

Vous pouvez réduire les deux types de coûts en donnant à Claude un contexte plus clair et en limitant la quantité de travail que chaque exécution peut faire :

• Écrivez des demandes @claude spécifiques pour que Claude ait besoin de moins de tours pour terminer
• Utilisez les modèles d'issue pour fournir du contexte à l'avance
• Gardez votre CLAUDE.md concis, car Claude le lit à chaque exécution
• Définissez --max-turns dans claude_args pour limiter les itérations
• Définissez les délais d'attente au niveau du workflow pour éviter les jobs qui s'exécutent indéfiniment
• Utilisez les contrôles de concurrence de GitHub pour limiter les exécutions parallèles

Pour le suivi de l'utilisation dans votre organisation, consultez le tableau de bord d'analyse et la surveillance. Pour savoir comment l'utilisation est mesurée et facturée, consultez coûts.

Utiliser un fournisseur cloud

Par défaut, la GitHub Action Claude Code appelle l'API Claude directement avec votre clé API ou token OAuth. Pour acheminer l'inférence via votre propre compte cloud à la place, définissez l'entrée pour votre fournisseur et suivez Utiliser Claude Code GitHub Actions avec les fournisseurs cloud :

• Amazon Bedrock : use_bedrock: "true"
• Google Cloud's Agent Platform : use_vertex: "true"
• Microsoft Foundry : use_foundry: "true"

Avec les trois fournisseurs, vous vous authentifiez via la fédération d'identité OIDC au lieu d'une clé API Claude, donc vous ne stockez aucune credential cloud statique dans votre repository.

Dépannage

Claude ne répond pas aux commandes @claude

• Vérifiez que la GitHub App est installée sur le repository
• Vérifiez que les workflows sont activés pour le repository
• Assurez-vous que votre clé API ou token OAuth est défini dans les secrets du repository
• Confirmez que le commentaire contient @claude comme mot complet, pas /claude ou @claude-bot
• Confirmez que l'utilisateur qui commente a un accès en écriture au repository. Consultez Qui peut déclencher les exécutions pour les exceptions

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

• GitHub ne déclenche pas les workflows sur les commits effectués avec le GITHUB_TOKEN par défaut. Si vous passez github_token: ${{ secrets.GITHUB_TOKEN }} à la GitHub Action Claude Code, supprimez-le pour qu'il s'authentifie en tant que Claude GitHub App, ou passez un token d'app personnalisé à la place
• Vérifiez que les déclencheurs du workflow CI incluent les événements que les pushes de Claude produisent, comme push ou pull_request

Erreurs d'authentification

• Confirmez que la clé API ou le token OAuth est valide en le testant localement avec claude avant de déboguer le workflow
• Pour Bedrock, Agent Platform et Foundry, consultez la section dépannage de la page du fournisseur cloud

Pour plus de solutions, consultez la FAQ de la GitHub Action Claude Code.

Configuration avancée

Paramètres de l'action

Ce sont les entrées les plus couramment utilisées. Chacune correspond à une clé with: dans l'étape anthropics/claude-code-action.

Pour la liste complète des entrées, consultez la référence de configuration de la GitHub Action Claude Code.

Passer les arguments CLI

Le paramètre claude_args accepte n'importe quel argument CLI Claude Code :

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

Arguments courants :

• --max-turns : limiter le nombre de tours de conversation
• --model : modèle à utiliser, par exemple claude-sonnet-5. Sans cet argument, la GitHub Action Claude Code utilise le modèle par défaut de Claude Code
• --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

Mettre à niveau depuis la version bêta

Si vos workflows font toujours référence à anthropics/claude-code-action@beta, mettez-les à jour vers v1 :

1. Changez @beta en @v1 dans la ligne uses
2. Supprimez l'entrée mode, car la GitHub Action Claude Code détecte maintenant le mode automatiquement
3. Remplacez direct_prompt par prompt
4. Déplacez les options CLI telles que max_turns et model dans claude_args. custom_instructions n'a pas de flag de même nom et devient --append-system-prompt

Pour le mappage complet des entrées et les exemples avant et après, consultez le guide de migration.

Prochaines étapes

• Utiliser Claude Code GitHub Actions avec les fournisseurs cloud : acheminer l'inférence via Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry
• Référence de configuration : la liste complète des entrées de l'action
• Répertoire d'exemples : workflows prêts à l'emploi pour plus de scénarios
• Code Review : révision automatique des pull requests sans maintenir un fichier de workflow