> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Устранение неполадок Code Review

> Исправьте ситуации, когда Code Review не запустился, завершился с ошибкой или был пропущен из-за бюджета, найдите недостающие замечания и решите проблемы с настройкой и `REVIEW.md`.

Если [Code Review](/docs/ru/code-review) ведёт себя на pull request не так, как вы ожидаете, начните с check run **Claude Code Review**. Его заголовок показывает, на каком этапе остановилось ревью.

<h2 id="check-how-far-the-review-got">
  Проверьте, на каком этапе остановилось ревью
</h2>

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

| Заголовок check run | Что это означает | Что делать |
| :- | :- | :- |
| **Code review queued...** или **Code review in progress...** | Ревью ещё не завершилось | Дождитесь изменения заголовка |
| **Code review found no issues** | Ревью завершилось и не нашло ничего, что стоило бы пометить | Ничего |
| Заголовок, сообщающий, что найдены проблемы | Ревью завершилось с замечаниями | Если вы не видите их в diff, см. [Поиск проблем, которые не отображаются как встроенные комментарии](#find-issues-that-aren’t-showing-as-inline-comments) |
| **Code review skipped — no new changes** | Автоматическое ревью не запустилось для вашего последнего push | Чтобы всё равно получить ревью, оставьте комментарий `@claude review` |
| **Code review failed** или **Code review timed out** | Ревью не завершилось | Чтобы запустить его снова, см. [Повторный запуск ревью, завершившегося с ошибкой или по тайм-ауту](#retrigger-a-failed-or-timed-out-review) |
| **Code review declined** | Ревью не запускалось | Прочитайте сводку check run. Если в ней упоминается бюджет или лимит расходов, см. [Ревью не запустилось, и в PR отображается сообщение о бюджете](#review-didn’t-run-and-the-pr-shows-a-budget-message) |
| Check run отсутствует | Ревью не запускалось | Оставьте комментарий `@claude review`. Если после этого check run не появился, см. [Команда в комментарии не запустила ревью](#a-comment-command-didn’t-start-a-review) |

<h2 id="a-review-didn’t-start">
  Ревью не запустилось
</h2>

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

<h3 id="a-comment-command-didn’t-start-a-review">
  Команда в комментарии не запустила ревью
</h3>

После того как вы оставили комментарий `@claude review`, найдите в pull request check run **Claude Code Review** с заголовком **Code review queued...** или **Code review in progress...**. Реакция 👀 на ваш комментарий не подтверждает, что ревью будет выполнено. Если check run не появился, проверьте каждую из следующих причин:

* **Code Review не включён для этого репозитория**: Claude не публикует ни комментария, ни check run в ответ на команду. Попросите Owner [добавить репозиторий](/docs/ru/code-review-setup#add-more-repositories).
* **Комментарий не соответствует условию**: это был встроенный комментарий или текст ревью, а не новый комментарий верхнего уровня, либо команда стояла не в начале комментария. Редактирование более раннего комментария вместо публикации нового также не учитывается, а pull request должен быть открыт. Ознакомьтесь с [условиями для команд в комментариях](/docs/ru/code-review-pull-requests#comment-commands) и опубликуйте новый комментарий, который им соответствует.
* **У вас нет прав на запись**: вам нужно разрешение 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 отображается сообщение о бюджете](#review-didn’t-run-and-the-pr-shows-a-budget-message).

<h3 id="review-didn’t-run-and-the-pr-shows-a-budget-message">
  Ревью не запустилось, и в PR отображается сообщение о бюджете
</h3>

Когда бюджета вашей организации недостаточно для ревью, Code Review пропускает его, а Claude публикует в pull request комментарий, начинающийся с "⚠️ Code review skipped". В некоторых из этих случаев также появляется check run с заголовком **Code review declined**.

Комментарий содержит ссылку на [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage), где администратор может восстановить бюджет. По формулировке можно понять, какой лимит был достигнут:

* **"has reached its monthly code review spending cap"**: достигнут [ежемесячный лимит расходов на Code Review](/docs/ru/code-review-costs#limit-your-spend). Ревью возобновятся в начале следующего расчётного периода. Чтобы получить их раньше, попросите администратора повысить лимит.
* **"has no extra usage available to pay for this review"**: баланс [кредитов использования](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) вашей организации исчерпан или достигнут её общий ежемесячный лимит расходов. Попросите администратора пополнить кредиты или повысить этот лимит.
* **"is too low to start another review"**: остаток бюджета или баланса меньше ожидаемой стоимости одного ревью. Попросите администратора повысить лимит или пополнить кредиты.

После восстановления бюджета оставьте в pull request комментарий `@claude review`, чтобы получить пропущенное ревью. Действуют [условия для команд в комментариях](/docs/ru/code-review-pull-requests#comment-commands), поэтому у автора комментария должны быть права на запись.

<h2 id="retrigger-a-failed-or-timed-out-review">
  Повторный запуск ревью, завершившегося с ошибкой или по тайм-ауту
</h2>

Если в сводке 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 не [из форка](/docs/ru/code-review-pull-requests#review-drafts-and-pull-requests-from-forks), нажмите **Re-run** у проверки **Claude Code Review** на вкладке **Checks** в GitHub. Повторный запуск охватывает текущий головной коммит pull request и также не подписывает pull request.

<h2 id="find-issues-that-aren’t-showing-as-inline-comments">
  Поиск проблем, которые не отображаются как встроенные комментарии
</h2>

Если заголовок check run сообщает, что найдены проблемы, но вы не видите встроенных комментариев ревью в diff, посмотрите в других местах, где отображаются замечания:

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

<h2 id="the-check-run-mentions-review-md">
  Check run упоминает REVIEW\.md
</h2>

Два сообщения, которые 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](/docs/ru/code-review-customize#which-branch-review-md-is-read-from).
* **"were not applied to this review: branch protection could not be confirmed"**: ревью не прочитало ни одного `REVIEW.md`.

<h2 id="setup-problems">
  Проблемы с настройкой
</h2>

Эти случаи возникают у Owner при [настройке Code Review](/docs/ru/code-review-setup).

<h3 id="a-repository-isn’t-listed-in-add-a-repository">
  Репозиторий не отображается в Add a repository
</h3>

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

<h3 id="no-check-run-appears-on-the-test-pull-request">
  В тестовом pull request не появляется check run
</h3>

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

<h2 id="related-resources">
  Связанные ресурсы
</h2>

* [Просмотр и запрос ревью в pull request](/docs/ru/code-review-pull-requests): что означают замечания и check run, а также команды в комментариях
* [Настройка Code Review](/docs/ru/code-review-setup): для Owner — включение Code Review и управление репозиториями
* [Стоимость и использование Code Review](/docs/ru/code-review-costs): лимиты расходов, стоящие за сообщением о бюджете
* [Кастомизация Code Review](/docs/ru/code-review-customize): какую копию `REVIEW.md` читает ревью