GitHub Actions et revue de code
Le meilleur endroit pour déléguer le travail répétitif est la pull request. C'est là que la revue a lieu, que les modifications sont intégrées, et que se concentre une grande partie de vos tâches fastidieuses. Il existe deux façons de mettre Claude au travail ici, et elles résolvent des problèmes différents. L'une est un service géré que vous activez. L'autre est une GitHub Action que vous configurez vous-même. Parcourons les deux et déterminons quand recourir à chacune.
La voie gérée : revue de code
L'option la plus simple est la revue de code. Il s'agit d'un service hébergé par Anthropic qui examine vos pull requests via l'application GitHub de Claude. Vous n'avez rien à créer ni à héberger. Vous l'activez, et elle commence à publier des constats sous forme de commentaires en ligne, directement sur les lignes concernées.
Un Owner de votre organisation Claude l'active depuis les paramètres d'administration de Claude Code. Vous trouverez une section Code review avec un interrupteur Allow code review qui démarre la configuration.
À partir de là, l'Owner installe l'application GitHub de Claude, choisit les dépôts qu'elle surveille, et décide du moment où elle s'exécute. Si l'Owner n'est pas également propriétaire de l'organisation GitHub, quelqu'un doit d'abord installer et lier l'application. Vous avez plusieurs choix pour le déclenchement :
- Une fois, à l'ouverture d'une PR
- À chaque push sur la PR
- Uniquement lorsque quelqu'un commente
@claude review
Une fois activé, tout s'exécute sur l'infrastructure d'Anthropic. Un ensemble d'agents de revue analyse le diff par rapport à l'ensemble de votre base de code, et non seulement les lignes modifiées de manière isolée. Il publie ensuite des constats sous forme de commentaires en ligne sur les lignes spécifiques, étiquetés par gravité, avec un tableau récapitulatif dans le check run.
Chaque constat arrive sous forme de commentaire de Claude, directement sur la ligne, avec une explication claire et un correctif suggéré.
Le point positif, c'est que le service déduplique et classe les constats. Ainsi, au lieu d'un mur de remarques mineures, vous lisez une poignée de problèmes réels qui méritent votre attention.
Ce que la revue de code fera et ne fera pas
Quelques points à garder à l'esprit concernant les limites de ce service :
- Elle n'approuve ni ne bloque jamais la PR. La décision finale reste entre les mains d'un humain. Claude signale les problèmes ; vous décidez.
- Elle ne pousse pas de correctifs. Le service se contente de publier des constats.
- Elle est disponible avec les forfaits Team Plan et Enterprise Plan.
Comme le service se contente de publier des constats, c'est à vous d'agir : corrigez le code et poussez-le. Pour vérifier votre correctif avant de le pousser, exécutez /code-review depuis votre propre terminal. Elle effectue sa propre revue de votre diff, et son option --fix applique les constats de cette revue à votre arborescence de travail.
La voie bricolage : la GitHub Action
La revue de code s'occupe de la revue. Lorsque la tâche va au-delà de la revue, vous vous tournez vers la GitHub Action. Celle-ci est destinée à une CI personnalisée : mettre en œuvre des modifications à partir d'un commentaire, exécuter des rapports planifiés, tout ce pour quoi vous écririez normalement un workflow. Elle exécute l'agent sur les commentaires de PR, les tâches planifiées, et tout événement GitHub.
La configuration démarre dans Claude Code. Exécutez la commande /install-github-app. Vous aurez besoin des droits d'administration du dépôt pour cela. La commande slash vous guide dans l'installation de l'application GitHub et la définition du secret de clé API Anthropic sur le dépôt.
L'action elle-même est anthropics/claude-code-action@v1. Voici les entrées que vous utiliserez réellement :
anthropic_api_key— requis lorsque l'exécution appelle l'API Claude, sauf si vous vous authentifiez avecclaude_code_oauth_token(issu d'un abonnement Claude) ou avec la fédération d'identité de charge de travail (configurée via un compte de service Claude Console, donc sans secret stocké). Non utilisé avec les fournisseurs cloud ci-dessous.github_token— facultatif. Omettez-le et l'action s'authentifie en tant qu'application GitHub de Claude que vous avez installée lors de la configuration. Ne transmettez un jeton que pour remplacer ce comportement.trigger_phrase— ce que l'action écoute dans les commentaires. La valeur par défaut est@claude.use_bedrock/use_vertex/use_foundry— achemine l'exécution via Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry au lieu de l'API Claude, en vous connectant avec votre compte cloud plutôt qu'avec une clé API.prompt— l'instruction pour une exécution automatisée. Définissez-la et Claude s'exécute sur l'événement sans attendre une mention. Omettez-la et l'action attend la phrase de déclenchement.claude_args— une chaîne d'arguments CLI transmise directement à Claude Code.
Un workflow qui répond à @claude
Déposez un workflow dans .github/workflows/claude.yaml et il écoute @claude dans les commentaires de PR et d'issues. Voici le fichier complet. La permission id-token: write permet à l'action de se connecter en tant qu'application GitHub de 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 }}
claude_args: "--max-turns 5 --model claude-sonnet-5"Maintenant, quelqu'un écrit @claude implement the spec in the linked Linear issue sur une pull request, et l'action le prend en charge. Claude pousse des commits et publie des commentaires décrivant ce qu'il a fait.
Un workflow qui s'exécute selon une planification
La même action fonctionne pour un récapitulatif quotidien. Un déclencheur cron se déclenche par exemple à 9h00 UTC, l'action exécute votre prompt, et vous lisez le récapitulatif dans le journal de cette exécution. Une exécution planifiée ne publie pas de commentaire d'elle-même. Vous pouvez aussi ajouter un déclencheur workflow_dispatch afin de pouvoir la lancer manuellement depuis l'onglet Actions :
name: Daily report
on:
schedule:
- cron: "0 9 * * *"
workflow_dispatch:
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: |
--allowedTools "mcp__github__list_commits,mcp__github__list_issues"Lorsque l'action s'exécute, vous pouvez la regarder parcourir les étapes dans l'onglet Actions, comme pour tout autre workflow GitHub.
Ajuster l'exécution avec claude_args
La ligne claude_args est l'endroit où s'effectue le réglage fin. Quelques réglages à connaître :
--max-turns 5impose une limite stricte à la boucle de l'agent, afin qu'elle ne puisse pas s'exécuter indéfiniment.- Le mode de permission. Pour une tâche non supervisée, vous voudrez qu'elle ne s'arrête pas pour demander, puisqu'il n'y a personne pour répondre.
- Les outils autorisés. Donnez à la tâche exactement ce dont elle a besoin, et rien de plus. Pour un rapport, cela signifie un accès en lecture seule.
Lequel devez-vous utiliser ?
Voici la version courte :
- Pour les revues de PR, optez pour la voie gérée. Activez la revue de code, laissez l'application GitHub publier les constats en ligne, puis corrigez le code et poussez.
- Tournez-vous vers l'action lorsque la tâche va au-delà de la revue. Utilisez
/install-github-apppour la configuration, un workflow pour les mentions@claude, un autre pour le cron, et tout l'ajustement se trouve dansclaude_args.
Commencez par le service géré. Passez à l'action dès que vous avez besoin que Claude fasse réellement quelque chose en CI, et pas seulement qu'il commente dessus.