Dépannage de Code Review

Corrigez une revue Code Review qui n'a pas démarré, qui a échoué ou qui a été ignorée faute de budget, retrouvez les résultats manquants et résolvez les problèmes de configuration et de REVIEW.md.

Lorsque Code Review ne se comporte pas comme prévu sur une pull request, commencez par le check run Claude Code Review. Son titre indique jusqu'où la revue est allée.

Vérifier jusqu'où la revue est allée

Trouvez le check run Claude Code Review sur votre pull request, puis faites correspondre son titre à l'un de ces titres courants :

Une revue n'a pas démarré

Vérifiez ces cas lorsqu'aucun check run Claude Code Review n'apparaît, ou lorsque Claude publie un commentaire indiquant que la revue a été ignorée.

Une commande en commentaire n'a pas démarré de revue

Après avoir commenté @claude review, recherchez sur la pull request un check run Claude Code Review intitulé Code review queued... ou Code review in progress.... Une réaction 👀 sur votre commentaire ne confirme pas qu'une revue va avoir lieu. Si aucun check run n'apparaît, vérifiez chacune de ces causes :

• Code Review n'est pas activé pour ce dépôt : Claude ne publie ni commentaire ni check run en réponse à la commande. Demandez à un Owner d'ajouter le dépôt.
• Le commentaire ne remplit pas une condition : il s'agissait d'un commentaire en ligne ou du corps d'une revue plutôt que d'un nouveau commentaire de premier niveau, ou la commande ne se trouvait pas au début du commentaire. Modifier un commentaire précédent au lieu d'en publier un nouveau ne compte pas non plus, et la pull request doit être ouverte. Consultez les conditions des commandes en commentaire et publiez un nouveau commentaire qui les remplit.
• Vous n'avez pas d'accès en écriture : vous avez besoin de la permission write, maintain ou admin sur le dépôt. Sur une pull request provenant d'un fork, c'est la permission sur le dépôt de base qui compte. Sauf si la pull request est la vôtre, Claude peut répondre par un conseil : « No review was started: manual reviews can only be requested by someone with write access to this repository. » Demandez plutôt à une personne disposant d'un accès en écriture de commenter.
• Le budget est épuisé : Claude publie un commentaire qui commence par « ⚠️ Code review skipped ». Consultez La revue ne s'est pas exécutée et la PR affiche un message de budget.

La revue ne s'est pas exécutée et la PR affiche un message de budget

Lorsque le budget de votre organisation ne peut pas couvrir une revue, Code Review ignore la revue et Claude publie sur la pull request un commentaire qui commence par « ⚠️ Code review skipped ». Dans certains de ces cas, un check run intitulé Code review declined apparaît également.

Le commentaire renvoie vers claude.ai/admin-settings/usage, où un administrateur peut rétablir le budget. Sa formulation vous indique quelle limite a été atteinte :

• « has reached its monthly code review spending cap » : la limite de dépenses mensuelle de Code Review a été atteinte. Les revues reprennent au début de la période de facturation suivante. Pour les obtenir plus tôt, demandez à un administrateur de relever la limite.
• « has no extra usage available to pay for this review » : le solde de crédits d'utilisation de votre organisation est vide, ou sa limite de dépenses mensuelle globale a été atteinte. Demandez à un administrateur d'ajouter des crédits d'utilisation ou de relever cette limite.
• « is too low to start another review » : ce qui reste du budget ou du solde est inférieur au coût prévu d'une revue. Demandez à un administrateur de relever la limite ou d'ajouter des crédits d'utilisation.

Une fois le budget rétabli, commentez @claude review sur la pull request pour obtenir la revue qui a été ignorée. Les conditions des commandes en commentaire s'appliquent, la personne qui commente doit donc disposer d'un accès en écriture.

Relancer une revue qui a échoué ou expiré

Si le résumé du check run indique « The review session was interrupted before it could finish. A new review of this commit has been queued automatically. », vous n'avez rien à faire. Cette revue est automatiquement relancée une fois.

Sinon, lorsque le titre du check run est Code review failed ou Code review timed out, relancez la revue avec un commentaire ou une réexécution :

• Commenter @claude review : publiez-le en tant que commentaire de premier niveau sur la pull request. Cela démarre une nouvelle revue sans abonner la pull request aux futurs pushs.
• Cliquer sur Re-run : si la pull request ne provient pas d'un fork, cliquez sur Re-run sur le check Claude Code Review dans l'onglet Checks de GitHub. La réexécution porte sur le commit de tête actuel de la pull request et n'abonne pas non plus la pull request.

Trouver les problèmes qui n'apparaissent pas sous forme de commentaires en ligne

Si le titre du check run indique que des problèmes ont été trouvés mais que vous ne voyez pas de commentaires de revue en ligne sur le diff, consultez ces autres emplacements où les résultats sont affichés :

• Details du check run : cliquez sur Details à côté du check Claude Code Review dans l'onglet Checks. Le tableau de sévérité liste les résultats avec leur fichier, leur ligne et leur résumé, que le commentaire en ligne ait été accepté ou non.
• Annotations dans Files changed : ouvrez l'onglet Files changed de la PR. Un résultat qui possède une ligne mais qui n'a pas été publié sous forme de commentaire en ligne y apparaît sous forme d'annotation sur les lignes concernées.
• Corps de la revue : les résultats qui n'ont pas d'emplacement en ligne, ou qui se situent en dehors du diff actuel, apparaissent sous un titre Additional findings dans le corps de la revue.

Le check run mentionne REVIEW.md

Voici quatre des messages qu'un check run peut afficher à propos de REVIEW.md :

• « This review applied the repository's review instructions (REVIEW.md) from its default branch, which is not protected against direct pushes. » : la revue a lu uniquement le fichier racine. Consultez Depuis quelle branche REVIEW.md est lu pour savoir ce que change la protection de la branche.
• « were not applied to this review: branch protection could not be confirmed » : la revue n'a lu aucun REVIEW.md.
• « they link to a file this pull request modifies, or carry more links than the review checks » : la revue a ignoré le REVIEW.md racine, ou le nombre de fichiers REVIEW.md de sous-répertoires indiqué par le message. Vérifiez le fichier ignoré pour chacune des causes. Pour le REVIEW.md racine, vérifiez également les fichiers qu'il inclut :
  • Trop de liens : il contient plus de 64 liens Markdown. Réduisez les liens à 64 ou moins.
  • Un lien que la revue ne peut pas analyser : il contient un lien Markdown mal formé. Corrigez ou supprimez le lien.
  • Un lien vers un fichier modifié : il pointe vers un fichier ou un dossier que cette pull request modifie, et la revue n'a pas pu exclure uniquement les lignes contenant ce lien. Rédigez la règle directement dans REVIEW.md.
• « include line(s) in the root REVIEW.md were skipped on this review » : votre REVIEW.md racine a été appliqué, mais pas les fichiers désignés par ces lignes. Vérifiez les listes sous Inclure d'autres fichiers dans REVIEW.md et, pour un skill, sous Inclure un fichier de skill.

Problèmes de configuration

Ces cas se présentent pour un Owner lors de la configuration de Code Review.

Un dépôt n'est pas listé dans Add a repository

Recherchez d'abord le dépôt par son nom, car la boîte de dialogue ne charge pas entièrement une longue liste. La boîte de dialogue ne liste un dépôt que si la Claude GitHub App peut y accéder. Cliquez sur Install GitHub App et donnez à l'application l'accès au dépôt. Lorsqu'aucun dépôt n'est listé, Install GitHub App est un bouton de la boîte de dialogue. Sinon, il se trouve en bas du menu de filtre d'organisation GitHub de la boîte de dialogue.

Aucun check run n'apparaît sur la pull request de test

Vérifiez que Allow code review est activé, que le dépôt est listé sous Repositories dans la section Code review et que la Claude GitHub App y a accès. Les revues automatiques ignorent les pull requests en brouillon, et un dépôt configuré sur Manual (@claude review) nécessite un commentaire @claude review pour démarrer la première revue.

Ressources associées

• Lire et demander des revues sur une pull request : la signification des résultats et du check run, et les commandes en commentaire
• Configurer Code Review : pour les Owners, activer Code Review et gérer les dépôts
• Coûts et utilisation de Code Review : les limites de dépenses à l'origine d'un message de budget
• Personnaliser Code Review : quelle copie de REVIEW.md une revue lit