Claude Code GitHub Actions apporte l’automatisation de Claude Code directement dans votre workflow GitHub, avec une simple mention @claude dans une issue ou une pull request. L’installation se fait en une commande depuis le terminal, et l’assistant peut ensuite analyser du code, créer des pull requests, ou répondre à des questions directement dans GitHub.
Qu’est-ce que Claude Code GitHub Actions ?
Claude Code GitHub Actions est construit sur l’Agent SDK de Claude Code, ce qui permet de l’intégrer directement dans les workflows GitHub Actions de votre dépôt. Concrètement, l’intégration propose deux usages principaux : répondre à une mention @claude dans une issue ou une pull request, et publier automatiquement une revue sur chaque nouvelle pull request.
Dans les deux cas, Claude a accès à l’ensemble de votre codebase et respecte les conventions définies dans votre fichier CLAUDE.md, ce qui garantit une cohérence avec le travail effectué en local.
Comment installer Claude Code GitHub Actions ?
La méthode la plus simple consiste à lancer /install-github-app dans le terminal Claude Code. Cette commande installe l’application GitHub Claude sur votre dépôt, puis vous guide dans l’ajout des fichiers de workflow et de la clé API en secret de dépôt.
Vous devez être administrateur du dépôt pour installer l’application et ajouter des secrets. L’application GitHub demande des permissions de lecture et écriture sur le contenu, les issues et les pull requests.
Pour une installation manuelle, installez l’application GitHub Claude depuis github.com/apps/claude, ajoutez ANTHROPIC_API_KEY à vos secrets de dépôt, puis copiez le fichier de workflow d’exemple dans votre dossier .github/workflows/. Testez ensuite l’action en mentionnant @claude dans un commentaire d’issue ou de pull request.
Comment fonctionne la mention @claude ?
Une mention @claude dans un commentaire d’issue ou de pull request déclenche l’analyse de la demande par Claude, qui élabore un plan de tâche puis l’exécute avec un accès complet à votre codebase. Le résultat est ensuite publié directement dans l’issue ou la pull request concernée.
Cette mention peut servir aussi bien à poser une question sur l’architecture du projet qu’à demander l’implémentation d’une fonctionnalité, avec la création automatique d’une pull request contenant les modifications nécessaires.
Comment fonctionne la revue automatique de pull requests ?
Le second workflow généré déclenche une revue automatique à chaque ouverture ou mise à jour de pull request, sans nécessiter de mention explicite. Claude analyse les changements proposés, évalue leur impact, et publie un rapport détaillé directement sur la pull request.
Ce mode convient bien à une première passe de relecture systématique, avant l’intervention d’un relecteur humain sur les points plus subjectifs.
Comment authentifier Claude Code sans stocker de clé API ?
Pour éviter de stocker une clé API statique dans vos secrets, la fédération d’identité de charge de travail (Workload Identity Federation) permet d’échanger le jeton OIDC du workflow GitHub Actions contre un jeton d’accès Anthropic de courte durée. Cette configuration nécessite un accès administrateur à votre organisation Anthropic pour enregistrer GitHub Actions comme émetteur reconnu.
Les utilisateurs Pro ou Max peuvent aussi générer un jeton OAuth avec claude setup-token en local, comme alternative à la clé API classique pour l’authentification du workflow.
Comment personnaliser le workflow généré ?
Une fois la pull request initiale fusionnée, vous pouvez personnaliser les fichiers de workflow selon les besoins de votre projet. Ajoutez par exemple une étape de préparation d’environnement avant l’exécution de Claude, ou des instructions personnalisées précisant que le serveur de développement tourne déjà, ou comment interroger votre base de données.
Si votre workflow utilise des serveurs MCP comme Playwright, chaque outil doit être explicitement listé dans les permissions autorisées : contrairement à une session locale, GitHub Actions n’offre aucun raccourci pour autoriser un serveur MCP entier d’un coup.
Ce qu’il faut retenir sur Claude Code dans GitHub Actions
Claude Code GitHub Actions transforme l’assistant en un membre d’équipe automatisé, capable de répondre aux demandes formulées dans les issues et de relire chaque pull request sans intervention manuelle. Commencez par les workflows par défaut avant de personnaliser progressivement les permissions et les instructions selon les besoins réels de votre équipe.
Pour la documentation complète, y compris la configuration avec Amazon Bedrock, Google Cloud ou Microsoft Foundry, consultez la documentation officielle de Claude Code GitHub Actions.
Questions fréquentes
Lancez /install-github-app dans le terminal Claude Code. La commande installe l’application GitHub Claude sur votre dépôt et vous guide dans l’ajout des workflows et de la clé API en secret de dépôt.
Mentionnez @claude dans un commentaire d’issue ou de pull request pour une demande spécifique, ou laissez le workflow de revue automatique se déclencher à chaque ouverture ou mise à jour de pull request.
Pas nécessairement. La fédération d’identité de charge de travail permet d’échanger le jeton OIDC du workflow contre un accès temporaire, sans clé API statique à stocker en secret.
L’application demande des permissions de lecture et écriture sur le contenu du dépôt, les issues et les pull requests, ce qui lui permet de modifier des fichiers et de créer des pull requests.
