Code Review analyse vos demandes de tirage GitHub et publie les résultats sous forme de commentaires en ligne sur les lignes de code où il a trouvé des problèmes. Une flotte d'agents spécialisés examine les modifications de code dans le contexte de votre base de code complète, en recherchant les erreurs de logique, les vulnérabilités de sécurité, les cas limites cassés et les régressions.
Cet article explique comment activer Code Review, configurer les déclencheurs d'examen, personnaliser ce qui est signalé et résoudre les problèmes de configuration courants.
Remarque : Code Review est disponible sur les plans Team et Enterprise. Il n'est pas disponible pour les organisations avec la rétention de données zéro activée. L'utilisation de Code Review est facturée séparément via des crédits d'utilisation et ne compte pas par rapport à l'utilisation incluse de votre plan.
Fonctionnement de Code Review
Une fois qu'une organisation active Code Review, il peut se déclencher automatiquement à l'ouverture d'une demande de tirage, à chaque envoi, ou uniquement lorsque quelqu'un demande manuellement un examen. Lorsqu'un examen s'exécute, plusieurs agents analysent le diff et le code environnant en parallèle. Chaque agent recherche une classe de problème différente, puis une étape de vérification vérifie les résultats par rapport au comportement réel du code pour filtrer les faux positifs.
Les résultats sont dédupliqués, classés par gravité et publiés sous forme de commentaires en ligne sur les lignes spécifiques où les problèmes ont été trouvés. Si aucun problème n'est trouvé, Claude publie un court commentaire de confirmation sur la PR. Les examens n'approuvent ni ne bloquent votre PR, donc les flux de travail d'examen existants restent intacts.
Les examens évoluent en coût selon la taille et la complexité de la PR, se complétant en moyenne en 20 minutes.
Niveaux de gravité
Chaque résultat est marqué avec un niveau de gravité :
Marqueur | Gravité | Signification |
🔴 | Normal | Un bug qui doit être corrigé avant la fusion |
🟡 | Détail | Un problème mineur, utile à corriger mais non bloquant |
🟣 | Préexistant | Un bug qui existe dans la base de code mais n'a pas été introduit par cette PR |
Les résultats incluent une section de raisonnement étendu réductible que vous pouvez développer pour voir pourquoi Claude a signalé le problème et comment il a vérifié le problème.
Ce que Code Review vérifie
Par défaut, Code Review se concentre sur la correction : les bugs qui casseraient la production, pas les préférences de formatage ou la couverture de test manquante. Vous pouvez élargir ce qu'il vérifie en ajoutant des fichiers de guidance à votre référentiel.
Configurer Code Review
Les étapes ci-dessous couvrent la configuration des référentiels sur github.com. Si vos référentiels se trouvent sur une instance GitHub Enterprise Server (GHES) auto-hébergée, consultez Claude Code avec GitHub Enterprise Server pour le guide de configuration complet.
Les propriétaires et propriétaires principaux des plans Team et Enterprise peuvent activer Code Review une fois pour l'organisation et sélectionner les référentiels à inclure. En plus d'un rôle de propriétaire au sein de votre organisation Claude, vous aurez besoin d'une autorisation pour installer des applications GitHub dans votre organisation GitHub.
Accédez à Paramètres de l'organisation > Claude Code et trouvez la section Code Review.
Cliquez sur « Configurer » pour commencer le flux d'installation de l'application GitHub.
Suivez les invites pour installer l'application Claude GitHub dans votre organisation GitHub. L'application demande des autorisations de lecture et d'écriture pour les contenus, les problèmes et les demandes de tirage.
Choisissez les référentiels à activer pour Code Review. Si vous ne voyez pas un référentiel, confirmez que vous avez donné à l'application Claude GitHub l'accès à celui-ci lors de l'installation.
Définissez un déclencheur d'examen pour chaque référentiel à l'aide de la liste déroulante Comportement d'examen (consultez la section suivante pour plus de détails sur chaque option).
Pour vérifier la configuration, ouvrez une PR de test. Si vous avez choisi un déclencheur automatique, une exécution de vérification nommée Claude Code Review devrait apparaître dans quelques minutes. Si vous avez choisi Manuel, commentez « @claude review » sur la PR pour démarrer le premier examen.
Choisir un déclencheur d'examen
Après la configuration, la section Code Review affiche vos référentiels dans un tableau. Pour chaque référentiel, choisissez quand les examens s'exécutent :
Une fois après la création de la PR : L'examen s'exécute une fois lorsqu'une PR est ouverte ou marquée comme prête pour examen.
Après chaque envoi : L'examen s'exécute à chaque envoi vers la branche PR, détectant les nouveaux problèmes à mesure que la PR évolue. Claude résout automatiquement les threads lorsque vous corrigez les problèmes précédemment signalés. Cela exécute le plus d'examens et coûte le plus cher.
Manuel : Les examens commencent uniquement lorsque quelqu'un commente « @claude review » sur une PR. Utile pour les référentiels à fort trafic où vous souhaitez sélectionner les PR à examiner.
Le tableau des référentiels affiche également le coût moyen par examen pour chaque référentiel en fonction de l'activité récente.
Déclencher manuellement les examens
Commentez « @claude review » sur une demande de tirage pour démarrer un examen et accepter cette PR dans les examens déclenchés par push à l'avenir. Cela fonctionne quel que soit le déclencheur configuré du référentiel.
Pour que le commentaire déclenche un examen :
Publiez-le en tant que commentaire PR de haut niveau, pas un commentaire en ligne sur une ligne de diff.
Mettez « @claude review » au début du commentaire.
Vous devez avoir un accès propriétaire, membre ou collaborateur au référentiel.
La PR doit être ouverte et ne pas être un brouillon.
Si un examen est déjà en cours, la demande est mise en file d'attente jusqu'à ce que l'examen en cours se termine.
Personnaliser les examens
Code Review lit deux fichiers de votre référentiel pour guider ce qu'il signale. Les deux s'ajoutent aux vérifications de correction par défaut.
CLAUDE.md
Code Review lit vos fichiers CLAUDE.md du référentiel et traite les violations nouvellement introduites comme des remarques de niveau mineur. Si votre PR modifie le code d'une manière qui rend une déclaration CLAUDE.md obsolète, Claude signale que la documentation doit également être mise à jour.
Claude lit les fichiers CLAUDE.md à chaque niveau de votre hiérarchie de répertoires, donc les règles du CLAUDE.md d'un sous-répertoire s'appliquent uniquement aux fichiers situés sous ce chemin.
REVIEW.md
Ajoutez un fichier REVIEW.md à la racine de votre référentiel pour les règles spécifiques aux révisions. Utilisez-le pour encoder :
Directives de style de l'entreprise ou de l'équipe
Conventions spécifiques au langage ou au framework non couvertes par les linters
Éléments que Claude doit toujours signaler (par exemple, « toute nouvelle route API doit avoir un test d'intégration »)
Éléments que Claude doit ignorer (par exemple, « ne pas commenter le code généré »)
Claude découvre automatiquement REVIEW.md à la racine du référentiel. Aucune configuration n'est nécessaire.
Tarification et utilisation
Code Review est facturé en fonction de l'utilisation des tokens. Chaque révision coûte en moyenne 15 à 25 $ et s'adapte à la taille de la PR, à la complexité de la base de code et au nombre de problèmes nécessitant une vérification.
L'utilisation de Code Review est facturée séparément via des crédits d'utilisation et ne compte pas par rapport à l'utilisation incluse dans votre plan. Le déclencheur de révision que vous choisissez affecte le coût total :
Une fois après la création de la PR s'exécute une fois par PR.
Après chaque push s'exécute à chaque push, multipliant le coût par le nombre de pushes.
Manuel n'entraîne aucun coût jusqu'à ce que quelqu'un commente « @claude review ». Après ce commentaire, les pushes supplémentaires vers la PR déclenchent automatiquement des révisions.
Les coûts apparaissent sur votre facture Anthropic, que votre organisation utilise AWS Bedrock ou Google Vertex AI pour d'autres fonctionnalités Claude Code.
Pour définir un plafond de dépenses mensuel, accédez à Paramètres de l'organisation > Utilisation et configurez la limite pour le service Claude Code Review.
Surveillez les dépenses via le graphique des coûts hebdomadaires du tableau de bord analytique ou la colonne du coût moyen par référentiel dans les paramètres d'administration.
Afficher l'utilisation
Accédez au tableau de bord analytique Code Review pour voir l'activité dans votre organisation. Le tableau de bord affiche :
PRs révisées : Nombre quotidien de demandes de tirage révisées sur la plage de temps sélectionnée.
Coût hebdomadaire : Dépenses hebdomadaires pour Code Review.
Retours : Nombre de commentaires de révision qui ont été auto-résolus parce que quelqu'un a résolu le problème.
Répartition par référentiel : Nombre de PRs révisées et de commentaires résolus par référentiel.
Dépannage
Les référentiels n'apparaissent pas après l'installation de l'application GitHub
Si vous avez installé l'application Claude GitHub mais que vos référentiels n'apparaissent pas dans le panneau d'administration :
Confirmez que l'application Claude GitHub a accès aux référentiels attendus. Accédez aux paramètres de votre organisation GitHub, trouvez l'application Claude GitHub sous Applications GitHub installées, et vérifiez si elle a accès à tous les référentiels ou seulement à certains.
Si votre organisation utilise GitHub Enterprise Cloud avec Enterprise Managed Users (EMU), autorisez Claude alors que vous êtes connecté avec votre compte géré et que vous avez une session SSO active. Il n'y a pas d'étape d'approbation au niveau de l'entreprise.
Essayez de déconnecter et reconnecter votre compte GitHub dans Claude. Accédez à Personnaliser > Connecteurs, déconnectez GitHub et reconnectez-le. Les référentiels auxquels l'application peut accéder sont gérés du côté de GitHub, comme indiqué à l'étape 1.
Si le problème persiste, contactez notre équipe d'assistance avec le nom de votre organisation et le nom de votre organisation GitHub afin que nous puissions enquêter.
Code Review ne démarre pas sur une nouvelle PR
Si aucune exécution de vérification n'apparaît après l'ouverture d'une PR :
Confirmez que le référentiel est répertorié et activé dans vos paramètres d'administration.
Vérifiez le paramètre du déclencheur de révision. S'il est défini sur Manuel, vous devrez commenter « @claude review » sur la PR pour démarrer une révision.
Assurez-vous que la PR n'est pas un brouillon. Code Review ne s'exécute pas sur les brouillons de PR.
Vérifiez que l'application Claude GitHub a toujours accès au référentiel dans les paramètres de votre organisation GitHub.
GitHub Enterprise Cloud avec restrictions IP
Si votre organisation GitHub Enterprise Cloud restreint l'accès par adresse IP, l'application Claude GitHub peut être incapable d'accéder à vos référentiels. Pour corriger cela, activez l'héritage de la liste d'autorisation IP pour les applications GitHub installées dans vos paramètres d'entreprise GitHub. L'application Claude GitHub enregistre ses plages IP, donc l'activation de ce paramètre permet l'accès sans configuration manuelle. Pour ajouter les plages à votre liste d'autorisation manuellement à la place, ou pour configurer d'autres pare-feu, consultez les adresses IP de l'API Anthropic.
GitHub Enterprise Server (auto-hébergé)
GitHub Enterprise Server (GHES) auto-hébergé est pris en charge via un flux de configuration distinct. Consultez Claude Code avec GitHub Enterprise Server pour les instructions complètes.
Problèmes courants de configuration GHES :
Erreur « Public cannot be private » lors de la configuration : Votre nom d'hôte GHES doit être résolvable en une adresse IP publiquement routable. Code Review accède à votre serveur via Internet, donc les adresses réseau internes ou privées ne fonctionneront pas. Mettez à jour le DNS ou votre configuration réseau afin que le nom d'hôte soit résolvable en une adresse IP publique, puis réessayez.
GitHub Enterprise Cloud avec résidence des données est un produit différent. GitHub Enterprise Cloud avec résidence des données (.ghe.com) est également pris en charge. Un propriétaire suit la configuration d'administration GitHub Enterprise Server et entre le nom d'hôte
ghe.com.
Questions fréquemment posées
Code Review est-il disponible en tant que capacité lors de la création d'un rôle personnalisé ?
Non, Code Review n'est pas disponible pour être ajouté à un rôle personnalisé pour le moment.
Ressources connexes
Plugins — Parcourez la place de marché des plugins, y compris un plugin d'examen du code pour exécuter des révisions à la demande localement avant de pousser.
GitHub Actions — Exécutez Claude dans vos propres workflows GitHub Actions pour une automatisation personnalisée au-delà de la révision de code.
GitLab CI/CD — Intégration Claude auto-hébergée pour les pipelines GitLab.