> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Effectuer une revue locale avec /code-review

> Exécutez `/code-review` dans une session Claude Code pour trouver des bugs dans les modifications de votre branche, orienter la revue vers une pull request ou un chemin, et demander à Claude d'appliquer les corrections.

`/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.

<Note>
  Pour que chaque pull request d'un dépôt soit automatiquement revue sur GitHub, consultez [Code Review](/docs/fr/code-review), un service géré qu'un Owner active pour votre organisation.
</Note>

`/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.

<Steps>
  <Step title="Exécuter /code-review">
    Exécutez la commande :

    ```text theme={null}
    /code-review
    ```

    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](#choose-what-to-review).

    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](/docs/fr/permission-modes).
    * `--comment` : publie les résultats sur une pull request GitHub sous forme de commentaires en ligne, ou sur une [merge request GitLab](#post-findings-to-a-gitlab-merge-request) sous forme d'une seule note
  </Step>

  <Step title="Continuer à travailler">
    La revue s'exécute en tant que [sous-agent](/docs/fr/sub-agents) 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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<h2 id="choose-what-to-review">
  Choisir ce qu'il faut revoir
</h2>

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 :

| Pour orienter la revue vers | Tapez |
| :- | :- |
| Votre branche actuelle et les modifications non commitées | `/code-review` |
| Vos 15 derniers commits | `/code-review HEAD~15..HEAD` |
| Une branche par rapport à une autre | `/code-review main...my-feature` |
| Un seul commit, où `abc1234` est le hash du commit | `/code-review abc1234^..abc1234` |
| Une pull request par numéro | `/code-review 1234` |
| Un chemin de fichier ou de répertoire | `/code-review src/auth` |

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](#text-after-the-effort-level-and-flags).

<h2 id="what-the-review-reads-and-edits">
  Ce que la revue lit et modifie
</h2>

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](/docs/fr/checkpointing#subagent-edits-not-restored) 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](#run-in-the-foreground), 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](/docs/fr/code-review-customize#use-review-md-for-review-only-rules) géré sur les pull requests GitHub.

<h2 id="how-findings-are-reported">
  Comment les résultats sont rapportés
</h2>

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é](/docs/fr/skills#run-skills-in-a-subagent)
* 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](/docs/fr/desktop#review-your-code), Claude rapporte plutôt les résultats de la revue via l'[outil `ReportFindings`](/docs/fr/tools-reference). 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.

<h2 id="tune-effort-and-arguments">
  Ajuster l'effort et les arguments
</h2>

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](/docs/fr/ultrareview#post-findings-to-the-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](/docs/fr/model-config#adjust-effort-level) 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.

<h3 id="post-findings-to-a-gitlab-merge-request">
  Publier les résultats sur une merge request GitLab
</h3>

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`.

<h3 id="text-after-the-effort-level-and-flags">
  Texte après le niveau d'effort et les flags
</h3>

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](/docs/fr/ultrareview#pass-a-request-in-plain-words). `/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é](/docs/fr/skills#pass-arguments-to-skills). Avant la v2.1.218, une commande empilée après `/code-review` se développait comme son propre skill.

<h2 id="run-in-the-foreground">
  Exécuter au premier plan
</h2>

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](/docs/fr/ultrareview#run-ultrareview-non-interactively).
* Définissez [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/fr/env-vars) 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.

<h2 id="let-claude-start-the-review">
  Laisser Claude lancer la revue
</h2>

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](/docs/fr/scheduled-tasks) avec `/code-review` comme prompt exécute la revue

Une tâche planifiée ne lance jamais la [revue cloud](#escalate-to-ultrareview), 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`](/docs/fr/skills#override-skill-visibility-from-settings) à un [fichier de paramètres](/docs/fr/settings#where-settings-live) tel que `~/.claude/settings.json` :

```json theme={null}
{
  "skillOverrides": {
    "code-review": "user-invocable-only"
  }
}
```

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](/docs/fr/env-vars#features-that-need-feature-flag-fetching), `/code-review` ne s'exécutait que lorsque vous la tapiez, et un `/code-review` planifié parvenait à Claude sous forme de texte brut.

<h2 id="escalate-to-ultrareview">
  Passer à ultrareview
</h2>

`/code-review ultra --fix` exécute l'[ultrareview](/docs/fr/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](/docs/fr/claude-code-on-the-web#send-local-repositories-without-github)
* **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](/docs/fr/ultrareview#post-findings-to-the-pull-request) sous forme de commentaire depuis votre compte GitHub. Nécessite Claude Code v2.1.227 ou ultérieur.

<Note>
  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](/docs/fr/hipaa-setup). 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](https://platform.claude.com/docs/en/manage-claude/cmek) (CMEK) ne peuvent pas exécuter ultrareview. Pour revoir vos modifications localement, exécutez `/code-review`.
</Note>

Pour exécuter une revue cloud depuis un script ou un job de CI, utilisez la [sous-commande `claude ultrareview`](/docs/fr/ultrareview#run-ultrareview-non-interactively), qui attend les résultats et les affiche sur stdout.

<h2 id="change-or-build-on-the-review">
  Modifier la revue ou s'appuyer sur elle
</h2>

`/code-review` est un [skill fourni](/docs/fr/skills#bundled-skills) : 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](/docs/fr/skills#resolve-skills-that-share-a-name).
* **Créer votre propre relecteur** : écrivez un [sous-agent](/docs/fr/sub-agents) de revue ou un [skill](/docs/fr/skills) de revue
* **Utiliser une commande voisine** : [`/simplify`](/docs/fr/commands) effectue une revue axée uniquement sur le nettoyage et applique ses corrections, et [`/verify`](/docs/fr/commands) 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`.

<h2 id="related-resources">
  Ressources connexes
</h2>

* [Code Review](/docs/fr/code-review) : le service géré qui revoit chaque pull request sur GitHub pour votre organisation
* [Ultrareview](/docs/fr/ultrareview) : configuration, limites et coût de la revue cloud approfondie
* [Commandes](/docs/fr/commands) : la référence en une ligne pour `/code-review`, `/review`, `/simplify` et `/verify`
* [Skills](/docs/fr/skills) : fonctionnement des skills fournis et comment écrire les vôtres