Trouver des bugs avec ultrareview

Exécutez une révision de code approfondie et multi-agents dans le cloud avec /code-review ultra pour trouver et vérifier les bugs avant de fusionner.

Ultrareview est une révision de code approfondie qui s'exécute sur Claude Code sur l'infrastructure web. Lorsque vous exécutez /code-review ultra, Claude Code lance une flotte d'agents examinateurs dans un sandbox distant pour trouver des bugs dans votre branche ou votre demande de fusion.

Comparé à un /code-review local, ultrareview offre :

• Signal plus élevé : chaque constatation signalée est indépendamment reproduite et vérifiée, de sorte que les résultats se concentrent sur les bugs réels plutôt que sur les suggestions de style
• Couverture plus large : une flotte plus importante d'agents examinateurs explore le changement en parallèle, ce qui met en évidence les problèmes qu'une révision locale pourrait manquer
• Aucune utilisation de ressources locales : la révision s'exécute entièrement dans un sandbox distant, de sorte que votre terminal reste libre pour d'autres travaux pendant qu'elle s'exécute

Ultrareview nécessite une authentification avec un compte claude.ai car il s'exécute sur Claude Code sur l'infrastructure web. Si vous êtes connecté avec une clé API uniquement, exécutez /login et authentifiez-vous d'abord avec claude.ai. Ultrareview n'est pas disponible lors de l'utilisation de Claude Code avec Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry, et il n'est pas disponible pour les organisations qui ont activé la rétention zéro des données. Lorsque ultrareview n'est pas disponible, /code-review ultra exécute une révision locale dans votre session à la place.

Exécuter ultrareview à partir de la CLI

Démarrez une révision à partir de n'importe quel référentiel git :

/code-review ultra

Sans arguments, ultrareview examine la différence entre votre branche actuelle et la branche par défaut, y compris les modifications non validées et mises en scène. Pour les modifications non validées de 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 cloud.

Pour une révision de branche, Claude Code regroupe l'état du référentiel et le télécharge vers un sandbox distant ; lorsque vous révisez une demande de fusion, Claude Code ne télécharge rien de votre machine.

Avant de lancer, Claude Code affiche une boîte de dialogue de confirmation avec l'étendue de la révision, vos exécutions gratuites restantes et le coût estimé ; pour une révision de branche, l'étendue inclut le nombre de fichiers et de lignes. Après confirmation, la révision continue en arrière-plan tandis que vous continuez à utiliser votre session.

La commande s'exécute uniquement lorsque vous l'invoquez avec /code-review ultra ; Claude ne démarre pas une ultrareview de lui-même.

Réviser par rapport à une base différente

Pour comparer par rapport à une base autre que la branche par défaut, transmettez le nom de la branche. Cet exemple révise votre branche actuelle par rapport à develop à la place :

/code-review ultra develop

La branche de base n'a pas besoin d'exister dans votre clone local ; Claude Code la récupère depuis origin. Si le nom contient une faute de frappe, Claude Code suggère le nom de branche le plus proche dans l'erreur.

Réviser une demande de fusion

Pour réviser une demande de fusion GitHub à la place d'une branche locale, transmettez le numéro de PR :

/code-review ultra 1234

La commande accepte également #1234, PR 1234 et les URL de PR collées ; une URL collée doit pointer vers le référentiel dans votre répertoire actuel.

En mode PR, le sandbox distant clone la demande de fusion directement depuis l'hôte plutôt que de regrouper votre arborescence de travail locale. Le mode PR fonctionne avec les référentiels sur github.com et sur les instances GitHub Enterprise Server qu'un administrateur a connectées à Claude Code.

Pour les référentiels sur github.com, le sandbox clone avec le compte GitHub connecté à votre compte Claude, donc le compte doit pouvoir lire le référentiel de la PR. Claude Code vérifie cela avant de créer la session cloud, sauf si vous avez défini CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, et refuse le lancement lorsque aucun compte n'est connecté ou le compte ne peut pas voir le référentiel ; le refus nomme la correction. Avant la v2.1.248, Claude Code ne vérifiait pas cela avant le lancement.

Exécutez /web-setup pour connecter votre connexion GitHub CLI à votre compte Claude.

Publier les résultats sur la demande de fusion

Sur Claude Code v2.1.227 ou ultérieur, lorsque vous révisez une demande de fusion sur github.com, vous pouvez faire en sorte que Claude publie les résultats terminés sur la PR en tant que commentaire simple unique depuis votre propre compte GitHub. Le commentaire n'est pas une révision ou une approbation, et il se termine par une note « Généré par Claude Code ». Lorsque vous révisez une branche ou une demande de fusion GitHub Enterprise Server, Claude Code affiche les résultats dans votre session uniquement.

Claude Code ne publie jamais sauf si vous le choisissez sur cette exécution, et --no-post est la valeur par défaut. La publication est un choix que vous faites pour chaque exécution :

• Interactif : dans la boîte de dialogue de lancement, sélectionnez Exécuter et publier les résultats sur la PR en tant que moi. Si vous ajoutez --post à la commande, comme dans /code-review ultra 1234 --post, Claude Code présélectionne ce choix et demande toujours avant de lancer.
• Non-interactif : exécutez la sous-commande claude ultrareview avec --post. Vous consentez à la publication en exécutant la sous-commande avec le drapeau, donc Claude Code publie sans demander. Dans une exécution claude -p '/code-review ultra', Claude Code se ferme avant l'arrivée des résultats, donc il ne publie rien ; utilisez la sous-commande à la place.

Claude Code ne publie pas depuis votre machine. Il envoie les résultats à une session sur Claude Code sur le web, qui publie le commentaire via le compte GitHub que vous avez connecté à Claude. La publication nécessite la même connexion claude.ai que la révision elle-même. Parce que la publication s'exécute via Claude Code sur le web, elle n'est pas disponible sur les fournisseurs tiers ou lorsque vous définissez CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

Dans une session interactive, Claude Code démarre la publication lorsque les résultats arrivent, donc gardez la session ouverte jusqu'à ce que la révision se termine. Claude Code conserve le choix de publication uniquement dans cette session. Si la session se termine avant la fin de la révision, Claude Code ne publie rien, même si vous reprenez la conversation plus tard.

Lorsque la publication ne peut pas démarrer pendant que votre session est ouverte, Claude vous dit que rien n'a été envoyé à la PR et pourquoi, et les résultats restent dans votre terminal afin que vous puissiez les publier à la main.

Transmettre une demande en langage simple

Sur Claude Code v2.1.218 ou ultérieur, vous pouvez également décrire ce sur quoi vous travaillez en langage simple :

/code-review ultra check my auth changes

La révision couvre toujours votre branche actuelle, la même étendue que l'exécution sans argument. Claude conserve votre texte comme une note, affichée dans la boîte de dialogue de lancement, et relie les résultats à celle-ci lorsqu'ils arrivent.

Claude Code traite votre texte comme une note uniquement lorsqu'il contient plus d'un mot et n'est pas un nom de branche ou une référence de PR. Il lit un seul mot comme un nom de branche ou une référence de PR, donc un nom de branche mal orthographié obtient l'erreur de branche la plus proche de Réviser par rapport à une base différente au lieu de lancer avec une note. Si votre texte combine une référence de PR avec d'autres mots, tels que check PR 123 again, Claude Code ne lance pas non plus ; il vous demande de relancer avec le numéro de PR seul pour réviser cette PR, ou sans la référence pour réviser votre branche actuelle.

Limites de diff et solutions de secours

Ultrareview vérifie le diff avant que tout travail de révision ne s'exécute et vous indique lorsqu'il ne peut pas le réviser tel quel :

• Diff trop volumineux : une révision de branche peut inclure jusqu'à 500 fichiers modifiés et 8 000 lignes modifiées par défaut. Les valeurs exactes peuvent changer, et le refus nomme celles en vigueur, la taille de votre diff et les fichiers avec le plus de lignes modifiées. Claude Code refuse une demande de fusion trop volumineux de la même manière, en nommant ses nombres de fichiers et de lignes mais pas la ventilation par fichier
• Rien à réviser : lorsque le diff par rapport à la base est vide, Claude Code le dit et suggère de mettre en scène ou de valider les modifications locales, ou de transmettre une base différente
• Pas de base de fusion : lorsque votre branche ne partage aucun historique avec la branche de base, Claude Code revient à la révision de chaque fichier suivi dans le référentiel à la place ; la solution de secours nécessite un clone complet et applique les mêmes limites de taille. Sur un checkout sans branches ou autres références, comme un HEAD détaché créé en vérifiant FETCH_HEAD après avoir récupéré une URL, Claude Code refuse la révision et suggère de créer d'abord une branche

Tarification et exécutions gratuites

Ultrareview est une fonctionnalité premium qui facture l'utilisation supplémentaire plutôt que l'utilisation incluse dans votre plan.

• Exécutions gratuites : les trois exécutions Pro et Max sont une allocation unique par compte et ne se renouvellent pas.
• Coût par révision : après avoir utilisé les exécutions gratuites, généralement entre 5 et 25 dollars en utilisation supplémentaire selon la taille du changement, correspondant à l'estimation affichée par la boîte de dialogue de lancement avant chaque exécution.
• Quand une exécution compte : une fois que la session cloud démarre. Une révision que vous arrêtez tôt ou qui ne se termine pas utilise quand même une exécution gratuite ; une révision payante facture uniquement l'utilisation supplémentaire pour la portion qui a été exécutée.

Parce que ultrareview facture toujours l'utilisation supplémentaire en dehors des exécutions gratuites, votre compte ou organisation doit avoir l'utilisation supplémentaire activée avant de pouvoir lancer une révision payante. Si l'utilisation supplémentaire n'est pas activée, Claude Code bloque le lancement, et la façon dont vous l'activez dépend de votre accès à la facturation :

• Si vous pouvez gérer la facturation de votre compte, Claude Code vous renvoie aux paramètres de facturation où vous pouvez activer l'utilisation supplémentaire.
• Sur les plans Team et Enterprise, les membres sans accès à la facturation envoient une demande depuis la CLI demandant à leur administrateur d'activer l'utilisation supplémentaire.

Vous pouvez également exécuter /usage-credits pour vérifier ou modifier votre paramètre d'utilisation supplémentaire.

Claude Code vous demande de confirmer la facturation de l'utilisation supplémentaire une fois par conversation : quand vous démarrez une nouvelle conversation, par exemple avec /clear, Claude Code affiche à nouveau la confirmation pour la prochaine révision payante.

Suivre une révision en cours

Une révision prend généralement 5 à 10 minutes. La révision s'exécute en tant que tâche en arrière-plan, de sorte que vous pouvez continuer à travailler dans votre session, démarrer d'autres commandes ou fermer complètement le terminal. Si vous avez choisi de publier les constatations sur la demande de tirage, gardez la session ouverte jusqu'à ce que la révision se termine ; si la session se termine en premier, Claude Code ne publie rien.

Utilisez /tasks pour voir les révisions en cours et terminées, ouvrir la vue détaillée d'une révision ou arrêter une révision en cours. Si vous arrêtez une révision, Claude Code archive la session cloud et ne retourne pas les constatations partielles.

Lorsque la révision se termine, Claude Code affiche les constatations vérifiées sous forme de notification dans votre session. Chaque constatation inclut l'emplacement du fichier et une explication du problème afin que vous puissiez demander à Claude de le corriger directement.

Exécuter ultrareview de manière non-interactive

Utilisez la sous-commande claude ultrareview pour démarrer une ultrareview à partir de CI ou d'un script sans session interactive. La sous-commande lance la même révision que /code-review ultra, bloque jusqu'à ce que la révision distante se termine, et imprime les constatations sur stdout.

claude ultrareview
claude ultrareview 1234
claude ultrareview origin/main

Sans arguments, la sous-commande examine la différence entre votre branche actuelle et la branche par défaut, avec le même repli sur l'ensemble du référentiel que /code-review ultra lorsqu'aucune base de fusion n'existe. Transmettez un numéro de PR pour examiner une demande de fusion, ou une branche de base pour examiner la différence par rapport à celle-ci ; la gestion de la branche de base correspond à la commande interactive.

Vous consentez au repli sur l'ensemble du référentiel et à l'invite de facturation et de conditions lorsque vous exécutez la sous-commande, de sorte que l'exécution démarre sans attendre d'entrée.

Sur Claude Code v2.1.218 ou ultérieur, vous pouvez également démarrer la révision cloud en exécutant /code-review ultra dans une session non-interactive, par exemple claude -p '/code-review ultra'. Claude Code lance la révision et imprime un lien de suivi sans attendre les constatations, contrairement à claude ultrareview, qui bloque jusqu'à leur arrivée. Lorsque la révision facturerait des crédits d'utilisation, Claude Code s'arrête avant de lancer et vous oriente vers claude ultrareview, car la confirmation de facturation nécessite une session interactive. Avant v2.1.218, /code-review ultra dans une session non-interactive exécutait une révision locale.

Les messages de progression et l'URL de session en direct vont vers stderr afin que stdout reste analysable. Utilisez ces drapeaux pour contrôler la sortie, le délai d'expiration et si les constatations doivent être publiées :

L'exécution de claude ultrareview nécessite la même authentification et configuration de crédits d'utilisation que /code-review ultra.

La sous-commande se termine avec l'un de ces trois codes :

• 0 : la révision s'est terminée, avec ou sans constatations
• 1 : la révision n'a pas pu se lancer, la session cloud a généré une erreur, ou le délai d'expiration s'est écoulé
• 130 : vous avez interrompu la sous-commande avec Ctrl-C

Si vous interrompez la sous-commande, la révision distante continue de s'exécuter ; suivez l'URL de session imprimée sur stderr pour la regarder dans le navigateur.

Avec --post, la sous-commande démarre la publication immédiatement après avoir imprimé les constatations. Si l'exécution échoue, expire ou que vous l'interrompez, la sous-commande ne publie rien. Si la révision se termine mais que la publication ne peut pas démarrer, Claude Code imprime la raison sur stderr, et les constatations restent sur stdout afin que vous puissiez les publier manuellement.

Pour les révisions automatiques sur les demandes de fusion GitHub, Code Review s'intègre directement à votre référentiel et publie les constatations sous forme de commentaires PR en ligne sans étape CLI.

Comment ultrareview se compare à /code-review

Les deux révisions examinent le code, mais vous les utilisez à différentes étapes de votre flux de travail.

Utilisez /code-review pour des retours rapides pendant que vous travaillez, ou transmettez un numéro de PR pour examiner la pull request d'un coéquipier avant de l'approuver. Utilisez /code-review ultra avant de fusionner un changement substantiel lorsque vous souhaitez une passe plus approfondie qui détecte les problèmes qu'une révision locale pourrait manquer.

Ressources connexes

• Claude Code sur le web : découvrez comment fonctionnent les sessions distantes et les sandboxes cloud
• Gérer les coûts efficacement : suivre l'utilisation et définir les limites de dépenses