Code Review анализирует ваши pull request'ы на GitHub и публикует результаты в виде встроенных комментариев на строках кода, где обнаружены проблемы. Множество специализированных агентов изучают изменения кода в контексте вашей полной кодовой базы, ища логические ошибки, уязвимости безопасности, нарушенные граничные случаи и регрессии.
В этой статье рассказывается, как включить Code Review, настроить триггеры проверки, настроить, что будет отмечено, и устранить распространённые проблемы при настройке.
Примечание: Code Review находится в исследовательском предпросмотре и доступен в планах Team и Enterprise. Он недоступен для организаций с включённым нулевым сохранением данных. Использование Code Review оплачивается отдельно через дополнительное использование и не учитывается в рамках включённого использования вашего плана.
Как работает Code Review
После того как организация включит Code Review, он может запускаться автоматически при открытии pull request'а, при каждом push'е или только при ручном запросе проверки. Когда запускается проверка, несколько агентов параллельно анализируют diff и окружающий код. Каждый агент ищет определённый класс проблем, затем этап проверки сравнивает результаты с фактическим поведением кода, чтобы отфильтровать ложные срабатывания.
Результаты дедублируются, ранжируются по серьёзности и публикуются в виде встроенных комментариев на конкретных строках, где обнаружены проблемы. Если проблемы не найдены, Claude публикует краткий подтверждающий комментарий на PR. Проверки не одобряют и не блокируют ваш PR, поэтому существующие рабочие процессы проверки остаются неизменными.
Проверки масштабируются по стоимости в зависимости от размера и сложности PR, в среднем завершаясь за 20 минут.
Уровни серьёзности
Каждый результат помечается уровнем серьёзности:
Маркер | Серьёзность | Значение |
🔴 | Обычная | Ошибка, которую следует исправить перед слиянием |
🟡 | Замечание | Незначительная проблема, стоит исправить, но не блокирует |
🟣 | Существовавшая ранее | Ошибка, которая существует в кодовой базе, но не была введена этим PR |
Результаты включают свёртываемый раздел расширенного рассуждения, который вы можете развернуть, чтобы увидеть, почему Claude отметил проблему и как она проверила проблему.
Что проверяет Code Review
По умолчанию Code Review сосредоточен на корректности: ошибки, которые нарушат production, а не предпочтения форматирования или отсутствие покрытия тестами. Вы можете расширить то, что он проверяет, добавив файлы руководства в ваш репозиторий.
Настройка Code Review
Владельцы и основные владельцы планов Team и Enterprise могут включить Code Review один раз для организации и выбрать, какие репозитории включить. Помимо роли владельца в вашей организации Claude, вам потребуется разрешение на установку GitHub Apps в вашей организации GitHub.
Перейдите в Параметры организации > Claude Code и найдите раздел Code Review.
Нажмите «Настроить», чтобы начать процесс установки GitHub App.
Следуйте подсказкам, чтобы установить Claude GitHub App в вашу организацию GitHub. Приложение запрашивает разрешения на чтение и запись для содержимого, проблем и pull request'ов.
Выберите, какие репозитории включить для Code Review. Если вы не видите репозиторий, убедитесь, что вы предоставили Claude GitHub App доступ к нему во время установки.
Установите триггер проверки для каждого репозитория, используя раскрывающееся меню Review Behavior (см. следующий раздел для получения подробной информации о каждом варианте).
Чтобы проверить настройку, откройте тестовый PR. Если вы выбрали автоматический триггер, проверка с именем Claude Code Review должна появиться в течение нескольких минут. Если вы выбрали Manual, прокомментируйте «@claude review» на PR, чтобы начать первую проверку.
Выберите триггер проверки
После настройки раздел Code Review показывает ваши репозитории в таблице. Для каждого репозитория выберите, когда запускаются проверки:
Один раз после создания PR: Проверка запускается один раз при открытии PR или отметке готовности к проверке.
После каждого push'а: Проверка запускается при каждом push'е в ветку PR, выявляя новые проблемы по мере развития PR. Claude автоматически разрешает потоки при исправлении ранее отмеченных проблем. Это запускает наибольшее количество проверок и стоит дороже всего.
Manual: Проверки начинаются только при комментировании «@claude review» на PR. Полезно для репозиториев с высокой активностью, где вы хотите выбрать, какие PR'ы будут проверены.
Таблица репозиториев также показывает среднюю стоимость проверки для каждого репозитория на основе недавней активности.
Ручное запуск проверок
Прокомментируйте «@claude review» на pull request'е, чтобы начать проверку и включить этот PR в push-триггерные проверки в дальнейшем. Это работает независимо от настроенного триггера репозитория.
Чтобы комментарий запустил проверку:
Опубликуйте его как комментарий верхнего уровня PR, а не встроенный комментарий на строке diff.
Поместите «@claude review» в начало комментария.
У вас должен быть доступ владельца, участника или сотрудника к репозиторию.
PR должен быть открыт и не быть черновиком.
Если проверка уже запущена, запрос ставится в очередь до завершения текущей проверки.
Настройка проверок
Code Review читает два файла из вашего репозитория, чтобы направить то, что он отмечает. Оба являются дополнительными к проверкам корректности по умолчанию.
CLAUDE.md
Code Review читает файлы CLAUDE.md вашего репозитория и рассматривает вновь введённые нарушения как результаты уровня замечания. Если ваш PR изменяет код таким образом, что делает утверждение CLAUDE.md устаревшим, Claude отмечает, что документация также нуждается в обновлении.
Claude читает файлы CLAUDE.md на каждом уровне иерархии вашего каталога, поэтому правила в CLAUDE.md подкаталога применяются только к файлам под этим путём.
REVIEW.md
Добавьте файл REVIEW.md в корень вашего репозитория для правил, специфичных для проверки. Используйте его для кодирования:
Рекомендации по стилю компании или команды
Соглашения, специфичные для языка или фреймворка, не охватываемые линтерами
Вещи, которые Claude всегда должен отмечать (например, «любой новый маршрут API должен иметь интеграционный тест»)
Вещи, которые Claude должен пропускать (например, «не комментируйте сгенерированный код»)
Claude автоматически обнаруживает REVIEW.md в корне репозитория. Никакая конфигурация не требуется.
Цены и использование
Code Review оплачивается на основе использования токенов. Каждая проверка в среднем стоит $15–25, масштабируясь в зависимости от размера PR, сложности кодовой базы и количества проблем, требующих проверки.
Использование Code Review оплачивается отдельно через дополнительное использование и не учитывается в рамках включённого использования вашего плана. Выбранный вами триггер проверки влияет на общую стоимость:
Один раз после создания PR запускается один раз на PR.
После каждого push'а запускается при каждом push'е, умножая стоимость на количество push'ей.
Manual не требует затрат до тех пор, пока кто-то не прокомментирует «@claude review». После этого комментария дополнительные push'и на PR автоматически запускают проверки.
Затраты отображаются в вашем счёте Anthropic независимо от того, использует ли ваша организация AWS Bedrock или Google Vertex AI для других функций Claude Code.
Чтобы установить ежемесячный лимит расходов, перейдите в Параметры организации > Использование и настройте лимит для сервиса Claude Code Review.
Отслеживайте расходы через еженедельную диаграмму затрат на панели аналитики или столбец средней стоимости на репозиторий в параметрах администратора.
Просмотр использования
Перейдите на панель аналитики Code Review, чтобы увидеть активность во всей вашей организации. Панель показывает:
Проверенные PR'ы: Ежедневное количество проверенных pull request'ов за выбранный период времени.
Стоимость еженедельно: Еженедельные расходы на Code Review.
Обратная связь: Количество комментариев проверки, которые были автоматически разрешены, потому что кто-то решил проблему.
Разбор по репозиториям: Количество проверенных PR'ов и разрешённых комментариев по репозиториям.
Устранение неполадок
Репозитории не отображаются после установки GitHub App
Если вы установили Claude GitHub App, но ваши репозитории не отображаются на панели администратора:
Убедитесь, что Claude GitHub App имеет доступ к репозиториям, которые вы ожидаете. Перейдите в параметры вашей организации GitHub, найдите Claude GitHub App в разделе Установленные GitHub Apps и проверьте, имеет ли она доступ ко всем репозиториям или только к выбранным.
Если ваша организация использует GitHub Enterprise Cloud с Enterprise Managed Users (EMU), убедитесь, что Claude GitHub OAuth App авторизирована на уровне предприятия. Предприятия EMU могут ограничивать, какие OAuth приложения одобрены, и приложение Claude должно быть явно разрешено.
Попробуйте отключить и повторно подключить интеграцию GitHub. Перейдите в Параметры организации > Claude Code, удалите конфигурацию репозитория и пройдите процесс настройки заново.
Если проблема сохраняется, свяжитесь с нашей командой поддержки с указанием названия вашей организации и названия организации GitHub, чтобы мы могли провести расследование.
Code Review не запускается на новом PR
Если проверка не появляется после открытия PR:
Убедитесь, что репозиторий указан и включён в параметрах администратора.
Проверьте параметр триггера проверки. Если он установлен на Manual, вам потребуется прокомментировать «@claude review» на PR, чтобы начать проверку.
Убедитесь, что PR не является черновиком. Code Review не запускается на черновиках PR.
Проверьте, что Claude GitHub App по-прежнему имеет доступ к репозиторию в параметрах вашей организации GitHub.
GitHub Enterprise Cloud с ограничениями IP
Если ваша организация GitHub Enterprise Cloud ограничивает доступ по IP-адресу, Claude GitHub App может быть не в состоянии получить доступ к вашим репозиториям. Чтобы исправить это, включите наследование списка разрешённых IP для установленных GitHub Apps в параметрах вашего предприятия GitHub. Claude GitHub App регистрирует свои диапазоны IP, поэтому включение этого параметра позволяет получить доступ без ручной конфигурации. Чтобы добавить диапазоны в список разрешённых вручную или настроить другие брандмауэры, см. IP-адреса API Anthropic.
GitHub Enterprise Server (самостоятельно размещённый)
Code Review в настоящее время требует репозиториев, размещённых на github.com, поэтому самостоятельно размещённый GitHub Enterprise Server пока не поддерживается.
Часто задаваемые вопросы
Доступен ли Code Review как возможность при создании пользовательской роли?
Нет, Code Review в настоящее время недоступен для добавления в пользовательскую роль.
Связанные ресурсы
Плагины — Просмотрите маркетплейс плагинов, включая плагин проверки кода для запуска проверок по требованию локально перед push'ем.
GitHub Actions — Запустите Claude в ваших собственных рабочих процессах GitHub Actions для пользовательской автоматизации за пределами Code Review.
GitLab CI/CD — Самостоятельно размещённая интеграция Claude для конвейеров GitLab.