Как провести code review с помощью Claude

Результат: после выполнения инструкции вы сможете провести code review с помощью Claude двумя актуальными способами: локально через /code-review в Claude Code и в GitHub pull request через managed Code Review с inline-комментариями и check run Claude Code Review.

Практический вердикт: если вам нужно быстро проверить изменения до push, начните с локального /code-review. Если нужен повторяемый review прямо в PR для команды, настраивайте managed Code Review в GitHub. Для нестандартной автоматизации есть официальный Claude Code Action, но его базовый вариант сам по себе не является trust boundary.

Какой режим code review выбрать

Пошагово: как провести code review с помощью Claude

1. Выберите исходный сценарий review.

   Если вы проверяете код сами перед отправкой в репозиторий, используйте локальную команду /code-review. Если вы хотите, чтобы Claude проверял открытый GitHub pull request и писал замечания в интерфейсе PR, настраивайте managed Code Review.

   Ожидаемый результат: вы понимаете, нужен вам локальный режим, review в PR или кастомная автоматизация через Action.

2. Откройте проект в Claude Code.

   Для локального сценария достаточно рабочего репозитория с изменениями. Официальный репозиторий Claude Code указывает, что plugin code-review автоматически доступен в Claude Code, то есть отдельно включать его не нужно.

   Если вы ещё не настроили терминальный рабочий процесс, сначала пройдите инструкцию по использованию Claude Code в терминале.

   Ожидаемый результат: вы находитесь в репозитории, где Claude Code может увидеть текущую ветку и рабочее дерево.

3. Запустите локальный review командой /code-review.

   /code-review

   Согласно официальной документации, команда проверяет commits вашей ветки ahead of upstream и uncommitted changes. По changelog команда /review теперь является алиасом /code-review, а если вы не указываете effort level, команда переиспользует последний введённый уровень.

   Ожидаемый результат: Claude Code запускает review как background subagent по умолчанию и возвращает замечания в локальном выводе.

4. Повторите review с флагами --fix или --comment, если вам нужен следующий шаг по тем же изменениям.

   Официальные материалы по plugin code-review указывают поддержку флагов --fix и --comment. Используйте этот шаг, если хотите сразу перейти от замечаний к исправлению или к комментированию в PR-контексте без смены инструмента.

   Ожидаемый результат: вы запускаете тот же review-процесс в более прикладном режиме, а не просто читаете список замечаний.

5. Если нужен review прямо в GitHub PR, откройте путь claude.ai/admin-settings/claude-code под ролью Owner и нажмите Setup.

   Текущая документация фиксирует, что managed Code Review находится в research preview, доступен только для Team и Enterprise и не работает для организаций с включённым Zero Data Retention.

   Ожидаемый результат: вы переходите к настройке интеграции GitHub на уровне организации.

6. Установите Claude GitHub App, выберите репозитории и задайте триггер review для каждого репозитория.

   Официальные шаги именно такие: установить GitHub App, отметить нужные репозитории и выбрать режим запуска review. Документация перечисляет триггеры once after PR creation, after every push и manual.

   Ожидаемый результат: для выбранных репозиториев review включён и привязан к понятному триггеру.

7. Откройте тестовый pull request и дождитесь первого запуска review.

   Если у вас включён автоматический триггер, в течение нескольких минут должен появиться check run Claude Code Review. Если выбран режим manual, оставьте top-level comment в открытом PR.

   @claude review
   @claude review once
   @claude review always

   Текущая документация уточняет поведение команд: @claude review и @claude review once запускают один review, а @claude review always запускает review и подписывает PR на будущие проверки после push.

   Ожидаемый результат: вы видите inline-комментарии Claude и neutral check run Claude Code Review; если проблем не найдено, check run обновится до статуса без найденных issues.

8. Если вам нужен кастомный pipeline, переходите на официальный Claude Code Action, а не на произвольный самописный шаблон.

   Официальный README Action говорит, что он умеет делать PR code review в GitHub и поддерживает direct Anthropic API, Bedrock, Vertex AI и Microsoft Foundry. Самый быстрый путь настройки в документации Action — команда /install-github-app в Claude Code.

   Важно: base action описан как thin wrapper и сам по себе не задаёт trust boundary. Для untrusted input, fork PR и внешних комментариев рекомендуется использовать полный путь anthropics/claude-code-action. Полный YAML в этом source pack не приведён, поэтому копируйте workflow только из официального README.

   Ожидаемый результат: вы понимаете, когда managed review уже достаточно, а когда нужен отдельный GitHub Actions workflow.

Редакционное ограничение: в проверенных источниках на 2026-08-19 есть точные команды, пути, роли и ограничения, но нет отдельного номера релиза Claude Code и нет полного YAML-примера для GitHub Actions в самом source pack. Поэтому в статье не приведены выдуманные workflow-файлы, неподтверждённые кнопки интерфейса и отдельная цена для локального review.

Как проверить, что всё работает

• Локальный режим: запустите /code-review в репозитории с известными изменениями. Проверка считается рабочей, если Claude Code анализирует commits ahead of upstream и uncommitted changes и возвращает замечания в выводе команды.
• Managed review в GitHub: откройте тестовый PR. При автоматическом триггере в течение нескольких минут должен появиться check run Claude Code Review. При ручном запуске оставьте top-level comment @claude review в открытом PR.
• Пустой результат тоже валиден: если Claude не нашёл проблем, check run обновится с сообщением о том, что issues не обнаружены. Это нормальный успешный сценарий, а не ошибка.
• Проверка severity через API: официальная документация даёт machine-readable пример на основе gh api и fromjson для извлечения counts из check run. В этом примере значение normal соответствует Important findings. Точный сниппет берите с официальной страницы, потому что его текст не включён в source pack.

Частые ошибки и исправления

• Ошибка: managed Code Review вообще недоступен в настройках.
  Решение: проверьте, что у вас Team или Enterprise, вы заходите с ролью Owner и в организации не включён Zero Data Retention. По официальной документации preview недоступен при ZDR.
• Ошибка: комментарий @claude review не запускает review.
  Решение: оставьте его как top-level comment в открытом PR. Документация прямо оговаривает оба условия.
• Ошибка: вы ожидали review после каждого push, но после команды @claude review новые проверки не идут.
  Решение: используйте @claude review always или заранее выберите per-repo trigger after every push. Источники отдельно предупреждают, что старые гайды могут описывать другое поведение.
• Ошибка: локальный review запускается, но вы не получаете workflow для исправления или комментирования.
  Решение: повторно запустите review с поддерживаемыми флагами --fix или --comment, которые перечислены в официальных материалах plugin code-review.
• Ошибка: вы пытаетесь строить review для fork PR на базе только base action.
  Решение: не рассматривайте base action как границу доверия. Для untrusted input и fork PR используйте рекомендованный путь anthropics/claude-code-action и опирайтесь на официальный README.

Безопасность и ограничения

• Managed Code Review на дату проверки остаётся в research preview. Это значит, что доступность и поведение могут меняться быстрее, чем у стабильной функции.
• Managed review работает только для Team и Enterprise и не поддерживается в организациях с включённым Zero Data Retention.
• Billing для managed review идёт отдельно через usage credits и не засчитывается во включённое использование плана. Официальная страница указывает средний расход около $15–25 за review.
• Локальный /code-review проверяет текущие изменения: commits ahead of upstream и uncommitted changes. Это удобно для повседневного PR-потока, но не равно полному аудиту всей кодовой базы.
• Для GitHub Actions точная стоимость в изученных источниках не расписана полностью: нужно учитывать ваш Anthropic provider и среду GitHub Actions.
• Если вы принимаете недоверенные входные данные, не полагайтесь на base action как на самостоятельную защиту. Это прямо оговорено в официальном README.
• В изученных официальных источниках нет географических ограничений по странам. Доступность описана через план, настройки организации и статус Zero Data Retention.

Что делать дальше

• Если вы только входите в CLI-процесс, сначала закрепите базовую работу с инструментом: как использовать Claude Code в терминале.
• После review добавьте быстрый слой качества к коду: как сгенерировать тесты с помощью AI.
• Если вы проверяете интеграционный код, пригодится связанная инструкция: как создать API-клиент с помощью AI.
• Для более богатого контекста в Claude используйте внешние инструменты через MCP (Model Context Protocol).

Источники

• Code Review – Claude Code Docs
• Claude Code changelog – Claude Code Docs
• claude-code/plugins/code-review/README.md at main · anthropics/claude-code · GitHub
• GitHub – anthropics/claude-code-action
• claude-code-action/README.md at main · anthropics/claude-code-action · GitHub
• claude-code-action/base-action/README.md at main · anthropics/claude-code-action · GitHub

Вопросы и ответы

Можно ли провести code review с Claude без GitHub App?

Да. Для этого используйте локальную команду /code-review в Claude Code. Официальная документация прямо разделяет локальный review и managed review через GitHub App.

Что выбрать для команды: локальный review или managed review?

Если цель — быстро проверить изменения до push, локальный /code-review проще. Если нужны inline-комментарии в PR и check run Claude Code Review, выбирайте managed review, но только если у вас Team или Enterprise и отключён Zero Data Retention.

Сколько стоит code review через Claude?

Для managed Code Review официальный источник указывает отдельный биллинг по token usage через usage credits, в среднем около $15–25 за review, и эти расходы не входят во включённое использование плана. Отдельная цена именно для локального /code-review в проверенных источниках не указана.

Можно ли автоматически проверять каждый новый push в PR?

Да. Для managed review можно выбрать триггер after every push. Если вы запускаете review комментариями, используйте @claude review always, потому что именно эта команда подписывает PR на будущие проверки после push.

Есть ли в источниках ограничения по странам или регионам?

Нет, в изученных официальных материалах географические ограничения не описаны. Доступность привязана к подписке, настройкам организации и состоянию Zero Data Retention.