Поиск ошибок с помощью ultrareview

Запустите глубокий многоагентный анализ кода в облаке с помощью /code-review ultra, чтобы найти и проверить ошибки перед слиянием.

Ultrareview — это глубокий анализ кода, который работает как облачный сеанс на инфраструктуре Anthropic. Когда вы запускаете /code-review ultra, Claude Code запускает флот агентов-рецензентов в облачной изолированной среде для поиска ошибок в вашей ветке или запросе на слияние.

По сравнению с локальным /code-review, ultrareview предлагает:

• Более высокий сигнал: каждый найденный результат независимо воспроизводится и проверяется, поэтому результаты сосредоточены на реальных ошибках, а не на предложениях по стилю
• Более широкое покрытие: более крупный флот агентов-рецензентов исследует изменение параллельно, что выявляет проблемы, которые может пропустить локальный анализ
• Без использования локальных ресурсов: анализ работает полностью в облачной изолированной среде, поэтому ваш терминал остается свободным для другой работы во время его выполнения

Ultrareview требует аутентификации с помощью учетной записи claude.ai, так как работает как облачный сеанс на инфраструктуре Anthropic. Если вы вошли только с помощью ключа API, запустите /login и сначала аутентифицируйтесь с помощью claude.ai. Ultrareview недоступен при использовании Claude Code с Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry, а также недоступен для организаций, которые включили Zero Data Retention. Когда ultrareview недоступен, /code-review ultra запускает локальный анализ в вашем сеансе вместо этого.

Запуск ultrareview из CLI

Начните анализ из любого репозитория git:

/code-review ultra

Без аргументов ultrareview анализирует разницу между вашей текущей ветвью и ветвью по умолчанию, включая незафиксированные и подготовленные изменения. Для незафиксированных изменений в файлах, названных как учетные данные или ключи, таких как .env и *.tfvars файлы, Claude Code следует правилам для загрузки локального репозитория в облачную сессию.

Для анализа ветки Claude Code упаковывает состояние репозитория и загружает его в удаленную изолированную среду; когда вы анализируете запрос на слияние, Claude Code ничего не загружает с вашей машины.

Перед запуском Claude Code показывает диалоговое окно подтверждения с областью анализа, оставшимися бесплатными запусками и предполагаемой стоимостью; для анализа ветки область включает количество файлов и строк. После подтверждения анализ продолжается в фоновом режиме, пока вы продолжаете использовать вашу сессию.

Команда запускается только при вызове с помощью /code-review ultra; Claude не запускает ultrareview самостоятельно.

Анализ относительно другой базы

Чтобы сравнить с базой, отличной от ветви по умолчанию, передайте имя ветви. Этот пример анализирует вашу текущую ветвь относительно develop:

/code-review ultra develop

Базовая ветвь не должна существовать в вашем локальном клоне; Claude Code получает её из origin. Если имя содержит опечатку, Claude Code предлагает ближайшее имя ветви в ошибке.

Анализ запроса на слияние

Чтобы анализировать запрос на слияние GitHub вместо локальной ветви, передайте номер PR:

/code-review ultra 1234

Команда также принимает #1234, PR 1234 и вставленные URL-адреса PR; вставленный URL должен указывать на репозиторий в вашем текущем каталоге.

В режиме PR удаленная изолированная среда клонирует запрос на слияние непосредственно с хоста, а не упаковывает ваше локальное рабочее дерево. Режим PR работает с репозиториями на github.com и на экземплярах GitHub Enterprise Server, которые администратор подключил к Claude Code.

Для репозиториев на github.com изолированная среда клонирует с учетной записью GitHub, подключенной к вашей учетной записи Claude, поэтому учетная запись должна иметь возможность читать репозиторий PR. Claude Code проверяет это перед созданием облачной сессии, если вы не установили CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, и отказывает в запуске, когда нет подключенной учетной записи или учетная запись не может видеть репозиторий; отказ указывает на исправление. До версии 2.1.248 Claude Code не проверял это перед запуском.

Запустите /web-setup, чтобы подключить вашу учетную запись GitHub CLI к вашей учетной записи Claude.

Опубликуйте результаты в запросе на слияние

На Claude Code версии 2.1.227 или позже, когда вы анализируете запрос на слияние на github.com, вы можете попросить Claude опубликовать готовые результаты в PR как один простой комментарий от вашей собственной учетной записи GitHub. Комментарий не является рецензией или одобрением и заканчивается примечанием "Generated by Claude Code". Когда вы анализируете ветвь или запрос на слияние GitHub Enterprise Server, Claude Code показывает результаты только в вашей сессии.

Claude Code никогда не публикует, если вы не выберете это на этом запуске, и --no-post является значением по умолчанию. Публикация — это выбор, который вы делаете для каждого запуска:

• Интерактивно: в диалоговом окне запуска выберите Run and post the findings to the PR as me. Если вы добавите --post к команде, как в /code-review ultra 1234 --post, Claude Code предварительно выбирает этот выбор и все еще спрашивает перед запуском.
• Неинтерактивно: запустите подкоманду claude ultrareview с --post. Вы даете согласие на публикацию, запустив подкоманду с флагом, поэтому Claude Code публикует без вопросов. В запуске claude -p '/code-review ultra' Claude Code выходит перед прибытием результатов, поэтому ничего не публикует; используйте подкоманду вместо этого.

Claude Code не публикует с вашей машины. Он отправляет ID сессии анализа в API Anthropic, который публикует сохраненные результаты анализа как комментарий через учетную запись GitHub, которую вы подключили к Claude. Публикация требует того же входа claude.ai, что и сам анализ, и она недоступна у сторонних поставщиков или когда вы установили CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

В интерактивной сессии Claude Code начинает публикацию, когда результаты прибывают, поэтому держите сессию открытой до завершения анализа. Claude Code сохраняет выбор публикации только в этой сессии. Если сессия заканчивается перед завершением анализа, Claude Code ничего не публикует, даже если вы возобновите разговор позже.

Когда публикация завершается, Claude сообщает вам результат:

• Опубликовано: Claude дает вам ссылку на комментарий.
• Уже опубликовано: более ранняя публикация того же анализа уже поместила комментарий в PR, поэтому Claude ссылает вас на запрос на слияние вместо повторной публикации.
• Не удалось: Claude сообщает вам почему, и результаты остаются в вашем терминале, чтобы вы могли опубликовать их вручную.

Передайте запрос простыми словами

На Claude Code версии 2.1.218 или позже вы также можете описать, над чем вы работаете, простыми словами:

/code-review ultra check my auth changes

Анализ по-прежнему охватывает вашу текущую ветвь, ту же область, что и запуск без аргумента. Claude сохраняет ваш текст как примечание, показанное в диалоговом окне запуска, и связывает результаты с ним, когда они прибывают.

Claude Code рассматривает ваш текст как примечание только, когда он содержит более одного слова и не является именем ветви или ссылкой на PR. Он читает одно слово как имя ветви или ссылку на PR, поэтому неправильно введенное имя ветви получает ошибку ближайшей ветви из Анализ относительно другой базы вместо запуска с примечанием. Если ваш текст объединяет ссылку на PR с другими словами, такие как check PR 123 again, Claude Code также не запускается; он просит вас повторно запустить только с номером PR для анализа этого PR или без ссылки для анализа вашей текущей ветви.

Ограничения diff и резервные варианты

Ultrareview проверяет diff перед началом любой работы по анализу и сообщает вам, когда он не может анализировать его как есть:

• Diff слишком большой: анализ ветки может включать до 500 измененных файлов и 8000 измененных строк по умолчанию. Точные значения могут измениться, и отказ указывает на действующие значения, размер вашего diff и файлы с наибольшим количеством измененных строк. Claude Code отказывает в анализе слишком большого запроса на слияние таким же образом, указывая количество файлов и строк, но не разбивку по файлам
• Нечего анализировать: когда diff относительно базы пуст, Claude Code говорит об этом и предлагает подготовить или зафиксировать локальные правки или передать другую базу
• Нет базы слияния: когда ваша ветвь не имеет общей истории с базовой ветвью, Claude Code переходит на анализ каждого отслеживаемого файла в репозитории; резервный вариант требует полного клона и применяет те же ограничения размера. При проверке без ветвей или других ссылок, такой как отсоединенный HEAD, созданный путем проверки FETCH_HEAD после получения URL, Claude Code отказывает в анализе и предлагает сначала создать ветвь

Цены и бесплатные запуски

Ultrareview — это премиум-функция, которая выставляет счета за дополнительное использование, а не за включенное использование в вашем плане.

• Бесплатные запуски: три запуска Pro и Max — это одноразовое выделение на учетную запись и не обновляются.
• Стоимость одного анализа: после использования бесплатных запусков обычно от 5 до 25 долларов в дополнительном использовании в зависимости от размера изменения, что соответствует оценке, которую показывает диалоговое окно запуска перед каждым запуском.
• Когда запуск считается начатым: после запуска облачной сессии. Анализ, который вы остановили рано или который не завершился, все равно использует бесплатный запуск; платный анализ выставляет счет только за ту часть, которая была выполнена.

Поскольку ultrareview всегда выставляет счет как дополнительное использование вне бесплатных запусков, ваша учетная запись или организация должны иметь включенное дополнительное использование перед запуском платного анализа. Если дополнительное использование не включено, Claude Code блокирует запуск, и способ его включения зависит от вашего доступа к выставлению счетов:

• Если вы можете управлять выставлением счетов для вашей учетной записи, Claude Code ссылает вас на параметры выставления счетов, где вы можете включить дополнительное использование.
• В планах Team и Enterprise члены без доступа к выставлению счетов отправляют запрос из CLI, прося своего администратора включить дополнительное использование.

Вы также можете запустить /usage-credits для проверки или изменения параметра дополнительного использования.

Claude Code просит вас подтвердить выставление счетов за дополнительное использование один раз за разговор: когда вы начинаете новый разговор, например с /clear, Claude Code показывает подтверждение снова для следующего платного анализа.

Отслеживание выполняемого анализа

Анализ обычно занимает от 5 до 10 минут. Анализ работает как фоновая задача, поэтому вы можете продолжать работать в вашей сессии, запускать другие команды или полностью закрыть терминал. Если вы выбрали публикацию результатов в запрос на слияние, держите сессию открытой до завершения анализа; если сессия завершится раньше, Claude Code ничего не публикует.

Используйте /tasks для просмотра выполняемых и завершенных анализов, открытия подробного представления анализа или остановки выполняемого анализа. Если вы остановите анализ, Claude Code архивирует облачную сессию и не возвращает частичные результаты.

Когда анализ завершится, Claude Code показывает проверенные результаты как уведомление в вашей сессии. Каждый результат включает расположение файла и объяснение проблемы, чтобы вы могли попросить Claude исправить это напрямую.

Запуск ultrareview неинтерактивно

Используйте подкоманду claude ultrareview для запуска ultrareview из CI или скрипта без интерактивной сессии. Подкоманда запускает тот же анализ, что и /code-review ultra, блокирует до завершения удаленного анализа и выводит результаты в stdout.

claude ultrareview
claude ultrareview 1234
claude ultrareview origin/main

Без аргументов подкоманда анализирует разницу между вашей текущей ветвью и ветвью по умолчанию, с тем же резервным вариантом для всего репозитория, что и /code-review ultra, когда база слияния не существует. Передайте номер PR для анализа запроса на слияние или базовую ветвь для анализа против нее; обработка базовой ветви соответствует интерактивной команде.

Вы даете согласие на резервный вариант для всего репозитория и на подсказку выставления счетов и условий при запуске подкоманды, поэтому запуск начинается без ожидания ввода.

В Claude Code v2.1.218 или позже вы также можете запустить облачный анализ, запустив /code-review ultra в неинтерактивной сессии, например claude -p '/code-review ultra'. Claude Code запускает анализ и выводит ссылку отслеживания без ожидания результатов, в отличие от claude ultrareview, который блокирует до их получения. Когда анализ будет выставлять счета за использование кредитов, Claude Code останавливается перед запуском и указывает вам на claude ultrareview, потому что подтверждение выставления счетов требует интерактивной сессии. До v2.1.218 /code-review ultra в неинтерактивной сессии запускал локальный анализ.

Сообщения о ходе выполнения и URL живой сессии идут в stderr, чтобы stdout оставался анализируемым. Используйте эти флаги для управления выводом, тайм-аутом и тем, публиковать ли результаты:

Запуск claude ultrareview требует той же аутентификации и конфигурации дополнительного использования, что и /code-review ultra.

Подкоманда выходит с одним из трех кодов:

• 0: анализ завершен, с результатами или без них
• 1: анализ не запустился, облачная сессия ошибилась или истек тайм-аут
• 130: вы прервали подкоманду с помощью Ctrl-C

Если вы прерываете подкоманду, удаленный анализ продолжает работать; следите за URL сессии, выведенным в stderr, чтобы смотреть его в браузере.

С флагом --post подкоманда начинает публикацию сразу после вывода результатов, и выводит ссылку в stderr.

• Если запуск не удается, истекает тайм-аут или вы его прерываете, подкоманда ничего не публикует.
• Если анализ завершается, но комментарий не опубликован, Claude Code выводит причину в stderr, а результаты остаются в stdout, чтобы вы могли опубликовать их вручную.

Для автоматических анализов запросов на слияние GitHub Code Review интегрируется непосредственно с вашим репозиторием и публикует результаты как встроенные комментарии PR без этапа CLI.

Как ultrareview сравнивается с /code-review

Оба анализа проверяют код, но вы используете их на разных этапах вашего рабочего процесса.

Используйте /code-review для быстрой обратной связи во время работы или передайте номер PR для проверки pull request коллеги перед его одобрением. Используйте /code-review ultra перед слиянием существенного изменения, когда вам нужен более глубокий анализ, который поймет проблемы, которые может пропустить локальный анализ.

Связанные ресурсы

• Claude Code в веб-версии: узнайте, как работают удаленные сессии и облачные изолированные среды
• Эффективное управление затратами: отслеживайте использование и устанавливайте лимиты расходов