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 l'utilisation supplémentaire et ne compte pas contre 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 s'adaptent en coût à la taille et à 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 cassent 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 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 (voir la section suivante pour les 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, la demande est mise en file d'attente jusqu'à ce que la révision en cours soit terminée.
Personnaliser les révisions
La révision de code lit deux fichiers de votre référentiel pour guider ce qu'elle signale. Les deux s'ajoutent aux vérifications de correction par défaut.
CLAUDE.md
La révision de code lit les fichiers CLAUDE.md de votre référentiel et traite les violations nouvellement introduites comme des résultats au niveau des détails. Si votre demande de tirage 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, de sorte que les règles dans le CLAUDE.md d'un sous-répertoire s'appliquent uniquement aux fichiers sous ce chemin.
REVIEW.md
Ajoutez un fichier REVIEW.md à la racine de votre référentiel pour les règles spécifiques à la révision. 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
Les choses que Claude doit toujours signaler (par exemple, « toute nouvelle route API doit avoir un test d'intégration »)
Les 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
La révision de code est facturée en fonction de l'utilisation des jetons. Chaque révision coûte en moyenne 15 à 25 dollars, en fonction de la taille de la demande de tirage, de la complexité de la base de code et du nombre de problèmes nécessitant une vérification.
L'utilisation de la révision de code est facturée séparément via l'utilisation supplémentaire et ne compte pas contre l'utilisation incluse de 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 demande de tirage s'exécute une fois par demande de tirage.
Après chaque envoi s'exécute à chaque envoi, multipliant le coût par le nombre d'envois.
Manuel n'entraîne aucun coût jusqu'à ce que quelqu'un commente « @claude review ». Après ce commentaire, les envois supplémentaires vers la demande de tirage déclenchent automatiquement les 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 de coût hebdomadaire du tableau de bord d'analyse ou la colonne de coût moyen par référentiel dans les paramètres d'administration.
Afficher l'utilisation
Accédez au tableau de bord d'analyse de la révision de code pour voir l'activité dans votre organisation. Le tableau de bord affiche :
Demandes de tirage 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 en révision de code.
Retours : Nombre de commentaires de révision qui ont été automatiquement résolus parce que quelqu'un a résolu le problème.
Ventilation par référentiel : Nombre par référentiel de demandes de tirage révisées et de commentaires résolus.
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 que vous attendez. 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 exécutez à nouveau 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.
La révision de code ne démarre pas sur une nouvelle demande de tirage
Si aucune exécution de vérification n'apparaît après l'ouverture d'une demande de tirage :
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 demande de tirage pour démarrer une révision.
Assurez-vous que la demande de tirage n'est pas un brouillon. La révision de code ne s'exécute pas sur les demandes de tirage 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é)
La révision de code nécessite actuellement des référentiels hébergés sur github.com, de sorte que GitHub Enterprise Server auto-hébergé n'est pas encore pris en charge.
Questions fréquemment posées
La révision de code est-elle disponible en tant que capacité lors de la création d'un rôle personnalisé ?
Non, la révision de code n'est pas disponible pour être ajoutée à un rôle personnalisé pour le moment.
Ressources connexes
Plugins — Parcourez la place de marché des plugins, y compris un plugin de révision de code pour exécuter des révisions à la demande localement avant de pousser.
Actions GitHub — Exécutez Claude dans vos propres flux de travail 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.