Claude Code et GitHub : Actions, revue de PR et intégration

Claude Code ne se limite pas à votre terminal ou votre éditeur : il peut aussi vivre directement dans vos issues et vos pull requests GitHub, répondre à une mention @claude, tourner dans vos workflows GitHub Actions, ou relire automatiquement chaque PR ouverte sur un dépôt. Trois mécanismes distincts couvrent ces usages, et il vaut mieux les distinguer avant de choisir lequel installer.

L’application GitHub officielle et les mentions @claude

La façon la plus rapide de connecter Claude Code à un dépôt est d’exécuter /install-github-app directement dans le terminal Claude Code. Cette commande installe l’application GitHub Claude sur le dépôt choisi, puis propose d’ajouter les workflows GitHub Actions et le secret de clé API. Il faut être administrateur du dépôt pour installer l’application et ajouter des secrets. L’app demande des permissions en lecture et écriture sur Contents, Issues et Pull requests.

Une fois installée, une simple mention @claude dans un commentaire d’issue ou de PR suffit à déclencher Claude : il peut analyser le code, créer des pull requests, implémenter des fonctionnalités ou corriger des bugs, en respectant les standards définis dans le CLAUDE.md du dépôt. Quelques exemples de commentaires qui fonctionnent :

@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

Si la commande /install-github-app échoue ou que vous préférez une configuration manuelle, il suffit d’installer l’app depuis github.com/apps/claude, d’ajouter ANTHROPIC_API_KEY dans les secrets du dépôt, puis de copier le fichier de workflow d’exemple dans .github/workflows/.

Claude Code GitHub Actions

Sous le capot, l’intégration repose sur l’action anthropics/claude-code-action, construite sur le Claude Agent SDK. Elle permet de faire tourner Claude Code dans n’importe quel workflow GitHub Actions, pas uniquement en réponse à une mention. Un workflow minimal ressemble à ceci :

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

L’action détecte automatiquement si elle doit répondre à une mention @claude ou s’exécuter immédiatement avec un prompt fourni. Le paramètre claude_args accepte n’importe quel argument CLI de Claude Code, ce qui permet par exemple de fixer un modèle ou un nombre maximal de tours :

claude_args: "--max-turns 5 --model claude-sonnet-5"

Ce mécanisme sert aussi bien à automatiser des tâches récurrentes, comme un résumé quotidien des commits sur un cron GitHub Actions, qu’à installer un skill packagé dans un plugin pour standardiser une revue de code sur chaque PR. Pour les organisations qui passent par Amazon Bedrock ou Google Cloud plutôt que par l’API Claude directe, l’action supporte aussi l’authentification via Workload Identity Federation, avec sa propre configuration détaillée dans la documentation officielle.

La revue de code automatique sur chaque PR

Distincte de l’action GitHub, la fonctionnalité Code Review est un service managé, disponible pour les abonnements Team et Enterprise (indisponible pour les organisations sous rétention zéro des données). Une fois activée par un administrateur pour un dépôt, elle analyse chaque pull request avec plusieurs agents spécialisés qui examinent les changements dans le contexte de toute la base de code, à la recherche d’erreurs de logique, de failles de sécurité et de régressions subtiles.

Pour chaque dépôt, un menu Review Behavior permet de choisir le déclencheur : une revue unique à l’ouverture de la PR, une revue à chaque push, ou un déclenchement manuel via un commentaire @claude review. Les résultats sont postés en commentaires inline sur les lignes concernées, classés par sévérité :

• Important (rouge) : un bug qui devrait être corrigé avant fusion.
• Nit (jaune) : un problème mineur, à corriger sans bloquer.
• Pré-existant (violet) : un bug déjà présent dans la base de code, non introduit par cette PR.

Les résultats n’approuvent ni ne bloquent jamais la PR : le check run associé se termine toujours en conclusion neutre pour ne jamais interférer avec vos règles de protection de branche. Deux fichiers permettent d’ajuster le comportement : CLAUDE.md, lu comme contexte général et dont les violations nouvellement introduites remontent en simple nit, et REVIEW.md, injecté comme instruction prioritaire dans chaque agent de revue pour recalibrer la sévérité, plafonner le nombre de nits ou exclure certains chemins. Chaque revue coûte en moyenne 15 à 25 dollars, facturés séparément de votre forfait via des crédits d’usage.

Pour relire un diff localement sans installer l’application GitHub, la commande /code-review dans une session Claude Code fait le même travail directement dans le terminal, avec les options --comment pour poster les résultats en commentaires de PR ou --fix pour appliquer les corrections trouvées.

Cas d’usage concrets

En pratique, ces trois mécanismes couvrent des besoins différents mais complémentaires :

• Corriger une issue en autonomie : assignez une issue ou mentionnez @claude implement this feature based on the issue description, et Claude propose une pull request complète à relire.
• Revue de pull request systématique : activez Code Review en mode « after every push » sur les dépôts sensibles, ou en mode manuel pour les dépôts à fort trafic où seules certaines PR méritent une revue approfondie.
• Automatisation CI personnalisée : utilisez l’action GitHub directement dans un workflow pour des tâches sur mesure, générer un rapport, vérifier une convention de nommage, ou exécuter un skill packagé sur chaque nouvelle PR.

Dans tous les cas, gardez un CLAUDE.md à jour à la racine du dépôt : il s’applique aussi bien aux sessions locales qu’aux exécutions GitHub Actions et à Code Review, ce qui évite de dupliquer vos conventions de code à trois endroits différents.

Pour une prise en main générale de l’outil avant de le connecter à GitHub, voir comment utiliser Claude Code. Si vous hésitez entre Claude Code et un autre assistant pour ce type de workflow, notre comparatif Claude Code ou Cursor, lequel choisir détaille les différences. Pour aller plus loin dans la personnalisation, notre guide sur les skills, agents et plugins montre comment packager une revue de code standardisée en plugin.