Êtes-vous prêt à dynamiser votre flux de travail avec Claude Code et GitHub Actions ? Imaginez avoir un coéquipier IA qui examine les demandes d'extraction (pull requests), corrige les bogues, ou même écrit de nouvelles fonctionnalités directement dans votre dépôt GitHub. Ça ressemble à de la magie, n'est-ce pas ? Claude Code d'Anthropic rend cela possible en s'intégrant de manière transparente à GitHub Actions, automatisant les tâches avec une simple mention @claude. Je suis tombé sur ce joyau dans la documentation d'Anthropic et le dépôt GitHub, et c'est une révolution pour les développeurs. Dans ce tutoriel, je vous guiderai à travers la configuration de Claude Code dans GitHub Actions, la création d'un flux de travail pour examiner les PR, et l'exploration de ses pouvoirs. Plongeons-nous et rendons votre dépôt plus intelligent !
Pourquoi Claude Code et GitHub Actions sont-ils géniaux ?
Claude Code est l'outil de codage agentique d'Anthropic qui vit dans votre terminal ou IDE, comprenant votre base de code comme un pro. Lorsqu'il est associé à GitHub Actions, il devient un coéquipier virtuel qui automatise les revues de code, implémente des fonctionnalités et trie les problèmes directement dans votre dépôt. Il est en version bêta (en mai 2025), mais brille déjà pour des tâches telles que :
- Revues de code : analyse les PR pour les bogues, le style et les normes.
- Implémentation de fonctionnalités : transforme les descriptions de problèmes en code fonctionnel.
- Corrections de bogues : détecte et corrige les erreurs avec des PR prêtes à être fusionnées.
Le dépôt GitHub anthropics/claude-code-action met en évidence sa capacité à se déclencher sur les commentaires @claude, ce qui le rend interactif et convivial pour les développeurs. Configurons-le !
Configuration de Claude Code pour GitHub Actions
Avant d'automatiser votre dépôt, préparons votre environnement. C'est facile pour les débutants, et je vais faire vite !
1. Vérifiez les exigences :
- Dépôt GitHub : vous avez besoin d'un accès administrateur pour ajouter des secrets et des applications.
- Clé API Anthropic : procurez-vous-en une sur console.anthropic.com. Les comptes gratuits fonctionnent, mais les forfaits payants (Pro/Max) offrent plus d'utilisation.
- Système : n'importe quel système d'exploitation (macOS, Linux, Windows avec WSL2) avec Git et un terminal.
- Claude Code CLI (facultatif pour la configuration) : installez via
npm install -g @anthropic-ai/claude-code.
2. Installez l'application GitHub Claude :
- Ouvrez votre terminal et exécutez :
claude
/install-github-app
- Cela vous guide pour installer l'application GitHub Claude (github.com/apps/claude) dans votre dépôt. Suivez les invites pour sélectionner votre dépôt et autoriser les autorisations.
- Si vous rencontrez une erreur 404, actualisez votre jeton
gh:gh auth refresh -h github.com -s workflowet réessayez. - Remarque : ce démarrage rapide est destiné aux utilisateurs de l'API Anthropic. Pour AWS Bedrock ou Google Vertex AI, consultez la configuration manuelle dans la documentation d'Anthropic.
3. Ajoutez votre clé API :
- Après l'installation, la CLI crée une PR avec un fichier de flux de travail (
.github/workflows/claude.yml). Avant de fusionner, ajoutez votre clé API Anthropic en tant que secret GitHub : - Accédez à Settings > Secrets and variables > Actions de votre dépôt.
- Ajoutez un secret nommé
ANTHROPIC_API_KEYavec votre clé de la console d'Anthropic. - Fusionnez la PR pour activer le flux de travail.
J'ai configuré cela en 10 minutes sur un dépôt de test, super simple.
Remarque : Utilisez toujours les secrets GitHub pour les clés API !
Création d'un flux de travail Claude Code dans GitHub Actions
Maintenant, créons un flux de travail GitHub Actions pour que Claude Code examine automatiquement les PR. Nous utiliserons le anthropics/claude-code-action du dépôt GitHub.
1. Créez le fichier de flux de travail :
- Si le
/install-github-appne l'a pas créé, ajoutez manuellement.github/workflows/claude.ymldans votre dépôt :
name: Claude Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Run Claude Code Review
uses: anthropics/claude-code-action@beta
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
direct_prompt: |
Review the PR changes. Focus on code quality, potential bugs, and adherence to project standards. Suggest improvements and provide a detailed explanation.
- Cela déclenche Claude Code sur les PR nouvelles ou mises à jour, en examinant le code pour la qualité et les bogues.
2. Testez le flux de travail :
- Envoyez une modification vers une branche et ouvrez une PR. Claude Code s'exécutera, en publiant un commentaire avec son examen (par exemple, « A trouvé un pointeur nul potentiel dans
main.py. Envisagez d'ajouter une vérification… »). - J'ai testé cela sur un dépôt Python, et Claude a détecté un indice de type manquant, parfait !
3. Personnalisez le déclencheur :
- Vous voulez un contrôle manuel ? Modifiez le flux de travail pour qu'il se déclenche sur les commentaires :
on:
issue_comment:
types: [created]
jobs:
claude:
if: contains(github.event.comment.body, '@claude')
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: anthropics/claude-code-action@beta
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
- Maintenant, commentez
@claude review this PRpour le déclencher.
Utilisation de Claude Code pour des tâches avancées
Claude Code dans GitHub Actions ne sert pas seulement aux revues, il peut implémenter des fonctionnalités ou corriger des bogues. Voici comment passer au niveau supérieur :
1. Implémenter une fonctionnalité :
- Créez un problème : « Ajouter l'authentification utilisateur au point de terminaison de connexion. »
- Commentaire :
@claude implement this feature based on the issue description. - Claude analyse le problème, écrit du code et crée une PR. J'ai essayé cela pour une API REST, et cela a ajouté une configuration d'authentification JWT de base, impressionnant
2. Corriger un bogue :
- Dans un problème, décrivez le bogue : « TypeError dans
dashboard.js. » - Commentaire :
@claude fix the TypeError in the user dashboard component. - Claude localise le problème, envoie une correction et ouvre une PR.
3. Ajouter des normes de projet :
- Créez un fichier
CLAUDE.mddans la racine de votre dépôt pour définir les normes de codage (par exemple, « Utilisez PEP 8 pour Python »). Claude respecte ces directives lors des revues et des implémentations.
Exemple d'implémentation :
1. Tout d'abord, un utilisateur laisse un commentaire en taguant @Claude, lui demandant de répondre aux commentaires, ce qui déclenche la réponse automatisée de Claude via GitHub Actions.
2. Ensuite, Claude répond automatiquement au commentaire, effectue les actions demandées (par exemple, gestion des erreurs d'API, déduplication) et fournit une liste de contrôle des tâches accomplies.
3. Enfin, un réviseur (par exemple, un ingénieur frontend) approuve les modifications apportées par Claude, la demande d'extraction est fusionnée et fermée avec succès, indiquant que les modifications de Claude ont réussi la revue.
Explorer les fonctionnalités de GitHub Actions de Claude Code
Vous voulez pousser Claude Code plus loin ? Voici quelques astuces intéressantes :
- Analyse d'image : téléchargez une capture d'écran dans un commentaire (par exemple,
@claude fix this UI bug [screenshot]), et Claude l'analyse pour suggérer des corrections. Idéal pour les bogues visuels - Outils personnalisés : activez des outils comme
Bash(git:*),GlobTool, ou les serveurs MCP (Model Control Protocol) pour des tâches avancées (par exemple, l'extraction de données). Consultez le dépôt GitHub pour des exemples. - Exécuteurs plus rapides : utilisez les exécuteurs Depot (
runs-on: depot-ubuntu-latest) pour une exécution plus rapide et moins chère par rapport aux exécuteurs par défaut de GitHub. - Intégration SDK : créez des flux de travail personnalisés avec le SDK Claude Code pour des tâches au-delà de GitHub Actions.
J'ai expérimenté l'analyse d'image pour un bogue CSS, et Claude a réussi la correction, époustouflant !
En résumé : maîtrisez Claude Code avec GitHub Actions
Bravo ! Vous venez de déverrouiller Claude Code dans GitHub Actions pour automatiser les revues de code, implémenter des fonctionnalités et éliminer les bogues ! De l'installation de l'application GitHub à la création de flux de travail, vous êtes maintenant prêt à faire de votre dépôt une centrale de productivité. Essayez d'ajouter des outils MCP, de modifier CLAUDE.md ou de documenter vos API avec APIdog. Partagez vos victoires Claude Code sur X ou Reddit, je suis ravi de voir vos PR briller ! Bon codage !
