Claude Code GitHub Actions

• 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

• 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 du workflow pour vous
• Configuration manuelle : installez l’application, ajoutez le secret et copiez vous-même le fichier de workflow dans votre dépôt. Choisissez cette option si vous n’exécutez pas Claude Code en local, si la commande échoue ou si vous souhaitez garder un contrôle total sur les fichiers de workflow

​

Configuration rapide

• Si Claude Code dispose déjà d’une clé API, il réutilise cette clé et propose de conserver le secret ANTHROPIC_API_KEY existant du dépôt s’il est déjà défini
• Sinon, choisissez entre créer un jeton de longue durée avec votre abonnement Claude et coller une clé API

• Exécutez à nouveau /install-github-app. Lorsque le dépôt contient déjà un claude.yml, sélectionnez Update workflow file with latest version. Claude Code pousse de nouvelles copies des fichiers de workflow vers une nouvelle branche et ouvre la pull request, comme lors d’une première installation.
• Ajoutez vous-même l’argument --comment et la ligne claude_args de l’exemple de workflow de revue au fichier versionné, ce qui conserve toutes les autres modifications que vous y avez apportées.

​

Configuration manuelle

​

Configurer pour une organisation

• Installez une seule fois la Claude GitHub App au niveau de l’organisation, en choisissant tous les dépôts ou une liste sélectionnée
• Stockez le secret d’authentification en tant que secret Actions au niveau de l’organisation, afin que chaque dépôt n’ait pas besoin de sa propre copie
• Ajoutez le fichier de workflow à chaque dépôt qui doit exécuter la GitHub Action Claude Code, ou définissez le job une seule fois en tant que workflow réutilisable appelé par chaque dépôt

• anthropic_federation_rule_id : l’ID de la règle de fédération, fdrl_...
• anthropic_organization_id : l’ID de votre organisation Anthropic
• anthropic_service_account_id : l’ID du compte de service, svac_.... Facultatif, 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_.... Facultatif lorsque la règle de fédération cible un seul espace de travail

​

Désinstaller

• Fichiers de workflow : supprimez de .github/workflows/ les workflows qui utilisent anthropics/claude-code-action. Si vous avez utilisé la configuration rapide, recherchez claude.yml et, si vous avez sélectionné le workflow de revue, claude-code-review.yml. Une fois 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 dépôt, ainsi que des secrets Actions au niveau de l’organisation si vous l’avez partagé entre plusieurs dépôts. Si vous supprimez un secret, les identifiants 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 dépôt ou de votre organisation, sous GitHub Apps, mais uniquement si vous ne l’utilisez pas pour une autre fonctionnalité de Claude, comme Code Review ou la correction automatique sur le web

​

Permissions de la GitHub App

​

Modes interactif et automatisation

• 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

• 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

​

Répondre aux mentions @claude

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

• 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

@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

​

Exécuter une skill

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

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-plugins-official.git"
          plugins: "code-review@claude-plugins-official"
          prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"
          claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

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

​

Exécuter selon un calendrier

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-5-5
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

​

Bonnes pratiques

​

Définir les normes du projet dans CLAUDE.md

​

Protéger vos credentials

​

Gérer les coûts

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

• É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

​

Utiliser un fournisseur cloud

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

​

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

​

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

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

​

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