Ce dont vous avez besoin pour activer Code Review
Vérifiez d’abord que votre organisation est éligible à Code Review. Assurez-vous ensuite de disposer des accès suivants, ou qu’une personne qui en dispose puisse vous aider :Activer Code Review
1
Cliquer sur le commutateur Allow code review
Accédez à la section Code review de Admin settings > Claude Code et cliquez sur le commutateur Allow code review.Si Code Review s’active immédiatement sans boîte de dialogue, votre organisation a déjà la Claude GitHub App liée ou des dépôts ajoutés. Accédez à Ajouter d’autres dépôts, puis revenez pour la dernière étape.
2
Connecter votre compte GitHub
Si une boîte de dialogue Connect GitHub s’ouvre, cliquez sur Connect. Si votre organisation utilise GitHub Enterprise Server, sélectionnez d’abord votre instance dans la boîte de dialogue. GitHub vous demande d’autoriser Claude, puis vous renvoie vers la page d’administration avec la boîte de dialogue Add a repository ouverte.Si Add a repository s’est ouvert directement, votre compte est déjà connecté : passez à l’étape suivante.
3
Installer la Claude GitHub App
Si les dépôts souhaités figurent dans la boîte de dialogue Add a repository, ou si vous les trouvez en effectuant une recherche, passez à l’étape suivante. La boîte de dialogue ne liste un dépôt que si la Claude GitHub App peut y accéder ; s’ils n’y figurent pas, installez l’application :
- Cliquez sur Install GitHub App. Lorsqu’aucun dépôt n’est listé, il s’agit d’un bouton dans la boîte de dialogue. Sinon, il se trouve en bas du menu de filtre d’organisation GitHub de la boîte de dialogue. La page d’installation de GitHub s’ouvre dans un nouvel onglet.
- Choisissez l’organisation GitHub propriétaire des dépôts.
- Choisissez les dépôts auxquels l’application peut accéder.
- Approuvez les permissions demandées. Cet ensemble est plus large que ce qu’utilise une revue et il est partagé par d’autres fonctionnalités de Claude, comme GitHub Actions. Consultez ce à quoi une revue peut accéder et la liste complète des permissions.
- Une fois l’installation terminée, l’onglet revient à Claude. S’il affiche un bouton Finish connecting GitHub, cliquez dessus pour lier l’installation à votre organisation Claude.
- Revenez à l’onglet de la page d’administration, où la liste de la boîte de dialogue s’actualise.
4
Choisir les dépôts
Sélectionnez les dépôts que vous souhaitez faire réviser, puis cliquez sur Continue. L’ajout d’un dépôt nécessite un accès en écriture à celui-ci depuis le compte GitHub que vous avez connecté. Vous pourrez ajouter d’autres dépôts plus tard.
5
Cliquer sur Finish
Une boîte de dialogue Code review is set up s’affiche ensuite. Cliquez sur Finish pour activer Code Review. Si vous fermez la boîte de dialogue d’une autre manière, vos dépôts restent ajoutés mais Allow code review reste désactivé, et vous l’activez depuis le commutateur.Chaque dépôt est initialement configuré pour une revue après chaque push, ce qui exécute le plus de revues. Pour en exécuter moins, définissez quand les revues s’exécutent.
6
Vérifier avec une pull request de test
Ouvrez une pull request de test dans l’un des dépôts que vous avez ajoutés, sans la marquer comme brouillon. Un check run nommé Claude Code Review apparaît en quelques minutes. Si vous avez déjà configuré le dépôt sur Manual (@claude review), commentez
@claude review sur la pull request pour lancer la première revue.Si aucun check run n’apparaît, consultez Aucun check run n’apparaît sur la pull request de test.Une fois la revue arrivée, envoyez à vos développeurs Lire et demander des revues sur une pull request, qui présente les niveaux de gravité, les commandes de commentaire et la manière de répondre aux résultats.Définir les valeurs par défaut de votre organisation
En tant qu’Owner, vous décidez du niveau de rigueur des revues et de leur fréquence. Ces deux paramètres se trouvent dans la section Code review de Admin settings > Claude Code.Définir le niveau de revue par défaut
Le niveau de revue détermine la rigueur de chaque revue, et une revue plus approfondie coûte plus cher. Vous définissez une valeur par défaut pour l’organisation et pouvez la remplacer pour des dépôts individuels.- Valeur par défaut de l’organisation : sélectionnez un niveau sous Review level et confirmez avec Change level. Chaque dépôt l’utilise, sauf si vous lui attribuez son propre niveau.
- Un seul dépôt : cliquez sur Edit sur la ligne du dépôt, puis sélectionnez un Review level. La première option, Default, suit l’organisation. Le niveau est enregistré dès que vous le sélectionnez.
Définir quand les revues s’exécutent
Chaque dépôt possède son propre paramètre Review runs, qui détermine quand ses pull requests sont révisées.- Once after PR creation : une revue s’exécute lorsqu’une pull request est ouverte, rouverte ou marquée comme prête pour la revue
- After every push : une revue s’exécute à chaque push sur la branche de la pull request, détectant les nouveaux problèmes à mesure que la pull request évolue et résolvant automatiquement les fils de discussion lorsque vous corrigez les problèmes signalés
- Manual (@claude review) : ouvrir une pull request ou y pousser des modifications ne lance pas de revue. Commentez
@claude reviewpour en demander une, ou@claude review alwayspour abonner également la pull request aux revues lors des pushs suivants.
- Brouillons et pull requests provenant de forks : quelle que soit l’option choisie, les revues automatiques ignorent les deux
- Nouveaux dépôts : un dépôt que vous ajoutez depuis la boîte de dialogue Add a repository démarre sur After every push. Si son organisation GitHub est couverte dans son ensemble, il adopte plutôt le paramètre de la ligne de cette organisation.
Activer ou désactiver les commentaires d’astuce
Un commentaire d’astuce est un court commentaire que Claude publie sur une pull request lorsqu’aucune revue ne démarre, en expliquant pourquoi et quoi faire ensuite. Show tips on pull requests est activé par défaut. Lorsqu’il est activé, Claude publie une astuce dans chacun des cas suivants, en expliquant :- Le dépôt est configuré sur Manual : comment demander une revue avec un commentaire
- La pull request provient d’un fork : qu’un mainteneur peut demander la revue
- Un bot, ou une personne sans accès en écriture, commente
@claude review: qu’aucune revue n’a été lancée, et qui peut en demander une - L’organisation GitHub n’est pas liée à votre organisation Claude : que les revues sont suspendues, et comment la lier
Ce que les développeurs peuvent modifier
Les développeurs s’adressent à vous pour modifier le niveau de revue, le paramètre Review runs ou les dépôts qui font l’objet de revues. Depuis GitHub, sans le rôle Owner, ils peuvent effectuer les actions suivantes :- Demander une revue : commenter
@claude reviewsur une pull request. Cela nécessite un accès en écriture au dépôt et fonctionne sur les brouillons et les pull requests provenant de forks, que les revues automatiques ignorent. - Abonner une pull request à une revue à chaque push : commenter
@claude review alwayssur une pull request qui n’est pas un brouillon ou issue d’un fork, par exemple dans un dépôt configuré sur Manual - Modifier ce que les revues signalent : faire un commit de fichiers
REVIEW.mdetCLAUDE.mddans le dépôt, par exemple pour ajouter une vérification
Gérer les dépôts
Vous pouvez ajouter des dépôts un par un ou couvrir une organisation GitHub entière en une seule fois, et arrêter les revues là où vous n’en voulez pas.Ajouter d’autres dépôts
Pour ajouter des dépôts après la configuration, cliquez sur Add au-dessus du tableau Repositories dans la section Code review. La boîte de dialogue Add a repository s’ouvre. Sélectionnez des dépôts et cliquez sur Continue.- Un dépôt n’est pas listé : consultez Un dépôt n’est pas listé dans Add a repository.
- Vous voulez tous les dépôts d’une organisation GitHub : couvrez l’organisation au lieu de sélectionner les dépôts un par un
Couvrir une organisation GitHub entière
Pour activer Code Review sur tous les dépôts d’une organisation GitHub, définissez Review runs sur la ligne de l’organisation dans le tableau Repositories. Cela couvre tous les dépôts de cette organisation auxquels la Claude GitHub App peut accéder, y compris les dépôts ajoutés ultérieurement. Cela peut augmenter considérablement les dépenses. Toutes les conditions suivantes sont requises :- Le compte GitHub que vous avez connecté à Claude est owner de cette organisation GitHub.
- L’organisation est hébergée sur github.com. Les instances GitHub Enterprise Server et les comptes GitHub personnels ne sont pas éligibles.
- Une limite de dépenses mensuelle est définie, pour votre organisation Claude ou pour Code Review.
- Couverture : chaque dépôt est couvert à partir de sa prochaine pull request. Si la Claude GitHub App a été installée sur une sélection de dépôts plutôt que sur tous, Claude révise ces dépôts ; modifiez l’accès aux dépôts de l’application sur GitHub pour couvrir les autres.
- Paramètres existants : chaque dépôt de cette organisation GitHub adopte l’option que vous sélectionnez, y compris les dépôts que vous aviez configurés individuellement. Redéfinir la ligne produit le même effet. Les dépôts que vous avez désactivés sur leur propre ligne restent désactivés.
- Modifications individuelles ultérieures : un dépôt que vous configurez ensuite différemment de son organisation est marqué Custom dans le tableau.
- Niveau de revue : une ligne d’organisation n’a pas de niveau de revue propre.
Désactiver Code Review ou retirer un dépôt
Dans la section Code review de Admin settings > Claude Code, choisissez le contrôle correspondant à ce que vous souhaitez arrêter :- Un dépôt, en le conservant dans la liste : cliquez sur Edit sur sa ligne et désactivez Code review. Le tableau affiche le dépôt comme Off.
- Un dépôt, en le retirant : cliquez sur Edit sur sa ligne, puis sur Remove repository en bas de la boîte de dialogue. Les revues s’y arrêtent, et une autre organisation Claude peut alors configurer ce dépôt. Tant que l’organisation GitHub du dépôt est couverte dans son ensemble, vous ne pouvez pas le retirer ; désactivez plutôt son commutateur Code review.
- Une organisation GitHub entière : cliquez sur Edit sur la ligne de l’organisation et sélectionnez Off. Cela désactive également les dépôts de cette organisation que vous avez ajoutés un par un.
- Tout : désactivez Allow code review. Aucune nouvelle revue ne démarre dans aucun dépôt, et votre liste de dépôts est conservée pour que vous puissiez le réactiver plus tard.
Ressources associées
- Coûts et utilisation de Code Review : comment le niveau de revue et le moment d’exécution des revues affectent les dépenses, comment définir une limite de dépenses et où consulter l’utilisation
- Lire et demander des revues sur une pull request : ce que les développeurs voient sur une pull request et les commandes de commentaire
- Personnaliser Code Review : ajustez ce que Claude signale avec
REVIEW.mdetCLAUDE.md - GitHub Enterprise Server : connectez une instance GitHub auto-hébergée avant la configuration