Как автоматизировать код-ревью: опыт команды Claude Code
Как автоматизировать код-ревью: опыт команды Claude Code

Как автоматизировать код-ревью: опыт команды Claude Code

Код-ревью перестаёт быть ручным чтением диффов: чтение кода отдают агентам, а человек подключается только там, где уровень риска оправдывает его время. Работает это при двух условиях — проверки идут слоями, а каждая находка либо исправляется, либо закрывается с объяснением. Свежий пример — команда самого Claude Code из Anthropic: она описала свой конвейер публично, и схему можно повторить у себя.

Сколько изменений выдерживает ревью с агентами

Пропускная способность ревью растёт не за счёт новых ревьюеров, а за счёт перестройки пайплайна. В монорепозитории Anthropic число изменений выросло с ~2 500 в день в мае 2026 года до более 30 000 в день в сентябре. С июня по сентябрь количество смерженных pull request'ов в репозиториях Claude Code выросло более чем вдвое, а доля откатов упала более чем на 40%.

Чтение кода переложили на агентов не из экономии, а потому что при таком объёме человек физически не успевает прочитать всё. Ключевая метрика здесь — не скорость мержа, а качество замечаний. Доля внутренних PR, получивших содержательные замечания ревьюера, выросла с 16% до 54%. То есть ревью перестало быть формальностью «одобрить за тридцать секунд» и стало реальным фильтром: больше половины изменений возвращаются автору с содержательной правкой. Процесс команда описала в разборе код-ревью в Claude Code.

Как устроено ревью по слоям

Проверки идут строго по слоям, от смысла к механике, и человек не читает код в первом проходе. Порядок такой:

  1. AI-ревью на баги и логику — первый проход, его делает агент.
  2. Отдельное security-ревью — его находки могут блокировать мерж, а не просто оседать комментарием.
  3. Линтеры и проверки типов.
  4. Тесты на всех платформах и сборка.

Логика слоёв простая: смысловые ошибки отсекаются до того, как запускаются тяжёлые сборки и тесты на всех платформах. Security-проверка вынесена в отдельный контур именно потому, что у неё есть право остановить изменение. Это не «ещё один линтер», а отдельный субъект с правом вето.

Больше разборов по ИИ и автоматизации — в канале @il_chum

Человек подключается по уровню риска

Обязательных одобрений ровно столько, сколько требует риск изменения, — и это главное отличие от привычной схемы «каждый PR проходит через живого ревьюера». У команды три уровня:

  • низкий риск — обязательных одобрений нет вообще;
  • обычные изменения — один человек;
  • самый рискованный код и чувствительные пути — двое.

Такая матрица — частный случай общего принципа: агенту можно отдать чтение и проверку, а человек нужен там, где цена ошибки выше стоимости его часа. Тот же подход разобран в материале что доверить AI-агенту уже сейчас, а что лучше оставить человеку.

Три правила, без которых слои разваливаются

Слоёное ревью держится на дисциплине по находкам, а не на инструментах. У команды Claude Code три жёстких правила:

  • каждая находка либо исправляется, либо закрывается с объяснением — «просто проигнорировать» нельзя;
  • после первых раундов ревью идёт только по новому диффу, а не по всему изменению заново;
  • лимит — три раунда.

Лимит в три раунда — защита от бесконечных правок. Если за три итерации проблема не закрыта, она решается не в комментариях, а другим способом. Без этого правила агент и человек могут раундами переписывать одну и ту же функцию, и доля откатов поползёт вверх вместо того, чтобы падать.

Что перенести в свой проект

Начинать не с покупки инструмента, а с разделения проверок и уровней риска. Практический порядок:

  1. Разделите проверки на слои: баги и логика → безопасность → линтеры и типы → тесты и сборка.
  2. Опишите три уровня риска для своих путей и файлов и закрепите, сколько одобрений требует каждый.
  3. Введите правило «исправить или объяснить» для каждой находки.
  4. Ограничьте число раундов ревью — начните с трёх.
  5. Считайте не число смерженных PR, а долю PR с содержательными замечаниями. Ориентир — движение от 16% к 50%+.

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

Публичная версия Code Review для Claude Code уже доступна на планах Team и Enterprise, а команда /code-review запускает облегчённую проверку прямо из терминала — схему можно проверить на своём репозитории.

Частые вопросы

Сколько раундов ревью оптимально? Три. Лимит нужен, чтобы правки не превращались в бесконечный цикл: после него вопрос решается вне комментариев.

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

Что считать главной метрикой такого ревью? Долю PR с содержательными замечаниями: у команды Claude Code она выросла с 16% до 54%. Вторая метрика — доля откатов, она упала более чем на 40% с июня по сентябрь.


Больше разборов по ИИ и автоматизации — в канале: @il_chum