Ultrareview — это функция исследовательского предпросмотра. Функция, цены и доступность могут измениться на основе отзывов. Команда вызывается как
/code-review ultra. Когда ultrareview доступен для вашей учетной записи, /ultrareview является псевдонимом./code-review ultra, Claude Code запускает флот агентов-рецензентов в облачной изолированной среде для поиска ошибок в вашей ветке или запросе на слияние.
По сравнению с локальным /code-review, ultrareview предлагает:
- Более высокий сигнал: каждый найденный результат независимо воспроизводится и проверяется, поэтому результаты сосредоточены на реальных ошибках, а не на предложениях по стилю
- Более широкое покрытие: более крупный флот агентов-рецензентов исследует изменение параллельно, что выявляет проблемы, которые может пропустить локальный анализ
- Без использования локальных ресурсов: анализ работает полностью в облачной изолированной среде, поэтому ваш терминал остается свободным для другой работы во время его выполнения
/login и сначала аутентифицируйтесь с помощью claude.ai. Ultrareview недоступен при использовании Claude Code с Amazon Bedrock, Google Cloud’s Agent Platform или Microsoft Foundry, а также недоступен для организаций, которые включили Zero Data Retention или к которым применена конфигурация HIPAA. Когда ultrareview недоступен, /code-review ultra вместо этого запускает локальное код-ревью в вашей сессии.
Запуск ultrareview из CLI
Начните анализ из любого репозитория git:.env и *.tfvars. Когда вы анализируете pull request, Claude Code ничего не загружает с вашей машины.
Перед запуском Claude Code показывает диалоговое окно подтверждения с областью анализа, оставшимися бесплатными запусками и предполагаемой стоимостью; для анализа ветки область включает количество файлов и строк. После подтверждения анализ продолжается в фоновом режиме, пока вы продолжаете использовать вашу сессию.
Команда запускается только при вызове с помощью /code-review ultra; Claude не запускает ultrareview самостоятельно.
Анализ относительно другой базы
Чтобы сравнить с базой, отличной от ветви по умолчанию, передайте имя ветви. Этот пример анализирует вашу текущую ветвь относительноdevelop:
origin. Если имя содержит опечатку, Claude Code предлагает ближайшее имя ветви в ошибке.
Идентификатор коммита или тег также работают в качестве базы, и анализ затем охватывает изменения на вашей ветви с момента этого коммита.
Анализ запроса на слияние
Чтобы проанализировать pull request наgithub.com вместо локальной ветки, передайте номер PR:
#1234, PR 1234 и вставленные URL-адреса PR; вставленный URL должен указывать на репозиторий в вашем текущем каталоге.
Для режима PR нужен репозиторий на github.com. Для репозитория на экземпляре GitHub Enterprise Server запустите /code-review ultra без номера PR, чтобы вместо этого проанализировать вашу локальную ветку.
В режиме PR облачная песочница клонирует pull request с github.com вместо загрузки вашего рабочего дерева. Она использует учётную запись GitHub, подключённую к вашей учётной записи Claude, поэтому эта учётная запись должна иметь доступ на чтение к репозиторию.
Запустите /web-setup, чтобы подключить вашу учетную запись GitHub CLI к вашей учетной записи Claude.
Опубликуйте результаты в запросе на слияние
В Claude Code версии 2.1.227 или новее, когда вы анализируете pull request наgithub.com, вы можете попросить Claude опубликовать готовые результаты в PR как один простой комментарий от вашей собственной учётной записи GitHub. Комментарий не является рецензией или одобрением и заканчивается примечанием “Generated by Claude Code”. Когда вы анализируете ветку, 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_DISABLE_NONESSENTIAL_TRAFFIC.
В интерактивной сессии Claude Code начинает публикацию, когда результаты прибывают, поэтому держите сессию открытой до завершения анализа. Claude Code сохраняет выбор публикации только в этой сессии. Если сессия заканчивается перед завершением анализа, Claude Code ничего не публикует, даже если вы возобновите разговор позже.
Когда публикация завершается, Claude сообщает вам результат:
- Опубликовано: Claude дает вам ссылку на комментарий.
- Уже опубликовано: более ранняя публикация того же анализа уже поместила комментарий в PR, поэтому Claude ссылает вас на запрос на слияние вместо повторной публикации.
- Не удалось: Claude сообщает вам почему, и результаты остаются в вашем терминале, чтобы вы могли опубликовать их вручную.
Передайте запрос простыми словами
На Claude Code версии 2.1.218 или позже вы также можете описать, над чем вы работаете, простыми словами:check PR 123 again, Claude Code также не запускается; он просит вас повторно запустить только с номером PR для анализа этого PR или без ссылки для анализа вашей текущей ветви.
Ограничения diff и резервные варианты
Ultrareview проверяет diff перед началом любой работы по анализу и сообщает вам, когда он не может анализировать его как есть:- Diff слишком большой: анализ ветки может включать до 500 измененных файлов и 8000 измененных строк по умолчанию. Точные значения могут измениться, и отказ указывает на действующие значения, размер вашего diff и файлы с наибольшим количеством измененных строк. Claude Code отказывает в анализе слишком большого запроса на слияние таким же образом, указывая количество файлов и строк, но не разбивку по файлам
- Нечего анализировать: когда diff относительно базы пуст, ultrareview отказывает и указывает на ветвь или коммит, с которым он сравнивал, и случай, в котором вы находитесь, например, находитесь на самой базовой ветви без ничего незафиксированного, или ветвь, чьи коммиты уже являются частью базы. Он также предлагает способ выхода для этого случая, например переключение на ветвь с вашей работой, подготовка или фиксация локальных правок или передача другой базы
-
Первый коммит: первый коммит репозитория не имеет ничего более раннего для сравнения, поэтому ultrareview анализирует каждый файл в нем после вашего подтверждения в диалоговом окне запуска. Если у вас есть неотслеживаемые файлы, он отказывает вместо этого и говорит вам
git addте, которые вы хотите анализировать. Применяются те же ограничения размера. Первый коммит анализируется целиком только после этого подтверждения, поэтому подкомандаclaude ultrareviewиclaude -pотказывают в нем и указывают вам на интерактивную сессию вместо этого. Требует Claude Code версии 2.1.277 или позже -
Нет базы слияния: когда ваша ветвь не имеет общей истории с базовой ветвью, или репозиторий не имеет базовой ветви для сравнения, ultrareview анализирует каждый отслеживаемый файл в репозитории вместо этого. Резервный вариант требует полного клона и применяет те же ограничения размера. Он запускается только когда вы подтверждаете в диалоговом окне запуска или запускаете подкоманду
claude ultrareviewсамостоятельно. Вclaude -pи везде, где ни то, ни другое не происходит, ultrareview отказывает, говорит, что анализ охватит каждый файл, и указывает вам на интерактивную сессию. При проверке без ветвей или других ссылок, такой как отсоединенный HEAD, созданный путем проверкиFETCH_HEADпосле получения URL, Claude Code отказывает в анализе и предлагает сначала создать ветвь
Цены и бесплатные запуски
Ultrareview — это премиум-функция, которая выставляет счета за дополнительное использование, а не за включенное использование в вашем плане.- Бесплатные запуски: три запуска Pro и Max — это одноразовое выделение на учетную запись и не обновляются.
- Стоимость одного анализа: после использования бесплатных запусков обычно от 5 до 25 долларов в дополнительном использовании в зависимости от размера изменения, что соответствует оценке, которую показывает диалоговое окно запуска перед каждым запуском.
- Когда запуск считается начатым: после запуска облачной сессии. Анализ, который вы остановили рано или который не завершился, все равно использует бесплатный запуск; платный анализ выставляет счет только за ту часть, которая была выполнена.
/usage-credits для проверки или изменения параметра дополнительного использования.
Claude Code просит вас подтвердить выставление счетов за дополнительное использование один раз за разговор: когда вы начинаете новый разговор, например с /clear, Claude Code показывает подтверждение снова для следующего платного анализа.
Отслеживание выполняемого анализа
Анализ обычно занимает от 15 до 25 минут. Анализ работает как фоновая задача, поэтому вы можете продолжать работать в вашей сессии или запускать другие команды. Если вы выбрали публикацию результатов в pull request, держите сессию открытой до завершения анализа; если сессия завершится раньше, Claude Code ничего не публикует. Используйте/tasks для просмотра выполняемых и завершенных анализов, открытия подробного представления анализа или остановки выполняемого анализа. Если вы остановите анализ, Claude Code архивирует облачную сессию и не возвращает частичные результаты.
Claude также может сообщить вам, что анализ был остановлен или что его сессия не была найдена:
- Если облачная сессия анализа остановлена или архивирована на claude.ai до завершения анализа, Claude сообщит вам, что она была остановлена.
- Если облачная сессия анализа была удалена, или вы вошли в другой аккаунт Claude или организацию с момента её запуска, Claude сообщит вам, что сессия не была найдена.
- Если вы переключили аккаунты, анализ может всё ещё завершиться под аккаунтом, который его запустил. Если анализ всё ещё выполняется, войдите обратно под этот аккаунт и возобновите разговор с помощью
claude --resume, чтобы переподключить его.
Запуск ultrareview неинтерактивно
Используйте подкомандуclaude ultrareview для запуска ultrareview из CI или скрипта без интерактивной сессии. Подкоманда запускает тот же обзор, что и /code-review ultra, блокирует выполнение до завершения удалённого обзора и выводит результаты в stdout.
/code-review ultra, когда база слияния не существует. Передайте номер PR, чтобы проверить pull request на github.com, или базовую ветку для проверки относительно неё; обработка базовой ветки соответствует интерактивной команде.
Вы даёте согласие на резервный вариант для всего репозитория и на подтверждение выставления счёта и условия при запуске подкоманды, поэтому выполнение начинается без ожидания ввода. Запуск её самостоятельно — это то, что считается согласием. Когда Claude запускает подкоманду для вас, например через инструмент Bash, Claude Code отказывает в проверке всего репозитория.
claude -p '/code-review ultra' не возвращает вам результаты, поэтому в скриптах используйте claude ultrareview. Запуск с -p запускает облачный обзор и завершается, не дожидаясь его окончания. Если обзор будет списывать кредиты использования, запуск с -p останавливается, не запуская его. До v2.1.218 /code-review ultra в неинтерактивной сессии запускал локальный обзор.
claude ultrareview записывает сообщения о ходе выполнения в stderr, чтобы stdout оставался пригодным для анализа. Используйте эти флаги для управления выводом, таймаутом и тем, следует ли публиковать результаты:
Запуск
claude ultrareview требует той же аутентификации и конфигурации кредитов использования, что и /code-review ultra.
Подкоманда завершается с одним из трёх кодов:
- 0: обзор завершился, с результатами или без них
- 1: обзор не запустился или был остановлен до завершения, облачная сессия ошибилась или истёк тайм-аут
- 130: вы прервали подкоманду с помощью Ctrl-C
--post подкоманда начинает публикацию сразу после вывода результатов и выводит ссылку в stderr.
- Если выполнение не удаётся, остановлено или истекает таймаут, подкоманда ничего не публикует.
- Если обзор завершится, но комментарий не будет опубликован, Claude Code выведет причину в stderr, а результаты останутся в stdout, чтобы вы могли опубликовать их вручную.
Сравнение ultrareview и /code-review
Оба вида ревью анализируют код, но вы используете их на разных этапах своего рабочего процесса.
Используйте
/code-review для быстрой обратной связи во время работы или передайте номер PR, чтобы провести ревью pull request коллеги перед его одобрением. Используйте /code-review ultra перед слиянием существенного изменения, когда вам нужен более глубокий проход, который выявляет проблемы, способные ускользнуть от локального ревью.
Связанные ресурсы
- Claude Code в веб-версии: узнайте, как работают удаленные сессии и облачные изолированные среды
- Эффективное управление затратами: отслеживайте использование и устанавливайте лимиты расходов