Claude для ревью кода: рабочий процесс на практике

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

Три способа и кому какой подходит

Если вы пишете код ежедневно, начните со среднего. Ему не нужно приложение для GitHub, он не стоит ничего сверх вашего тарифа и ловит именно тот класс ошибок, который важнее всего поймать, — те, что ещё лежат у вас в рабочей копии.

Ревью до пуша

В сессии Claude Code команда /code-review проверяет коммиты вашей ветки, опережающие апстрим, плюс всё незакоммиченное. Можно направить её и на конкретную цель — путь к файлу, имя ветки, номер пул-реквеста или диапазон вроде main...my-feature.

На практике важны два флага. --fix применяет найденное к рабочей копии после ревью, а --comment публикует замечания прямо в пул-реквесте. Само ревью идёт в фоне со своим контекстом и не вытесняет разговор, который вы вели.

Можно настроить и глубину поиска. Низкий уровень усилий сообщает только о том, в чём модель уверена, — меньше ложных срабатываний; высокий расширяет охват и включает то, в чём она сомневается. Для быстрой проверки перед пушем обычно правильнее низкий.

Автоматическое ревью пул-реквестов

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

Три вещи, которые стоит знать до того, как предлагать это команде. Это исследовательское превью, доступное только на тарифах Team и Enterprise. Оно никогда не блокирует мерж: проверка всегда завершается нейтрально, поэтому ваш текущий процесс ревью остаётся нетронутым. И оплачивается оно отдельно от тарифа, через кредиты использования, в среднем $15–25 за одно ревью, причём цена растёт с размером пул-реквеста.

Счёт определяется выбранным триггером. Ревью на каждый пуш ловит проблемы по мере развития пул-реквеста и умножает стоимость на число пушей; ручной режим не стоит ничего, пока кто-нибудь не напишет @claude review в пул-реквесте.

Изменение, о котором стоит знать

До обновления в июле 2026 года комментарий @claude review заодно подписывал пул-реквест на ревью при каждом следующем пуше. Больше не подписывает. Если процесс, скопированный из старой статьи, на это рассчитывает, используйте @claude review always: голая команда теперь запускает одно ревью и ничего сверх того.

Чтобы любая из этих команд сработала, пишите её отдельным комментарием к пул-реквесту, а не ответом на строку диффа, и ставьте команду в начало комментария.

Как научить его вашим стандартам

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

Общий контекст проекта кладите в CLAUDE.md, а правила именно для ревью — в REVIEW.md. Самое ценное во втором: ограничение числа мелких замечаний («сообщай не больше пяти, остальное укажи числом»), правила пропуска для сгенерированных файлов и всего, что и так проверяет CI, и переопределение того, что для вашего репозитория означает Important — калибровка по умолчанию рассчитана на продакшен-код и будет неверной для репозитория с документацией или прототипом.

Держите файл коротким. Длинный набор инструкций размывает самые важные правила — ровно так же, как длинный блок пользовательских инструкций.

О чём просить при ревью в чате

Если вы вставляете дифф вместо использования инструментов, формулировка важнее самого диффа. «Проверь это» даёт список общих наблюдений; узкий вопрос даёт то, с чем можно работать.

• «Что сломается, если этот ввод окажется пустым или null?» — бьёт по краевым случаям, которые тесты обычно упускают.
• «Какие из этих изменений могут повлиять на поведение за пределами показанных файлов?» — вытаскивает риск, который дифф скрывает по своей природе.
• «Только безопасность: есть ли здесь утечка данных или доверие к вводу, которому доверять не стоит?» — одна оптика за раз работает лучше общего прочёсывания.
• «Что автор, вероятно, задумал и где код этого не делает?» — ловит логические ошибки, а не стиль.
• «Какой контекст тебе нужен, чтобы отревьюить это как следует?» — неожиданно действенно: ответ подсказывает, что вставить следующим.

Давайте окружающую функцию или файл целиком, а не только изменённые строки. Дифф отсекает ровно тот контекст, который нужен ревьюеру, — потому живые ревьюеры тоже открывают файл.

Где он действительно не справляется

• Он не знает вашего продукта. Изменение может быть технически верным и при этом неправильным для бизнеса, и ни один ревьюер без этого контекста этого не поймает.
• Он не заменяет тесты. Ревью рассуждает о коде; доказывает что-либо только запуск.
• Ревью выполняется по мере возможности: упавший или истёкший по времени запуск сам не повторяется.
• Сервис для GitHub недоступен организациям с включённым нулевым хранением данных.
• В чате он видит только то, что вы вставили, и охотно рассуждает о функции, которую ему не показывали.
• Он помечает уверенно. Относитесь к находкам 🔴 как к поводу проверить, а не как к приговору.

Процесс, который реально ложится в работу

1. Напишите изменение.
2. До пуша запустите локально /code-review на низком уровне усилий ради скорости.
3. Почините найденное или передайте --fix и прочитайте получившийся дифф.
4. Запушьте. Если у команды подключена интеграция с GitHub, дайте автоматическому ревью отработать.
5. Отправьте человеку, чья задача теперь — то, чего машины не умеют: а нужное ли это изменение вообще?

Куда двигаться дальше

Если вы регулярно ревьюите один и тот же код в чате, проект держит контекст загруженным, и заново вставлять соглашения каждый раз не нужно — смотрите как пользоваться Claude Projects. За базовыми понятиями — глоссарий Claude и база знаний по Claude, а тарифы и ограничения собраны на странице Claude.

Итог

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

Запускайте /code-review до пуша: он бесплатен в рамках вашего тарифа и ловит проблемы, пока они дёшевы. Подключайте интеграцию с GitHub, если команда тонет в пул-реквестах и $15–25 за ревью дешевле, чем баги. И оставьте человеку вопрос, решает ли код правильную задачу, — эта часть никуда не делась.