Skip to main content
/code-review est une commande que vous tapez dans le prompt de Claude Code, dans la session où vous travaillez. Claude examine les modifications de votre branche, recherche les bugs de correction et rapporte ce qu’il a trouvé dans votre conversation. Selon votre modèle et votre niveau d’effort, la revue couvre également les nettoyages liés à la réutilisation, à la simplification et à l’efficacité. La commande fonctionne avec tous les forfaits. La revue s’exécute dans votre propre session, elle est donc comptabilisée dans l’utilisation de votre forfait ou dans votre facturation API de la même manière que le reste de la session.
Pour que chaque pull request d’un dépôt soit automatiquement revue sur GitHub, consultez Code Review, un service géré qu’un Owner active pour votre organisation.
/review est un alias de /code-review. Avant la v2.1.223, /review était une commande distincte qui effectuait une revue en une seule passe, en lecture seule, d’une pull request GitHub.
1

Exécuter /code-review

Exécutez la commande :
Sans cible, la revue couvre les modifications de votre branche actuelle. Pour orienter plutôt la revue vers une pull request, une autre branche, un chemin ou une plage de commits, consultez Choisir ce qu’il faut revoir.Vous pouvez également ajouter des flags :
  • --fix : demande également à Claude d’appliquer les résultats à votre arbre de travail après la revue. Ses modifications passent par votre mode de permission.
  • --comment : publie les résultats sur une pull request GitHub sous forme de commentaires en ligne, ou sur une merge request GitLab sous forme d’une seule note
2

Continuer à travailler

La revue s’exécute en tant que sous-agent en arrière-plan avec sa propre fenêtre de contexte, elle ne remplit donc pas votre conversation. Les résultats arrivent dans votre conversation lorsque la revue est terminée.
3

Agir sur les résultats

Demandez à Claude de corriger ce que la revue a trouvé. Avec --fix ou --comment, Claude applique ou publie les résultats dans le cadre de la revue, et il peut vous être demandé d’approuver ses modifications.

​
Choisir ce qu’il faut revoir

Pour revoir autre chose que votre branche actuelle, tapez une cible après le niveau d’effort et les éventuels flags. Claude reçoit ce texte comme cible de la revue. Une cible peut être un numéro de pull request, un nom de branche, un chemin de fichier ou une plage de révisions Git. Trouvez ce que vous souhaitez faire revoir dans la première colonne et tapez ce qu’indique la deuxième colonne : Sans cible, /code-review revoit les commits de votre branche en avance sur sa branche upstream ainsi que vos modifications non commitées. Si la branche n’a pas d’upstream, Claude effectue la comparaison avec main, ou avec le commit précédent. Avec ultra, Claude Code interprète la cible différemment, comme le décrit Texte après le niveau d’effort et les flags.

​
Ce que la revue lit et modifie

Vérifiez ces points avant de lancer une revue, en particulier avec --fix :
  • Modifications : sans --fix, les instructions de la revue demandent à Claude uniquement un rapport. Avec --fix, elles lui demandent également d’appliquer les résultats à votre arbre de travail. Dans les deux cas, toute modification passe par votre mode de permission.
  • Retour en arrière : une revue en arrière-plan applique ses modifications --fix en dehors des checkpoints de votre session. Après une telle revue, /rewind ne restaure que les fichiers que Claude avait déjà modifiés dans votre conversation. Les modifications de la revue sur les autres fichiers restent en place, utilisez donc git pour les annuler. Lorsque la revue s’exécute au premier plan, elle modifie votre arbre de travail pendant votre propre tour, donc /rewind restaure ses modifications comme d’habitude.
  • Instructions : la revue suit votre CLAUDE.md, y compris lors d’une exécution non interactive avec -p. Elle ne lit pas REVIEW.md. Ce fichier configure le service Code Review géré sur les pull requests GitHub.

​
Comment les résultats sont rapportés

Claude rapporte les résultats sous forme de texte dans la réponse dans ces deux types d’exécution :
  • Dans une session de terminal, où /code-review exécute la revue en tant que sous-agent forké
  • Dans une exécution -p avec une sortie texte ou JSON
Dans une application hôte qui demande la liste des résultats, comme l’application de bureau, Claude rapporte plutôt les résultats de la revue via l’outil ReportFindings. Le rapport apparaît sous forme de liste de résultats, et chaque entrée affiche l’emplacement du fichier, un résumé d’une phrase et une étiquette de catégorie telle que correctness lorsque le résultat en comporte une. Une demande de l’hôte s’applique à tous les niveaux d’effort et nécessite Claude Code v2.1.218 ou ultérieur. Lorsque Claude corrige plus tard dans la session des résultats rapportés, il les rapporte à nouveau. Claude Code marque alors chaque résultat de la liste mise à jour comme corrigé, ignoré ou ne nécessitant aucune modification.

​
Ajuster l’effort et les arguments

Au-delà de --fix et --comment, la commande accepte ces flags :
  • --post : lors d’une revue cloud ultra d’une pull request github.com, présélectionne la publication des résultats finaux sur la PR dans la boîte de dialogue de lancement. Consultez Publier les résultats sur la pull request. Nécessite Claude Code v2.1.227 ou ultérieur.
  • --max-findings <n>, --max-findings all ou --max-findings default : rapporte jusqu’à n résultats, ou tous les résultats avec all, à la place de la limite habituelle de la revue. Lorsque la revue rapporte via l’outil de résultats, la limite est de 32. Les revues suivantes réutilisent la valeur que vous avez tapée jusqu’à ce que vous passiez --max-findings default, mais une valeur passée lors d’une exécution non interactive avec -p n’est pas mémorisée. Nécessite Claude Code v2.1.288 ou ultérieur.
Passez un niveau d’effort pour arbitrer entre couverture et confiance. Au niveau low, la revue rapporte les résultats dont elle est la plus sûre, vous voyez donc moins de faux positifs. De medium à max, la revue élargit sa couverture. Lorsque vous ne tapez pas de niveau, la revue réutilise le dernier niveau entre low et max que vous avez tapé, même lors d’une session antérieure. Claude Code affiche un avis tel que Reusing high effort, the level you typed last time. Ces règles déterminent le niveau utilisé par une exécution :
  • Taper un niveau : un niveau que vous tapez, comme /code-review high, modifie ce que les exécutions suivantes réutilisent
  • Exécutions non interactives : un niveau passé lors d’une exécution non interactive avec -p ne met pas à jour le niveau mémorisé
  • ultra : la revue n’utilise ni ne met à jour le niveau mémorisé
  • Aucun niveau jamais tapé : la revue utilise l’effort actuel de la session
Avant la v2.1.223, un /code-review sans niveau utilisait toujours l’effort actuel de la session.

​
Publier les résultats sur une merge request GitLab

Lorsque vous passez --comment pour une merge request GitLab, Claude Code publie les résultats via le CLI glab de GitLab. Nécessite Claude Code v2.1.257 ou ultérieur. Lorsque glab n’est pas installé, Claude affiche plutôt les résultats dans le terminal. Passez la merge request sous forme d’URL ou de référence !123. Claude Code ne traite un simple numéro ou un nom de branche comme une merge request que lorsque l’origin du checkout se trouve sur gitlab.com. Sur une instance GitLab autogérée, utilisez la forme URL ou !123.

​
Texte après le niveau d’effort et les flags

Après le niveau d’effort et les flags, Claude Code lit le reste de la ligne comme cible de la revue. L’argument ultra modifie cette lecture :
  • Avec ultra : Claude Code interprète un mot unique comme une branche de base ou un numéro de PR. Un texte plus long qui ne désigne ni une branche ni une PR devient une note jointe à la revue. /code-review ultra check my auth changes revoit votre branche actuelle, et Claude met les résultats en relation avec votre note.
  • Sans ultra : tout ce qui reste constitue la cible de la revue, même lorsque cela commence par un autre nom de commande. /code-review /fix-issue 123 effectue la revue avec /fix-issue 123 comme texte cible au lieu de charger /fix-issue comme second skill empilé. Avant la v2.1.218, une commande empilée après /code-review se développait comme son propre skill.

​
Exécuter au premier plan

Pour que la revue s’exécute au premier plan, effectuez l’une de ces actions :
  • Exécutez-la en mode non interactif, avec le flag -p ou l’Agent SDK. Claude Code attend la revue et inclut les résultats dans la réponse, sauf pour ultra, qui n’attend pas la revue cloud.
  • Définissez CLAUDE_CODE_DISABLE_BACKGROUND_TASKS sur 1, ce qui désactive également toutes les autres fonctionnalités de tâches en arrière-plan
  • Exécutez à nouveau /code-review pendant qu’une revue précédente est encore en cours
Avant la v2.1.218, la revue s’exécutait à l’intérieur de votre conversation.

​
Laisser Claude lancer la revue

Claude peut lancer /code-review de lui-même, sans que vous ayez à taper la commande :
  • Lorsque vous le demandez en langage courant : demandez à Claude de revoir vos modifications et il peut exécuter le skill
  • Depuis une tâche planifiée : une tâche planifiée avec /code-review comme prompt exécute la revue
Une tâche planifiée ne lance jamais la revue cloud, planifiez donc /code-review sans l’argument ultra. Pour empêcher à la fois Claude et les tâches planifiées de lancer la revue tout en laissant /code-review disponible pour que vous puissiez la taper, ajoutez une entrée skillOverrides à un fichier de paramètres tel que ~/.claude/settings.json :
Avant la v2.1.246, Claude ne lançait /code-review de lui-même que lorsqu’un feature flag récupéré auprès d’Anthropic l’activait. Dans les sessions qui ne récupèrent pas de feature flags, /code-review ne s’exécutait que lorsque vous la tapiez, et un /code-review planifié parvenait à Claude sous forme de texte brut.

​
Passer à ultrareview

/code-review ultra --fix exécute l’ultrareview, plus approfondie, dans le cloud, puis demande à Claude d’appliquer ses résultats à votre arbre de travail lorsqu’ils reviennent dans votre session. Ultrareview utilise sa propre portée :
  • Ce qu’elle compare : votre branche actuelle par rapport à la branche par défaut du dépôt, ainsi que les modifications non commitées et indexées dans l’arbre de travail
  • Fichiers sensibles : pour les modifications non commitées de fichiers dont le nom évoque des identifiants ou des clés, tels que les fichiers .env et *.tfvars, Claude Code suit les règles de téléversement d’un dépôt local vers une session cloud
  • Une base différente : passez un nom de branche, par exemple /code-review ultra develop, pour effectuer la comparaison avec une base différente
Lorsque la cible est une pull request github.com, vous pouvez demander à Claude de publier les résultats finaux sur la PR sous forme de commentaire depuis votre compte GitHub. Nécessite Claude Code v2.1.227 ou ultérieur.
Ultrareview nécessite une authentification avec un compte claude.ai. Elle n’est pas disponible sur Amazon Bedrock, Agent Platform de Google Cloud ou Microsoft Foundry, ni pour les organisations ayant activé la Zero Data Retention ou appliqué la configuration HIPAA. Dans ces cas, /code-review ultra exécute plutôt une revue locale dans votre session. Les organisations qui utilisent des clés de chiffrement gérées par le client (CMEK) ne peuvent pas exécuter ultrareview. Pour revoir vos modifications localement, exécutez /code-review.
Pour exécuter une revue cloud depuis un script ou un job de CI, utilisez la sous-commande claude ultrareview, qui attend les résultats et les affiche sur stdout.

​
Modifier la revue ou s’appuyer sur elle

/code-review est un skill fourni : ses instructions sont intégrées à Claude Code, il n’existe donc aucun fichier SKILL.md sur le disque à ouvrir ou à modifier. Pour donner à chaque revue des règles de projet à suivre, ajoutez-les à votre CLAUDE.md. Pour aller plus loin, commencez par l’une de ces pages :
  • Remplacer la commande : un skill de projet ou personnel nommé code-review s’exécute à la place du skill fourni, et l’alias /review continue d’exécuter la revue fournie. Consultez Résoudre les skills qui partagent un nom.
  • Créer votre propre relecteur : écrivez un sous-agent de revue ou un skill de revue
  • Utiliser une commande voisine : /simplify effectue une revue axée uniquement sur le nettoyage et applique ses corrections, et /verify exécute votre application pour confirmer qu’une modification fonctionne
La commande s’appelait /simplify avant la v2.1.147, lorsqu’elle appliquait les corrections par défaut. Si vous avez scripté /simplify pour la recherche de bugs, passez à /code-review --fix.
  • Code Review : le service géré qui revoit chaque pull request sur GitHub pour votre organisation
  • Ultrareview : configuration, limites et coût de la revue cloud approfondie
  • Commandes : la référence en une ligne pour /code-review, /review, /simplify et /verify
  • Skills : fonctionnement des skills fournis et comment écrire les vôtres