La révision de code analyse vos demandes de tirage GitHub et publie les résultats sous forme de commentaires en ligne sur les lignes de code où elle 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 la révision de code, configurer les déclencheurs de révision, personnaliser ce qui est signalé et résoudre les problèmes courants de configuration.
Remarque : La révision de code est en aperçu de recherche et disponible sur les plans Team et Enterprise. Elle n'est pas disponible pour les organisations avec rétention de données zéro activée. L'utilisation de la révision de code est facturée séparément via des crédits d'utilisation et ne compte pas par rapport à l'utilisation incluse de votre plan.
Comment fonctionne la révision de code
Une fois qu'une organisation active la révision de code, elle peut se déclencher automatiquement à l'ouverture d'une demande de tirage, à chaque envoi ou uniquement lorsque quelqu'un demande manuellement une révision. Lorsqu'une révision s'exécute, plusieurs agents analysent la différence 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 demande de tirage. Les révisions n'approuvent ni ne bloquent votre demande de tirage, de sorte que les flux de travail de révision existants restent intacts.
Les révisions évoluent en coût en fonction de la taille et de la complexité de la demande de tirage, 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 bogue qui doit être corrigé avant la fusion |
🟡 | Détail | Un problème mineur, utile à corriger mais non bloquant |
🟣 | Préexistant | Un bogue qui existe dans la base de code mais n'a pas été introduit par cette demande de tirage |
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 la révision de code vérifie
Par défaut, la révision de code se concentre sur la correction : les bogues qui casseraient la production, pas les préférences de formatage ou la couverture de test manquante. Vous pouvez développer ce qu'elle vérifie en ajoutant des fichiers de guidance à votre référentiel.
Configurer la révision de code
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 la révision de code 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 Révision de code.
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 la révision de code. 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 de révision pour chaque référentiel à l'aide de la liste déroulante Comportement de révision (consultez la section suivante pour plus de détails sur chaque option).
Pour vérifier la configuration, ouvrez une demande de tirage 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 demande de tirage pour démarrer la première révision.
Choisir un déclencheur de révision
Après la configuration, la section Révision de code affiche vos référentiels dans un tableau. Pour chaque référentiel, choisissez quand les révisions s'exécutent :
Une fois après la création de la demande de tirage : La révision s'exécute une fois lorsqu'une demande de tirage est ouverte ou marquée comme prête pour révision.
Après chaque envoi : La révision s'exécute à chaque envoi vers la branche de la demande de tirage, détectant les nouveaux problèmes à mesure que la demande de tirage évolue. Claude résout automatiquement les threads lorsque vous corrigez les problèmes précédemment signalés. Cela exécute le plus de révisions et coûte le plus cher.
Manuel : Les révisions commencent uniquement lorsque quelqu'un commente « @claude review » sur une demande de tirage. Utile pour les référentiels à fort trafic où vous souhaitez sélectionner les demandes de tirage à réviser.
Le tableau des référentiels affiche également le coût moyen par révision pour chaque référentiel en fonction de l'activité récente.
Déclencher manuellement les révisions
Commentez « @claude review » sur une demande de tirage pour démarrer une révision et accepter cette demande de tirage dans les révisions déclenchées par envoi à l'avenir. Cela fonctionne quel que soit le déclencheur configuré du référentiel.
Pour que le commentaire déclenche une révision :
Publiez-le en tant que commentaire de demande de tirage de niveau supérieur, pas un commentaire en ligne sur une ligne de différence.
Mettez « @claude review » au début du commentaire.
Vous devez avoir un accès propriétaire, membre ou collaborateur au référentiel.
La demande de tirage doit être ouverte et ne pas être un brouillon.
Si une révision est déjà en cours d'exécution, la demande est mise en file d'attente jusqu'à ce que la révision en cours se termine.
Personnaliser les révisions
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 les fichiers CLAUDE.md de votre référentiel et traite les violations nouvellement introduites comme des résultats au niveau des remarques. 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 à l'examen. 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
Choses que Claude doit toujours signaler (par exemple, « tout nouvel itinéraire API doit avoir un test d'intégration »)
Choses 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 jetons. Chaque examen 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 d'examen 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 examens.
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 :
PR examinées : Nombre quotidien de demandes de tirage examinées sur la plage de temps sélectionnée.
Coût hebdomadaire : Dépenses hebdomadaires pour Code Review.
Retours : Nombre de commentaires d'examen qui ont été automatiquement résolus parce que quelqu'un a résolu le problème.
Répartition du référentiel : Nombre de PR examiné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), assurez-vous que l'application Claude GitHub OAuth est autorisée au niveau de l'entreprise. Les entreprises EMU peuvent restreindre les applications OAuth approuvées, et l'application Claude doit être explicitement autorisée.
Essayez de déconnecter et de 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, couverts à 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 d'examen. S'il est défini sur Manuel, vous devrez commenter « @claude review » sur la PR pour démarrer un examen.
Assurez-vous que la PR n'est pas un brouillon. Code Review ne s'exécute pas sur les PR en brouillon.
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 obtenir des 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 Data Residency est un produit différent. Les locataires Data Residency (noms d'hôte correspondant à
*.ghe.com) ne sont pas pris en charge par Code Review. Seul GitHub Enterprise Server auto-hébergé et les référentiels github.com standard sont pris en charge.
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
Extensions — Parcourez la place de marché des extensions, y compris une extension d'examen de code pour exécuter des examens à 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 l'examen de code.
GitLab CI/CD — Intégration Claude auto-hébergée pour les pipelines GitLab.