Skip to main content
/code-review — это команда, которую вы вводите в промпт Claude Code в той сессии, где работаете. Claude проверяет изменения в вашей ветке, ищет ошибки корректности и сообщает о найденном в вашем диалоге. В зависимости от модели и уровня effort ревью также охватывает улучшения, связанные с повторным использованием кода, упрощением и эффективностью. Команда работает на любом тарифном плане. Ревью выполняется в вашей собственной сессии, поэтому оно учитывается в использовании вашего плана или в биллинге API так же, как и остальная часть сессии.
Чтобы каждый pull request в репозитории автоматически проходил ревью на GitHub, см. Code Review — управляемый сервис, который владелец (Owner) включает для вашей организации.
/review — это псевдоним /code-review. До версии v2.1.223 /review была отдельной командой, которая выполняла однопроходное ревью pull request на GitHub в режиме только для чтения.
1

Запустите /code-review

Выполните команду:
Без указания цели ревью охватывает изменения в вашей текущей ветке. Чтобы вместо этого направить ревью на pull request, другую ветку, путь или диапазон коммитов, см. раздел Выбор объекта ревью.Вы также можете добавить флаги:
  • --fix: дополнительно просит Claude применить найденные исправления к рабочему дереву после ревью. Его правки проходят через ваш режим разрешений.
  • --comment: публикует результаты в pull request на GitHub в виде встроенных комментариев или в merge request на GitLab в виде одной заметки
2

Продолжайте работу

Ревью выполняется как фоновый субагент с собственным контекстным окном, поэтому оно не заполняет ваш диалог. Результаты появляются в вашем диалоге после завершения ревью.
3

Действуйте по результатам

Попросите Claude исправить то, что нашло ревью. С флагом --fix или --comment Claude применяет или публикует результаты в рамках ревью, и вас могут попросить одобрить его правки.

​
Выбор объекта ревью

Чтобы провести ревью чего-либо, кроме текущей ветки, введите цель после уровня effort и флагов. Claude получает этот текст как цель ревью. Целью может быть номер pull request, имя ветки, путь к файлу или диапазон ревизий Git. Найдите в первом столбце то, что вы хотите проверить, и введите то, что указано во втором столбце: Без указания цели /code-review проверяет коммиты вашей ветки, опережающие её upstream-ветку, а также ваши незакоммиченные изменения. Если у ветки нет upstream, Claude сравнивает с main или с предыдущим коммитом. С ultra Claude Code интерпретирует цель иначе, как описано в разделе Текст после уровня effort и флагов.

​
Что ревью читает и редактирует

Проверьте следующее перед запуском ревью, особенно с --fix:
  • Правки: без --fix инструкции ревью запрашивают у Claude только отчёт. С --fix они также просят его применить результаты к вашему рабочему дереву. В любом случае любая правка проходит через ваш режим разрешений.
  • Откат: фоновое ревью применяет свои правки --fix вне чекпоинтов вашей сессии. После такого ревью /rewind восстанавливает только те файлы, которые Claude уже редактировал в вашем диалоге. Правки ревью в других файлах остаются, поэтому используйте git, чтобы их откатить. Когда ревью выполняется в основном режиме, оно редактирует рабочее дерево во время вашего собственного хода, поэтому /rewind восстанавливает его правки как обычно.
  • Инструкции: ревью следует вашему CLAUDE.md, в том числе при неинтерактивном запуске с -p. Оно не читает REVIEW.md. Этот файл настраивает управляемый сервис Code Review для pull request на GitHub.

​
Как сообщается о результатах

Claude сообщает о результатах в виде текста в ответе в обоих этих случаях:
  • В сессии терминала, где /code-review запускает ревью как ответвлённый субагент
  • При запуске с -p с текстовым выводом или выводом в JSON
В хост-приложении, которое запрашивает список результатов, например в десктопном приложении, Claude вместо этого сообщает о результатах ревью через инструмент ReportFindings. Отчёт отображается как список результатов, и каждая запись показывает расположение в файле, краткое описание в одно предложение и тег категории, например correctness, если он есть у результата. Запрос хоста применяется на любом уровне effort и требует Claude Code v2.1.218 или более поздней версии. Когда Claude позже в сессии исправляет найденные проблемы, он снова сообщает о них. Затем Claude Code помечает каждый результат в обновлённом списке как исправленный, пропущенный или не требующий изменений.

​
Настройка effort и аргументов

Помимо --fix и --comment, команда принимает следующие флаги:
  • --post: при облачном ревью ultra для pull request на github.com заранее выбирает публикацию готовых результатов в PR в диалоговом окне запуска. См. Публикация результатов в pull request. Требуется Claude Code v2.1.227 или более поздней версии.
  • --max-findings <n>, --max-findings all или --max-findings default: сообщает до n результатов или все результаты с all вместо обычного лимита ревью. Когда ревью сообщает результаты через инструмент результатов, лимит составляет 32. Последующие ревью повторно используют введённое значение, пока вы не передадите --max-findings default, но значение, переданное при неинтерактивном запуске с -p, не запоминается. Требуется Claude Code v2.1.288 или более поздней версии.
Передайте уровень effort, чтобы найти баланс между охватом и уверенностью. На уровне low ревью сообщает о результатах, в которых наиболее уверено, поэтому вы видите меньше ложных срабатываний. От medium до max ревью расширяет охват. Если вы не вводите уровень, ревью повторно использует последний введённый вами уровень от low до max, даже из предыдущей сессии. Claude Code показывает уведомление, например Reusing high effort, the level you typed last time. Следующие правила определяют, какой уровень используется при запуске:
  • Ввод уровня: введённый вами уровень, например /code-review high, меняет то, что будут повторно использовать последующие запуски
  • Неинтерактивные запуски: уровень, переданный при неинтерактивном запуске с -p, не обновляет запомненный уровень
  • ultra: ревью не использует и не обновляет запомненный уровень
  • Уровень ни разу не вводился: ревью использует текущий уровень effort сессии
До версии v2.1.223 /code-review без уровня всегда использовала текущий уровень effort сессии.

​
Публикация результатов в merge request на GitLab

Когда вы передаёте --comment для merge request на GitLab, Claude Code публикует результаты через CLI GitLab glab. Требуется Claude Code v2.1.257 или более поздней версии. Если glab не установлен, Claude вместо этого выводит результаты в терминал. Передайте merge request в виде URL или ссылки !123. Claude Code рассматривает простой номер или имя ветки как merge request, только если origin рабочей копии находится на gitlab.com. Для самостоятельно управляемого экземпляра GitLab передайте URL или форму !123.

​
Текст после уровня effort и флагов

После уровня effort и флагов Claude Code читает остаток строки как цель ревью. Аргумент ultra меняет эту интерпретацию:
  • С ultra: Claude Code интерпретирует одно слово как базовую ветку или номер PR. Более длинный текст, не являющийся именем ветки или PR, становится заметкой, прикреплённой к ревью. /code-review ultra check my auth changes проверяет вашу текущую ветку, и Claude соотносит результаты с вашей заметкой.
  • Без ultra: всё оставшееся является целью ревью, даже если начинается с имени другой команды. /code-review /fix-issue 123 проводит ревью с /fix-issue 123 в качестве текста цели, а не загружает /fix-issue как второй составной скилл. До версии v2.1.218 команда, указанная после /code-review, раскрывалась как отдельный скилл.

​
Запуск в основном режиме

Чтобы ревью выполнялось в основном режиме (не в фоне), сделайте одно из следующего:
  • Запустите его в неинтерактивном режиме с флагом -p или через Agent SDK. Claude Code дожидается завершения ревью и включает результаты в ответ, за исключением ultra, которое не ожидает облачного ревью.
  • Установите CLAUDE_CODE_DISABLE_BACKGROUND_TASKS в 1, что также отключает все остальные функции фоновых задач
  • Снова запустите /code-review, пока предыдущее ревью ещё выполняется
До версии v2.1.218 ревью выполнялось внутри вашего диалога.

​
Запуск ревью самим Claude

Claude может запустить /code-review самостоятельно, без ввода команды с вашей стороны:
  • Когда вы просите обычными словами: попросите Claude проверить ваши изменения, и он может запустить скилл
  • Из запланированной задачи: запланированная задача с /code-review в качестве промпта запускает ревью
Запланированная задача никогда не запускает облачное ревью, поэтому планируйте /code-review без аргумента ultra. Чтобы запретить и Claude, и запланированным задачам запускать ревью, сохранив при этом возможность вводить /code-review вручную, добавьте запись skillOverrides в файл настроек, например ~/.claude/settings.json:
До версии v2.1.246 Claude самостоятельно запускал /code-review только там, где это включал флаг функции, получаемый от Anthropic. В сессиях, которые не получают флаги функций, /code-review запускалась только при вводе вручную, а запланированная /code-review доходила до Claude как обычный текст.

​
Переход к ultrareview

/code-review ultra --fix запускает более глубокое ultrareview в облаке, а затем просит Claude применить его результаты к вашему рабочему дереву, когда они вернутся в вашу сессию. Ultrareview использует собственную область действия:
  • Что сравнивается: ваша текущая ветка с веткой репозитория по умолчанию, а также незакоммиченные и проиндексированные изменения в рабочем дереве
  • Конфиденциальные файлы: для незакоммиченных изменений в файлах с именами, похожими на учётные данные или ключи, например файлах .env и *.tfvars, Claude Code следует правилам загрузки локального репозитория в облачную сессию
  • Другая база: передайте имя ветки, например /code-review ultra develop, чтобы сравнить с другой базой
Когда целью является pull request на github.com, вы можете поручить Claude опубликовать готовые результаты в PR в виде комментария от вашей учётной записи GitHub. Требуется Claude Code v2.1.227 или более поздней версии.
Ultrareview требует аутентификации с учётной записью claude.ai. Оно недоступно в Amazon Bedrock, Google Cloud’s Agent Platform или Microsoft Foundry, а также для организаций с включённым Zero Data Retention или применённой конфигурацией HIPAA. В этих случаях /code-review ultra вместо этого запускает локальное ревью в вашей сессии. Организации, использующие ключи шифрования, управляемые клиентом (CMEK), не могут запускать ultrareview. Чтобы проверить изменения локально, выполните /code-review.
Чтобы запустить облачное ревью из скрипта или задания CI, используйте подкоманду claude ultrareview, которая дожидается результатов и выводит их в stdout.

​
Изменение ревью и создание собственного на его основе

/code-review — это встроенный скилл: его инструкции встроены в Claude Code, поэтому на диске нет файла SKILL.md, который можно открыть или отредактировать. Чтобы каждое ревью следовало правилам проекта, добавьте их в ваш CLAUDE.md. Чтобы пойти дальше, начните с одной из этих страниц:
  • Замена команды: скилл проекта или личный скилл с именем code-review запускается вместо встроенного, а псевдоним /review продолжает запускать встроенное ревью. См. Разрешение конфликтов скиллов с одинаковыми именами.
  • Создание собственного ревьюера: напишите субагента-ревьюера или скилл для ревью
  • Использование смежной команды: /simplify проверяет только возможности улучшения кода и применяет свои исправления, а /verify запускает ваше приложение, чтобы подтвердить, что изменение работает
До версии v2.1.147 команда называлась /simplify и по умолчанию применяла исправления. Если вы использовали /simplify в скриптах для поиска ошибок, перейдите на /code-review --fix.
  • Code Review: управляемый сервис, который проводит ревью каждого pull request на GitHub для вашей организации
  • Ultrareview: настройка, ограничения и стоимость более глубокого облачного ревью
  • Команды: краткий справочник по /code-review, /review, /simplify и /verify
  • Скиллы: как работают встроенные скиллы и как написать собственный