Documentation 2026-10-14 22:58 UTC to 2026-10-15 23:58 UTC

636| Limitation | Description |636| Limitation | Description |

637| - | - |637| - | - |

638| Outils Write/Edit/NotebookEdit uniquement | Les modifications effectuées via les commandes Bash ne sont pas suivies |638| Outils Write/Edit/NotebookEdit uniquement | Les modifications effectuées via les commandes Bash ne sont pas suivies |

639| Éditions de sous-agent | Les éditions qu'un [sous-agent](/docs/fr/agent-sdk/subagents) applique ne sont pas suivies ou restaurées, sauf une compétence avec `context: fork` s'exécutant au premier plan ; utilisez git pour annuler les éditions non suivies |639| Éditions de sous-agent | Les éditions qu'un [sous-agent](/docs/fr/agent-sdk/subagents) applique ne sont pas suivies, sauf un skill avec `context: fork` s'exécutant au premier plan. Un rembobinage ne les annule que dans les fichiers que la conversation principale avait déjà modifiés ; utilisez git pour annuler le reste |

640| Même session | Les points de contrôle sont liés à la session qui les a créés |640| Même session | Les points de contrôle sont liés à la session qui les a créés |

641| Contenu du fichier uniquement | La création, le déplacement ou la suppression de répertoires ne sont pas annulés par le rembobinage |641| Contenu du fichier uniquement | La création, le déplacement ou la suppression de répertoires ne sont pas annulés par le rembobinage |

642| Fichiers locaux | Les fichiers distants ou réseau ne sont pas suivis |642| Fichiers locaux | Les fichiers distants ou réseau ne sont pas suivis |

17 17 

18Ce guide explique comment le SDK émet la télémétrie, comment configurer l'export et comment étiqueter et filtrer les données une fois qu'elles atteignent votre backend. Pour lire l'utilisation des tokens et les coûts directement à partir du flux de réponse du SDK au lieu d'exporter vers un backend, consultez [Suivre les coûts et l'utilisation](/docs/fr/agent-sdk/cost-tracking).18Ce guide explique comment le SDK émet la télémétrie, comment configurer l'export et comment étiqueter et filtrer les données une fois qu'elles atteignent votre backend. Pour lire l'utilisation des tokens et les coûts directement à partir du flux de réponse du SDK au lieu d'exporter vers un backend, consultez [Suivre les coûts et l'utilisation](/docs/fr/agent-sdk/cost-tracking).

19 19 

20<Note>

21 Pour l'API Claude ou Managed Agents, consultez [OpenTelemetry pour l'API Claude](https://platform.claude.com/docs/en/manage-claude/opentelemetry).

22</Note>

23 

20<h2 id="how-telemetry-flows-from-the-sdk">24<h2 id="how-telemetry-flows-from-the-sdk">

21 Comment la télémétrie circule depuis le SDK25 Comment la télémétrie circule depuis le SDK

22</h2>26</h2>

1700 1700 

1701Un message utilisateur produit par un sous-agent, comme le `tool_result` de l'un de ses propres appels d'outils, porte `agent_id`. Consultez [`SDKAssistantMessage`](#sdkassistantmessage), qui définit ce champ et la version requise.1701Un message utilisateur produit par un sous-agent, comme le `tool_result` de l'un de ses propres appels d'outils, porte `agent_id`. Consultez [`SDKAssistantMessage`](#sdkassistantmessage), qui définit ce champ et la version requise.

1702 1702 

1703Sur un message qui porte un bloc `tool_result`, `tool_use_result` est l'objet de sortie structurée de l'outil plutôt que le texte envoyé au modèle. Sa forme dépend de l'outil nommé par le bloc `tool_use` correspondant : le champ est donc typé `unknown` ; les formes intégrées sont répertoriées sous [Types de sortie des outils](#tool-output-types). Ces résultats nécessitent un traitement qui va au-delà de leur forme répertoriée :1703Sur un message qui porte un bloc `tool_result`, `tool_use_result` est l'objet de sortie structurée de l'outil plutôt que le texte envoyé au modèle. Sa forme dépend de l'outil nommé par le bloc `tool_use` correspondant : le champ est donc typé `unknown` ; les formes intégrées sont répertoriées sous [Types de sortie d'outils](#tool-output-types). Ces résultats nécessitent un traitement qui va au-delà de leur forme répertoriée :

1704 1704 

1705* L'outil `Agent` : `tool_use_result` est [`AgentOutput`](#agent-2). Effectuez le rendu à partir de celui-ci plutôt que d'analyser le texte du `tool_result`. Le `content` d'un résultat `completed` contient le rapport du sous-agent ou, pour un sous-agent dont le rapport passe par un appel d'outil `SubagentHandback`, une courte note sur cette remise à la place du rapport. En [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) sur Claude Code v2.1.271 ou version ultérieure, tout sous-agent qui produit un résultat `completed` fait son rapport de cette façon, sauf s'il s'agit d'un [fork](/docs/fr/sub-agents#fork-the-current-conversation), et Claude reçoit le rapport sous la forme d'un message distinct provenant du sous-agent.1705* L'outil `Agent` : `tool_use_result` est [`AgentOutput`](#agent-2). Effectuez le rendu à partir de celui-ci plutôt que d'analyser le texte du `tool_result`. Le `content` d'un résultat `completed` contient le rapport du sous-agent ou, pour un sous-agent dont le rapport passe par un appel d'outil `SubagentHandback`, une courte note sur cette remise à la place du rapport. En [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode) sur Claude Code v2.1.271 ou version ultérieure, tout sous-agent qui produit un résultat `completed` fait son rapport de cette façon, sauf s'il s'agit d'un [fork](/docs/fr/sub-agents#fork-the-current-conversation), et Claude reçoit le rapport sous la forme d'un message distinct provenant du sous-agent.

1706* Un appel WebFetch ou WebSearch que Claude Code a déplacé en arrière-plan pour livrer un message `'now'` : le message utilisateur qui porte le `tool_result` de cet appel a `tool_use_result` défini sur `{ detachedToolCall: true }`. L'appel est toujours en cours et Claude reçoit son résultat une fois qu'il est terminé. Aucun second `tool_result` pour ce `tool_use_id` ne suit : si votre application affiche une ligne pour chaque appel d'outil, marquez donc cette ligne comme déplacée en arrière-plan lorsque ce message arrive. Nécessite Claude Code v2.1.287 ou version ultérieure.1706* Un appel WebFetch ou WebSearch que Claude Code a déplacé en arrière-plan pour livrer un message `'now'` : le message utilisateur qui porte le `tool_result` de cet appel a `tool_use_result` défini sur `{ detachedToolCall: true }`. L'appel est toujours en cours et Claude reçoit son résultat une fois qu'il est terminé. Aucun second `tool_result` pour ce `tool_use_id` ne suit : si votre application affiche une ligne pour chaque appel d'outil, marquez donc cette ligne comme déplacée en arrière-plan lorsque ce message arrive. Nécessite Claude Code v2.1.287 ou version ultérieure.

6173 6173 

6174Émis lorsque l'ensemble des commandes disponibles change en milieu de session, par exemple lorsque Claude Code découvre des skills à mesure que l'agent entre dans un sous-répertoire. Le tableau `commands` est la liste complète mise à jour, donc remplacez tout cache de liste de commandes par ce payload. L'appel de [`supportedCommands()`](#query-object) après ce message renvoie la même liste mise à jour, car la méthode suit le dernier push ; cela nécessite Agent SDK v0.3.216 ou version ultérieure. Dans les versions antérieures du SDK, `supportedCommands()` renvoie l'instantané capturé à l'initialisation et ne reflète jamais les changements en milieu de session.6174Émis lorsque l'ensemble des commandes disponibles change en milieu de session, par exemple lorsque Claude Code découvre des skills à mesure que l'agent entre dans un sous-répertoire. Le tableau `commands` est la liste complète mise à jour, donc remplacez tout cache de liste de commandes par ce payload. L'appel de [`supportedCommands()`](#query-object) après ce message renvoie la même liste mise à jour, car la méthode suit le dernier push ; cela nécessite Agent SDK v0.3.216 ou version ultérieure. Dans les versions antérieures du SDK, `supportedCommands()` renvoie l'instantané capturé à l'initialisation et ne reflète jamais les changements en milieu de session.

6175 6175 

6176Claude Code émet également ce message lorsque les [prompts](/docs/fr/mcp#use-mcp-prompts-as-commands) d'un serveur MCP rejoignent ou quittent la liste, par exemple lorsqu'un serveur termine la connexion après le démarrage de la session. Cela nécessite Claude Code v2.1.281 ou version ultérieure.6176Claude Code émet également ce message lorsque les [prompts](/docs/fr/mcp#use-mcp-prompts-as-commands) d'un serveur MCP rejoignent ou quittent la liste, par exemple lorsqu'un serveur termine de se connecter après le démarrage de la session. Cela nécessite Claude Code v2.1.281 ou version ultérieure.

6177 6177 

6178```typescript theme={null}6178```typescript theme={null}

6179type SDKCommandsChangedMessage = {6179type SDKCommandsChangedMessage = {

500 Ce qui est transféré quand vous mettez en arrière-plan500 Ce qui est transféré quand vous mettez en arrière-plan

501</h4>501</h4>

502 502 

503La mise en arrière-plan démarre un nouveau processus qui reprend à partir de la conversation enregistrée, et le travail en cours y est transféré : les commandes shell en arrière-plan en cours d'exécution, les sous-agents mis en arrière-plan, les workflows dynamiques, les tâches planifiées que vous avez créées avec [`/loop`](/docs/fr/scheduled-tasks), et les [réponses automatiques de Claude aux commentaires d'artefacts](/docs/fr/artifacts#let-claude-reply-to-comments-on-its-own) sont tous transférés et continuent de s'y exécuter. Un sous-agent se déplace avec tout ce qu'il a démarré, donc il n'est transféré que lorsque tout ce travail peut aussi être déplacé. Pour arrêter le travail en cours au lieu de le transférer, définissez la variable d'environnement [`CLAUDE_DISABLE_ADOPT=1`](/docs/fr/env-vars#variables) ; Claude Code vous demande alors de confirmer avant la mise en arrière-plan.503La mise en arrière-plan démarre un nouveau processus qui reprend à partir de la conversation enregistrée, et le travail en arrière-plan en cours y est transféré : les commandes shell en arrière-plan en cours d'exécution, les sous-agents mis en arrière-plan, les workflows dynamiques, les tâches planifiées que vous avez créées avec [`/loop`](/docs/fr/scheduled-tasks), et les [réponses automatiques de Claude aux commentaires d'artefacts](/docs/fr/artifacts#let-claude-reply-to-comments-on-its-own) sont tous transférés et continuent de s'y exécuter. Un sous-agent se déplace avec tout ce qu'il a démarré, donc il n'est transféré que lorsque tout ce travail peut aussi être déplacé. Pour arrêter le travail en arrière-plan en cours au lieu de le transférer, définissez la variable d'environnement [`CLAUDE_DISABLE_ADOPT=1`](/docs/fr/env-vars#variables) ; Claude Code vous demande alors de confirmer avant la mise en arrière-plan.

504 504 

505Quand un [workflow dynamique](/docs/fr/workflows) a encore des sous-agents en cours d'exécution, Claude Code demande confirmation avant la mise en arrière-plan avec la boîte de dialogue `Background this session?`, qui indique combien de sous-agents redémarreraient. Choisissez `Stay` pour les laisser terminer d'abord. Si vous confirmez, Claude Code rejoue l'exécution dans la session en arrière-plan : les sous-agents qui s'exécutaient encore recommencent depuis le début, donc les tokens qu'ils ont utilisés jusqu'à présent sont dépensés à nouveau. Voir [Reprendre après une pause](/docs/fr/workflows#resume-after-a-pause) pour savoir quels sous-agents terminés renvoient leurs résultats enregistrés et lesquels s'exécutent à nouveau.505Quand un [workflow dynamique](/docs/fr/workflows) a encore des sous-agents en cours d'exécution, Claude Code demande confirmation avant la mise en arrière-plan avec la boîte de dialogue `Background this session?`, qui indique combien de sous-agents redémarreraient. Choisissez `Stay` pour les laisser terminer d'abord. Si vous confirmez, Claude Code rejoue l'exécution dans la session en arrière-plan : les sous-agents qui s'exécutaient encore recommencent depuis le début, donc les tokens qu'ils ont utilisés jusqu'à présent sont dépensés à nouveau. Voir [Reprendre après une pause](/docs/fr/workflows#resume-after-a-pause) pour savoir quels sous-agents terminés renvoient leurs résultats enregistrés et lesquels s'exécutent à nouveau.

506 506 

507Claude Code arrête le travail qui ne peut pas être transféré, comme un [monitor](/docs/fr/tools-reference#monitor-tool) en cours d'exécution, et arrête avec lui un sous-agent mis en arrière-plan qui possède un monitor. Quand un tel travail est en cours, Claude Code affiche la boîte de dialogue `Background this session?` pour que vous puissiez confirmer avant qu'il n'arrête le travail.507Claude Code arrête le travail en arrière-plan qui ne peut pas être transféré, comme un [monitor](/docs/fr/tools-reference#monitor-tool) en cours d'exécution, et arrête avec lui un sous-agent mis en arrière-plan qui possède un monitor. Quand un tel travail est en cours, Claude Code affiche la boîte de dialogue `Background this session?` pour que vous puissiez confirmer avant qu'il n'arrête le travail.

508 508 

509Une fois en arrière-plan, la session peut démarrer de nouveaux sous-agents, monitors et commandes en arrière-plan, et ceux-ci continuent de s'exécuter lors des détachements et rattachements ultérieurs.509Une fois en arrière-plan, la session peut démarrer de nouveaux sous-agents, monitors et commandes en arrière-plan, et ceux-ci continuent de s'exécuter lors des détachements et rattachements ultérieurs.

510 510 

949 Le backgrounding affiche une boîte de dialogue `Background this session?`949 Le backgrounding affiche une boîte de dialogue `Background this session?`

950</h3>950</h3>

951 951 

952Si vous appuyez sur `←` pour mettre en arrière-plan la session actuelle et que Claude Code affiche une boîte de dialogue `Background this session?`, la session a du travail en cours que la mise en arrière-plan arrêterait, redémarrerait ou laisserait s'exécuter sans surveillance, et Claude Code demande avant de faire l'une de ces actions :952Si vous appuyez sur `←` pour mettre en arrière-plan la session actuelle et que Claude Code affiche une boîte de dialogue `Background this session?`, la session a du travail en arrière-plan en cours que la mise en arrière-plan arrêterait, redémarrerait ou laisserait s'exécuter sans surveillance, et Claude Code demande avant de faire l'une de ces actions :

953 953 

954* **Travail qui ne peut pas être déplacé** : la session a du travail qui ne peut pas être déplacé vers la session en arrière-plan, comme un [monitor](/docs/fr/tools-reference#monitor-tool) en cours d'exécution. La boîte de dialogue nomme le travail que Claude Code arrêterait et, séparément, compte les tâches qui sont transférées.954* **Travail qui ne peut pas être déplacé** : la session a du travail qui ne peut pas être déplacé vers la session en arrière-plan, comme un [monitor](/docs/fr/tools-reference#monitor-tool) en cours d'exécution. La boîte de dialogue nomme le travail en arrière-plan que Claude Code arrêterait et, séparément, compte les tâches qui sont transférées.

955* **Un workflow avec des sous-agents en cours d'exécution** : un [workflow dynamique](/docs/fr/workflows) a toujours des sous-agents en cours d'exécution. Le workflow lui-même est transféré, mais ses sous-agents en cours d'exécution redémarrent depuis le début, et la boîte de dialogue indique combien.955* **Un workflow avec des sous-agents en cours d'exécution** : un [workflow dynamique](/docs/fr/workflows) a toujours des sous-agents en cours d'exécution. Le workflow lui-même est transféré, mais ses sous-agents en cours d'exécution redémarrent depuis le début, et la boîte de dialogue indique combien.

956* **Réponses automatiques aux artefacts** : Claude [répond aux commentaires sur un artefact de sa propre initiative](/docs/fr/artifacts#let-claude-reply-to-comments-on-its-own). Ces réponses continuent dans la session en arrière-plan, et la boîte de dialogue le dit.956* **Réponses automatiques aux artefacts** : Claude [répond aux commentaires sur un artefact de sa propre initiative](/docs/fr/artifacts#let-claude-reply-to-comments-on-its-own). Ces réponses continuent dans la session en arrière-plan, et la boîte de dialogue le dit.

957 957 

1175| v2.1.199 | Une session en arrière-plan dont le processus se termine avant de finir de démarrer sur un hôte à faible mémoire affiche `possibly low memory — free some up and retry` dans le statut de sa ligne au lieu de la seule raison de sortie brute. Mettre en arrière-plan une session avec `←` ou `/background` transfère son `/color` vers la nouvelle ligne. |1175| v2.1.199 | Une session en arrière-plan dont le processus se termine avant de finir de démarrer sur un hôte à faible mémoire affiche `possibly low memory — free some up and retry` dans le statut de sa ligne au lieu de la seule raison de sortie brute. Mettre en arrière-plan une session avec `←` ou `/background` transfère son `/color` vers la nouvelle ligne. |

1176| v2.1.198 | La vue agent envoie une notification via `preferredNotifChannel` quand une session en arrière-plan a besoin d'une entrée, se termine ou échoue, et déclenche le hook `Notification` avec le type `agent_needs_input` ou `agent_completed`. `←` et `/exit` à l'intérieur de `claude attach <id>` reviennent à la vue agent au lieu de quitter vers le shell ; `Ctrl+Z` revient au shell. Une session en arrière-plan qui a isolé son travail dans un worktree crée un commit, pousse sa propre branche isolée, jamais `main` ou `master`, et ouvre une pull request en brouillon quand elle se termine au lieu de demander d'abord. `/login` s'exécute dans la vue agent et ouvre la boîte de dialogue de connexion. La boîte de dialogue de sortie `Background work is running` propose `Move to background and exit`. Le transfert à la sortie couvre également les sous-agents en arrière-plan, qui reprennent à partir de leur transcription au prochain réveil au lieu d'être signalés comme échoués. `claude --bg` combiné avec `-p` ou `--print` est rejeté avec une erreur. L'hôte de session en arrière-plan demande la permission de réseau local macOS au premier accès au LAN au lieu d'échouer avec `connect: no route to host`. |1176| v2.1.198 | La vue agent envoie une notification via `preferredNotifChannel` quand une session en arrière-plan a besoin d'une entrée, se termine ou échoue, et déclenche le hook `Notification` avec le type `agent_needs_input` ou `agent_completed`. `←` et `/exit` à l'intérieur de `claude attach <id>` reviennent à la vue agent au lieu de quitter vers le shell ; `Ctrl+Z` revient au shell. Une session en arrière-plan qui a isolé son travail dans un worktree crée un commit, pousse sa propre branche isolée, jamais `main` ou `master`, et ouvre une pull request en brouillon quand elle se termine au lieu de demander d'abord. `/login` s'exécute dans la vue agent et ouvre la boîte de dialogue de connexion. La boîte de dialogue de sortie `Background work is running` propose `Move to background and exit`. Le transfert à la sortie couvre également les sous-agents en arrière-plan, qui reprennent à partir de leur transcription au prochain réveil au lieu d'être signalés comme échoués. `claude --bg` combiné avec `-p` ou `--print` est rejeté avec une erreur. L'hôte de session en arrière-plan demande la permission de réseau local macOS au premier accès au LAN au lieu d'échouer avec `connect: no route to host`. |

1177| v2.1.196 | Une seule pression sur `←` met en arrière-plan une session au premier plan ; les versions antérieures nécessitaient deux pressions, avec un indice de pied de page et une confirmation. `--dangerously-skip-permissions` passé à `claude agents` affiche l'avertissement de contournement au lieu d'être silencieusement supprimé. Les sessions interactives que vous n'avez jamais nommées portent un nom par défaut comme `my-app-3f` dans les listes de sessions et `claude agents --json`. Les commandes shell en arrière-plan et les workflows dynamiques survivent à l'arrêt, au redémarrage ou à la mise à jour du processus de la session, y compris sur Windows ; définissez `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` pour désactiver le transfert. Une transcription lue à tort comme vide au redémarrage est renommée avec un suffixe `.orphaned-` au lieu d'être supprimée. |1177| v2.1.196 | Une seule pression sur `←` met en arrière-plan une session au premier plan ; les versions antérieures nécessitaient deux pressions, avec un indice de pied de page et une confirmation. `--dangerously-skip-permissions` passé à `claude agents` affiche l'avertissement de contournement au lieu d'être silencieusement supprimé. Les sessions interactives que vous n'avez jamais nommées portent un nom par défaut comme `my-app-3f` dans les listes de sessions et `claude agents --json`. Les commandes shell en arrière-plan et les workflows dynamiques survivent à l'arrêt, au redémarrage ou à la mise à jour du processus de la session, y compris sur Windows ; définissez `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` pour désactiver le transfert. Une transcription lue à tort comme vide au redémarrage est renommée avec un suffixe `.orphaned-` au lieu d'être supprimée. |

1178| v2.1.195 | Le travail en cours est aussi transféré quand vous mettez en arrière-plan une session sur Windows ; définissez `CLAUDE_DISABLE_ADOPT=1` pour l'arrêter à la place. Le groupe `Completed` remplit l'espace vertical restant et l'en-tête se compacte sur les terminaux de faible hauteur. Une version plus ancienne de Claude Code ne supprime plus les champs `state.json` des sessions plus récentes et ne cache plus ces sessions de `claude agents`. S'attacher à une session arrêtée bascule immédiatement au lieu d'afficher un écran vide pendant jusqu'à cinq secondes. Un superviseur qui ne peut pas accepter les connexions quitte et libère son verrou de lui-même. |1178| v2.1.195 | Le travail en arrière-plan en cours est aussi transféré quand vous mettez en arrière-plan une session sur Windows ; définissez `CLAUDE_DISABLE_ADOPT=1` pour l'arrêter à la place. Le groupe `Completed` remplit l'espace vertical restant et l'en-tête se compacte sur les terminaux de faible hauteur. Une version plus ancienne de Claude Code ne supprime plus les champs `state.json` des sessions plus récentes et ne cache plus ces sessions de `claude agents`. S'attacher à une session arrêtée bascule immédiatement au lieu d'afficher un écran vide pendant jusqu'à cinq secondes. Un superviseur qui ne peut pas accepter les connexions quitte et libère son verrou de lui-même. |

1179| v2.1.191 | `claude --bg` avec un nom `--agent` qui ne correspond à aucun de vos sous-agents fait échouer le lancement : la session quitte immédiatement avec une erreur `--agent '<name>' not found` au lieu de s'exécuter avec l'agent par défaut. |1179| v2.1.191 | `claude --bg` avec un nom `--agent` qui ne correspond à aucun de vos sous-agents fait échouer le lancement : la session quitte immédiatement avec une erreur `--agent '<name>' not found` au lieu de s'exécuter avec l'agent par défaut. |

1180| v2.1.174 | Les sessions en arrière-plan n'héritent plus des variables d'endpoint de passerelle comme `ANTHROPIC_BASE_URL` du shell de lancement du superviseur ; le superviseur fournit un nouvel instantané d'identifiants aux workers préchauffés, corrigeant les erreurs `Could not resolve authentication method` intempestives. |1180| v2.1.174 | Les sessions en arrière-plan n'héritent plus des variables d'endpoint de passerelle comme `ANTHROPIC_BASE_URL` du shell de lancement du superviseur ; le superviseur fournit un nouvel instantané d'identifiants aux workers préchauffés, corrigeant les erreurs `Could not resolve authentication method` intempestives. |

1181| v2.1.172 | `/model` dans l'entrée de dispatch définit un remplacement du modèle de dispatch limité à la session. |1181| v2.1.172 | `/model` dans l'entrée de dispatch définit un remplacement du modèle de dispatch limité à la session. |

13| Claude for Teams / Enterprise | [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) | Métriques d'utilisation, métriques de contribution avec intégration GitHub, classement, export de données | [Détails](#access-analytics-for-team-and-enterprise) |13| Claude for Teams / Enterprise | [claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) | Métriques d'utilisation, métriques de contribution avec intégration GitHub, classement, export de données | [Détails](#access-analytics-for-team-and-enterprise) |

14| API (Claude Console) | [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | Métriques d'utilisation, suivi des dépenses, insights d'équipe | [Détails](#access-analytics-for-api-customers) |14| API (Claude Console) | [platform.claude.com/claude-code](https://platform.claude.com/claude-code) | Métriques d'utilisation, suivi des dépenses, insights d'équipe | [Détails](#access-analytics-for-api-customers) |

15 15 

16Code Review dispose de son propre tableau de bord. Pour l'activité de revue et les dépenses, consultez [Afficher l'utilisation](/docs/fr/code-review-costs#view-usage).

17 

16<h2 id="access-analytics-for-team-and-enterprise">18<h2 id="access-analytics-for-team-and-enterprise">

17 Accéder à l'analytique pour Teams et Enterprise19 Accéder à l'analytique pour Teams et Enterprise

18</h2>20</h2>

75| La session est en [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) | Demande avant la première publication de chaque artefact |75| La session est en [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode) | Demande avant la première publication de chaque artefact |

76| La publication déclare des capacités d'exécution pour la page, comme des [appels de connecteur](#pull-live-data-with-mcp-connectors) ou des [téléchargements de fichiers](#offer-a-file-download) | Demande avant cette publication |76| La publication déclare des capacités d'exécution pour la page, comme des [appels de connecteur](#pull-live-data-with-mcp-connectors) ou des [téléchargements de fichiers](#offer-a-file-download) | Demande avant cette publication |

77| Vous avez partagé l'artefact publiquement | Demande une fois par conversation avant de le modifier |77| Vous avez partagé l'artefact publiquement | Demande une fois par conversation avant de le modifier |

78| Vous avez désactivé la [récupération des feature flags](/docs/fr/env-vars#features-that-need-feature-flag-fetching) | Demande avant la première publication de chaque artefact |

79| Claude publie lors d'un tour déclenché par une [tâche planifiée](/docs/fr/scheduled-tasks) s'exécutant dans votre session, plutôt que par un prompt que vous avez tapé | Demande avant la première publication de chaque artefact |78| Claude publie lors d'un tour déclenché par une [tâche planifiée](/docs/fr/scheduled-tasks) s'exécutant dans votre session, plutôt que par un prompt que vous avez tapé | Demande avant la première publication de chaque artefact |

80| Claude ne peut pas lire le fichier sans votre approbation | Demande avant de le publier. Une règle d'autorisation pour l'outil `Artifact` ne permet pas d'ignorer cette demande |79| Claude ne peut pas lire le fichier sans votre approbation | Demande avant de le publier. Une règle d'autorisation pour l'outil `Artifact` ne permet pas d'ignorer cette demande |

80| En mode [Manual](/docs/fr/permission-modes) ou `acceptEdits`, Claude apporte une petite modification au fichier d'un artefact qu'il ne peut pas modifier sans votre approbation, comme un fichier du projet en mode Manual | Demande avant de publier la modification. La demande vous est présentée même si une règle d'autorisation couvre l'outil `Artifact`, car la modification du fichier nécessite votre approbation |

81 81 

82Claude lit sans demander les fichiers situés dans les [répertoires de travail](/docs/fr/permissions#working-directories) de votre session, ainsi que dans le répertoire temporaire où il écrit les pages. Pour permettre à Claude de publier depuis un autre dossier sans demande, ajoutez ce dossier comme répertoire de travail avec [`--add-dir`](/docs/fr/cli-reference#cli-flags) au lancement ou `/add-dir` pendant la session.82Pour permettre à Claude de lire un fichier situé en dehors de vos [répertoires de travail](/docs/fr/permissions#working-directories) sans votre approbation, ajoutez son dossier comme répertoire de travail avec [`--add-dir`](/docs/fr/cli-reference#cli-flags) au lancement ou `/add-dir` pendant la session. Claude lit déjà sans demander les fichiers de ces répertoires, ainsi que ceux du répertoire temporaire où il écrit les pages.

83 

84Si une demande de publication inclut une phrase telle que `Also makes 1 edit to that file on disk.`, Claude modifie le fichier de l'artefact et le publie en une seule étape. Lorsque vous approuvez la demande, Claude Code publie la page, puis écrit la modification dans votre fichier.

83 85 

84<h2 id="update-an-artifact">86<h2 id="update-an-artifact">

85 Mettre à jour un artifact87 Mettre à jour un artifact

149* **Session cloud sans accès réseau** : pour un [environnement cloud](/docs/fr/cloud-environments#access-levels), il s'agit du niveau **None**. En [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode), le classifieur peut approuver à votre place ; dans une session [Cowork](https://claude.com/product/cowork), l'approbation vous revient exclusivement.151* **Session cloud sans accès réseau** : pour un [environnement cloud](/docs/fr/cloud-environments#access-levels), il s'agit du niveau **None**. En [mode auto](/docs/fr/permission-modes#eliminate-prompts-with-auto-mode), le classifieur peut approuver à votre place ; dans une session [Cowork](https://claude.com/product/cowork), l'approbation vous revient exclusivement.

150* **Artefact public d'une autre organisation** : Claude Code vous demande d'abord, même en mode auto. Lorsque Claude Code ne peut pas vous demander, par exemple en mode `bypassPermissions`, Claude ne peut pas lire l'artefact. Claude ne peut lire ces artefacts que lorsque la [récupération des feature flags](/docs/fr/env-vars#features-that-need-feature-flag-fetching) est activée.152* **Artefact public d'une autre organisation** : Claude Code vous demande d'abord, même en mode auto. Lorsque Claude Code ne peut pas vous demander, par exemple en mode `bypassPermissions`, Claude ne peut pas lire l'artefact. Claude ne peut lire ces artefacts que lorsque la [récupération des feature flags](/docs/fr/env-vars#features-that-need-feature-flag-fetching) est activée.

151* **Propriétaire ou paramètre réseau non confirmé** : lorsque Claude Code ne peut pas confirmer qui a créé l'artefact, ou ne peut pas confirmer le paramètre réseau d'une session cloud, il vous demande, et votre approbation couvre uniquement cette requête.153* **Propriétaire ou paramètre réseau non confirmé** : lorsque Claude Code ne peut pas confirmer qui a créé l'artefact, ou ne peut pas confirmer le paramètre réseau d'une session cloud, il vous demande, et votre approbation couvre uniquement cette requête.

152* **Mode plan, ou récupération des feature flags désactivée** : en [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode), ou si vous avez désactivé la [récupération des feature flags](/docs/fr/env-vars#features-that-need-feature-flag-fetching), Claude Code demande avant que l'outil Artifact ne lise un artefact créé par quelqu'un d'autre dans votre organisation.154* **Mode plan** : en [mode plan](/docs/fr/permission-modes#analyze-before-you-edit-with-plan-mode), Claude Code demande avant que l'outil Artifact ne lise un artefact créé par quelqu'un d'autre dans votre organisation.

153 155 

154Lorsque Claude lit l'artefact avec WebFetch, les propres [règles de demande de permission](/docs/fr/tools-reference#webfetch-tool-behavior) de WebFetch continuent de s'appliquer.156Lorsque Claude lit l'artefact avec WebFetch, les propres [règles de demande de permission](/docs/fr/tools-reference#webfetch-tool-behavior) de WebFetch continuent de s'appliquer.

155 157 

102Un [subagent](/docs/fr/sub-agents) effectue des modifications avec les outils d'édition de fichiers de Claude, mais Claude Code ne capture généralement pas ces modifications dans les checkpoints de votre session. Le fait que le rembobinage les restaure dépend de la façon dont le subagent s'exécute :102Un [subagent](/docs/fr/sub-agents) effectue des modifications avec les outils d'édition de fichiers de Claude, mais Claude Code ne capture généralement pas ces modifications dans les checkpoints de votre session. Le fait que le rembobinage les restaure dépend de la façon dont le subagent s'exécute :

103 103 

104* **Skill forké en avant-plan** : un [skill avec `context: fork`](/docs/fr/skills#run-skills-in-a-subagent) qui s'exécute en avant-plan modifie votre arborescence de travail pendant votre propre tour, donc le rembobinage restaure ses modifications comme d'habitude. Définissez `background: false` pour exécuter un fork en avant-plan ; quelques situations, [listées sur la page des skills](/docs/fr/skills#run-skills-in-a-subagent), l'exécutent là-bas indépendamment du paramètre.104* **Skill forké en avant-plan** : un [skill avec `context: fork`](/docs/fr/skills#run-skills-in-a-subagent) qui s'exécute en avant-plan modifie votre arborescence de travail pendant votre propre tour, donc le rembobinage restaure ses modifications comme d'habitude. Définissez `background: false` pour exécuter un fork en avant-plan ; quelques situations, [listées sur la page des skills](/docs/fr/skills#run-skills-in-a-subagent), l'exécutent là-bas indépendamment du paramètre.

105* **Tout autre subagent** : le rembobinage ne restaure pas les modifications. Utilisez git pour les annuler. Cela inclut un skill forké qui s'exécute en arrière-plan, le paramètre par défaut, et une exécution [`/code-review --fix`](/docs/fr/code-review) en arrière-plan.105* **Tout autre sous-agent** : le rembobinage restaure uniquement les fichiers que Claude avait déjà modifiés dans votre conversation. Les modifications du sous-agent sur les autres fichiers sont conservées ; utilisez donc git pour les annuler. Cela inclut un skill forké qui s'exécute en arrière-plan, le comportement par défaut, et une exécution [`/code-review --fix`](/docs/fr/code-review-local) en arrière-plan.

106 106 

107<h3 id="external-changes-not-tracked">107<h3 id="external-changes-not-tracked">

108 Les modifications externes ne sont pas suivies108 Les modifications externes ne sont pas suivies

64Consultez [Connecter depuis votre terminal](/docs/fr/web-quickstart#connect-from-your-terminal) pour la procédure pas à pas de `/web-setup`, y compris ce que `/web-setup` stocke et comment le supprimer.64Consultez [Connecter depuis votre terminal](/docs/fr/web-quickstart#connect-from-your-terminal) pour la procédure pas à pas de `/web-setup`, y compris ce que `/web-setup` stocke et comment le supprimer.

65 65 

66<Note>66<Note>

67 Les organisations avec [Zéro rétention de données](/docs/fr/zero-data-retention) activée, ou avec la [configuration HIPAA](/docs/fr/hipaa-setup) appliquée, ne peuvent pas utiliser `/web-setup` ou d'autres fonctionnalités de session cloud.67 Les organisations avec [Zéro rétention de données](/docs/fr/zero-data-retention) activée, ou avec la [configuration HIPAA](/docs/fr/hipaa-setup) appliquée, ne peuvent pas utiliser `/web-setup` ou d'autres fonctionnalités de session cloud. 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 non plus démarrer de sessions cloud.

68</Note>68</Note>

69 69 

70<h3 id="quick-setup-for-team-and-enterprise">70<h3 id="quick-setup-for-team-and-enterprise">

559 559 

560Le `matcher` limite le crochet aux événements `startup` et `resume`, et `$CLAUDE_PROJECT_DIR` se résout à la racine du dépôt, donc le crochet trouve le script quel que soit le répertoire de travail de la session.560Le `matcher` limite le crochet aux événements `startup` et `resume`, et `$CLAUDE_PROJECT_DIR` se résout à la racine du dépôt, donc le crochet trouve le script quel que soit le répertoire de travail de la session.

561 561 

562Ensuite, créez le script sur `scripts/install_pkgs.sh`. Il quitte immédiatement en dehors du cloud, puis installe vos dépendances :562Ensuite, créez le script sur `scripts/install_pkgs.sh`. Il quitte immédiatement en dehors du cloud, puis installe vos dépendances. Il ignore `npm install` tant que `package.json`, `package-lock.json` et le script lui-même n'ont pas changé depuis la dernière installation réussie :

563 563 

564```bash theme={null}564```bash theme={null}

565#!/bin/bash565#!/bin/bash

568 exit 0568 exit 0

569fi569fi

570 570 

571npm install571cd "$CLAUDE_PROJECT_DIR" || exit 1

572hashes=node_modules/.install_pkgs.sha256

573 

574if ! sha256sum --check --status "$hashes" 2>/dev/null; then

575 # Delete the old hashes first, so a failed install runs again next time

576 rm -f "$hashes"

577 if npm install; then

578 sha256sum scripts/install_pkgs.sh package.json package-lock.json > "$hashes" || rm -f "$hashes"

579 fi

580fi

581 

582# pip skips requirements that are already satisfied

572pip install -r requirements.txt583pip install -r requirements.txt

573exit 0584exit 0

574```585```

575 586 

576La vérification `CLAUDE_CODE_REMOTE` est ce qui limite l'installation aux sessions cloud : la VM de la session porte cette variable comme `true`, elle n'est jamais `true` localement, donc sur votre ordinateur portable le script quitte avant d'installer quoi que ce soit.587La vérification `CLAUDE_CODE_REMOTE` est ce qui limite l'installation aux sessions cloud : la VM de la session porte cette variable comme `true`, elle n'est jamais `true` localement, donc sur votre ordinateur portable le script quitte avant d'installer quoi que ce soit.

577 588 

578Ensemble, les deux fichiers donnent à chaque session cloud un `npm install` et `pip install` frais au démarrage tout en laissant les sessions locales intactes.589Pour confirmer que `npm install` a réussi, démarrez une session cloud et demandez à Claude d'afficher `node_modules/.install_pkgs.sha256`. Le fichier liste un hash pour chacun des trois fichiers. Si le fichier est absent, demandez à Claude d'exécuter `npm install` et de signaler l'erreur.

590 

591<Note>

592 Si `npm install` lit d'autres fichiers, comme le `package.json` d'un espace de travail, un `.npmrc` ou les entrées de votre script `postinstall`, ajoutez-les à la commande `sha256sum` qui enregistre les hashs. Sinon, vous conservez les anciens paquets après la modification de l'un de ces fichiers.

593</Note>

579 594 

580<h4 id="limitations-in-cloud-sessions">595<h4 id="limitations-in-cloud-sessions">

581 Limitations dans les sessions cloud596 Limitations dans les sessions cloud

587* **Pas de limitation au cloud uniquement** : les crochets s'exécutent dans les sessions locales et cloud. Pour ignorer l'exécution locale, quittez tôt sauf si la variable d'environnement `CLAUDE_CODE_REMOTE` est `true`, de la même manière que le [script d'installation de dépendances](#install-dependencies-with-a-sessionstart-hook) le fait.602* **Pas de limitation au cloud uniquement** : les crochets s'exécutent dans les sessions locales et cloud. Pour ignorer l'exécution locale, quittez tôt sauf si la variable d'environnement `CLAUDE_CODE_REMOTE` est `true`, de la même manière que le [script d'installation de dépendances](#install-dependencies-with-a-sessionstart-hook) le fait.

588* **Nécessite un accès réseau** : les commandes d'installation doivent atteindre les registres de paquets. Si votre environnement utilise un accès réseau **None**, ces crochets échouent. La [liste d'autorisation par défaut](#default-allowed-domains) sous **Trusted** couvre npm, PyPI, RubyGems et crates.io.603* **Nécessite un accès réseau** : les commandes d'installation doivent atteindre les registres de paquets. Si votre environnement utilise un accès réseau **None**, ces crochets échouent. La [liste d'autorisation par défaut](#default-allowed-domains) sous **Trusted** couvre npm, PyPI, RubyGems et crates.io.

589* **Compatibilité proxy** : dans les environnements hébergés par Anthropic, tout le trafic sortant passe par un [proxy de sécurité](#security-proxy), et certains gestionnaires de paquets ne fonctionnent pas correctement avec lui ; Bun est un exemple connu. Dans un [environnement auto-hébergé](/docs/fr/self-hosted-environments-deploy#default-deny-egress), le trafic sortant va via votre propre limite réseau à la place.604* **Compatibilité proxy** : dans les environnements hébergés par Anthropic, tout le trafic sortant passe par un [proxy de sécurité](#security-proxy), et certains gestionnaires de paquets ne fonctionnent pas correctement avec lui ; Bun est un exemple connu. Dans un [environnement auto-hébergé](/docs/fr/self-hosted-environments-deploy#default-deny-egress), le trafic sortant va via votre propre limite réseau à la place.

590* **Ajoute une latence de démarrage** : les crochets s'exécutent chaque fois qu'une session démarre ou reprend, contrairement aux scripts de configuration qui bénéficient de la [mise en cache d'environnement](#environment-caching). Gardez les scripts d'installation rapides en vérifiant si les dépendances sont déjà présentes avant de réinstaller.605* **Ajoute une latence de démarrage** : les hooks s'exécutent chaque fois qu'une session démarre ou reprend, contrairement aux scripts de configuration qui bénéficient de la [mise en cache d'environnement](#environment-caching). Gardez les scripts d'installation rapides en ignorant le travail déjà effectué, de la même manière que le [script d'installation de dépendances](#install-dependencies-with-a-sessionstart-hook) le fait.

591 606 

592Pour personnaliser l'image de base, utilisez un script de configuration pour installer ce dont vous avez besoin en haut de l'[image fournie](#installed-tools), ou exécutez votre propre image en tant que conteneur à côté de Claude avec `docker compose`. Remplacer l'image de base entièrement n'est pas encore supporté.607Pour personnaliser l'image de base, utilisez un script de configuration pour installer ce dont vous avez besoin en haut de l'[image fournie](#installed-tools), ou exécutez votre propre image en tant que conteneur à côté de Claude avec `docker compose`. Remplacer l'image de base entièrement n'est pas encore supporté.

593 608 

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.3> Use this file to discover all available pages before exploring further.

4 4 

5# Révision de code5# Code Review

6 6 

7> Configurez des révisions de PR automatisées qui détectent les erreurs logiques, les vulnérabilités de sécurité et les régressions en utilisant l'analyse multi-agents de votre base de code complète7> Détectez les bugs dans les pull requests GitHub avec Code Review : Claude examine chaque modification, vérifie ses résultats et publie des commentaires en ligne. Pour les plans Team et Enterprise

8 8 

9<Note>9Avec Code Review, Claude effectue la revue des pull requests de vos dépôts GitHub. Plusieurs agents lisent chaque modification ainsi que le code environnant, à la recherche de problèmes tels que des erreurs logiques, des vulnérabilités de sécurité ou des cas limites cassés. Une étape de vérification confronte les résultats au code avant qu'ils ne soient signalés.

10 Code Review est en research preview, disponible pour les abonnements [Team et Enterprise](https://claude.ai/admin-settings/claude-code). Il n'est pas disponible pour les organisations avec [Zero Data Retention](/docs/fr/zero-data-retention) activé ou avec la [configuration HIPAA](/docs/fr/hipaa-setup) appliquée, et n'est pas couvert par le BAA d'Anthropic. Sur les autres plans, vous pouvez toujours [examiner un diff localement](#review-a-diff-locally) avec la commande `/code-review`.

11</Note>

12 

13Code Review analyse vos pull requests GitHub et publie les résultats sous forme de commentaires en ligne sur les lignes de code où il 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 logiques, les vulnérabilités de sécurité, les cas limites cassés et les régressions subtiles.

14 

15Les résultats sont étiquetés par gravité et n'approuvent ni ne bloquent votre PR, de sorte que les flux de travail d'examen existants restent intacts. Vous pouvez affiner ce que Claude signale en ajoutant un fichier `CLAUDE.md` ou `REVIEW.md` à votre référentiel.

16 

17Pour exécuter Claude dans votre propre infrastructure CI au lieu de ce service géré, consultez [GitHub Actions](/docs/fr/github-actions) ou [GitLab CI/CD](/docs/fr/gitlab-ci-cd). Pour les référentiels sur une instance GitHub auto-hébergée, consultez [GitHub Enterprise Server](/docs/fr/github-enterprise-server).

18 

19Cette page couvre :

20 

21* [Comment fonctionnent les révisions](#how-reviews-work)

22* [Configuration](#set-up-code-review)

23* [Déclenchement manuel des révisions](#manually-trigger-reviews) avec `@claude review` et `@claude review always`

24* [Personnalisation des révisions](#customize-reviews) avec `CLAUDE.md` et `REVIEW.md`

25* [Tarification](#pricing)

26* [Dépannage](#troubleshooting) des exécutions échouées et des commentaires manquants

27* [Révision d'une diff localement](#review-a-diff-locally) avec la commande `/code-review`

28 

29<h2 id="how-reviews-work">

30 Comment fonctionnent les révisions

31</h2>

32 

33Une fois qu'un administrateur [active Code Review](#set-up-code-review) pour votre organisation, les révisions se déclenchent à l'ouverture d'une PR, à chaque push, ou sur demande manuelle, selon le comportement configuré du référentiel. Commenter `@claude review` [démarre une révision sur une PR](#manually-trigger-reviews) dans n'importe quel mode.

34 

35Lorsqu'une révision s'exécute, plusieurs agents analysent le diff et le code environnant en parallèle sur l'infrastructure Anthropic. Chaque agent recherche une classe de problème différente, puis une étape de vérification vérifie les candidats 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, avec un résumé dans le corps de la révision. Si aucun problème n'est trouvé, Code Review met à jour la vérification GitHub pour montrer qu'aucun problème n'a été détecté. Claude peut également publier un court commentaire de confirmation sur la PR.

36 

37Les révisions s'adaptent en coût à la taille et à la complexité de la PR, se complétant en moyenne en 20 minutes. Les administrateurs peuvent surveiller l'activité de révision et les dépenses via le [tableau de bord analytique](#view-usage).

38 

39<h3 id="severity-levels">

40 Niveaux de gravité

41</h3>

42 

43Chaque résultat est étiqueté avec un niveau de gravité :

44 

45| Marqueur | Gravité | Signification |

46| :- | :- | :- |

47| 🔴 | Important | Un bug qui devrait être corrigé avant la fusion |

48| 🟡 | Nit | Un problème mineur, utile à corriger mais non bloquant |

49| 🟣 | Préexistant | Un bug qui existe dans la base de code mais n'a pas été introduit par cette PR |

50 

51Les résultats incluent une section réductible **Pourquoi ceci a été signalé** que vous pouvez développer pour lire pourquoi Claude a signalé le problème et comment il a vérifié le problème.

52 

53<h3 id="rate-and-reply-to-findings">

54 Évaluer et répondre aux résultats

55</h3>

56 

57Chaque commentaire de révision de Claude arrive avec 👍 et 👎 déjà attachés de sorte que les deux boutons apparaissent dans l'interface utilisateur GitHub pour un classement en un clic. Cliquez sur 👍 si le résultat était utile ou 👎 s'il était incorrect ou bruyant. Anthropic collecte les comptages de réactions après la fusion de la PR et les utilise pour affiner le réviseur. Les réactions ne déclenchent pas une re-révision ou ne changent rien sur la PR.

58 

59Répondre à un commentaire en ligne ne pousse pas Claude à répondre ou à mettre à jour la PR. Pour agir sur un résultat, corrigez le code et poussez. Si la PR est abonnée aux révisions déclenchées par push, la prochaine exécution résout le thread quand le problème est corrigé. Pour demander une révision fraîche sans pousser, commentez `@claude review` comme un [commentaire PR de haut niveau](#manually-trigger-reviews).

60 

61Pour rejeter un résultat sans modification du code, résolvez son thread ; répondre ne le rejette pas.

62 

63<h3 id="check-run-output">

64 Sortie de l'exécution de vérification

65</h3>

66 

67Au-delà des commentaires de révision en ligne, chaque révision remplit l'exécution de vérification **Claude Code Review** qui apparaît aux côtés de vos vérifications CI. Développez son lien **Details** pour voir un résumé de chaque résultat en un seul endroit, trié par gravité :

68 

69| Gravité | Fichier:Ligne | Problème |

70| - | - | - |

71| 🔴 Important | `src/auth/session.ts:142` | L'actualisation du token entre en concurrence avec la déconnexion, laissant les sessions obsolètes actives |

72| 🟡 Nit | `src/auth/session.ts:88` | `parseExpiry` retourne silencieusement 0 sur une entrée malformée |

73 

74Chaque résultat apparaît également comme une annotation dans l'onglet **Files changed**, marqué directement sur les lignes de diff pertinentes. Les résultats importants s'affichent avec un marqueur rouge, les nits avec un avertissement jaune, et les bugs préexistants avec un avis gris. Les annotations et le tableau de gravité sont écrits dans l'exécution de vérification indépendamment des commentaires de révision en ligne, de sorte qu'ils restent disponibles même si GitHub rejette un commentaire en ligne sur une ligne qui a bougé.

75 

76L'exécution de vérification se termine toujours avec une conclusion neutre, de sorte qu'elle ne bloque jamais la fusion via les règles de protection de branche. Si vous souhaitez conditionner les fusions aux résultats de Code Review, lisez la répartition de gravité à partir de la sortie de l'exécution de vérification dans votre propre CI. La dernière ligne du texte Details est un commentaire lisible par machine que votre flux de travail peut analyser avec `gh` et jq. Pour trouver l'ID de l'exécution de vérification, listez les exécutions de vérification du commit avec `gh api repos/OWNER/REPO/commits/<commit-sha>/check-runs --jq '.check_runs[] | {id, name}'` et prenez l'`id` de l'exécution `Claude Code Review`. Remplacez `OWNER`, `REPO` et `CHECK_RUN_ID` par le propriétaire de votre référentiel, le nom du référentiel et cet ID :

77 

78```bash theme={null}

79gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \

80 --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'

81```

82 

83Cela retourne un objet JSON avec des comptages par gravité, par exemple `{"normal": 2, "nit": 1, "pre_existing": 0}`. La clé `normal` contient le nombre de résultats importants ; une valeur non nulle signifie que Claude a trouvé au least un bug à corriger avant la fusion.

84 

85<h3 id="what-code-review-checks">

86 Ce que Code Review vérifie

87</h3>

88 

89Par défaut, Code Review se concentre sur la correction : les bugs qui cassent la production, pas les préférences de formatage ou la couverture de test manquante. Vous pouvez élargir ce qu'il vérifie en [ajoutant des fichiers de guidance](#customize-reviews) à votre référentiel.

90 

91<h2 id="set-up-code-review">

92 Configurer Code Review

93</h2>

94 

95Un propriétaire active Code Review une fois pour l'organisation et sélectionne les référentiels à inclure.

96 

97<Steps>

98 <Step title="Ouvrir les paramètres d'administration Claude Code">

99 Allez à [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) et trouvez la section Code Review. Vous avez besoin du rôle Propriétaire ou Propriétaire principal dans votre organisation Claude et de la permission d'installer des GitHub Apps dans votre organisation GitHub.

100 </Step>

101 

102 <Step title="Démarrer la configuration">

103 Cliquez sur **Setup**. Cela commence le flux d'installation de GitHub App.

104 </Step>

105 

106 <Step title="Installer la GitHub App Claude">

107 Suivez les invites pour installer la GitHub App Claude : choisissez l'organisation GitHub qui possède les référentiels que vous souhaitez examiner, sélectionnez les référentiels auxquels l'application peut accéder, et approuvez les permissions demandées.

108 

109 Pour examiner une demande de tirage, Claude lit le contenu de votre référentiel via l'accès en lecture de l'application, et publie des commentaires et l'[exécution de vérification](#check-run-output) via son accès en écriture aux demandes de tirage et aux vérifications. Lors de l'installation, vous accordez un ensemble de permissions plus large partagé par d'autres fonctionnalités Claude, telles que [GitHub Actions](/docs/fr/github-actions) ; consultez [Permissions de GitHub App](/docs/fr/github-actions#github-app-permissions) pour la liste complète.

110 </Step>

111 

112 <Step title="Sélectionner les référentiels">

113 Choisissez les référentiels à activer pour Code Review. Si vous ne voyez pas un référentiel, assurez-vous d'avoir donné à la GitHub App Claude l'accès pendant l'installation. Vous pouvez ajouter plus de référentiels plus tard.

114 </Step>

115 

116 <Step title="Définir les déclencheurs de révision par référentiel">

117 Une fois la configuration terminée, la section Code Review affiche vos référentiels dans un tableau. Pour chaque référentiel, utilisez la liste déroulante **Review Behavior** pour choisir quand les révisions s'exécutent :

118 

119 * **Once after PR creation** : la révision s'exécute une fois à l'ouverture d'une PR ou marquée comme prête pour révision

120 * **After every push** : la révision s'exécute à chaque push vers la branche PR, détectant les nouveaux problèmes à mesure que la PR évolue et résolvant automatiquement les threads lorsque vous corrigez les problèmes signalés

121 * **Manual** : l'ouverture ou le push vers une PR ne démarre pas une révision ; commentez [`@claude review`](#manually-trigger-reviews) pour en demander une, ou `@claude review always` pour également abonner la PR aux révisions lors des pushes ultérieurs

122 

123 Quelle que soit l'option que vous choisissez, Claude examine une [demande de tirage à partir d'une fourche](#review-pull-requests-from-forks) uniquement quand quelqu'un commente `@claude review` sur celle-ci.

124 

125 Réviser à chaque push exécute le plus de révisions et coûte le plus cher. Le mode manuel est utile pour les référentiels à fort trafic où vous souhaitez opter pour des PR spécifiques dans la révision, ou pour commencer à réviser vos PR uniquement une fois qu'elles sont prêtes.

126 </Step>

127</Steps>

128 

129Le 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. Utilisez le menu d'actions de ligne pour activer ou désactiver Code Review par référentiel, ou pour supprimer complètement un référentiel.

130 

131Pour vérifier la configuration, ouvrez une PR de test. Si vous avez choisi un déclencheur automatique, une exécution de vérification nommée **Claude Code Review** apparaît dans quelques minutes. Si vous avez choisi Manual, commentez `@claude review` sur la PR pour démarrer la première révision. Si aucune exécution de vérification n'apparaît, confirmez que le référentiel est listé dans vos paramètres d'administration et que la GitHub App Claude y a accès.

132 10 

133<h2 id="manually-trigger-reviews">11Les résultats arrivent sous forme de commentaires en ligne sur les lignes concernées, classés par [gravité](/docs/fr/code-review-pull-requests#severity-levels), accompagnés d'un résumé et d'une exécution de vérification sur la pull request. Une revue n'approuve ni ne bloque jamais la pull request : la décision de fusionner reste donc entre les mains de votre équipe.

134 Déclencher manuellement les révisions

135</h2>

136 

137Les commandes de commentaire démarrent une révision à la demande. Elles fonctionnent quel que soit le déclencheur configuré du référentiel, de sorte que vous pouvez les utiliser pour opter pour des PR spécifiques dans la révision en mode Manual ou pour obtenir une re-révision immédiate dans d'autres modes.

138 12 

139| Commande | Ce qu'elle fait |13<img src="https://mintcdn.com/claude-code/gLJVaPQEgKC8ZyUD/images/code-review-pipeline.svg?fit=max&auto=format&n=gLJVaPQEgKC8ZyUD&q=85&s=0351c96df9efa3105172eb00a672f130" className="dark:hidden" alt="Diagramme d'une revue en quatre étapes. Une pull request sur GitHub est transmise à plusieurs agents qui effectuent des recherches en parallèle sur l'infrastructure Anthropic. Une étape de vérification élimine les faux positifs, les résultats restants sont dédupliqués et classés par gravité, et la revue publie des commentaires en ligne, un résumé et une exécution de vérification sur GitHub." width="760" height="300" data-path="images/code-review-pipeline.svg" />

140| :- | :- |

141| `@claude review` | Démarre une seule révision sans abonner la PR aux pushes futurs |

142| `@claude review always` | Démarre une révision et abonne la PR aux révisions déclenchées par push à partir de maintenant |

143| `@claude review once` | Identique à `@claude review` : démarre une seule révision sans abonner |

144 14 

145Utilisez `@claude review always` quand vous souhaitez que chaque push ultérieur vers la PR démarre une révision complète, par exemple sur une PR hautement prioritaire dans un référentiel défini en mode Manual. Comme la commande simple n'abonne pas la PR, vous pouvez demander un deuxième avis ponctuel sans modifier si les pushes ultérieurs déclenchent des révisions.15<img src="https://mintcdn.com/claude-code/gLJVaPQEgKC8ZyUD/images/code-review-pipeline-dark.svg?fit=max&auto=format&n=gLJVaPQEgKC8ZyUD&q=85&s=9cf26bde98f4e999d0d9ff5bf5bdff40" className="hidden dark:block" alt="Diagramme d'une revue en quatre étapes. Une pull request sur GitHub est transmise à plusieurs agents qui effectuent des recherches en parallèle sur l'infrastructure Anthropic. Une étape de vérification élimine les faux positifs, les résultats restants sont dédupliqués et classés par gravité, et la revue publie des commentaires en ligne, un résumé et une exécution de vérification sur GitHub." width="760" height="300" data-path="images/code-review-pipeline-dark.svg" />

146 16 

147<Note>17<Note>

148 Avant une mise à jour de juillet 2026, `@claude review` abonnait la PR aux révisions déclenchées par push. Si vous aviez compté sur ce comportement, commentez `@claude review always` à la place. `@claude review once` fonctionne toujours et se comporte de la même manière que la commande simple.18 Code Review utilise l'IA pour effectuer la revue du code et peut manquer des bugs, des vulnérabilités de sécurité ou d'autres problèmes. Une revue sans résultat ne signifie pas que votre code est exempt d'erreurs ou sécurisé.

149</Note>19</Note>

150 20 

151Pour que l'une de ces commandes déclenche une révision :21<span id="review-a-diff-locally" />

152 

153* Publiez-la comme un commentaire PR de haut niveau, pas un commentaire en ligne sur une ligne de diff

154* Mettez la commande au début du commentaire, avec `once` ou `always` sur la même ligne que le reste de la commande

155* Vous devez avoir un accès en écriture, maintenance ou administrateur au référentiel

156* La PR doit être ouverte

157 

158Contrairement aux déclencheurs automatiques, les déclencheurs manuels s'exécutent sur les PR brouillon, car une demande explicite signale que vous souhaitez la révision maintenant quel que soit le statut de brouillon.

159 

160Si une révision s'exécute déjà sur cette PR, la demande est mise en file d'attente jusqu'à ce que la révision en cours se termine. Vous pouvez surveiller la progression via l'exécution de vérification sur la PR.

161 

162<h3 id="review-pull-requests-from-forks">

163 Réviser les demandes de tirage à partir de forks

164</h3>

165 

166Claude ne révise pas une demande de tirage à partir d'un fork automatiquement, quel que soit le paramètre **Review Behavior** du référentiel. Pour en démarrer une, commentez `@claude review` sur la demande de tirage. Les [exigences pour les commandes de commentaire](#manually-trigger-reviews) s'appliquent toujours, et l'accès en écriture dont vous avez besoin est au référentiel de base, pas au fork.

167 22 

168Pour obtenir une autre révision d'une demande de tirage fork, publiez un nouveau commentaire `@claude review`. `@claude review always` fonctionne aussi, mais n'abonne pas la demande de tirage aux révisions sur les pushes ultérieurs. Rien d'autre qu'une commande de commentaire ne démarre une révision sur une demande de tirage fork :23Pour activer Code Review, un Propriétaire de votre organisation Claude suit la procédure [Configurer Code Review](/docs/fr/code-review-setup). Claude peut également effectuer la revue de code sans ce service. Exécutez [`/code-review`](/docs/fr/code-review-local) dans votre session Claude Code, quel que soit votre plan, ou [comparez toutes les options](#compare-ways-to-get-a-review).

169 24 

170* Cliquer sur **Re-run** sur l'exécution de vérification ne démarre pas une révision25<h2 id="availability">

171* Pousser de nouveaux commits ne démarre pas une révision, même dans un référentiel défini sur **After every push**26 Disponibilité

172 

173<h2 id="customize-reviews">

174 Personnaliser les révisions

175</h2>27</h2>

176 28 

177Code Review lit deux fichiers de votre référentiel pour guider ce qu'il signale. Ils diffèrent dans la force avec laquelle ils influencent la révision :29Vérifiez que votre organisation est éligible avant de configurer Code Review :

178 

179* **`CLAUDE.md`** : instructions de projet partagées que Claude Code utilise pour toutes les tâches, pas seulement les révisions. Code Review le lit comme contexte de projet et signale les violations nouvellement introduites comme des nits.

180* **`REVIEW.md`** : instructions de révision uniquement, données aux agents qui trouvent et vérifient les résultats et consultées par les agents qui classent et rapportent les résultats. Utilisez-le pour dire ce que votre équipe veut signaler, à quelle gravité, et comment les résultats sont rapportés.

181 

182<h3 id="claude-md">

183 CLAUDE.md

184</h3>

185 

186Code Review lit vos fichiers `CLAUDE.md` du référentiel et traite les violations nouvellement introduites comme des [résultats au niveau nit](#severity-levels). Cela fonctionne bidirectionnellement : si votre PR modifie le code d'une manière qui rend une déclaration `CLAUDE.md` obsolète, Claude signale que les docs doivent être mises à jour aussi.

187 

188Claude lit les fichiers `CLAUDE.md` à chaque niveau de votre hiérarchie de répertoires, donc les règles dans le `CLAUDE.md` d'un sous-répertoire s'appliquent uniquement aux fichiers sous ce chemin. Consultez la [documentation de mémoire](/docs/fr/memory) pour plus d'informations sur le fonctionnement de `CLAUDE.md`.

189 30 

190Pour la guidance spécifique à la révision que vous ne souhaitez pas appliquer aux sessions Claude Code générales, utilisez [`REVIEW.md`](#review-md) à la place.31* **Plans** : [Team et Enterprise](/docs/fr/feature-availability)

191 32* **Hébergeurs de code** : dépôts hébergés sur GitHub, y compris [GitHub Enterprise Server](/docs/fr/github-enterprise-server) et GitHub Enterprise Cloud avec résidence des données. Pour la résidence des données, demandez à un Propriétaire de suivre la [configuration administrateur de GitHub Enterprise Server](/docs/fr/github-enterprise-server#admin-setup) et de saisir le nom d'hôte `ghe.com` de votre entreprise.

192<h3 id="review-md">33* **Conservation des données** : Code Review n'est pas disponible pour les organisations ayant activé [Zero Data Retention](/docs/fr/zero-data-retention) ou appliqué la [configuration HIPAA](/docs/fr/hipaa-setup), et n'est pas couvert par le Business Associate Agreement (BAA) d'Anthropic.

193 REVIEW\.md34* **Clés de chiffrement** : Code Review n'est pas encore disponible pour les organisations qui utilisent des clés de chiffrement gérées par le client (CMEK).

194</h3>35* **Fournisseurs cloud** : vous avez besoin d'une organisation Claude sur l'un de ces plans, même si vos développeurs utilisent Claude Code via Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry

195 36 

196`REVIEW.md` est un fichier à la racine de votre référentiel qui adapte Code Review à votre référentiel. Les agents du pipeline de révision qui trouvent et vérifient les résultats reçoivent son contenu comme les instructions de révision de votre référentiel, aux côtés de la guidance de révision par défaut de Code Review, et les agents qui classent et rapportent les résultats le consultent avant de fixer la gravité et d'écrire la révision.37<h2 id="set-up-and-use-code-review">

197 38 Configurer et utiliser Code Review

198Mettez les règles que vous souhaitez appliquer directement dans `REVIEW.md`.

199 

200<h4 id="what-you-can-tune">

201 Ce que vous pouvez affiner

202</h4>

203 

204`REVIEW.md` est du markdown libre, donc tout ce que vous pouvez exprimer comme une instruction de révision est dans le champ d'application. Les modèles ci-dessous ont le plus d'impact en pratique.

205 

206**Gravité** : redéfinissez ce que 🔴 Important signifie pour votre référentiel. L'étalonnage par défaut cible le code de production ; un référentiel de docs, un référentiel de config, ou un prototype pourrait vouloir une définition beaucoup plus étroite. Énoncez explicitement quelles classes de résultats sont Important et lesquelles sont Nit au maximum. Vous pouvez également escalader dans l'autre direction, par exemple en traitant toute violation `CLAUDE.md` comme Important plutôt que le nit par défaut.

207 

208**Volume de nit** : limitez le nombre de commentaires 🟡 Nit qu'une seule révision publie. La prose et les fichiers de config peuvent être polis à jamais. Un plafond comme « signaler au maximum cinq nits, mentionner le reste comme un comptage dans le résumé » garde les révisions actionnables.

209 

210**Règles de saut** : listez les chemins, les modèles de branche et les catégories de résultats où Claude ne devrait publier aucun résultat. Les candidats courants sont le code généré, les lockfiles, les dépendances vendues, et les branches créées par machine, ainsi que tout ce que votre CI applique déjà comme le linting ou la vérification orthographique. Pour les chemins qui méritent une certaine révision mais pas un examen complet, définissez une barre plus élevée au lieu de sauter entièrement : « dans `scripts/`, signaler uniquement si proche de certain et grave. »

211 

212**Vérifications spécifiques au référentiel** : ajoutez des règles que vous souhaitez signaler sur chaque PR, comme « les nouveaux itinéraires API doivent avoir un test d'intégration. » Parce que `REVIEW.md` atteint chaque agent de résultat et de vérification directement, ceux-ci atterrissent plus fiablement que les mêmes règles dans un long `CLAUDE.md`.

213 

214**Barre de vérification** : exigez des preuves avant qu'une classe de résultat soit publiée. Par exemple, « les affirmations de comportement ont besoin d'une citation `file:line` dans la source, pas une inférence à partir de la dénomination » réduit les faux positifs qui coûteraient autrement à l'auteur un aller-retour.

215 

216**Convergence de re-révision** : dites à Claude comment se comporter quand une PR a déjà été révisée. Une règle comme « après la première révision, supprimez les nouveaux nits et publiez les résultats Important uniquement » empêche un correctif d'une ligne d'atteindre la septième manche sur le style seul.

217 

218**Forme du résumé** : demandez au corps de la révision de s'ouvrir avec un comptage d'une ligne comme `2 factual, 4 style`, et de commencer par « aucun problème factuel » quand c'est le cas. L'auteur veut connaître la forme du travail avant les détails.

219 

220<h4 id="example">

221 Exemple

222</h4>

223 

224Ce `REVIEW.md` recalibre la gravité pour un service backend, limite les nits, saute les fichiers générés, et ajoute des vérifications spécifiques au référentiel.

225 

226```markdown theme={null}

227# Instructions de révision

228 

229## Ce que Important signifie ici

230 

231Réservez Important aux résultats qui cassent le comportement, fuient les données,

232ou bloquent un rollback : logique incorrecte, requêtes de base de données non scoped, PII

233dans les logs ou les messages d'erreur, et les migrations qui ne sont pas backward

234compatible. Le style, la dénomination, et les suggestions de refactorisation sont Nit au

235maximum.

236 

237## Limiter les nits

238 

239Signaler au maximum cinq Nits par révision. Si vous en avez trouvé plus, dites « plus N

240éléments similaires » dans le résumé au lieu de les publier en ligne. Si

241tout ce que vous avez trouvé est un Nit, commencez le résumé par « Aucun problème bloquant. »

242 

243## Ne pas signaler

244 

245- Tout ce que CI applique déjà : lint, formatage, erreurs de type

246- Fichiers générés sous `src/gen/` et tout fichier `*.lock`

247- Code de test uniquement qui viole intentionnellement les règles de production

248 

249## Toujours vérifier

250 

251- Les nouveaux itinéraires API ont un test d'intégration

252- Les lignes de log n'incluent pas les adresses e-mail, les ID utilisateur, ou les corps de requête

253- Les requêtes de base de données sont scoped au tenant de l'appelant

254```

255 

256<h4 id="keep-it-focused">

257 Gardez-le concentré

258</h4>

259 

260La longueur a un coût : un long `REVIEW.md` dilue les règles qui importent le plus. Gardez-le aux instructions qui changent le comportement de révision, et laissez le contexte de projet général dans `CLAUDE.md`.

261 

262<h2 id="view-usage">

263 Afficher l'utilisation

264</h2>39</h2>

265 40 

266Allez à [claude.ai/analytics/code-review](https://claude.ai/analytics/code-review) pour voir l'activité Code Review dans votre organisation. Le tableau de bord affiche :41<span id="set-up-code-review" />

267 42 

268| Section | Ce qu'il affiche |43<span id="pricing" />

269| :- | :- |

270| PRs reviewed | Nombre quotidien de pull requests examinées sur la plage de temps sélectionnée |

271| Code Review cost | Dépenses Code Review depuis le début du mois |

272| Feedback | Nombre de commentaires de révision qui ont été auto-résolus parce qu'un développeur a résolu le problème |

273| Repository breakdown | Nombre par dépôt de PR examinées, de commentaires résolus et d'exécutions de revue, avec le coût estimé et une vue par PR |

274 44 

275La carte Code Review cost n'affiche un montant que lorsque le mois en cours est sélectionné. Les chiffres de coût dans les analyses peuvent différer de votre facture. Les coûts de Repository breakdown sont estimés au prix catalogue, avant toute remise ou tout crédit, et ne couvrent que les revues que Claude a publiées sur une pull request. Pour des dépenses conformes à votre facture, consultez votre facture Anthropic.45<span id="manually-trigger-reviews" />

276 46 

277<h2 id="pricing">47<span id="customize-reviews" />

278 Tarification

279</h2>

280 

281Code Review est facturé en fonction de l'utilisation des tokens. Chaque révision coûte en moyenne 15 à 25 dollars, s'adaptant à la taille de la PR, à la complexité de la base de code, et au nombre de problèmes nécessitant une vérification. L'utilisation de Code Review est facturée séparément via [crédits d'utilisation](https://support.claude.com/fr/articles/12429409-extra-usage-for-paid-claude-plans) et ne compte pas par rapport à l'utilisation incluse de votre plan.

282 

283Le déclencheur de révision que vous choisissez affecte le coût total :

284 

285* **Une fois après la création de la PR** : s'exécute une fois par PR

286* **Après chaque push** : s'exécute à chaque push, multipliant le coût par le nombre de pushes

287* **Manuel** : aucune révision sur les PR ouvertes ou les pushes, donc le coût s'accumule uniquement à partir des révisions que quelqu'un demande

288 48 

289En mode Une fois après la création de la PR ou Manuel, commenter `@claude review always` [opte la PR dans les révisions déclenchées par push](#manually-trigger-reviews), de sorte que des coûts supplémentaires s'accumulent par push après ce commentaire. En mode Après chaque push, les pushes déclenchent déjà des révisions, donc l'abonnement ne change pas le coût par push. Commenter `@claude review` exécute une seule révision sans vous abonner à des pushes futurs. Claude révise une [pull request à partir d'une fork](#review-pull-requests-from-forks) uniquement lorsque quelqu'un commente `@claude review`, donc une pull request à partir d'une fork n'accumule jamais de coût par push dans aucun mode.49<span id="troubleshooting" />

290 50 

291Les coûts apparaissent sur votre facture Anthropic quel que soit le fait que votre organisation utilise Amazon Bedrock ou Google Cloud's Agent Platform pour d'autres fonctionnalités Claude Code. Pour définir un plafond de dépenses mensuelles pour Code Review, allez à [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) et configurez la limite pour le service Claude Code Review.51Choisissez la page correspondant à ce que vous souhaitez faire :

292 52 

293Pour surveiller les dépenses, utilisez le [tableau de bord analytics](#view-usage).53<CardGroup cols={2}>

54 <Card title="Configurer Code Review" icon="toggle-on" href="/docs/fr/code-review-setup">

55 Vérifiez les prérequis, installez la GitHub App Claude, et choisissez les dépôts, un niveau de revue et le moment où les revues s'exécutent

56 </Card>

294 57 

295<h2 id="troubleshooting">58 <Card title="Personnaliser Code Review" icon="sliders" href="/docs/fr/code-review-customize">

296 Dépannage59 Ajustez ce qui est signalé grâce aux fichiers `REVIEW.md` et `CLAUDE.md` de votre dépôt

297</h2>60 </Card>

298 

299Les exécutions de révision sont au mieux, et une exécution échouée ne bloque jamais votre PR. Code Review réessaye automatiquement certaines révisions interrompues. Cette section couvre comment exécuter une révision à nouveau vous-même et où chercher quand l'exécution de vérification signale des problèmes que vous ne pouvez pas trouver.

300 61 

301<h3 id="retrigger-a-failed-or-timed-out-review">62 <Card title="Lire et demander des revues sur une pull request" icon="code-pull-request" href="/docs/fr/code-review-pull-requests">

302 Redéclencher une révision échouée ou expirée63 Lisez les résultats et leur gravité, et demandez une nouvelle revue par un commentaire

303</h3>64 </Card>

304 65 

305Quand une révision échoue ou dépasse sa limite de temps, l'exécution de vérification se termine avec un titre tel que **Code review failed** ou **Code review timed out**. La conclusion est toujours neutre, de sorte que rien ne bloque votre fusion. À moins que le résumé de l'exécution de vérification ne dise qu'une nouvelle révision du commit a été mise en file d'attente automatiquement, exécutez la révision à nouveau vous-même.66 <Card title="Dépannage de Code Review" icon="wrench" href="/docs/fr/code-review-troubleshooting">

67 Résolvez le cas d'une revue qui n'a pas démarré, a échoué ou a été ignorée pour raison de budget

68 </Card>

306 69 

307Pour exécuter la révision à nouveau, commentez `@claude review` sur la PR. Cela démarre une révision fraîche sans abonner la PR aux pushes futurs. Si la PR n'est pas [issue d'une fork](#review-pull-requests-from-forks), vous pouvez plutôt cliquer sur **Re-run** sur la vérification **Claude Code Review** dans l'onglet Checks de GitHub. Une réexécution démarre également une révision fraîche sans abonner la PR.70 <Card title="Coûts et utilisation de Code Review" icon="chart-line" href="/docs/fr/code-review-costs">

71 Découvrez comment les revues sont facturées, estimez les dépenses, définissez la limite de dépenses mensuelles et suivez l'activité des revues

72 </Card>

73</CardGroup>

308 74 

309<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">75<h2 id="how-reviews-work">

310 La révision ne s'est pas exécutée et la PR affiche un message de budget76 Comment fonctionnent les revues

311</h3>

312 

313Quand le plafond de dépenses mensuelles de votre organisation pour Code Review est atteint ou que son solde de crédits d'utilisation est épuisé, Code Review ignore la révision et publie un seul commentaire sur la PR. Le commentaire et la carte de l'exécution de vérification indiquent tous deux la cause et renvoient vers la page d'administration où un administrateur peut résoudre le problème :

314 

315* **Plafond de dépenses atteint** : les révisions reprennent au début de la prochaine période de facturation, ou immédiatement après qu'un administrateur a augmenté le plafond à [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage)

316* **Crédits d'utilisation épuisés** : les révisions reprennent dès qu'un administrateur ajoute des [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) supplémentaires à [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage)

317 

318<h3 id="find-issues-that-aren’t-showing-as-inline-comments">

319 Trouver les problèmes qui ne s'affichent pas comme des commentaires en ligne

320</h3>

321 

322Si le titre de l'exécution de vérification dit que des problèmes ont été trouvés mais que vous ne voyez pas de commentaires de révision en ligne sur le diff, cherchez dans ces autres emplacements où les résultats sont surfacés :

323 

324* **Check run Details** : cliquez sur **Details** à côté de la vérification Claude Code Review dans l'onglet Checks. Le tableau de gravité liste chaque résultat avec son fichier, sa ligne, et son résumé quel que soit le fait que le commentaire en ligne ait été accepté.

325* **Files changed annotations** : ouvrez l'onglet **Files changed** sur la PR. Les résultats s'affichent comme des annotations attachées directement aux lignes de diff, séparées des commentaires de révision.

326* **Review body** : si vous avez poussé vers la PR pendant qu'une révision s'exécutait, certains résultats peuvent référencer des lignes qui n'existent plus dans le diff actuel. Ceux-ci apparaissent sous un titre **Additional findings** dans le texte du corps de révision plutôt que comme des commentaires en ligne.

327 

328<h2 id="review-a-diff-locally">

329 Révision d'une diff localement

330</h2>77</h2>

331 78 

332La commande [`/code-review`](/docs/fr/commands) effectue la revue d'un diff dans votre terminal sans installer l'application GitHub. Elle signale les bugs de correction. Selon votre modèle et votre niveau d'effort, la revue couvre également la réutilisation, la simplification et les nettoyages d'efficacité.79<span id="what-code-review-checks" />

333 80 

334`/review` est un alias de `/code-review` ; avant v2.1.223, c'était une commande séparée qui exécutait une révision en une seule passe, en lecture seule, d'une demande de tirage GitHub.81Par défaut, Code Review se concentre sur la correction : les bugs qui casseraient la production, et non les préférences de formatage ou la couverture de test manquante. Pour modifier ce qu'il signale, [ajoutez des fichiers de consignes](/docs/fr/code-review-customize) à votre dépôt.

335 82 

336<Steps>83Une revue s'exécute sur l'infrastructure Anthropic en quatre étapes :

337 <Step title="Exécuter /code-review">

338 À partir de la session où vous travaillez, exécutez la commande :

339 84 

340 ```text theme={null}851. **Recherche** : plusieurs agents examinent le diff et le code environnant en parallèle.

341 /code-review862. **Vérification** : une étape de vérification confronte les résultats candidats au code et élimine les faux positifs.

342 ```873. **Classement** : les résultats restants sont dédupliqués et classés par gravité.

884. **Publication** : la revue publie ses résultats sur la pull request.

343 89 

344 Elle examine les commits de votre branche en avance sur son amont plus les modifications non validées, elle a donc besoin de travail sur la branche ou dans l'arborescence de travail pour avoir quelque chose à signaler. Pour examiner quelque chose d'autre, passez une cible : un chemin de fichier, un numéro de PR, un nom de branche, ou une plage de références telle que `main...my-feature`.90Chaque revue laisse les éléments suivants sur la pull request :

345 91 

346 Vous pouvez également ajouter des drapeaux :92* **Résultats** : des commentaires en ligne sur les lignes concernées, avec un résumé dans le corps de la revue

93* **Une exécution de vérification** : nommée **Claude Code Review**, avec les résultats listés dans ses [détails](/docs/fr/code-review-pull-requests#check-run-output). L'exécution de vérification ne se conclut jamais par un échec.

94* **Lorsqu'elle ne trouve rien** : le titre de l'exécution de vérification indique **Code review found no issues**, et Claude publie la même courte note sur la pull request

347 95 

348 * `--fix` : applique les résultats à votre arborescence de travail après la revue96Code Review choisit les modèles Claude sur lesquels s'exécutent les revues, et ses paramètres d'administration ne proposent pas de choix de modèle. Pour rendre les revues plus ou moins approfondies, modifiez le [niveau de revue](#review-levels).

349 * `--comment` : publie les résultats sous forme de commentaires en ligne sur une pull request GitHub, ou sous forme de note unique sur une merge request GitLab

350 * `--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 ; voir [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

351 * `--max-findings <n>`, `--max-findings all` ou `--max-findings default` : signale jusqu'à `n` résultats, ou tous les résultats avec `all`, à la place de la limite habituelle de la revue. Les revues ultérieures réutilisent la valeur que vous avez saisie jusqu'à ce que vous passiez `--max-findings default`. Nécessite Claude Code v2.1.288 ou ultérieur

352 97 

353 Quand vous passez `--comment` pour une demande de fusion GitLab, Claude Code publie les résultats via l'interface de ligne de commande `glab` de GitLab. Nécessite Claude Code v2.1.257 ou ultérieur. Quand `glab` n'est pas installé, Claude imprime les résultats dans le terminal à la place.98Une fois qu'un Propriétaire a activé Code Review, chaque dépôt dispose d'un paramètre définissant [quand les revues s'exécutent](/docs/fr/code-review-setup#set-when-reviews-run) : une fois à l'ouverture d'une pull request, après chaque push, ou uniquement sur demande. Quel que soit ce paramètre, une personne disposant d'un accès en écriture au dépôt peut commenter `@claude review` sur une pull request pour [démarrer une revue](/docs/fr/code-review-pull-requests#comment-commands).

354 99 

355 Passez la demande de fusion comme son URL ou une référence `!123`. Claude Code traite un nombre nu ou un nom de branche comme une demande de fusion uniquement quand l'extraction d'origine est sur `gitlab.com`. Sur une instance GitLab auto-gérée, passez l'URL ou la forme `!123`.100<h3 id="review-levels">

356 </Step>101 Niveaux de revue

357 

358 <Step title="Continuer à travailler">

359 La révision 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 quand la révision se termine.

360 </Step>

361 

362 <Step title="Agir sur les résultats">

363 Demandez à Claude de corriger ce que la révision a trouvé. Si vous avez passé `--fix` ou `--comment`, la révision a déjà appliqué ou publié ses résultats.

364 </Step>

365</Steps>

366 

367Claude signale les résultats sous forme de texte dans la réponse dans ces deux exécutions, même quand une application hôte demande une liste des résultats :

368 

369* Dans une session de terminal, où `/code-review` exécute la révision en tant que [sous-agent forké](/docs/fr/skills#run-skills-in-a-subagent)

370* Dans une exécution `-p` avec sortie texte ou JSON

371 

372Dans une application hôte qui demande la liste des résultats, comme l'[application de bureau](/docs/fr/desktop#review-your-code), Claude signale plutôt les résultats de la revue via l'[outil `ReportFindings`](/docs/fr/tools-reference). Claude Code affiche le rapport sous forme de liste des résultats, et chaque entrée affiche l'emplacement du fichier, un résumé d'une phrase et une balise de catégorie telle que `correctness` quand le résultat en porte une. Une demande de l'hôte s'applique à chaque niveau d'effort et nécessite Claude Code v2.1.218 ou ultérieur.

373 

374Quand Claude corrige les résultats signalés plus tard dans la session, il les signale à nouveau, et Claude Code marque chaque résultat dans la liste des résultats mise à jour comme corrigé, ignoré, ou aucun changement nécessaire.

375 

376<h3 id="what-the-review-reads-and-edits">

377 Ce que la révision lit et édite

378</h3>102</h3>

379 103 

380La révision suit votre `CLAUDE.md` comme n'importe quelle session Claude Code, mais elle ne lit pas [`REVIEW.md`](#review-md). Une révision en arrière-plan applique ses édits `--fix` en dehors des [points de contrôle](/docs/fr/checkpointing#subagent-edits-not-restored) de votre session, donc `/rewind` ne les annule pas ; utilisez git pour les annuler. Quand la révision [s'exécute au premier plan](#run-in-the-foreground), elle édite votre arborescence de travail pendant votre propre tour, donc `/rewind` restaure ses édits comme d'habitude.104Le niveau de revue définit le degré d'approfondissement de chaque revue, et une revue plus approfondie coûte plus cher :

381 105 

382<h3 id="tune-effort-and-arguments">106* **Quick** : une passe plus légère. Le niveau le plus rapide, au coût le plus bas.

383 Ajuster l'effort et les arguments107* **Standard** : un équilibre entre profondeur, rapidité et coût. Le niveau par défaut.

384</h3>108* **Deep** : la passe la plus approfondie. La plus longue et la plus coûteuse.

385 109 

386Passez un [niveau d'effort](/docs/fr/model-config#adjust-effort-level) pour échanger la couverture contre la confiance. À `low`, la revue signale les résultats dont elle est la plus sûre, vous voyez donc moins de faux positifs. De `medium` à `max`, la revue élargit la couverture.110Un Propriétaire [choisit un niveau pour l'organisation](/docs/fr/code-review-setup#set-the-default-review-level) et peut attribuer à un dépôt particulier son propre niveau, par exemple Quick pour une base de code courante et Deep pour une base de code critique. Pour connaître les autres facteurs qui déterminent le coût de chaque revue, consultez [Coûts et utilisation de Code Review](/docs/fr/code-review-costs).

387 111 

388Quand vous ne tapez pas de niveau, la révision réutilise le dernier niveau de `low` à `max` que vous avez tapé, même dans une session antérieure, et Claude Code affiche un avis tel que `Reusing high effort, the level you typed last time`. Tapez un niveau, comme `/code-review high`, pour changer ce que les exécutions ultérieures réutilisent ; un niveau que vous passez dans une exécution `-p` non interactive ne le met pas à jour. `ultra` ne met à jour ni n'utilise le niveau mémorisé. Si vous n'avez jamais tapé de niveau, la révision utilise l'effort actuel de la session. Avant v2.1.223, un `/code-review` sans niveau utilisait toujours l'effort actuel de la session.112<h3 id="what-a-review-can-access">

389 113 Ce à quoi une revue peut accéder

390Après le niveau d'effort et les drapeaux, Claude Code lit le reste de la ligne de l'une de deux façons :

391 

392* **Sans `ultra`** : tout ce qui reste est la cible de révision, même quand cela commence par un autre nom de commande. `/code-review /fix-issue 123` examine avec `/fix-issue 123` comme texte cible au lieu de charger `/fix-issue` comme une deuxième [compétence empilée](/docs/fr/skills#pass-arguments-to-skills). Avant v2.1.218, une commande empilée après `/code-review` s'étendait comme sa propre compétence.

393* **Avec `ultra`** : Claude Code lit un seul mot comme une branche de base ou un numéro de PR, et transforme le texte plus long qui ne nomme pas une branche ou une PR en [une note attachée à la révision](/docs/fr/ultrareview#pass-a-request-in-plain-words). `/code-review ultra check my auth changes` examine votre branche actuelle, et Claude relie les résultats à votre note.

394 

395<h3 id="run-in-the-foreground">

396 Exécuter au premier plan

397</h3>114</h3>

398 115 

399La révision s'exécute en arrière-plan par défaut ; avant v2.1.218, elle s'exécutait dans votre conversation. Elle s'exécute au premier plan à la place dans des cas comme ceux-ci :116Une revue accède à votre dépôt via la GitHub App Claude qu'un Propriétaire [installe lors de la configuration](/docs/fr/code-review-setup#turn-on-code-review) :

400 117 

401* Vous exécutez `/code-review` à nouveau alors qu'une révision antérieure est toujours en cours118* **Où elle s'exécute** : sur l'infrastructure Anthropic, dans un environnement géré. Les revues ne s'exécutent pas dans des [environnements auto-hébergés](/docs/fr/self-hosted-environments).

402* Vous l'exécutez 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)119* **Ce qu'elle lit et écrit** : pendant une revue, l'accès à votre dépôt est en lecture seule, et une revue ne pousse aucun commit. Sur la pull request, elle publie des commentaires et l'[exécution de vérification](/docs/fr/code-review-pull-requests#check-run-output), résout ses propres fils de commentaires antérieurs et peut réagir à une commande de commentaire avec 👀. L'application elle-même détient un [ensemble de permissions plus large](/docs/fr/github-actions#github-app-permissions) partagé avec d'autres fonctionnalités Claude.

403* Vous définissez [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/fr/env-vars) à `1`, ce qui désactive également toute autre fonctionnalité de tâche en arrière-plan120* **Comment elle examine votre code** : une revue se base sur la lecture du diff et du code environnant, sans compiler ni exécuter votre code.

404 121 

405<h3 id="let-claude-start-the-review">122<h3 id="who-controls-a-review">

406 Laisser Claude démarrer la révision123 Qui contrôle une revue

407</h3>124</h3>

408 125 

409Claude peut démarrer `/code-review` de lui-même. Demandez-lui d'examiner vos modifications en langage naturel et il peut exécuter la compétence sans que vous tapiez la commande, et une [tâche programmée](/docs/fr/scheduled-tasks) avec `/code-review` comme invite exécute la révision.126* **Qui peut en démarrer une** : là où les revues s'exécutent automatiquement, l'ouverture d'une pull request ou un push vers celle-ci démarre une revue, [sauf pour les brouillons et les forks](/docs/fr/code-review-pull-requests#review-drafts-and-pull-requests-from-forks). Une [commande de commentaire](/docs/fr/code-review-pull-requests#comment-commands) n'en démarre une que lorsqu'elle provient d'une personne disposant d'un accès en écriture au dépôt.

410 127* **Quelles instructions elle suit** : `REVIEW.md` issu de la branche de base ou de la branche par défaut, et [jamais des modifications de la pull request elle-même](/docs/fr/code-review-customize#which-branch-review-md-is-read-from).

411Une tâche programmée ne lance jamais la [révision en cloud](#escalate-to-ultrareview), donc programmez `/code-review` sans l'argument `ultra`.

412 128 

413Pour empêcher Claude et les tâches programmées de démarrer la révision tout en gardant `/code-review` disponible pour que vous la tapiez, 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` :129<h2 id="compare-ways-to-get-a-review">

414 130 Comparer les façons d'obtenir une revue

415```json theme={null}131</h2>

416{

417 "skillOverrides": {

418 "code-review": "user-invocable-only"

419 }

420}

421```

422 

423Avant v2.1.246, Claude démarrait `/code-review` de lui-même uniquement où un drapeau de fonctionnalité récupéré d'Anthropic l'activait. Dans les [sessions qui ne récupèrent pas les drapeaux de fonctionnalité](/docs/fr/env-vars#features-that-need-feature-flag-fetching), `/code-review` s'exécutait uniquement quand vous le tapiez, et une `/code-review` programmée arrivait à Claude sous forme de texte brut.

424 

425<h3 id="escalate-to-ultrareview">

426 Escalader vers ultrareview

427</h3>

428 

429`/code-review ultra --fix` exécute la [ultrareview](/docs/fr/ultrareview) plus profonde dans le cloud, puis applique ses résultats à votre arborescence de travail quand ils reviennent dans votre session.

430 

431Ultrareview utilise sa propre portée : votre branche actuelle par rapport à la branche par défaut du référentiel, plus les modifications non validées et mises en scène dans l'arborescence de travail. Pour les modifications non validées des fichiers nommés comme des identifiants ou des clés, tels que les fichiers `.env` et `*.tfvars`, Claude Code suit les règles pour [télécharger un référentiel local vers une session en cloud](/docs/fr/claude-code-on-the-web#send-local-repositories-without-github). Passez un nom de branche, tel que `/code-review ultra develop`, pour comparer par rapport à une base différente.

432 

433Quand la cible est une demande de tirage `github.com`, vous pouvez faire en sorte que Claude [publie les résultats terminés à la PR](/docs/fr/ultrareview#post-findings-to-the-pull-request) en tant que commentaire depuis votre compte GitHub. Nécessite Claude Code v2.1.227 ou ultérieur.

434 

435<Note>

436 Ultrareview nécessite une authentification avec un compte claude.ai et n'est pas disponible sur Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, ni pour les organisations ayant activé Zero Data Retention ou appliqué la [configuration HIPAA](/docs/fr/hipaa-setup). Quand ultrareview n'est pas disponible, `/code-review ultra` exécute une revue locale dans votre session à la place.

437</Note>

438 132 

439Pour 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.133Pour trouver les options qui s'offrent à vous, comparez la colonne **Qui peut l'utiliser** avec votre plan et votre hébergeur de code :

440 134 

441La commande s'appelait `/simplify` avant v2.1.147, quand elle appliquait les correctifs par défaut. `/simplify` exécute une révision de nettoyage séparé qui applique les correctifs sans rechercher les bugs. Si vous avez écrit un script `/simplify` pour la recherche de bugs, passez à `/code-review --fix`.135| Option | Ce qui démarre une revue | Où elle s'exécute | Qui peut l'utiliser |

136| :- | :- | :- | :- |

137| [Code Review](#how-reviews-work) | L'activité de la pull request, selon le paramétrage de chaque dépôt, ou un commentaire `@claude review` | Infrastructure Anthropic | Organisations sur un plan Team ou Enterprise avec des dépôts GitHub, une fois qu'un Propriétaire l'a activé |

138| [`/code-review`](/docs/fr/code-review-local) | Vous exécutez la commande sur votre branche | Votre session Claude Code | Tout le monde, sur n'importe quel plan |

139| [Ultrareview](/docs/fr/ultrareview) | Vous la démarrez depuis Claude Code | Un sandbox cloud | Nécessite une connexion avec un compte claude.ai. Consultez [Ultrareview](/docs/fr/ultrareview) pour savoir où elle n'est pas disponible |

140| Claude dans votre propre CI, avec [GitHub Actions](/docs/fr/github-actions) ou [GitLab CI/CD](/docs/fr/gitlab-ci-cd) | Les événements de votre pipeline, comme chaque pull request ou merge request | Vos propres runners CI | Toute personne disposant d'une clé API Claude ou d'identifiants d'un fournisseur cloud, sur GitHub ou GitLab |

141| Votre propre réviseur, sous forme de [sous-agent](/docs/fr/sub-agents) ou de [skill](/docs/fr/skills) | Vous ou Claude l'invoquez pendant une session | Partout où vous exécutez Claude Code | Toute personne qui en écrit un |

442 142 

443<h2 id="related-resources">143<h2 id="related-resources">

444 Ressources connexes144 Ressources connexes

445</h2>145</h2>

446 146 

447* [Commandes](/docs/fr/commands) : exécutez `/code-review` dans une session Claude Code locale pour vérifier une diff avant de pousser147* [GitHub Enterprise Server](/docs/fr/github-enterprise-server) : utilisez Code Review avec une instance GitHub auto-hébergée

448* [GitHub Actions](/docs/fr/github-actions) : exécutez Claude dans vos propres flux de travail GitHub Actions pour une automatisation personnalisée au-delà de la révision de code148* [Permissions de GitHub App](/docs/fr/github-actions#github-app-permissions) : l'ensemble complet des permissions demandées par la GitHub App Claude

449* [GitLab CI/CD](/docs/fr/gitlab-ci-cd) : intégration Claude auto-hébergée pour les pipelines GitLab149* [How Anthropic secures its AI-native software development lifecycle](https://claude.com/blog/how-anthropic-secures-its-ai-native-software-development-lifecycle) : comment la revue automatisée s'inscrit comme une couche du processus de développement sécurisé d'Anthropic

450* [Memory](/docs/fr/memory) : comment les fichiers `CLAUDE.md` fonctionnent dans Claude Code

451* [Analytics](/docs/fr/analytics) : suivez l'utilisation de Claude Code au-delà de la révision de code

452* [How Anthropic secures its AI-native software development lifecycle](https://claude.com/blog/how-anthropic-secures-its-ai-native-software-development-lifecycle) : comment la révision automatisée s'inscrit comme une couche du processus de développement sécurisé d'Anthropic

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Coûts et utilisation de Code Review

6 

7> Estimez et plafonnez les dépenses de votre organisation pour Claude Code Review : comment les revues sont facturées via les crédits d'utilisation, ce qui détermine les coûts et où suivre l'utilisation.

8 

9[Code Review](/docs/fr/code-review) n'a pas de prix fixe par revue. Vos dépenses dépendent du coût de chaque revue et du nombre de revues exécutées :

10 

11* **Coût de chaque revue** : varie selon le [niveau de revue](/docs/fr/code-review-setup#set-the-default-review-level), la taille de la modification, la complexité du code environnant et le nombre de problèmes potentiels à vérifier

12* **Nombre de revues** : déterminé par [la fréquence d'exécution des revues](#how-often-reviews-run) dans chaque dépôt

13 

14<h2 id="pricing">

15 Tarification

16</h2>

17 

18Code Review est facturé en fonction de l'utilisation de tokens via les [crédits d'utilisation](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans), séparément de l'utilisation incluse dans votre forfait. Les revues sont facturées à votre organisation, et non au développeur qui a ouvert la PR ou demandé la revue. Les coûts apparaissent sur votre facture Anthropic, que votre organisation utilise ou non Amazon Bedrock, Agent Platform de Google Cloud ou Microsoft Foundry pour d'autres fonctionnalités de Claude Code.

19 

20<h3 id="how-often-reviews-run">

21 Fréquence d'exécution des revues

22</h3>

23 

24Un dépôt que vous ajoutez depuis la page d'administration démarre avec **After every push**, le mode qui exécute le plus de revues. Le [paramètre **Review runs**](/docs/fr/code-review-setup#set-when-reviews-run) de chaque dépôt détermine le nombre de revues que reçoit une pull request :

25 

26* **Once after PR creation** : une revue s'exécute lorsque la pull request est ouverte, rouverte ou marquée comme prête pour la revue

27* **After every push** : s'exécute à chaque push, ce qui multiplie le coût par le nombre de pushs

28* **Manual (@claude review)** : aucune revue à l'ouverture ou au push

29 

30Les commandes en commentaire, les brouillons et les pull requests provenant de forks modifient ces décomptes :

31 

32* **`@claude review always` en mode Once after PR creation ou Manual** : [inscrit la PR aux revues déclenchées par push](/docs/fr/code-review-pull-requests#comment-commands), de sorte qu'un coût supplémentaire s'accumule à chaque push après ce commentaire

33* **`@claude review always` en mode After every push** : les pushs déclenchent déjà des revues, donc l'abonnement ne modifie pas le coût par push

34* **`@claude review`** : exécute une seule revue sans s'abonner aux pushs futurs

35* **Brouillons et pull requests provenant de forks** : [les revues automatiques ignorent les deux](/docs/fr/code-review-pull-requests#review-drafts-and-pull-requests-from-forks), de sorte que les pushs vers ceux-ci n'ajoutent pas de revues

36 

37<h2 id="estimate-your-spend">

38 Estimer vos dépenses

39</h2>

40 

41Avant un déploiement à grande échelle, menez un petit pilote pour estimer les dépenses mensuelles à partir de vos propres pull requests.

42 

431. Définissez une [limite de dépenses mensuelle](#limit-your-spend) pour le pilote.

442. Activez Code Review pour quelques dépôts représentatifs avec **Review runs** défini sur **Once after PR creation** ou **Manual (@claude review)**.

453. Une fois plusieurs revues exécutées, consultez le coût moyen par revue de chaque dépôt dans la colonne **Average cost** du tableau **Repositories**, dans la section **Code review** de [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review).

464. Multipliez cette moyenne par le nombre de pull requests ouvertes dans le dépôt en un mois. Pour **After every push**, multipliez à nouveau par le nombre habituel de pushs par pull request.

47 

48La moyenne d'un dépôt évolue avec la taille de ses pull requests et le niveau de revue que vous choisissez.

49 

50<h2 id="limit-your-spend">

51 Limiter vos dépenses

52</h2>

53 

54Pour définir une limite de dépenses mensuelle pour Code Review, accédez à [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) et configurez la limite pour le service Claude Code Review. La limite s'applique à l'ensemble de l'organisation.

55 

56Code Review ignore les revues lorsque l'un des éléments suivants est épuisé :

57 

58* **Limite de dépenses de Code Review** : la limite mensuelle que vous définissez pour le service Claude Code Review. Elle est réinitialisée au début de la période de facturation suivante, et les revues reprennent plus tôt si vous l'augmentez.

59* **Limite de dépenses de l'organisation** : la limite de dépenses mensuelle globale de votre organisation pour les crédits d'utilisation. Augmentez-la sur la même page.

60* **Solde des crédits d'utilisation** : le solde des crédits d'utilisation de votre organisation. Ajoutez des crédits sur la même page.

61 

62Code Review ignore également les revues dès que le montant restant est inférieur au coût estimé d'une revue. Lorsqu'une revue est ignorée, les développeurs voient un [commentaire sur la PR](/docs/fr/code-review-troubleshooting#review-didn’t-run-and-the-pr-shows-a-budget-message) qui en indique la cause et renvoie vers les paramètres d'utilisation.

63 

64Pour surveiller les dépenses, utilisez le [tableau de bord analytique](#view-usage).

65 

66<h2 id="view-usage">

67 Consulter l'utilisation

68</h2>

69 

70Accédez à [claude.ai/analytics/code-review](https://claude.ai/analytics/code-review) pour voir l'activité de Code Review dans toute votre organisation.

71 

72| Section | Ce qu'elle affiche |

73| :- | :- |

74| PRs reviewed | Nombre quotidien de pull requests ayant fait l'objet d'une revue sur la période sélectionnée |

75| Code Review cost | Dépenses de Code Review depuis le début du mois |

76| Feedback | Nombre de commentaires de revue résolus automatiquement parce qu'un développeur a corrigé le problème |

77| Repository breakdown | Nombre par dépôt de PR ayant fait l'objet d'une revue, de commentaires résolus et d'exécutions de revue, avec le coût estimé et une vue par PR |

78 

79La carte Code Review cost n'affiche un montant que lorsque le mois en cours est sélectionné. Les montants affichés dans les analyses peuvent différer de votre facture. Les coûts de Repository breakdown sont estimés au prix catalogue, avant toute remise ou tout crédit, et ne couvrent que les revues que Claude a publiées sur une pull request. Pour connaître les dépenses exactes facturées, consultez votre facture Anthropic.

80 

81<h2 id="related-resources">

82 Ressources associées

83</h2>

84 

85* [Configurer Code Review](/docs/fr/code-review-setup) : où choisir le niveau de revue et le moment d'exécution des revues dans chaque dépôt

86* [Lire et demander des revues sur une pull request](/docs/fr/code-review-pull-requests) : les commandes en commentaire, les pull requests provenant de forks et le message de budget que voient les développeurs lorsqu'une revue est ignorée

87* [Code Review](/docs/fr/code-review) : ce qu'une revue vérifie et ce qu'elle publie

88* [Gérer efficacement les coûts](/docs/fr/costs) : contrôles des dépenses et suivi de l'utilisation pour le reste de Claude Code

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Personnaliser Code Review

6 

7> Ajustez ce que Code Review signale sur vos pull requests avec REVIEW.md et CLAUDE.md : recalibrez la sévérité, ignorez des chemins, ajoutez des vérifications et identifiez quelle copie s'applique.

8 

9Vous pouvez modifier ce que [Code Review](/docs/fr/code-review) signale sur votre dépôt en y committant des instructions. C'est ainsi que vous réduisez le volume de nits, mettez fin aux commentaires sur les fichiers générés ou ajoutez une règle qui compte pour votre équipe. Placez-les dans l'un de ces deux fichiers :

10 

11* **`CLAUDE.md`** : des [instructions de projet](/docs/fr/memory) que Claude Code lit pour chaque tâche, revues comprises. Code Review les lit comme contexte de projet et signale les modifications qui les enfreignent.

12* **`REVIEW.md`** : des instructions réservées aux revues. Utilisez-le pour indiquer ce que votre équipe souhaite voir signalé, à quel niveau de sévérité, et ce qu'il faut ignorer.

13 

14Ajoutez `REVIEW.md` à la racine de votre dépôt et fusionnez-le. Ensuite, [protégez votre branche par défaut](#which-branch-review-md-is-read-from).

15 

16<Note>

17 Pour modifier le niveau de détail des revues ou le moment où elles s'exécutent, demandez à un Owner de modifier le [niveau de revue](/docs/fr/code-review-setup#set-the-default-review-level) ou le [paramètre **Review runs**](/docs/fr/code-review-setup#set-when-reviews-run).

18</Note>

19 

20<h2 id="use-claude-md-for-project-wide-rules">

21 Utiliser CLAUDE.md pour les règles à l'échelle du projet

22</h2>

23 

24Code Review lit les fichiers `CLAUDE.md` de votre dépôt comme contexte de projet. Une modification qui enfreint l'une de leurs règles devient un résultat au [niveau de sévérité](/docs/fr/code-review-pull-requests#severity-levels) adapté au problème.

25 

26Une revue lit le fichier `CLAUDE.md` à la racine de votre dépôt ainsi que les fichiers `CLAUDE.md` des répertoires parents de chaque fichier modifié. Le fichier `CLAUDE.md` d'un sous-répertoire est lu lorsque la pull request modifie un fichier sous ce chemin.

27 

28<h2 id="use-review-md-for-review-only-rules">

29 Utiliser REVIEW\.md pour les règles propres aux revues

30</h2>

31 

32`REVIEW.md` est un fichier situé à la racine de votre dépôt qui adapte Code Review à votre dépôt. Vous pouvez également ajouter un `REVIEW.md` dans un sous-répertoire pour ajouter des vérifications sur les modifications sous ce chemin, en plus du fichier racine.

33 

34Les agents qui détectent les problèmes et les agents qui les vérifient reçoivent son contenu en tant qu'instructions de revue de votre dépôt, en complément des consignes de revue par défaut de Code Review. L'étape qui rédige la revue finale le consulte avant de fixer la sévérité et de rédiger le résumé.

35 

36Cet exemple d'arborescence comporte un fichier racine et un fichier de sous-répertoire :

37 

38```text theme={null}

39your-repo/

40├── REVIEW.md # Root file

41├── services/

42│ └── billing/

43│ └── REVIEW.md # Adds checks for changes under services/billing/

44└── src/

45```

46 

47Avant de vous appuyer sur un fichier de sous-répertoire, protégez votre branche par défaut et vérifiez [ce qu'une revue lit selon la configuration de vos branches](#what-a-review-reads-for-each-branch-setup).

48 

49<Note>

50 Le service Code Review et la [commande `/code-review`](/docs/fr/code-review-local) locale sont deux outils distincts, et ils lisent des fichiers différents. Le service lit à la fois `CLAUDE.md` et `REVIEW.md`. La commande `/code-review`, que vous exécutez dans une session Claude Code sur votre propre machine, lit vos fichiers `CLAUDE.md` mais pas `REVIEW.md`. Placez dans `CLAUDE.md` les consignes que vous souhaitez appliquer aux deux endroits, et réservez `REVIEW.md` aux règles propres à la revue des pull requests.

51</Note>

52 

53<h3 id="example-review-md">

54 Exemple de REVIEW\.md

55</h3>

56 

57Ce `REVIEW.md` recalibre la sévérité pour un service backend, plafonne les nits, ignore les fichiers générés et ajoute des vérifications propres au dépôt.

58 

59```markdown theme={null}

60# Review instructions

61 

62## What Important means here

63 

64Reserve Important for findings that would break behavior, leak data,

65or block a rollback: incorrect logic, unscoped database queries, PII

66in logs or error messages, and migrations that aren't backward

67compatible. Style, naming, and refactoring suggestions are Nit at

68most.

69 

70## Cap the nits

71 

72Report at most five Nits per review.

73 

74## Do not report

75 

76- Anything CI already enforces: lint, formatting, type errors

77- Generated files under `src/gen/` and any `*.lock` file

78- Test-only code that intentionally violates production rules

79 

80## Always check

81 

82- New API routes have an integration test

83- Log lines don't include email addresses, user IDs, or request bodies

84- Database queries are scoped to the caller's tenant

85```

86 

87<h3 id="choose-what-to-write-in-review-md">

88 Choisir ce qu'il faut écrire dans REVIEW\.md

89</h3>

90 

91`REVIEW.md` est un fichier Markdown de forme libre qui modifie ce qu'une revue détecte et signale. Il ne modifie pas le format de la revue. Identifiez le problème que vous rencontrez, puis ajoutez une instruction semblable à celle indiquée. L'[exemple](#example-review-md) utilise les quatre premières.

92 

93* **Les mauvais éléments sont marqués Important** : redéfinissez ce que signifie 🔴 Important pour votre dépôt. Le calibrage par défaut cible le code de production, et un dépôt de documentation, un dépôt de configuration ou un prototype peuvent nécessiter une définition beaucoup plus restreinte. Indiquez quelles catégories de résultats sont Important et lesquelles sont tout au plus Nit. Vous pouvez également faire l'inverse, par exemple en traitant toute violation de `CLAUDE.md` comme Important.

94* **Trop de nits** : plafonnez le nombre de commentaires 🟡 Nit publiés par une même revue. Un plafond comme « signaler au maximum cinq nits » permet de garder des revues exploitables.

95* **Commentaires sur des fichiers générés ou sur ce que la CI vérifie déjà** : listez les chemins et les catégories de résultats pour lesquels Claude doit s'abstenir de signaler quoi que ce soit. Les candidats courants sont le code généré, les fichiers de verrouillage et les dépendances vendorisées, ainsi que tout ce que votre CI applique déjà, comme le linting ou la vérification orthographique. Pour les chemins qui méritent une certaine revue sans examen complet, fixez plutôt un seuil plus élevé : « dans `scripts/`, ne signaler que si c'est quasi certain et grave. »

96* **Une règle d'équipe n'est pas vérifiée** : ajoutez les règles que vous souhaitez voir signalées sur chaque pull request, comme « les nouvelles routes d'API doivent avoir un test d'intégration. »

97* **Des résultats s'avèrent erronés** : exigez des preuves avant qu'une catégorie de résultats soit publiée. Par exemple, « les affirmations sur le comportement nécessitent une citation `file:line` dans le source, et non une déduction à partir du nommage » réduit les faux positifs qui coûteraient sinon un aller-retour à l'auteur.

98 

99Certaines de ces instructions [nécessitent que le fichier racine se trouve sur une branche par défaut protégée](#which-branch-review-md-is-read-from).

100 

101Limitez `REVIEW.md` aux instructions qui modifient le comportement de la revue, et laissez le contexte général du projet dans `CLAUDE.md`.

102 

103<h3 id="which-branch-review-md-is-read-from">

104 Depuis quelle branche REVIEW\.md est lu

105</h3>

106 

107Code Review lit `REVIEW.md` depuis la branche de base de la pull request ou depuis la branche par défaut, jamais depuis les modifications de la pull request elle-même. Pour modifier le comportement de la revue, fusionnez d'abord la modification de `REVIEW.md`.

108 

109Conservez `REVIEW.md` sur votre branche par défaut et protégez cette branche. Lorsqu'une revue lit la copie présente sur une branche par défaut protégée, soit la première ligne du tableau ci-dessous, elle respecte ces instructions du fichier racine :

110 

111* Abaisser la sévérité d'un résultat

112* Exclure des chemins, des fichiers ou des catégories de problèmes

113* Plafonner les commentaires de type nit

114 

115<h4 id="what-counts-as-branch-protection">

116 Ce qui compte comme protection de branche

117</h4>

118 

119Code Review considère ces paramètres comme une protection :

120 

121* **Branche par défaut** : une règle de protection de branche classique ou un ruleset

122* **Toute autre branche** : un ruleset uniquement

123 

124Un ruleset compte lorsqu'il restreint les mises à jour ou exige des pull requests avec au moins une approbation. S'il exige des pull requests, il doit également révoquer cette approbation lors d'un nouveau push ou exiger que l'approbation intervienne après le dernier push.

125 

126<h4 id="what-a-review-reads-for-each-branch-setup">

127 Ce qu'une revue lit selon la configuration des branches

128</h4>

129 

130Trouvez la situation de votre dépôt dans la première colonne du tableau ci-dessous.

131 

132| Protection de branche | Copie lue | Fichiers lus |

133| :- | :- | :- |

134| La branche par défaut est protégée, et la pull request la cible ou cible une branche qu'aucun ruleset ne protège | Branche par défaut | Fichiers racine et de sous-répertoire |

135| La pull request cible une autre branche protégée par un ruleset | Cette branche de base | Fichiers racine et de sous-répertoire |

136| La branche par défaut n'est pas protégée, et la branche de base n'a aucune règle de protection, quel qu'en soit le type | Branche par défaut | Fichier racine |

137| Code Review ne peut pas confirmer les paramètres de protection. Cela inclut une branche par défaut non protégée avec une branche de base qui n'a qu'une règle classique | Aucune | Aucun |

138 

139Si le check run mentionne `REVIEW.md`, consultez [Le check run mentionne REVIEW.md](/docs/fr/code-review-troubleshooting#the-check-run-mentions-review-md).

140 

141<h2 id="related-resources">

142 Ressources associées

143</h2>

144 

145* [Code Review](/docs/fr/code-review) : ce qu'est le service et comment se déroule une revue

146* [Lire et demander des revues sur une pull request](/docs/fr/code-review-pull-requests#severity-levels) : ce que signifie chaque niveau de sévérité et comment les résultats apparaissent

147* [Configurer Code Review](/docs/fr/code-review-setup) : le niveau de revue et le moment où les revues s'exécutent, définis par un Owner

148* [Effectuer une revue en local avec `/code-review`](/docs/fr/code-review-local) : la commande `/code-review`, ses arguments et ses niveaux d'effort

149* [Mémoire](/docs/fr/memory) : comment les fichiers `CLAUDE.md` fonctionnent dans Claude Code

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Effectuer une revue locale avec /code-review

6 

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

8 

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

10 

11La 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.

12 

13<Note>

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

15</Note>

16 

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

18 

19<Steps>

20 <Step title="Exécuter /code-review">

21 Exécutez la commande :

22 

23 ```text theme={null}

24 /code-review

25 ```

26 

27 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).

28 

29 Vous pouvez également ajouter des flags :

30 

31 * `--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).

32 * `--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

33 </Step>

34 

35 <Step title="Continuer à travailler">

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

37 </Step>

38 

39 <Step title="Agir sur les résultats">

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

41 </Step>

42</Steps>

43 

44<h2 id="choose-what-to-review">

45 Choisir ce qu'il faut revoir

46</h2>

47 

48Pour 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 :

49 

50| Pour orienter la revue vers | Tapez |

51| :- | :- |

52| Votre branche actuelle et les modifications non commitées | `/code-review` |

53| Vos 15 derniers commits | `/code-review HEAD~15..HEAD` |

54| Une branche par rapport à une autre | `/code-review main...my-feature` |

55| Un seul commit, où `abc1234` est le hash du commit | `/code-review abc1234^..abc1234` |

56| Une pull request par numéro | `/code-review 1234` |

57| Un chemin de fichier ou de répertoire | `/code-review src/auth` |

58 

59Sans 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.

60 

61Avec `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).

62 

63<h2 id="what-the-review-reads-and-edits">

64 Ce que la revue lit et modifie

65</h2>

66 

67Vérifiez ces points avant de lancer une revue, en particulier avec `--fix` :

68 

69* **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.

70* **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.

71* **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.

72 

73<h2 id="how-findings-are-reported">

74 Comment les résultats sont rapportés

75</h2>

76 

77Claude rapporte les résultats sous forme de texte dans la réponse dans ces deux types d'exécution :

78 

79* 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)

80* Dans une exécution `-p` avec une sortie texte ou JSON

81 

82Dans 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.

83 

84Lorsque 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.

85 

86<h2 id="tune-effort-and-arguments">

87 Ajuster l'effort et les arguments

88</h2>

89 

90Au-delà de `--fix` et `--comment`, la commande accepte ces flags :

91 

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

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

94 

95Passez 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.

96 

97Lorsque 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 :

98 

99* **Taper un niveau** : un niveau que vous tapez, comme `/code-review high`, modifie ce que les exécutions suivantes réutilisent

100* **Exécutions non interactives** : un niveau passé lors d'une exécution non interactive avec `-p` ne met pas à jour le niveau mémorisé

101* **`ultra`** : la revue n'utilise ni ne met à jour le niveau mémorisé

102* **Aucun niveau jamais tapé** : la revue utilise l'effort actuel de la session

103 

104Avant la v2.1.223, un `/code-review` sans niveau utilisait toujours l'effort actuel de la session.

105 

106<h3 id="post-findings-to-a-gitlab-merge-request">

107 Publier les résultats sur une merge request GitLab

108</h3>

109 

110Lorsque 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.

111 

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

113 

114<h3 id="text-after-the-effort-level-and-flags">

115 Texte après le niveau d'effort et les flags

116</h3>

117 

118Aprè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 :

119 

120* **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.

121* **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.

122 

123<h2 id="run-in-the-foreground">

124 Exécuter au premier plan

125</h2>

126 

127Pour que la revue s'exécute au premier plan, effectuez l'une de ces actions :

128 

129* 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).

130* 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

131* Exécutez à nouveau `/code-review` pendant qu'une revue précédente est encore en cours

132 

133Avant la v2.1.218, la revue s'exécutait à l'intérieur de votre conversation.

134 

135<h2 id="let-claude-start-the-review">

136 Laisser Claude lancer la revue

137</h2>

138 

139Claude peut lancer `/code-review` de lui-même, sans que vous ayez à taper la commande :

140 

141* **Lorsque vous le demandez en langage courant** : demandez à Claude de revoir vos modifications et il peut exécuter le skill

142* **Depuis une tâche planifiée** : une [tâche planifiée](/docs/fr/scheduled-tasks) avec `/code-review` comme prompt exécute la revue

143 

144Une tâche planifiée ne lance jamais la [revue cloud](#escalate-to-ultrareview), planifiez donc `/code-review` sans l'argument `ultra`.

145 

146Pour 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` :

147 

148```json theme={null}

149{

150 "skillOverrides": {

151 "code-review": "user-invocable-only"

152 }

153}

154```

155 

156Avant 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.

157 

158<h2 id="escalate-to-ultrareview">

159 Passer à ultrareview

160</h2>

161 

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

163 

164Ultrareview utilise sa propre portée :

165 

166* **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

167* **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)

168* **Une base différente** : passez un nom de branche, par exemple `/code-review ultra develop`, pour effectuer la comparaison avec une base différente

169 

170Lorsque 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.

171 

172<Note>

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

174</Note>

175 

176Pour 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.

177 

178<h2 id="change-or-build-on-the-review">

179 Modifier la revue ou s'appuyer sur elle

180</h2>

181 

182`/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 :

183 

184* **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).

185* **Créer votre propre relecteur** : écrivez un [sous-agent](/docs/fr/sub-agents) de revue ou un [skill](/docs/fr/skills) de revue

186* **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

187 

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

189 

190<h2 id="related-resources">

191 Ressources connexes

192</h2>

193 

194* [Code Review](/docs/fr/code-review) : le service géré qui revoit chaque pull request sur GitHub pour votre organisation

195* [Ultrareview](/docs/fr/ultrareview) : configuration, limites et coût de la revue cloud approfondie

196* [Commandes](/docs/fr/commands) : la référence en une ligne pour `/code-review`, `/review`, `/simplify` et `/verify`

197* [Skills](/docs/fr/skills) : fonctionnement des skills fournis et comment écrire les vôtres

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Lire et demander des revues sur une pull request

6 

7> Lisez les résultats de Code Review sur votre pull request GitHub, répondez-y ou ignorez-les, et demandez une revue avec `@claude review`.

8 

9Code Review est un service géré qu'un Owner de votre organisation Claude active pour un ensemble de dépôts GitHub. Une fois activé, Claude examine les pull requests de ces dépôts et publie ses résultats sous forme de commentaires en ligne, d'un résumé dans le corps de la revue et d'un check run nommé **Claude Code Review**. Une revue n'approuve ni ne bloque jamais votre pull request, et le check run ne se conclut jamais par un échec.

10 

11Un Owner contrôle [quand les revues s'exécutent](/docs/fr/code-review-setup#set-when-reviews-run) et [leur niveau d'exhaustivité](/docs/fr/code-review-setup#set-the-default-review-level) pour chaque dépôt.

12 

13<Note>

14 Si votre forfait n'inclut pas Code Review, vous pouvez tout de même demander à Claude d'examiner votre branche depuis une session Claude Code : consultez [Effectuer une revue locale avec `/code-review`](/docs/fr/code-review-local).

15</Note>

16 

17<h2 id="severity-levels">

18 Niveaux de gravité

19</h2>

20 

21Claude publie chaque résultat sous forme de commentaire en ligne sur les lignes concernées et lui attribue l'un des trois niveaux de gravité suivants :

22 

23| Marqueur | Gravité | Signification |

24| :- | :- | :- |

25| 🔴 | Important | Un bug qui devrait être corrigé avant la fusion |

26| 🟡 | Nit | Un problème mineur, qui mérite d'être corrigé mais n'est pas bloquant |

27| 🟣 | Pre-existing | Un bug qui existe dans la base de code mais qui n'a pas été introduit par cette PR |

28 

29Lorsque la revue a enregistré son raisonnement, le résultat comporte une section repliée **Why this was flagged**. Développez-la pour lire pourquoi Claude a signalé le problème et comment il l'a vérifié.

30 

31Pour modifier ce que Claude signale dans votre dépôt ou la façon dont il classe la gravité, consultez [Personnaliser Code Review](/docs/fr/code-review-customize).

32 

33<h2 id="respond-to-findings">

34 Répondre aux résultats

35</h2>

36 

37Vous pouvez fusionner sans répondre à un résultat, sauf si les règles propres à votre dépôt l'exigent. Si sa protection de branche [exige la résolution des conversations](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches#require-conversation-resolution-before-merging), résolvez le fil de chaque résultat avant de fusionner.

38 

39Pour traiter un résultat, résolvez son fil ou poussez une correction.

40 

41* **L'ignorer sans modifier le code** : résolvez vous-même le fil sur GitHub. Une simple réponse n'ignore pas un résultat.

42* **Corriger le problème** : modifiez le code et poussez. La revue suivante de la pull request résout le fil précédent lorsqu'elle juge le problème corrigé, que cette revue s'exécute automatiquement lors de votre push ou que vous la demandiez.

43* **Expliquer ou contester** : répondez au commentaire. Claude ne répond pas immédiatement, et une réponse ne lance pas de revue. La revue suivante de la pull request lit les réponses à ses résultats précédents, et peut résoudre le fil ou publier une réponse de suivi. Si le même type de résultat revient sans cesse, demandez à un mainteneur d'ajouter une règle à [`REVIEW.md`](/docs/fr/code-review-customize#choose-what-to-write-in-review-md).

44 

45Pour obtenir cette revue suivante sans pousser, publiez `@claude review` en tant que [commentaire de premier niveau sur la pull request](#comment-commands).

46 

47<h2 id="check-run-output">

48 Sortie du check run

49</h2>

50 

51Le lien **Details** du check run **Claude Code Review** ouvre les résultats dans un tableau trié par gravité, y compris tout résultat dont le commentaire en ligne n'a pas été accepté par GitHub :

52 

53| Gravité | Fichier:Ligne | Problème |

54| - | - | - |

55| 🔴 Important | `src/auth/session.ts:142` | Le rafraîchissement du token entre en concurrence avec la déconnexion, laissant des sessions obsolètes actives |

56| 🟡 Nit | `src/auth/session.ts:88` | `parseExpiry` renvoie silencieusement 0 en cas d'entrée mal formée |

57 

58Un résultat associé à une ligne mais qui n'a pas été publié en tant que commentaire en ligne apparaît sous forme d'annotation dans l'onglet **Files changed**, sur les lignes concernées. Les résultats Important s'affichent en rouge, les nits en jaune et les bugs préexistants en gris.

59 

60Le check run se conclut comme neutre, ou comme ignoré lorsqu'une revue automatique ne s'est pas exécutée parce qu'un push n'a modifié aucun fichier. Il ne se conclut jamais par un échec, de sorte qu'une revue terminée ne fait pas échouer une vérification requise. Si vous ne voyez aucun résultat, ou si une revue ne s'est pas exécutée, consultez [Résoudre les problèmes de Code Review](/docs/fr/code-review-troubleshooting).

61 

62<h3 id="read-the-result-from-a-script">

63 Lire le résultat depuis un script

64</h3>

65 

66Pour conditionner une fusion ou publier un résumé depuis votre propre CI, analysez la dernière ligne du texte Details avec `gh` et jq. Cette ligne est un commentaire lisible par machine.

67 

68<Steps>

69 <Step title="Trouver l'ID du check run">

70 Depuis votre shell, listez les check runs du commit et récupérez l'`id` de l'exécution `Claude Code Review`. Remplacez `OWNER` et `REPO` par le propriétaire et le nom de votre dépôt, et `<commit-sha>` par le commit de tête de la pull request :

71 

72 ```bash theme={null}

73 gh api repos/OWNER/REPO/commits/<commit-sha>/check-runs --jq '.check_runs[] | {id, name}'

74 ```

75 </Step>

76 

77 <Step title="Lire les décomptes par gravité">

78 Lisez les décomptes de ce check run, en remplaçant `CHECK_RUN_ID` par l'ID :

79 

80 ```bash theme={null}

81 gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \

82 --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'

83 ```

84 

85 Cette commande affiche un objet JSON contenant un décompte par gravité, avec ses clés dans l'ordre alphabétique, par exemple `{"nit": 1, "normal": 2, "pre_existing": 0}`. Les décomptes incluent les résultats des revues précédentes de la pull request dont les fils sont encore ouverts.

86 </Step>

87 

88 <Step title="Agir en fonction du résultat">

89 Faites en sorte que votre script gère ces cas :

90 

91 * **`normal` est supérieur à zéro** : faites échouer le job si vous souhaitez conditionner la fusion. La clé `normal` contient le nombre de résultats Important : Claude a donc trouvé au moins un bug qui mérite d'être corrigé avant la fusion.

92 * **La ligne est absente** : considérez-la comme une absence de verdict plutôt que comme zéro résultat. Le check run d'une revue qui a échoué, expiré, été annulée ou remplacée par une plus récente ne comporte pas cette ligne, et certaines revues terminées n'en ont pas non plus.

93 </Step>

94</Steps>

95 

96<h2 id="request-a-review">

97 Demander une revue

98</h2>

99 

100Si votre pull request est un brouillon ou provient d'un fork, les revues automatiques l'ignorent : [demandez donc la revue avec une commande de commentaire](#review-drafts-and-pull-requests-from-forks). Pour obtenir une revue sur votre pull request, effectuez l'une des actions suivantes :

101 

102* **L'ouvrir ou la marquer comme prête** : dans un dépôt configuré sur **Once after PR creation** ou **After every push**, une revue démarre lorsque vous ouvrez ou rouvrez la pull request, ou que vous marquez un brouillon comme prêt pour la revue.

103* **Publier une commande en commentaire** : publiez [`@claude review`](#comment-commands) sur la pull request.

104* **Pousser un commit** : un push lance une revue dans un dépôt configuré sur **After every push**, ou sur une pull request que vous avez abonnée avec `@claude review always`.

105* **Cliquer sur Re-run** : après l'échec ou l'expiration d'une revue sur une pull request qui ne provient pas d'un fork, [relancez-la](/docs/fr/code-review-troubleshooting#retrigger-a-failed-or-timed-out-review) depuis le check run.

106* **Attendre la nouvelle tentative automatique** : une revue dont la session a été interrompue est automatiquement réessayée une fois. Le [résumé du check run](/docs/fr/code-review-troubleshooting#retrigger-a-failed-or-timed-out-review) indique quand c'est le cas.

107 

108<h3 id="comment-commands">

109 Commandes de commentaire

110</h3>

111 

112Publiez l'une de ces commandes en commentaire sur la pull request :

113 

114| Commande | Ce qu'elle fait | Quand l'utiliser |

115| :- | :- | :- |

116| `@claude review` | Lance une revue unique sans abonner la PR aux futurs push | Vous voulez une revue maintenant, par exemple sur une pull request d'un dépôt configuré sur Manual, ou une autre revue immédiatement dans les autres modes |

117| `@claude review always` | Lance une revue et abonne la PR aux revues déclenchées par push à l'avenir | Vous voulez que chaque push ultérieur lance une nouvelle revue, par exemple sur une PR prioritaire dans un dépôt configuré sur Manual |

118| `@claude review once` | Identique à `@claude review` : lance une revue unique sans abonnement | Les mêmes cas que `@claude review` |

119 

120Pour que l'une de ces commandes lance une revue, toutes les conditions suivantes doivent être remplies :

121 

122* Publiez-la en tant que nouveau commentaire de premier niveau sur la pull request, et non en tant que commentaire en ligne sur une ligne du diff ni dans le corps d'une revue. La modification d'un commentaire précédent ne compte pas.

123* Placez la commande au début du commentaire, avec `always` sur la même ligne que le reste de la commande. La casse n'a pas d'importance.

124* Vous devez disposer de la permission write, maintain ou admin sur le dépôt. Claude vérifie cela auprès de GitHub pour chaque personne qui commente, et les commentaires de bots ne lancent pas de revues.

125* La pull request doit être ouverte.

126 

127Lorsque la commande est acceptée, un check run **Claude Code Review** apparaît sur la pull request avec le titre **Code review queued...**. Le titre devient **Code review in progress...** lorsque la revue démarre. Claude peut aussi réagir à votre commentaire avec 👀, mais cette réaction peut apparaître même lorsqu'aucune revue ne démarre : fiez-vous plutôt au check run.

128 

129Si une revue est déjà en cours sur le dernier commit de la pull request, une nouvelle demande n'en lance pas une seconde.

130 

131<Note>

132 Avant une mise à jour de juillet 2026, `@claude review` abonnait la PR aux revues déclenchées par push. Si vous dépendiez de ce comportement, publiez plutôt `@claude review always`.

133</Note>

134 

135<h3 id="what-a-later-review-covers">

136 Ce que couvre une revue ultérieure

137</h3>

138 

139Une revue ultérieure qui démarre d'elle-même, par exemple après un push, se concentre sur ce qui a changé depuis la dernière revue et publie moins de nits et de résultats préexistants. Son résumé comptabilise ce qu'elle a omis, dans une ligne se terminant par « found and not posted » ou « outside the scope of this re-review and not posted. »

140 

141Pour obtenir une revue qui n'omet aucun de ces résultats, publiez [`@claude review`](#comment-commands). Elle couvre à nouveau l'ensemble de la pull request.

142 

143<h3 id="review-drafts-and-pull-requests-from-forks">

144 Revue des brouillons et des pull requests provenant de forks

145</h3>

146 

147Les revues automatiques ignorent ces deux cas : demandez donc la revue avec une commande de commentaire :

148 

149* **Pull requests en brouillon** : une commande de commentaire s'exécute sur un brouillon, ce qui vous permet de demander une revue avant de marquer la pull request comme prête. Les push vers un brouillon ne lancent pas de revues, même après `@claude review always`. L'abonnement prend effet une fois la pull request marquée comme prête.

150* **Pull requests provenant de forks** : Claude n'examine pas automatiquement une pull request provenant d'un fork, quel que soit le paramètre **Review runs** du dépôt. Pour en lancer une, publiez `@claude review` sur la pull request. Les [conditions des commandes de commentaire](#comment-commands) s'appliquent toujours, et l'accès en écriture requis porte sur le dépôt de base, et non sur le fork.

151 

152Sur une pull request provenant d'un fork, `@claude review always` fonctionne également, mais n'abonne pas la pull request aux revues lors des push ultérieurs. Cliquer sur **Re-run** sur le check run n'y lance pas de revue.

153 

154<h3 id="use-code-review-alongside-the-claude-code-github-action">

155 Utiliser Code Review avec la GitHub Action Claude Code

156</h3>

157 

158Si le dépôt exécute également la [GitHub Action Claude Code](/docs/fr/github-actions) en mode interactif avec sa phrase de déclenchement `@claude` par défaut, un commentaire `@claude review` lance aussi l'Action. Pour séparer les deux, définissez l'entrée `trigger_phrase` de l'Action sur une phrase différente.

159 

160<h2 id="related-resources">

161 Ressources associées

162</h2>

163 

164* [Résoudre les problèmes de Code Review](/docs/fr/code-review-troubleshooting) : une revue qui n'a pas démarré, a échoué ou a été ignorée pour des raisons de budget

165* [Code Review](/docs/fr/code-review) : ce qu'est le service et comment se déroule une revue

166* [Configurer Code Review](/docs/fr/code-review-setup) : pour les Owners, activer Code Review et choisir quand les revues s'exécutent et à quel niveau

167* [Personnaliser Code Review](/docs/fr/code-review-customize) : modifier ce que Claude signale avec `REVIEW.md` et `CLAUDE.md`

168* [Coûts et utilisation de Code Review](/docs/fr/code-review-costs) : comment les revues sont facturées et où la limite de dépenses est définie

169* [Effectuer une revue locale avec `/code-review`](/docs/fr/code-review-local) : exécuter une revue de votre branche depuis une session Claude Code

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Configurer Code Review

6 

7> Activez Code Review pour votre organisation Claude : connectez GitHub, installez la Claude GitHub App, choisissez les dépôts et définissez quand les revues s'exécutent

8 

9En tant qu'Owner de votre organisation Claude, vous activez Code Review dans [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) sur claude.ai. Les revues s'exécutent sur l'infrastructure d'Anthropic, vous n'avez donc pas besoin d'ajouter de fichiers de workflow à vos dépôts.

10 

11Après la configuration, vous choisissez le niveau de rigueur des revues et le moment où elles s'exécutent dans chaque dépôt. Vos dépenses augmentent avec un niveau de revue plus élevé et lorsque les revues s'exécutent plus souvent. Consultez [Coûts de Code Review](/docs/fr/code-review-costs#pricing).

12 

13<h2 id="what-you-need-to-turn-on-code-review">

14 Ce dont vous avez besoin pour activer Code Review

15</h2>

16 

17Vérifiez d'abord que votre organisation [est éligible à Code Review](/docs/fr/code-review#availability). Assurez-vous ensuite de disposer des accès suivants, ou qu'une personne qui en dispose puisse vous aider :

18 

19| Accès | Nécessaire pour |

20| :- | :- |

21| [Rôle Owner](/docs/fr/server-managed-settings#access-control) dans votre organisation Claude | Chaque étape de la page d'administration |

22| Owner de l'organisation GitHub | Installer la Claude GitHub App et [la lier à votre organisation Claude](/docs/fr/admin-setup#connected-github-accounts). Si vous n'êtes pas owner, demandez à un owner d'installer et de lier l'application avant de commencer |

23| Accès en écriture à chaque dépôt que vous ajoutez, depuis le compte GitHub que vous connectez à Claude | Ajouter le dépôt |

24 

25<h2 id="turn-on-code-review">

26 Activer Code Review

27</h2>

28 

29<Steps>

30 <Step title="Cliquer sur le commutateur Allow code review">

31 Accédez à la section **Code review** de [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review) et cliquez sur le commutateur **Allow code review**.

32 

33 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](#add-more-repositories), puis revenez pour la dernière étape.

34 </Step>

35 

36 <Step title="Connecter votre compte GitHub">

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

38 

39 Si **Add a repository** s'est ouvert directement, votre compte est déjà connecté : passez à l'étape suivante.

40 </Step>

41 

42 <Step title="Installer la Claude GitHub App">

43 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 :

44 

45 * 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.

46 * Choisissez l'organisation GitHub propriétaire des dépôts.

47 * Choisissez les dépôts auxquels l'application peut accéder.

48 * 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](/docs/fr/github-actions). Consultez [ce à quoi une revue peut accéder](/docs/fr/code-review#what-a-review-can-access) et la [liste complète des permissions](/docs/fr/github-actions#github-app-permissions).

49 * 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.

50 * Revenez à l'onglet de la page d'administration, où la liste de la boîte de dialogue s'actualise.

51 </Step>

52 

53 <Step title="Choisir les dépôts">

54 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](#add-more-repositories) plus tard.

55 </Step>

56 

57 <Step title="Cliquer sur Finish">

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

59 

60 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](#set-when-reviews-run).

61 </Step>

62 

63 <Step title="Vérifier avec une pull request de test">

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

65 

66 Si aucun check run n'apparaît, consultez [Aucun check run n'apparaît sur la pull request de test](/docs/fr/code-review-troubleshooting#no-check-run-appears-on-the-test-pull-request).

67 

68 Une fois la revue arrivée, envoyez à vos développeurs [Lire et demander des revues sur une pull request](/docs/fr/code-review-pull-requests), qui présente les niveaux de gravité, les commandes de commentaire et la manière de répondre aux résultats.

69 </Step>

70</Steps>

71 

72<h2 id="set-defaults-for-your-organization">

73 Définir les valeurs par défaut de votre organisation

74</h2>

75 

76En 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**](https://claude.ai/admin-settings/claude-code#code-review).

77 

78<h3 id="set-the-default-review-level">

79 Définir le niveau de revue par défaut

80</h3>

81 

82Le 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.

83 

84| Niveau | Compromis |

85| :- | :- |

86| Quick | Une passe plus légère. Le niveau le plus rapide, au coût le plus bas |

87| Standard | Équilibre entre profondeur, vitesse et coût. Le niveau par défaut |

88| Deep | La passe la plus approfondie. La plus longue et la plus coûteuse |

89 

90* **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.

91* **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.

92 

93Un nouveau niveau s'applique aux revues qui démarrent après la modification. Pour connaître les autres facteurs qui influencent le coût de chaque revue, consultez [Coûts et utilisation de Code Review](/docs/fr/code-review-costs).

94 

95<h3 id="set-when-reviews-run">

96 Définir quand les revues s'exécutent

97</h3>

98 

99Chaque dépôt possède son propre paramètre **Review runs**, qui détermine quand ses pull requests sont révisées.

100 

101* **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

102* **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

103* **Manual (@claude review)** : ouvrir une pull request ou y pousser des modifications ne lance pas de revue. Commentez [`@claude review`](/docs/fr/code-review-pull-requests#comment-commands) pour en demander une, ou `@claude review always` pour abonner également la pull request aux revues lors des pushs suivants.

104 

105Le mode Manual est utile pour les dépôts à fort trafic où vous souhaitez soumettre certaines pull requests à la revue, ou pour ne commencer à réviser les pull requests qu'une fois qu'elles sont prêtes. Pour comparer l'effet de chaque option sur les dépenses, consultez [Fréquence d'exécution des revues](/docs/fr/code-review-costs#how-often-reviews-run).

106 

107Pour modifier le paramètre, cliquez sur **Edit** sur la ligne du dépôt dans le tableau **Repositories** et sélectionnez une option **Review runs**. Le choix est enregistré dès que vous le sélectionnez, et la colonne **Review runs** du tableau l'affiche sous forme abrégée : Once per PR, Every push ou Manual.

108 

109* **Brouillons et pull requests provenant de forks** : quelle que soit l'option choisie, [les revues automatiques ignorent les deux](/docs/fr/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)

110* **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](#cover-a-whole-github-organization), il adopte plutôt le paramètre de la ligne de cette organisation.

111 

112<h3 id="turn-tip-comments-on-or-off">

113 Activer ou désactiver les commentaires d'astuce

114</h3>

115 

116Un 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 :

117 

118* **Le dépôt est configuré sur Manual** : comment demander une revue avec un commentaire

119* **La pull request provient d'un fork** : qu'un mainteneur peut demander la revue

120* **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

121* **L'organisation GitHub n'est pas liée à votre organisation Claude** : que les revues sont suspendues, et comment la lier

122 

123Désactivez le paramètre pour arrêter ces commentaires.

124 

125<h3 id="what-developers-can-change">

126 Ce que les développeurs peuvent modifier

127</h3>

128 

129Les 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 :

130 

131* **Demander une revue** : commenter [`@claude review`](/docs/fr/code-review-pull-requests#comment-commands) sur 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](/docs/fr/code-review-pull-requests#review-drafts-and-pull-requests-from-forks), que les revues automatiques ignorent.

132* **Abonner une pull request à une revue à chaque push** : commenter `@claude review always` sur une pull request qui n'est pas [un brouillon ou issue d'un fork](/docs/fr/code-review-pull-requests#review-drafts-and-pull-requests-from-forks), par exemple dans un dépôt configuré sur Manual

133* **Modifier ce que les revues signalent** : faire un commit de [fichiers `REVIEW.md` et `CLAUDE.md`](/docs/fr/code-review-customize) dans le dépôt, par exemple pour ajouter une vérification

134 

135Les revues demandées par les développeurs sont [facturées à votre organisation](/docs/fr/code-review-costs#pricing). Pour limiter les dépenses mensuelles de Code Review, consultez [Limiter vos dépenses](/docs/fr/code-review-costs#limit-your-spend).

136 

137<h2 id="manage-repositories">

138 Gérer les dépôts

139</h2>

140 

141Vous 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.

142 

143<h3 id="add-more-repositories">

144 Ajouter d'autres dépôts

145</h3>

146 

147Pour 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**.

148 

149* **Un dépôt n'est pas listé** : consultez [Un dépôt n'est pas listé dans Add a repository](/docs/fr/code-review-troubleshooting#a-repository-isn’t-listed-in-add-a-repository).

150* **Vous voulez tous les dépôts d'une organisation GitHub** : [couvrez l'organisation](#cover-a-whole-github-organization) au lieu de sélectionner les dépôts un par un

151 

152<h3 id="cover-a-whole-github-organization">

153 Couvrir une organisation GitHub entière

154</h3>

155 

156Pour 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 :

157 

158* Le compte GitHub que vous avez connecté à Claude est owner de cette organisation GitHub.

159* L'organisation est hébergée sur github.com. Les instances GitHub Enterprise Server et les comptes GitHub personnels ne sont pas éligibles.

160* Une [limite de dépenses mensuelle](/docs/fr/code-review-costs#limit-your-spend) est définie, pour votre organisation Claude ou pour Code Review.

161 

162Pour couvrir l'organisation, cliquez sur **Edit** sur sa ligne, sélectionnez une option **Review runs** et confirmez. Les options sont les trois de [Définir quand les revues s'exécutent](#set-when-reviews-run), plus **Off**.

163 

164Après votre confirmation, les modifications suivantes prennent effet :

165 

166* **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.

167* **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.

168* **Modifications individuelles ultérieures** : un dépôt que vous configurez ensuite différemment de son organisation est marqué **Custom** dans le tableau.

169* **Niveau de revue** : une ligne d'organisation n'a pas de niveau de revue propre.

170 

171<h3 id="turn-off-code-review-or-remove-a-repository">

172 Désactiver Code Review ou retirer un dépôt

173</h3>

174 

175Dans la section **Code review** de [**Admin settings > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review), choisissez le contrôle correspondant à ce que vous souhaitez arrêter :

176 

177* **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.

178* **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**.

179* **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.

180* **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.

181 

182<h2 id="related-resources">