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
Приведённые ниже шаги охватывают настройку для репозиториев на github.com. Если ваши репозитории находятся на самостоятельно размещённом экземпляре GitHub Enterprise Server (GHES), см. Claude Code с GitHub Enterprise Server для полного руководства по настройке.
Владельцы и основные владельцы планов 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 вашего репозитория и рассматривает вновь введённые нарушения как замечания уровня nit. Если ваш 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'ей.
Вручную не требует затрат до тех пор, пока кто-то не прокомментирует «@claude review». После этого комментария дополнительные push'и в PR автоматически запускают проверки.
Затраты отображаются в вашем счёте Anthropic независимо от того, использует ли ваша организация AWS Bedrock или Google Vertex AI для других функций Claude Code.
Чтобы установить ежемесячный лимит расходов, перейдите в Параметры организации > Использование и настройте лимит для сервиса Claude Code Review.
Отслеживайте расходы через еженедельную диаграмму затрат на панели аналитики или столбец средней стоимости на репозиторий в параметрах администратора.
Просмотр использования
Перейдите на панель аналитики Code Review, чтобы увидеть активность во всей организации. Панель показывает:
Проверенные PR: Ежедневное количество проверенных pull request'ов за выбранный период времени.
Стоимость еженедельно: Еженедельные расходы на Code Review.
Обратная связь: Количество комментариев проверки, которые были автоматически разрешены, потому что кто-то решил проблему.
Разбор по репозиториям: Количество проверенных PR и разрешённых комментариев по каждому репозиторию.
Устранение неполадок
Репозитории не отображаются после установки приложения GitHub
Если вы установили приложение Claude GitHub, но ваши репозитории не отображаются на панели администратора:
Подтвердите, что приложение Claude GitHub имеет доступ к репозиториям, которые вы ожидаете. Перейдите в параметры вашей организации GitHub, найдите приложение Claude GitHub в разделе Установленные приложения GitHub и проверьте, имеет ли оно доступ ко всем репозиториям или только к выбранным.
Если ваша организация использует GitHub Enterprise Cloud с Enterprise Managed Users (EMU), авторизуйте Claude, пока вы вошли с помощью управляемой учётной записи и имеете активный сеанс SSO. Отдельного шага одобрения на уровне предприятия нет.
Попробуйте отключить и повторно подключить вашу учётную запись GitHub в Claude. Перейдите в Настройка > Соединители, отключите GitHub и подключите его снова. Какие репозитории может использовать приложение, управляется на стороне GitHub, как описано на шаге 1.
Если проблема сохраняется, свяжитесь с нашей командой поддержки с указанием названия вашей организации и названия организации GitHub, чтобы мы могли провести расследование.
Code Review не запускается на новом PR
Если после открытия PR не появляется проверка:
Подтвердите, что репозиторий указан и включён в параметрах администратора.
Проверьте параметр триггера проверки. Если он установлен на «Вручную», вам нужно прокомментировать «@claude review» на PR, чтобы запустить проверку.
Убедитесь, что PR не является черновиком. Code Review не запускается на черновиках PR.
Проверьте, что приложение Claude GitHub по-прежнему имеет доступ к репозиторию в параметрах вашей организации GitHub.
GitHub Enterprise Cloud с ограничениями по IP
Если ваша организация GitHub Enterprise Cloud ограничивает доступ по IP-адресу, приложение Claude GitHub может быть не в состоянии получить доступ к вашим репозиториям. Чтобы исправить это, включите наследование списка разрешённых IP для установленных приложений GitHub в параметрах вашего предприятия GitHub. Приложение Claude GitHub регистрирует свои диапазоны IP, поэтому включение этого параметра позволяет получить доступ без ручной конфигурации. Чтобы добавить диапазоны в список разрешённых вручную или настроить другие брандмауэры, см. IP-адреса API Anthropic.
GitHub Enterprise Server (самостоятельно размещённый)
Самостоятельно размещённый GitHub Enterprise Server (GHES) поддерживается через отдельный процесс настройки. Полные инструкции см. в разделе Claude Code с GitHub Enterprise Server.
Распространённые проблемы при настройке GHES:
Ошибка «Public cannot be private» во время настройки: Ваше имя хоста GHES должно разрешаться на общедоступный IP-адрес. Code Review обращается к вашему серверу через Интернет, поэтому внутренние или приватные сетевые адреса не будут работать. Обновите DNS или конфигурацию сети так, чтобы имя хоста разрешалось на общедоступный IP, а затем повторите попытку.
GitHub Enterprise Cloud с Data Residency — это другой продукт. Тенанты Data Residency (имена хостов, соответствующие
*.ghe.com) не поддерживаются Code Review. Поддерживаются только самостоятельно размещённый GitHub Enterprise Server и стандартные репозитории github.com.
Часто задаваемые вопросы
Доступна ли функция Code Review при создании пользовательской роли?
Нет, Code Review в настоящее время недоступна для добавления в пользовательскую роль.
Связанные ресурсы
Плагины — Просмотрите маркетплейс плагинов, включая плагин проверки кода для запуска проверок по требованию локально перед push'ем.
GitHub Actions — Запускайте Claude в собственных рабочих процессах GitHub Actions для пользовательской автоматизации за пределами Code Review.
GitLab CI/CD — Самостоятельная интеграция Claude для конвейеров GitLab.