Skip to main content
Если Code Review ведёт себя на pull request не так, как вы ожидаете, начните с check run Claude Code Review. Его заголовок показывает, на каком этапе остановилось ревью.

​
Проверьте, на каком этапе остановилось ревью

Найдите check run Claude Code Review в вашем pull request, затем сопоставьте его заголовок с одним из распространённых вариантов:

​
Ревью не запустилось

Проверьте эти случаи, если check run Claude Code Review не появляется или если Claude публикует комментарий о том, что ревью было пропущено.

​
Команда в комментарии не запустила ревью

После того как вы оставили комментарий @claude review, найдите в pull request check run Claude Code Review с заголовком Code review queued… или Code review in progress…. Реакция 👀 на ваш комментарий не подтверждает, что ревью будет выполнено. Если check run не появился, проверьте каждую из следующих причин:
  • Code Review не включён для этого репозитория: Claude не публикует ни комментария, ни check run в ответ на команду. Попросите Owner добавить репозиторий.
  • Комментарий не соответствует условию: это был встроенный комментарий или текст ревью, а не новый комментарий верхнего уровня, либо команда стояла не в начале комментария. Редактирование более раннего комментария вместо публикации нового также не учитывается, а pull request должен быть открыт. Ознакомьтесь с условиями для команд в комментариях и опубликуйте новый комментарий, который им соответствует.
  • У вас нет прав на запись: вам нужно разрешение write, maintain или admin в репозитории, а для pull request из форка учитывается разрешение в базовом репозитории. Если в вашей организации включены подсказки, Claude ответит: “No review was started: manual reviews can only be requested by someone with write access to this repository.” Попросите оставить комментарий кого-то, у кого есть права на запись.
  • Бюджет исчерпан: Claude публикует комментарий, начинающийся с “⚠️ Code review skipped”. См. Ревью не запустилось, и в PR отображается сообщение о бюджете.

​
Ревью не запустилось, и в PR отображается сообщение о бюджете

Когда бюджета вашей организации недостаточно для ревью, Code Review пропускает его, а Claude публикует в pull request комментарий, начинающийся с “⚠️ Code review skipped”. В некоторых из этих случаев также появляется check run с заголовком Code review declined. Комментарий содержит ссылку на claude.ai/admin-settings/usage, где администратор может восстановить бюджет. По формулировке можно понять, какой лимит был достигнут:
  • “has reached its monthly code review spending cap”: достигнут ежемесячный лимит расходов на Code Review. Ревью возобновятся в начале следующего расчётного периода. Чтобы получить их раньше, попросите администратора повысить лимит.
  • “has no extra usage available to pay for this review”: баланс кредитов использования вашей организации исчерпан или достигнут её общий ежемесячный лимит расходов. Попросите администратора пополнить кредиты или повысить этот лимит.
  • “is too low to start another review”: остаток бюджета или баланса меньше ожидаемой стоимости одного ревью. Попросите администратора повысить лимит или пополнить кредиты.
После восстановления бюджета оставьте в pull request комментарий @claude review, чтобы получить пропущенное ревью. Действуют условия для команд в комментариях, поэтому у автора комментария должны быть права на запись.

​
Повторный запуск ревью, завершившегося с ошибкой или по тайм-ауту

Если в сводке check run указано “The review session was interrupted before it could finish. A new review of this commit has been queued automatically.”, ничего делать не нужно. Такое ревью автоматически повторяется один раз. В остальных случаях, когда заголовок check run — Code review failed или Code review timed out, запустите ревью снова с помощью комментария или повторного запуска:
  • Оставьте комментарий @claude review: опубликуйте его как комментарий верхнего уровня в pull request. Это запускает новое ревью без подписки pull request на будущие push.
  • Нажмите Re-run: если pull request не из форка, нажмите Re-run у проверки Claude Code Review на вкладке Checks в GitHub. Повторный запуск охватывает текущий головной коммит pull request и также не подписывает pull request.

​
Поиск проблем, которые не отображаются как встроенные комментарии

Если заголовок check run сообщает, что найдены проблемы, но вы не видите встроенных комментариев ревью в diff, посмотрите в других местах, где отображаются замечания:
  • Details в check run: нажмите Details рядом с проверкой Claude Code Review на вкладке Checks. Таблица серьёзности содержит замечания с файлом, строкой и кратким описанием независимо от того, был ли принят встроенный комментарий.
  • Аннотации в Files changed: откройте вкладку Files changed в PR. Замечание, привязанное к строке, но не опубликованное как встроенный комментарий, отображается там как аннотация к соответствующим строкам.
  • Текст ревью: замечания без привязки к месту в коде или выходящие за пределы текущего diff отображаются под заголовком Additional findings в тексте ревью.

​
Check run упоминает REVIEW.md

Два сообщения, которые check run может содержать о REVIEW.md, касаются защиты веток:
  • “This review applied the repository’s review instructions (REVIEW.md) from its default branch, which is not protected against direct pushes.”: ревью прочитало только корневой файл. О том, что меняет защита ветки, см. Из какой ветки читается REVIEW.md.
  • “were not applied to this review: branch protection could not be confirmed”: ревью не прочитало ни одного REVIEW.md.

​
Проблемы с настройкой

Эти случаи возникают у Owner при настройке Code Review.

​
Репозиторий не отображается в Add a repository

Сначала найдите репозиторий по имени, поскольку диалог не загружает длинный список полностью. Диалог показывает репозиторий, только если у Claude GitHub App есть к нему доступ. Нажмите Install GitHub App и предоставьте приложению доступ к репозиторию. Если ни один репозиторий не отображается, Install GitHub App — это кнопка в диалоге. В противном случае она находится внизу меню фильтра организаций GitHub в диалоге.

​
В тестовом pull request не появляется check run

Убедитесь, что Allow code review включён, что репозиторий указан в списке Repositories в разделе Code review и что у Claude GitHub App есть к нему доступ. Автоматические ревью пропускают черновые pull request, а для репозитория с режимом Manual (@claude review) для запуска первого ревью нужен комментарий @claude review.