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 d'examen, 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.
Fonctionnement de 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 un examen. Lorsqu'un examen 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 examens n'approuvent ni ne bloquent votre demande de tirage, de sorte que les flux de travail d'examen existants restent intacts.
Les examens évoluent en coût en fonction de la taille et de la complexité de la demande de tirage, se terminant 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 élargir 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 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 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 le premier examen.
Choisir un déclencheur d'examen
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 examens s'exécutent :
Une fois après la création de la demande de tirage : L'examen s'exécute une fois lorsqu'une demande de tirage est ouverte ou marquée comme prête pour examen.
Après chaque envoi : L'examen 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 d'examens et coûte le plus cher.
Manuel : Les examens 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 à 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 demande de tirage dans les examens déclenchés par envoi à 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 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 un examen est déjà en cours d'exécution, 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 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 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
Choses que Claude doit toujours signaler (par exemple, « toute nouvelle route 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 tokens. Chaque révision coûte en moyenne 15 à 25 $ et varie selon la taille de la PR, la complexité de la base de code et le 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 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 de révision qui ont été automatiquement résolus parce que quelqu'un a résolu le problème.
Répartition par référentiel : Nombre de PRs 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 l'intégration GitHub. Accédez à Paramètres de l'organisation > Claude Code, supprimez la configuration du référentiel et relancez la configuration.
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 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 actuellement pas disponible pour être ajouté à un rôle personnalisé.
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.