Skip to main content
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. Pour arrêter la configuration à mi-chemin, appuyez sur Échap. Une étape déjà en cours se termine et aucune étape ultérieure ne démarre. Le message de fermeture énumère ce qui s’est déjà passé dans le repository, comme une branche poussée ou un secret enregistré. 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.

​
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 :
1

Installer la Claude GitHub App

Installez la Claude GitHub App sur votre repository. La GitHub Action Claude Code s’appuie sur trois des permissions de l’app :
  • Contents : lecture et écriture, pour que Claude puisse modifier les fichiers du repository
  • Issues : lecture et écriture, pour que Claude puisse répondre aux issues
  • Pull requests : lecture et écriture, pour que Claude puisse créer des PRs et pousser des modifications
Lors de l’installation, vous accordez également des permissions que d’autres fonctionnalités Claude utilisent. Consultez Permissions de la GitHub App pour l’ensemble complet.
2

Ajouter un secret d'authentification

Ajoutez l’un des secrets suivants à votre repository, selon votre mode d’authentification. Consultez le guide de GitHub sur l’utilisation des secrets dans GitHub Actions.
  • ANTHROPIC_API_KEY : une clé API Claude de la Claude Console
  • CLAUDE_CODE_OAUTH_TOKEN : un token OAuth qui s’authentifie avec votre abonnement Claude, disponible sur les plans Pro, Max, Team et Enterprise. Générez-en un en exécutant claude setup-token localement. Consultez Générer un token de longue durée
Dans les fichiers de workflow, passez le secret à l’entrée correspondante : anthropic_api_key pour une clé API, ou claude_code_oauth_token pour un token OAuth.
3

Copier le fichier de workflow

Copiez examples/claude.yml dans le répertoire .github/workflows/ de votre repository. Le fichier est un workflow fonctionnel, pas seulement un exemple. Tel qu’enregistré, Claude répond chaque fois que quelqu’un mentionne @claude dans une issue ou une pull request, en s’authentifiant avec le secret ANTHROPIC_API_KEY. Si vous avez ajouté CLAUDE_CODE_OAUTH_TOKEN à la place, changez la ligne anthropic_api_key du workflow en claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}.
Après la configuration, testez la GitHub Action Claude Code en marquant @claude dans un commentaire d’issue ou de PR.

​
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.