Проверка кода анализирует ваши запросы на слияние GitHub и публикует результаты в виде встроенных комментариев на строках кода, где обнаружены проблемы. Группа специализированных агентов изучает изменения кода в контексте вашей полной кодовой базы, ища логические ошибки, уязвимости безопасности, нарушенные граничные случаи и регрессии.
В этой статье описано, как включить проверку кода, настроить триггеры проверки, настроить, что будет отмечено, и устранить распространённые проблемы при настройке.
Примечание: Проверка кода находится в исследовательском предпросмотре и доступна в планах Team и Enterprise. Она недоступна для организаций с включённым нулевым сохранением данных. Использование проверки кода оплачивается отдельно через дополнительное использование и не учитывается в рамках включённого использования вашего плана.
Как работает проверка кода
После того как организация включит проверку кода, она может срабатывать автоматически при открытии запроса на слияние, при каждом отправлении или только при ручном запросе проверки. Когда запускается проверка, несколько агентов параллельно анализируют diff и окружающий код. Каждый агент ищет определённый класс проблем, затем этап проверки сравнивает результаты с фактическим поведением кода, чтобы отфильтровать ложные срабатывания.
Результаты дедублируются, ранжируются по серьёзности и публикуются в виде встроенных комментариев на конкретных строках, где обнаружены проблемы. Если проблемы не найдены, Claude публикует краткий подтверждающий комментарий на PR. Проверки не одобряют и не блокируют ваш PR, поэтому существующие рабочие процессы проверки остаются неизменными.
Стоимость проверок масштабируется в зависимости от размера и сложности PR, в среднем завершаясь за 20 минут.
Уровни серьёзности
Каждый результат помечается уровнем серьёзности:
Маркер | Серьёзность | Значение |
🔴 | Обычная | Ошибка, которую следует исправить перед слиянием |
🟡 | Замечание | Незначительная проблема, стоит исправить, но не блокирует |
🟣 | Существовавшая ранее | Ошибка, которая существует в кодовой базе, но не была введена этим PR |
Результаты включают свёртываемый раздел расширенного обоснования, который вы можете развернуть, чтобы увидеть, почему Claude отметил проблему и как она проверила проблему.
Что проверяет проверка кода
По умолчанию проверка кода сосредоточена на корректности: ошибки, которые нарушат производство, а не предпочтения форматирования или отсутствие покрытия тестами. Вы можете расширить то, что она проверяет, добавив файлы руководства в ваш репозиторий.
Настройка проверки кода
Приведённые ниже шаги охватывают настройку для репозиториев на github.com. Если ваши репозитории находятся на самостоятельно размещённом экземпляре GitHub Enterprise Server (GHES), см. Claude Code с GitHub Enterprise Server для полного руководства по настройке.
Владельцы и основные владельцы планов Team и Enterprise могут включить проверку кода один раз для организации и выбрать, какие репозитории включить. Помимо роли владельца в вашей организации Claude, вам потребуется разрешение на установку приложений GitHub в вашей организации GitHub.
Перейдите в Параметры организации > Claude Code и найдите раздел Проверка кода.
Нажмите «Настроить», чтобы начать процесс установки приложения GitHub.
Следуйте подсказкам, чтобы установить приложение Claude GitHub в вашу организацию GitHub. Приложение запрашивает разрешения на чтение и запись для содержимого, проблем и запросов на слияние.
Выберите, какие репозитории включить для проверки кода. Если вы не видите репозиторий, убедитесь, что вы предоставили приложению Claude GitHub доступ к нему во время установки.
Установите триггер проверки для каждого репозитория, используя раскрывающееся меню Поведение проверки (см. следующий раздел для получения подробной информации о каждом варианте).
Чтобы проверить настройку, откройте тестовый PR. Если вы выбрали автоматический триггер, проверка с именем Claude Code Review должна появиться в течение нескольких минут. Если вы выбрали «Вручную», прокомментируйте «@claude review» на PR, чтобы начать первую проверку.
Выберите триггер проверки
После настройки раздел Проверка кода показывает ваши репозитории в таблице. Для каждого репозитория выберите, когда запускаются проверки:
Один раз после создания PR: Проверка запускается один раз при открытии PR или отметке как готовой к проверке.
После каждого отправления: Проверка запускается при каждом отправлении в ветку PR, выявляя новые проблемы по мере развития PR. Claude автоматически разрешает потоки при исправлении ранее отмеченных проблем. Это запускает наибольшее количество проверок и стоит дороже всего.
Вручную: Проверки начинаются только при комментировании «@claude review» на PR. Полезно для репозиториев с высокой активностью, где вы хотите выбрать, какие PR будут проверены.
Таблица репозиториев также показывает среднюю стоимость проверки для каждого репозитория на основе недавней активности.
Ручное запуск проверок
Прокомментируйте «@claude review» на запросе на слияние, чтобы начать проверку и включить этот PR в проверки, запускаемые при отправлении, в дальнейшем. Это работает независимо от настроенного триггера репозитория.
Чтобы комментарий запустил проверку:
Опубликуйте его как комментарий верхнего уровня 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 GitHub OAuth авторизовано на уровне предприятия. Предприятия EMU могут ограничивать, какие приложения OAuth одобрены, и приложение Claude должно быть явно разрешено.
Попробуйте отключить и повторно подключить интеграцию GitHub. Перейдите в Параметры организации > Claude Code, удалите конфигурацию репозитория и пройдите процесс настройки заново.
Если проблема сохраняется, свяжитесь с нашей командой поддержки с указанием названия вашей организации и названия организации 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 в настоящее время недоступна для добавления в пользовательскую роль.
Связанные ресурсы
Плагины — Просмотрите магазин плагинов, включая плагин проверки кода для запуска локальных проверок по требованию перед отправкой.
GitHub Actions — Запустите Claude в собственных рабочих процессах GitHub Actions для пользовательской автоматизации за пределами Code Review.
GitLab CI/CD — Самостоятельно размещённая интеграция Claude для конвейеров GitLab.