Что такое /code-review в Claude Code: как пользоваться, какой уровень выбрать, сколько стоит ultra, недостатки и результаты реального запуска

/code-review в Claude Code — это команда, которая читает ваш текущий diff (незакоммиченные изменения и коммиты, опережающие upstream), ищет в нём ошибки корректности и сообщает о них. Это встроенный навык (bundled skill), который поставляется вместе с Claude Code, поэтому запускать его можно прямо из терминала, не устанавливая никакого GitHub-приложения. Команда /review делает то же самое.

Статья опирается на исходный текст официальной документации Claude Code (раздел «Review a diff locally» страницы Code Review, страницы Find bugs with ultrareview и Commands), а также на CHANGELOG и объясняет, что умеет команда, как выбирать между уровнями (от low до max) и ultra и как пользоваться --fix и --comment. Все описанные здесь особенности сверены с первоисточником по состоянию на 2 октября 2026 года. В разделах 9 и 10 также рассказано, что получилось, когда я на самом деле запустил /code-review high на коде этого сайта, и какие недостатки обнаружились по ходу дела.

1. Что такое /code-review: встроенный навык, который ищет ошибки в diff

В справочнике Commands команда описана так: она проверяет текущий diff — или переданные ей номер PR, ветку либо путь — на ошибки корректности. Дальше уточняется, что в зависимости от модели и уровня effort ревью также затрагивает возможности улучшить код, а страница Code Review говорит, что команда сообщает об ошибках корректности и о возможностях переиспользования, упрощения и повышения эффективности. Главная задача — поиск ошибок, а предложения по улучшению кода появляются в зависимости от условий.

Синтаксис выглядит так:

/code-review [low|medium|high|xhigh|max|ultra] [--fix] [--comment] [pr#|branch|path]

Четыре свойства стоит знать заранее:

• Работает в фоне. Ревью выполняется как субагент со своим окном контекста, поэтому не засоряет ваш диалог. Результаты приходят в диалог, когда проверка завершится.
• Читает CLAUDE.md, но не REVIEW.md. REVIEW.md — это файл инструкций для версии Code Review в виде GitHub App, о ней ниже.
• /review — псевдоним. Согласно документации, до v2.1.223 /review был отдельной командой, которая за один проход читала PR на GitHub. Теперь это то же самое, что /code-review.
• Раньше команда называлась /simplify. По данным CHANGELOG, в v2.1.147 /simplify переименовали в /code-review, а позже /simplify вернулся как отдельная команда, которая только улучшает код и не ищет ошибок.

В терминале и при запуске с -p результаты приходят текстом в ответе. В приложениях, которые запрашивают список находок, например в десктопном приложении, они показываются списком: у каждой записи есть место в файле, краткое описание в одно предложение и тег категории вроде correctness. Когда Claude потом их исправляет, каждая запись помечается как исправленная, пропущенная или не требующая изменений.

2. Базовое использование: что проверять

Самый простой вариант — ввести команду без аргументов в той сессии, где вы работаете.

# Проверить коммиты впереди upstream + незакоммиченные изменения
/code-review

# Проверить на заданном уровне
/code-review high

# Передать номер PR, чтобы проверить pull request коллеги
/code-review high 1234

# Передать диапазон веток
/code-review main...my-feature

Без аргументов проверяются, по словам документации, коммиты вашей ветки, опережающие её upstream, плюс все незакоммиченные изменения. Если ни в ветке, ни в рабочем дереве нет ничего нового, сообщать будет не о чем. Чтобы проверить что-то другое, передайте цель:

Если не указан ultra, всё, что осталось после уровня и флагов, считается целью ревью. Например, /code-review /fix-issue 123 не загружает /fix-issue вторым навыком, а воспринимает текст /fix-issue 123 как цель.

В следующих случаях ревью идёт не в фоне, а на переднем плане, прямо в вашем диалоге: если запустить его повторно, пока предыдущее ещё выполняется; в неинтерактивном режиме с -p или через Agent SDK; и если задать переменной окружения CLAUDE_CODE_DISABLE_BACKGROUND_TASKS значение 1 (это заодно отключает и все остальные фоновые функции).

3. Выбор уровня: от low до max

Уровень — это компромисс между широтой проверки и тем, насколько уверенными должны быть находки. Документация объясняет, что на low и medium ревью сообщает только о находках, в которых больше всего уверено, поэтому ложных срабатываний меньше, а уровни от high до max расширяют охват и могут включать находки, в которых ревью уверено меньше.

Главный ориентир — сколько сил вы готовы потратить на разбор находок. Для быстрой проверки между задачами берите low или medium; если хотите поймать больше перед слиянием и готовы сами отбрасывать ложные срабатывания — high и выше. Такое разделение следует описанию в документации. То, что более высокие уровни расходуют больше токенов, — та же логика, что и у effort вообще, но никаких цифр по времени или расходу для каждого уровня официальная документация не приводит. Что такое effort, объясняется в нашей статье о настройке effort в Claude Code.

Если уровень не указан, используется тот, что вы вводили последним

Если не указать уровень, ревью возьмёт последний уровень от low до max, который вы вводили сами. Это касается и уровня, введённого в прошлой сессии, — тогда появится уведомление вроде Reusing high effort, the level you typed last time. Подробности:

• Запомненный уровень обновляется, когда вы вводите, например, /code-review high в интерактивной сессии.
• Уровень, переданный при неинтерактивном запуске с -p, не запоминается.
• ultra не использует запомненный уровень и не обновляет его.
• Если вы ни разу не вводили уровень, используется текущий effort сессии.

В документации также отмечено, что до v2.1.223 /code-review без уровня всегда использовал текущий effort сессии. Если вы опускаете уровень в расчёте на старое поведение, ревью может пойти на более высоком (или более низком) уровне, чем вы ждёте, поэтому если это важно, указывайте уровень каждый раз.

4. Как пользоваться --fix и --comment

Правки --fix может не отменить /rewind

Это то, за чем нужно следить внимательнее всего. Согласно документации, правки, которые --fix вносит при фоновом ревью, делаются вне контрольных точек вашей сессии, поэтому /rewind их не отменяет. Откатывайте их через git. Если же ревью идёт на переднем плане (предыдущее ревью ещё выполняется, запуск с -p и т. п.), правки вносятся в ваш собственный ход, и /rewind восстанавливает их как обычно.

# Перед --fix закоммитьте текущее состояние, чтобы было легко вернуться
git add -A && git commit -m "wip: before code-review --fix"
/code-review medium --fix

# Если результат не понравился, откатите его через git
git diff
git restore .

Можно также запустить ревью без --fix, прочитать результаты и попросить исправить только пункты 1 и 3. Если вы не уверены, что стоит применять все находки, так надёжнее. Контрольные точки подробно разобраны в нашей статье о контрольных точках и /rewind.

Куда публикует --comment

• Pull request на GitHub: находки публикуются построчными комментариями на соответствующих строках.
• Merge request на GitLab: находки публикуются одной заметкой через glab, CLI для GitLab (v2.1.257 или новее). Если glab не установлен, находки только выводятся в терминал.

На GitLab передавайте MR в виде URL или в форме !123. Просто номер или имя ветки считается MR, только если origin находится на gitlab.com; для GitLab на собственном сервере документация советует использовать URL или !123. Нужна ли для публикации на GitHub аутентификация, например через gh, в официальной документации на 2 октября 2026 года не сказано.

5. ultra: многоагентное ревью в облаке и цены

/code-review ultra — это глубокое ревью, при котором несколько агентов-ревьюеров параллельно работают в песочнице в облаке Anthropic, а не на вашем компьютере. Это исследовательское превью под названием ultrareview, и в аккаунтах, где оно доступно, /ultrareview служит псевдонимом. Официальная документация называет три преимущества перед локальным /code-review:

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

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

ultra оплачивается из usage credits (дополнительного расхода), а не из лимитов, включённых в тариф.

• Бесплатные запуски: три запуска на Pro и Max — это разовая квота на аккаунт, она не обновляется.
• Стоимость запуска: когда бесплатные запуски закончатся, ревью обычно стоит от $5 до $25 из usage credits в зависимости от размера изменения. Перед каждым запуском диалог показывает оценку.
• Как считаются запуски: запуск засчитывается, как только стартует облачная сессия. Остановка на полпути или сбой всё равно расходуют один бесплатный запуск. Платные ревью оплачиваются по фактически выполненному объёму.
• Условие: платное ревью не запустится, если usage credits не включены. Проверить можно командой /usage-credits. Подтверждение оплаты из usage credits запрашивается один раз за диалог.

Дорого ли «$5–25» или дёшево, зависит от того, с чем сравнивать. По сравнению с /code-review на уровнях от low до max, который укладывается в лимиты тарифа без отдельной платы, ultra — это дополнительный расход. А по сравнению с описанной ниже версией Code Review в виде GitHub App (в среднем $15–25 за ревью) диапазоны цен пересекаются. Но Code Review — другая система, которая автоматически запускается на каждый PR, а цифры выражены по-разному («в среднем» против «обычного диапазона»), поэтому напрямую их сравнивать нельзя.

Время, охват и где недоступно

• Длительность: обычно от 5 до 10 минут. Ревью идёт в фоне, проверить его состояние или остановить можно через /tasks. При остановке частичные результаты не возвращаются.
• Охват: без аргументов проверяется текущая ветка относительно ветки по умолчанию в репозитории, а также незакоммиченные и проиндексированные изменения. Это другая точка отсчёта, чем «впереди upstream» у локального /code-review. Чтобы сменить базу, передайте имя ветки, например /code-review ultra develop.
• Ревью PR: если передать номер, например /code-review ultra 1234, с вашего компьютера ничего не загружается — облако клонирует PR напрямую. Это работает для github.com и подключённого GitHub Enterprise Server.
• Ограничения: ревью ветки по умолчанию охватывает до 500 изменённых файлов и 8 000 изменённых строк (документация оговаривает, что эти значения могут меняться).
• Где недоступно: нужен вход через аккаунт claude.ai; функция недоступна через Amazon Bedrock, Google Cloud Agent Platform и Microsoft Foundry, а также организациям с Zero Data Retention. Там, где ultra недоступен, /code-review ultra выполняется как локальное ревью.

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

Публикация результатов в PR (--post) и запуск из скриптов

При ревью PR на github.com через ultra можно опубликовать результаты в PR одним комментарием от вашего собственного аккаунта GitHub (v2.1.227 или новее). Это обычный комментарий, а не review и не одобрение, и по умолчанию публикация выключена (--no-post). /code-review ultra 1234 --post заранее выбирает публикацию в диалоге запуска, но подтверждение перед стартом всё равно появится. Публикация начинается, когда ревью завершится, поэтому сессию нужно держать открытой до конца.

Для CI и скриптов используйте подкоманду claude ultrareview. Она дожидается результатов и выводит их в stdout (доступны --json, --timeout (по умолчанию 45 минут) и --post). claude -p '/code-review ultra' только запускает ревью и завершается, не дожидаясь его, так что результатов вы не получите, а если требуется оплата из usage credits, ревью даже не запустится.

# Проверить PR 1234 через ultra из скрипта и получить результаты
claude ultrareview 1234

# Взять за базу не ветку по умолчанию
claude ultrareview origin/main

6. Чем отличается от похожих функций

В Claude Code есть несколько функций ревью с похожими названиями. Особенно легко спутать функцию GitHub App под названием Code Review, потому что она описана на той же странице документации, что и команда /code-review.

• /simplify: четыре агента параллельно проверяют переиспользование существующих хелперов, упрощение, эффективность и то, на правильном ли уровне абстракции сделано изменение, а затем применяют исправления. Ошибки корректности он не ищет. Страница Code Review также советует: если вы использовали /simplify в скриптах для поиска ошибок, переходите на /code-review --fix.
• /security-review: проверяет diff между текущей веткой и веткой по умолчанию в origin на уязвимости вроде инъекций, проблем с аутентификацией и утечек данных. Нужен remote origin.
• Code Review (GitHub App): после того как Owner организации включит функцию, несколько агентов на инфраструктуре Anthropic изучают PR при его открытии, при каждом push или когда кто-то пишет @claude review, и оставляют построчные комментарии. Это исследовательское превью только для Team и Enterprise (недоступно организациям с Zero Data Retention). Цена зависит от токенов и в среднем составляет $15–25 за ревью, в среднем оно занимает 20 минут и оплачивается из usage credits отдельно от лимитов тарифа. Что именно отмечать, можно настроить через REVIEW.md.
• claude-code-action: запускает Claude Code в workflow GitHub Actions вашего собственного репозитория. Пример ревью в официальной документации вызывает версию навыка code-review в виде плагина (/code-review:code-review --comment), чтобы оставить комментарий в PR. Стоимость — цены Claude API (или токены подписки) плюс время выполнения GitHub Actions.

Проще всего разложить их по трём вопросам: где работает, кто платит и что смотрит. Чтобы проверить свой diff локально, берите /code-review; чтобы глубоко проверить перед слиянием — ultra; чтобы автоматически проверять каждый PR команды — Code Review в виде GitHub App или claude-code-action.

7. Когда Claude запускает его сам и как это запретить

Claude может запустить /code-review по собственной инициативе. Если обычными словами попросить его проверить изменения, он может запустить навык, даже если вы не вводили команду, а запланированная задача с /code-review в качестве промпта тоже выполнит ревью. Однако запланированная задача никогда не запускает ultra (облачное ревью). ultra запускается, только когда вы сами вводите /code-review ultra.

Чтобы ни Claude, ни запланированные задачи не запускали его, но при этом команда оставалась доступной для ручного ввода, добавьте следующее в файл настроек, например ~/.claude/settings.json:

{
  "skillOverrides": {
    "code-review": "user-invocable-only"
  }
}

Фоновые ревью выполняются как субагенты. Как субагенты обращаются с контекстом и моделями, объясняется в нашей статье о субагентах и командах агентов.

8. Что и когда использовать

Сравнительная таблица в официальной документации называет локальный /code-review подходящим для быстрой обратной связи по ходу работы, а ultra — для уверенности перед слиянием крупных изменений. В повседневной работе это выглядит так:

Поскольку 3 бесплатных запуска ultra не обновляются, их выгоднее приберечь для изменений с широкой зоной влияния или для случаев, когда локальное ревью не сняло вопросов, а не тратить на мелкие правки. Точно так же /security-review стоит брать, когда нужно сосредоточиться на уязвимостях, а /simplify — когда хочется навести порядок в читаемости, а не искать ошибки; именно так, по назначению, их разделяет документация.

9. Я попробовал его на коде этого сайта

2 октября 2026 года я запустил /code-review high на коде детектора ИИ-изображений, опубликованного на этом сайте. Инструмент читает метаданные и данные о происхождении (C2PA) изображения целиком внутри браузера, а целью были четыре файла: логика интерфейса, логика разбора (Web Worker), контроллер и шаблон страницы. Я запускал его в десктопном приложении Claude Code (встроенный Claude Code 2.1.284, модель Opus 5.5) сразу после того, как сам поискал ошибки и исправил пять.

Каждая находка приходила в виде «какой файл, какая строка» и «какой ввод к чему приводит». Я сверил каждую с исходным кодом библиотеки, через которую инструмент читает метаданные изображений (exifr), и с тестовыми изображениями, которые сам подготовил, а затем исправил все 9, которые оказались реальными. Основные из них:

Итак, даже сразу после того, как я сам всё поискал и поправил, оставалось 9 ошибок другого рода. Особенно трудно было заметить без чтения исходников библиотеки находки о допущениях вида «библиотека должна вести себя так». При этом это результат одного запуска на одной кодовой базе. Не факт, что ревью каждый раз будет находить реальные ошибки с той же долей, и я не сравнивал его с low, medium или max и не пробовал платный ultra.

10. Недостатки и оговорки

По опыту использования и по официальной документации — пять моментов, на которые стоит обратить внимание:

• Расходует ваши лимиты. Локальные ревью тоже идут из обычного расхода Claude, а более высокие уровни расходуют больше. С ultra, когда пользователи Pro и Max израсходуют 3 бесплатных запуска (Team и Enterprise — с самого начала), вы платите примерно $5–25 за запуск из usage credits.
• Не принимайте находки на веру. Документация сама говорит, что на high и выше могут попадаться находки с меньшей уверенностью. В этот раз реальными оказались 9 из 10, но проверка каждой всё равно требует времени.
• Правки --fix нельзя отменить через /rewind. Изменения, сделанные в фоне, приходится откатывать через git, поэтому перед использованием сделайте коммит.
• Проверяет только корректность кода. Соответствие фактам текстов или содержимого настроек оно не проверяет. Например, частая для этого сайта проблема — «в статье написано не то, что в официальной спецификации» — вне его зоны.
• Claude может запустить его сам. Если вам это не нужно, настройка из раздела 7 ограничит запуск ручным вводом.

Мой вывод: усилия и расход оправдал один запуск на high после написания нового кода или крупного изменения. А вот для правок текста или мелких изменений настроек он не подходит.

Итоги

/code-review — это встроенный навык, который проверяет ваш локальный diff или PR с упором на ошибки корректности. Он работает в фоне и не прерывает вашу работу, а его стоимость укладывается в обычный расход. На low или medium вы получаете только уверенные находки; на уровнях от high до max охват шире, но результаты нужно отсеивать; а если уровень не указать, используется последний введённый.

--fix, который сразу вносит исправления, удобен, но фоновые правки нельзя отменить через /rewind, поэтому надёжнее сначала сделать коммит. Если нужно посмотреть глубже, ultra около 5–10 минут работает в облаке и возвращает только проверенные находки; на Pro и Max есть 3 разовых бесплатных запуска, после которых один запуск стоит примерно $5–25 из usage credits. Похожие по названию Code Review в виде GitHub App и claude-code-action — другие инструменты, которые отличаются и местом работы, и стоимостью.

Когда я один раз запустил его на коде этого сайта, 9 из 10 находок оказались реальными ошибками — и это сразу после того, как я сам всё исправил. Каждую находку нужно проверять, но один запуск после нового кода или крупного изменения того стоит.

FAQ

Q. Чем /review отличается от /code-review?

A. Сейчас это одно и то же. /review — псевдоним /code-review, он принимает те же уровни и флаги. Согласно официальной документации, до v2.1.223 /review был отдельной командой только для чтения, которая за один проход проверяла PR на GitHub.

Q. Стоит ли /code-review дополнительных денег?

A. На уровнях от low до max — нет. В сравнительной таблице официальной документации сказано, что его стоимость входит в обычный расход (counts toward normal usage). Дополнительно платить приходится за ultra: после 3 бесплатных запусков на Pro и Max это примерно $5–25 за запуск из usage credits.

Q. 3 бесплатных запуска ultra обновляются каждый месяц?

A. Нет. Официальная документация описывает три запуска на Pro и Max как разовую квоту на аккаунт, которая не обновляется. Ревью, остановленные на полпути или завершившиеся сбоем, тоже засчитываются как один запуск. У Team и Enterprise бесплатных запусков нет.

Q. Можно ли отменить изменения, внесённые --fix?

A. Через git. Правки ревью, которое шло в фоне, делаются вне контрольных точек, поэтому /rewind их не отменяет. Если ревью шло на переднем плане (предыдущее ревью ещё выполнялось, запуск с -p и т. п.), /rewind может их восстановить. Если сомневаетесь, сделайте коммит перед использованием --fix.

Q. Применяются ли правила из REVIEW.md к /code-review?

A. Нет. Локальный /code-review следует CLAUDE.md, но не читает REVIEW.md. REVIEW.md — файл инструкций для версии Code Review в виде GitHub App. Правила, которым должно следовать локальное ревью, записывайте в CLAUDE.md.

Источники

• Официальная документация Claude Code: Code Review (включая раздел «Review a diff locally»)
• Официальная документация Claude Code: Find bugs with ultrareview
• Официальная документация Claude Code: Commands
• Официальная документация Claude Code: Claude Code GitHub Actions
• Claude Code: CHANGELOG

Все источники сверены с исходным текстом 2 октября 2026 года. В официальной документации указано, что ultrareview — исследовательское превью, и его функции, цены и доступность могут меняться.