Claude Code · 11 min · 2026-11-11 · Par Équipe MaitriseLIA

Comment installer Claude Code GitHub Actions ? @claude, revue de PR, coûts et 6 pièges

Claude Code GitHub Actions fait tourner Claude Code dans vos workflows GitHub : une mention @claude dans une issue ou une PR suffit pour qu’il analyse, corrige et pousse des commits. Installation en une commande ou à la main, choix entre clé d’API, abonnement et OIDC, coût réel des minutes et des jetons, et les six pièges documentés qui font perdre une demi-journée.

Ordinateur portable ouvert sur du code : Claude Code exécuté dans les workflows GitHub Actions
Crédit photo : Unsplash

*Publié le 11 novembre 2026 · Mis à jour le 11 novembre 2026*

Pour installer Claude Code GitHub Actions, ouvrez claude dans votre dépôt et tapez /install-github-app : Claude Code installe l’application GitHub Claude, enregistre un secret d’authentification et prépare une pull request avec le fichier de workflow. Une fois cette PR fusionnée, il suffit d’écrire @claude dans un commentaire d’issue ou de pull request pour que Claude analyse le code, propose des modifications et pousse des commits. Il vous faut un accès administrateur au dépôt.

Claude Code GitHub Actions, c’est l’action officielle anthropics/claude-code-action : elle fait tourner Claude Code sur les runners de GitHub, soit à la demande (une mention), soit automatiquement (un événement ou un horaire). Le dépôt de l’action, sous licence MIT, compte environ 9 880 étoiles au 11 novembre 2026 et sa version v1 est publiée depuis le 26 août 2025. Chaque exécution coûte deux choses : des minutes GitHub Actions (0,006 $ la minute sur un runner Linux 2 cœurs, selon la grille GitHub 2026) et des jetons Claude, sauf si vous passez par votre abonnement.

L’essentiel en une minute

  • Installer : /install-github-app depuis Claude Code, ou installation manuelle (application GitHub + secret + fichier claude.yml).
  • Utiliser : @claude dans une issue ou une PR (mode interactif), ou un prompt fixe déclenché par un événement GitHub (mode automatisation).
  • S’authentifier : clé d’API (ANTHROPIC_API_KEY), jeton d’abonnement (CLAUDE_CODE_OAUTH_TOKEN) ou fédération d’identité sans secret stocké.
  • Payer : minutes GitHub sur les dépôts privés au-delà du quota inclus, plus les jetons Claude (ou votre forfait).
  • Se méfier : six pièges documentés, du CI qui ne se relance pas aux PR de forks privées de secrets.

Comment installer Claude Code GitHub Actions en une commande ?

La documentation officielle de Claude Code (2026) décrit deux chemins. Le chemin rapide passe par /install-github-app, qui ne fonctionne qu’avec les dépôts hébergés sur github.com : sur GitLab ou Bitbucket, la commande affiche un avertissement et s’arrête.

Avant de lancer la commande, installez la GitHub CLI et connectez-la avec gh auth login ; Claude Code vérifie sa présence. Ensuite :

  1. Ouvrez claude à la racine du dépôt à connecter.
  2. Tapez /install-github-app et suivez les étapes : Claude Code installe l’application GitHub Claude.
  3. Choisissez l’authentification : si Claude Code a déjà une clé d’API, il la réutilise ; sinon vous créez un jeton longue durée lié à votre abonnement, ou vous collez une clé d’API.
  4. Claude Code enregistre ce secret dans le dépôt, pousse une branche avec les workflows choisis et ouvre GitHub sur une pull request prête à créer.
  5. Créez et fusionnez cette PR : @claude fonctionne dans le dépôt.

Vous pouvez interrompre l’installation avec Échap : l’étape en cours se termine, aucune suivante ne démarre, et le message final liste ce qui a déjà été fait (branche poussée, secret enregistré). Si vous cochez aussi le workflow de revue, Claude publie ses revues directement sur la PR, en commentaires sur les lignes concernées ou en un commentaire de synthèse quand il ne trouve rien.

Comment faire l’installation manuelle, sans /install-github-app ?

Le chemin manuel sert quand vous n’utilisez pas Claude Code en local, quand la commande échoue, ou quand vous voulez garder la main sur les fichiers :

  1. Installez l’application Claude depuis github.com/apps/claude sur le dépôt.
  2. Ajoutez un secret de dépôt : ANTHROPIC_API_KEY (clé créée dans la Claude Console) ou CLAUDE_CODE_OAUTH_TOKEN (jeton généré en local avec claude setup-token, disponible sur les forfaits Pro, Max, Ultra, Team et Enterprise).
  3. Copiez le fichier examples/claude.yml du dépôt de l’action dans .github/workflows/. Il fonctionne tel quel : Claude répond à toute mention @claude.

Voici ce que contient le workflow minimal de la documentation, ligne par ligne :

Ligne du workflowValeurÀ quoi elle sert
onissue_comment et pull_request_review_comment, type createdDéclencher sur les nouveaux commentaires
ifcontains(github.event.comment.body, '@claude')Ne pas démarrer de runner pour les commentaires sans mention
permissionscontents, pull-requests et issues en write ; id-token en write ; actions en readModifier le code et commenter ; s’authentifier via l’application GitHub ; lire les résultats du CI
usesactions/checkout@v6 puis anthropics/claude-code-action@v1Donner à Claude une copie du dépôt, puis lancer Claude Code
withanthropic_api_key avec le secret ANTHROPIC_API_KEYAuthentifier les appels à Claude

Si vous utilisez un jeton d’abonnement, remplacez la ligne anthropic_api_key par claude_code_oauth_token, qui pointe vers le secret CLAUDE_CODE_OAUTH_TOKEN. Avant de toucher au workflow, écrivez un fichier CLAUDE.md à la racine du dépôt : Claude le lit à chaque exécution, c’est là que vivent vos règles de style et vos critères de revue (voir notre guide du fichier CLAUDE.md).

Quelle authentification choisir : clé d’API, abonnement ou OIDC ?

C’est la première décision, et elle conditionne la facture. Notre grille, construite à partir de la documentation :

SituationAuthentification conseilléePourquoi
Indépendant, un ou deux dépôtsCLAUDE_CODE_OAUTH_TOKEN (claude setup-token)Les exécutions consomment votre forfait au lieu d’une facturation à l’usage
Équipe, plusieurs dépôtsANTHROPIC_API_KEY en secret d’organisationUn jeton OAuth est lié à l’abonnement de la personne qui l’a généré
Entreprise avec revue sécuritéFédération d’identité (OIDC) via un compte de service de la Claude ConsoleAucun secret longue durée stocké dans GitHub
Données qui doivent rester chez votre clouduse_bedrock, use_vertex ou use_foundryLes appels passent par Amazon Bedrock, Google Cloud ou Microsoft Foundry, authentifiés par OIDC

Le cas de l’équipe est le plus souvent mal réglé : un jeton d’abonnement partagé dans toute l’organisation continue de dépendre du compte d’une seule personne. Si elle quitte l’entreprise ou change de forfait, tous les workflows tombent.

Que fait @claude, et quelle différence avec le mode automatisation ?

L’action choisit son mode toute seule, selon la configuration :

  • Mode interactif : sans paramètre prompt, Claude attend la phrase de déclenchement (@claude par défaut) dans un commentaire, une revue de PR, ou le titre et le corps d’une nouvelle issue. Il répond dans un commentaire qu’il met à jour au fil du travail.
  • Mode automatisation : avec un paramètre prompt, Claude s’exécute sans attendre de mention, sur n’importe quel événement GitHub, y compris un horaire cron. Par défaut, le résultat va dans le journal de l’exécution, pas dans un commentaire.

Exemples de demandes que la documentation donne pour le mode interactif : implémenter une fonctionnalité à partir de la description d’une issue, conseiller une approche d’authentification pour un endpoint, ou corriger une TypeError dans un composant. Le paramètre prompt accepte aussi l’appel d’un skill, par exemple /nom-du-skill pour un skill rangé dans .claude/skills/ (pensez alors à l’étape checkout), ou un skill de plugin installé via plugin_marketplaces et plugins.

Pour les tâches récurrentes, le mode automatisation recoupe les routines de Claude Code : nous comparons les deux approches dans notre guide des tâches planifiées et routines.

Combien coûte Claude Code GitHub Actions ?

Deux compteurs tournent à chaque exécution. Les chiffres ci-dessous viennent des grilles officielles de GitHub et d’Anthropic consultées le 11 novembre 2026.

PosteTarif officiel 2026Ce qu’il faut savoir
Runner GitHub sur dépôt publicGratuitLes runners standard hébergés par GitHub sont gratuits sur les dépôts publics
Runner Linux 2 cœurs, dépôt privé0,006 $ la minuteAu-delà de l’enveloppe incluse : 12 $ par mois sur GitHub Free, 18 $ sur Pro et Team, 300 $ sur Enterprise Cloud
Jetons Claude Sonnet 52 $ par million de jetons en entrée, 10 $ en sortieTarif devenu standard, la hausse prévue au 1er septembre 2026 n’a pas eu lieu
Jetons Claude Opus 5.54 $ par million en entrée, 20 $ en sortieLe modèle se choisit avec --model dans claude_args
Jeton d’abonnementInclus dans votre forfaitLes exécutions consomment votre abonnement au lieu de la facturation API

Sur GitHub Free, l’enveloppe de 12 $ représente environ 2 000 minutes de runner Linux 2 cœurs (12 divisé par 0,006, notre calcul). Pour fixer les idées, prenons un exemple théorique, pas une mesure : une revue qui lit 200 000 jetons et en écrit 10 000 avec Sonnet 5 coûte 0,40 $ en entrée et 0,10 $ en sortie, soit 0,50 $ de jetons, plus 0,03 $ de runner si elle dure 5 minutes sur un dépôt privé hors quota. À ce rythme, ce sont les jetons, pas les minutes, qui font la facture. Pour situer le prix et la qualité des modèles avant de figer le --model, un comparateur comme IA Cockpit permet de lancer le même prompt sur plusieurs modèles côte à côte.

La documentation donne les leviers pour contenir les deux postes : des demandes @claude précises, des modèles d’issue qui donnent le contexte d’emblée, un CLAUDE.md court (il est relu à chaque exécution), --max-turns dans claude_args pour plafonner les itérations, un timeout au niveau du workflow, et les contrôles de concurrence de GitHub pour limiter les exécutions parallèles.

Quels sont les 6 pièges à éviter avec Claude Code GitHub Actions ?

Ce sont les cas qui font perdre une demi-journée, tous documentés par Anthropic ou GitHub :

  1. Le CI ne se relance pas sur les commits de Claude. GitHub ne déclenche pas de workflow sur les commits faits avec le GITHUB_TOKEN par défaut. Si vous passez github_token avec ce jeton, retirez-le pour que l’action s’authentifie comme l’application Claude, ou fournissez le jeton d’une application personnalisée.
  2. Claude ne répond pas à @claude. Vérifiez l’application installée, les workflows activés, le secret présent, et que la mention est un mot entier : /claude ou @claude-bot ne déclenchent rien.
  3. Un utilisateur sans droit d’écriture est refusé. Sur les événements d’issue et de PR, l’auteur doit avoir l’accès en écriture. Pour des exceptions, il faut allowed_non_write_users et votre propre github_token.
  4. Un bot ne peut pas déclencher Claude. Les acteurs bots sont rejetés sauf s’ils figurent dans allowed_bots, pour éviter les boucles. Cela vaut aussi pour un cron attribué à un bot.
  5. Les PR venant de forks ne sont pas revues. Sur un dépôt public, GitHub retient les secrets pour les exécutions déclenchées par une PR de fork : la revue ne tourne que sur les branches du dépôt lui-même.
  6. Le cron s’arrête tout seul. GitHub n’exécute les workflows planifiés que depuis la branche par défaut et, sur un dépôt public, les désactive après 60 jours sans activité.

Un septième point relève de la sécurité plutôt que de la panne : l’application GitHub Claude, partagée par toutes les fonctionnalités Claude liées à GitHub, demande 14 permissions à l’installation, alors que l’action n’en utilise que 3 (Contents, Issues et Pull requests, en lecture et écriture). GitHub ne permet pas d’accepter une partie seulement. Si votre organisation l’exige, créez une application GitHub personnalisée limitée à ces trois droits ; la revue automatique Code Review exige en revanche l’application officielle. Pour le reste de la configuration des droits, voir notre guide des permissions Claude Code.

Comment passer de la version beta à la v1 ?

Si vos workflows référencent encore anthropics/claude-code-action@beta, la documentation liste quatre changements :

Avant (beta)Après (v1)
uses: anthropics/claude-code-action@betauses: anthropics/claude-code-action@v1
Paramètre modeSupprimé, le mode est détecté automatiquement
direct_promptprompt
max_turns, model en paramètres--max-turns, --model dans claude_args
custom_instructions--append-system-prompt dans claude_args

Le paramètre claude_args accepte n’importe quel argument de la ligne de commande de Claude Code : --max-turns, --model, --mcp-config, --allowedTools ou --debug. En mode automatisation avec un prompt en texte libre, Claude n’a accès ni au shell ni à l’API GitHub tant que vous ne lui accordez pas les outils nécessaires via --allowedTools ou une règle permissions.allow passée dans le paramètre settings.

En résumé

QuestionRéponse
Comment installer ?/install-github-app dans Claude Code, ou application GitHub + secret + claude.yml à la main
Prérequis ?Accès administrateur au dépôt, dépôt sur github.com, GitHub CLI connectée pour le chemin rapide
Comment déclencher ?@claude dans une issue ou une PR, ou un prompt sur un événement GitHub
Quelle authentification ?Jeton d’abonnement en solo, clé d’API en équipe, OIDC en entreprise
Combien ça coûte ?0,006 $ la minute de runner Linux en privé hors quota, plus les jetons (Sonnet 5 : 2 $ et 10 $ le million)
Le piège le plus courant ?Le GITHUB_TOKEN par défaut, qui empêche le CI de tourner sur les commits de Claude

Vous voulez apprendre à brancher Claude Code sur vos outils, du terminal à la CI, avec méthode ? Commencer la formation →

FAQ

Comment installer Claude Code GitHub Actions ?

Ouvrez claude dans le dépôt et tapez /install-github-app. La commande installe l’application GitHub Claude, enregistre un secret d’authentification et ouvre une pull request avec le workflow ; fusionnez-la et @claude fonctionne. Il faut un accès administrateur, un dépôt sur github.com et la GitHub CLI connectée. Sinon, installez l’application, ajoutez le secret et copiez examples/claude.yml à la main.

Peut-on utiliser Claude Code GitHub Actions avec un abonnement Claude plutôt qu’une clé d’API ?

Oui. Générez un jeton avec claude setup-token, sur un forfait Pro, Max, Ultra, Team ou Enterprise, puis enregistrez-le dans le secret CLAUDE_CODE_OAUTH_TOKEN et passez-le au paramètre claude_code_oauth_token. Les exécutions consomment alors votre abonnement au lieu de la facturation API. Pour un secret partagé par toute une organisation, la documentation recommande plutôt une clé d’API.

Combien coûte une exécution de Claude Code dans GitHub Actions ?

Deux postes s’additionnent : les minutes de runner, gratuites sur un dépôt public et facturées 0,006 dollar la minute en Linux 2 cœurs sur un dépôt privé au-delà du quota inclus, et les jetons Claude, par exemple 2 dollars par million en entrée et 10 dollars en sortie avec Sonnet 5. Avec un jeton d’abonnement, les jetons sont pris sur votre forfait.

Pourquoi Claude ne répond-il pas quand j’écris @claude ?

Vérifiez dans l’ordre : l’application GitHub Claude est installée sur le dépôt, les workflows sont activés, le secret ANTHROPIC_API_KEY ou CLAUDE_CODE_OAUTH_TOKEN existe, la mention est le mot entier @claude, et l’auteur du commentaire a l’accès en écriture au dépôt. Les bots sont aussi rejetés sauf s’ils figurent dans allowed_bots.

Pourquoi mon CI ne se lance-t-il pas sur les commits de Claude ?

Parce que GitHub ne déclenche aucun workflow sur les commits faits avec le GITHUB_TOKEN par défaut. Si votre workflow passe github_token avec ce jeton, retirez cette ligne pour que l’action s’authentifie comme l’application GitHub Claude, ou utilisez le jeton d’une application personnalisée. Vérifiez aussi que votre CI écoute bien les événements push ou pull_request.

Sources

  1. Claude Code, documentation GitHub Actions
  2. anthropics/claude-code-action, dépôt GitHub officiel (licence MIT)
  3. GitHub Docs, facturation de GitHub Actions
  4. Anthropic, tarifs de l’API Claude
  5. anthropics/claude-code-action, guide de migration beta vers v1
  6. MaitriseLIA, sécuriser Claude Code avec les permissions

À propos de l'auteur

Équipe MaitriseLIA

Experts en formation Claude Code, Anthropic API et outils d'IA professionnels. Nos contenus sont rédigés par des spécialistes qui utilisent Claude Code et les MCPs au quotidien pour automatiser leurs business.