Claude Code dans GitHub Actions : installation, permissions et garde-fous

Faire tourner un agent de code sur son poste est une chose. Le brancher sur le dépôt de l'équipe en est une autre : il travaille alors sans surveillance directe, avec des droits d'écriture. La documentation d'Anthropic sur l'action claude-code-action permet de voir précisément ce que l'on installe.

Deux façons de l'installer

Rapide. Dans le dépôt, lancez claude puis la commande /install-github-app. Claude Code installe l'application GitHub, enregistre le secret d'authentification et prépare une pull request contenant les fichiers de workflow. Il faut être administrateur du dépôt et avoir la ligne de commande GitHub authentifiée (gh auth login). La commande ne fonctionne qu'avec github.com.

Manuelle. Trois étapes : installer l'application Claude sur le dépôt, ajouter un secret, copier le fichier examples/claude.yml du dépôt de l'action dans .github/workflows/.

Le secret s'appelle ANTHROPIC_API_KEY pour une clé d'API, ou CLAUDE_CODE_OAUTH_TOKEN pour un jeton lié à un abonnement, généré avec claude setup-token.

Le workflow minimal

name: Claude Code
on:
  issue_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 }}

Deux modes de fonctionnement

• Interactif : sans entrée prompt, Claude attend la mention @claude dans un commentaire d'issue ou de pull request, puis répond au même endroit.
• Automatique : avec une entrée prompt, il s'exécute à chaque événement choisi, y compris sur une planification. Par défaut, le résultat se lit dans le journal du workflow, pas dans un commentaire.

En mode automatique avec une consigne en texte libre, Claude n'a ni shell ni accès à l'API GitHub tant que vous ne les accordez pas, via --allowedTools dans claude_args.

Qui peut déclencher l'agent

Deux contrôles s'appliquent avant chaque exécution. L'utilisateur à l'origine de l'événement doit avoir un droit d'écriture sur le dépôt. Et les robots sont refusés, sauf ceux listés dans allowed_bots, pour éviter qu'un robot ne relance Claude en boucle.

Les permissions, point d'attention

L'action n'utilise que trois permissions de l'application : contenus, issues et pull requests, en lecture et écriture. Mais l'application Claude est partagée avec d'autres fonctions d'Anthropic, et GitHub ne permet pas d'en accepter une partie seulement. L'installer revient à accorder l'ensemble, dont l'écriture sur les workflows et les hooks du dépôt. Si votre politique interne l'interdit, la documentation indique la marche à suivre : créer sa propre application GitHub limitée aux trois permissions utiles.

Contenir la dépense

Chaque exécution consomme des minutes GitHub Actions et des jetons. Les leviers cités :

• fixer --max-turns dans claude_args pour limiter le nombre d'itérations ;
• poser un délai maximal au niveau du workflow ;
• limiter les exécutions parallèles avec les contrôles de concurrence de GitHub ;
• garder CLAUDE.md concis, puisqu'il est lu à chaque exécution ;
• rédiger des demandes précises et utiliser des modèles d'issue.

Limites à connaître

Sur un dépôt public, GitHub ne transmet pas les secrets aux exécutions déclenchées depuis un fork : la revue automatique ne tourne donc que sur les branches du dépôt lui-même. Pour un secret partagé entre plusieurs dépôts, Anthropic recommande une clé d'API plutôt qu'un jeton lié à l'abonnement d'une personne. La page ne donne aucun coût moyen par exécution.

Notre lecture

Pour une petite équipe, commencez par le mode interactif sur un seul dépôt : rien ne se passe tant que personne n'écrit @claude, et seuls les membres ayant un droit d'écriture peuvent le faire. Lisez la liste complète des permissions avant d'installer l'application, plafonnez les itérations dès le premier jour, et conservez la règle que la documentation rappelle elle-même : relire les modifications de Claude avant de fusionner.