Перейти к основному содержанию

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 находится в исследовательском предпросмотре и доступен для подписок Team и Enterprise. Он недоступен для организаций с включённым Zero Data Retention.
Code Review анализирует ваши pull-запросы GitHub и публикует результаты в виде встроенных комментариев на строках кода, где были обнаружены проблемы. Группа специализированных агентов изучает изменения кода в контексте всей вашей кодовой базы, ища логические ошибки, уязвимости безопасности, нарушенные граничные случаи и тонкие регрессии. Результаты помечаются по степени серьёзности и не одобряют и не блокируют ваш PR, поэтому существующие рабочие процессы проверки остаются неизменными. Вы можете настроить, что Claude помечает, добавив файл CLAUDE.md или REVIEW.md в ваш репозиторий. Чтобы запустить Claude в собственной инфраструктуре CI вместо этого управляемого сервиса, см. GitHub Actions или GitLab CI/CD. Для репозиториев на самостоятельно размещённом экземпляре GitHub см. GitHub Enterprise Server. На этой странице рассматривается:

​
Как работают проверки

После того как администратор включит Code Review для вашей организации, проверки запускаются при открытии PR, при каждом push или при ручном запросе в зависимости от настроенного поведения репозитория. Комментарий @claude review запускает проверки на PR в любом режиме. Когда запускается проверка, несколько агентов параллельно анализируют diff и окружающий код на инфраструктуре Anthropic. Каждый агент ищет другой класс проблем, затем этап проверки проверяет кандидатов на соответствие фактическому поведению кода, чтобы отфильтровать ложные срабатывания. Результаты дедублицируются, ранжируются по степени серьёзности и публикуются в виде встроенных комментариев на конкретных строках, где были обнаружены проблемы, с кратким резюме в теле проверки. Если проблемы не найдены, Claude публикует краткий подтверждающий комментарий на PR. Проверки масштабируются по стоимости в зависимости от размера и сложности PR, в среднем завершаясь за 20 минут. Администраторы могут отслеживать активность проверок и расходы через панель аналитики.

​
Уровни серьёзности

Каждый результат помечается уровнем серьёзности:
МаркерСерьёзностьЗначение
🔴ImportantОшибка, которую следует исправить перед слиянием
🟡NitНезначительная проблема, стоит исправить, но не блокирует
🟣Pre-existingОшибка, которая существует в кодовой базе, но не была введена этим PR
Результаты включают свёртываемый раздел расширенного рассуждения, который вы можете развернуть, чтобы понять, почему Claude пометил проблему и как она проверила проблему.

​
Оценка и ответ на результаты

Каждый комментарий проверки от Claude поступает с уже прикреплёнными 👍 и 👎, поэтому обе кнопки появляются в пользовательском интерфейсе GitHub для одноклассного рейтинга. Нажмите 👍, если результат был полезен, или 👎, если он был неправильным или шумным. Anthropic собирает количество реакций после слияния PR и использует их для настройки рецензента. Реакции не запускают повторную проверку и не изменяют ничего на PR. Ответ на встроенный комментарий не побуждает Claude ответить или обновить PR. Чтобы действовать на основе результата, исправьте код и push. Если PR подписан на проверки, запускаемые при push, следующий запуск разрешает поток при исправлении проблемы. Чтобы запросить свежую проверку без push, прокомментируйте @claude review once как комментарий верхнего уровня PR.

​
Вывод проверки

Помимо встроенных комментариев проверки, каждая проверка заполняет проверку Claude Code Review, которая появляется рядом с вашими проверками CI. Разверните её ссылку Details, чтобы увидеть сводку каждого результата в одном месте, отсортированную по степени серьёзности:
СерьёзностьФайл:СтрокаПроблема
🔴 Importantsrc/auth/session.ts:142Обновление токена гонится с выходом, оставляя активными устаревшие сеансы
🟡 Nitsrc/auth/session.ts:88parseExpiry молча возвращает 0 при неправильном вводе
Каждый результат также появляется как аннотация на вкладке Files changed, отмеченный непосредственно на соответствующих строках diff. Важные результаты отображаются с красным маркером, nits с жёлтым предупреждением, а уже существующие ошибки с серым уведомлением. Аннотации и таблица серьёзности записываются в проверку независимо от встроенных комментариев проверки, поэтому они остаются доступными, даже если GitHub отклонит встроенный комментарий на строке, которая переместилась. Проверка всегда завершается с нейтральным выводом, поэтому она никогда не блокирует слияние через правила защиты ветки. Если вы хотите заблокировать слияния на основе результатов Code Review, прочитайте разбор серьёзности из вывода проверки в вашем собственном CI. Последняя строка текста Details — это машиночитаемый комментарий, который ваш рабочий процесс может разобрать с помощью gh и jq: 
gh api repos/OWNER/REPO/check-runs/CHECK_RUN_ID \
  --jq '.output.text | split("bughunter-severity: ")[1] | split(" -->")[0] | fromjson'
Это возвращает объект JSON с подсчётом по степени серьёзности, например {"normal": 2, "nit": 1, "pre_existing": 0}. Ключ normal содержит количество результатов Important; ненулевое значение означает, что Claude обнаружил по крайней мере одну ошибку, которую стоит исправить перед слиянием.

​
Что проверяет Code Review

По умолчанию Code Review сосредоточен на корректности: ошибки, которые нарушат production, а не на предпочтениях форматирования или отсутствии покрытия тестами. Вы можете расширить то, что он проверяет, добавив файлы руководства в ваш репозиторий.

​
Настройка Code Review

Администратор включает Code Review один раз для организации и выбирает, какие репозитории включить.
1

Откройте параметры администратора Claude Code

Перейдите на claude.ai/admin-settings/claude-code и найдите раздел Code Review. Вам нужен доступ администратора к вашей организации Claude и разрешение на установку GitHub Apps в вашей организации GitHub.
2

Начните настройку

Нажмите Setup. Это начинает процесс установки GitHub App.
3

Установите Claude GitHub App

Следуйте подсказкам для установки Claude GitHub App в вашу организацию GitHub. Приложение запрашивает эти разрешения репозитория:
  • Contents: чтение и запись
  • Issues: чтение и запись
  • Pull requests: чтение и запись
Code Review использует доступ на чтение содержимого и доступ на запись к pull-запросам. Более широкий набор разрешений также поддерживает GitHub Actions, если вы включите это позже.
4

Выберите репозитории

Выберите, какие репозитории включить для Code Review. Если вы не видите репозиторий, убедитесь, что вы дали Claude GitHub App доступ к нему во время установки. Вы можете добавить больше репозиториев позже.
5

Установите триггеры проверки для каждого репо

После завершения настройки раздел Code Review показывает ваши репозитории в таблице. Для каждого репозитория используйте раскрывающееся меню Review Behavior, чтобы выбрать, когда запускаются проверки:
  • Once after PR creation: проверка запускается один раз при открытии PR или отметке готовности к проверке
  • After every push: проверка запускается при каждом push в ветку PR, выявляя новые проблемы по мере развития PR и автоматически разрешая потоки при исправлении помеченных проблем
  • Manual: проверки запускаются только когда кто-то комментирует @claude review или @claude review once на PR; @claude review также подписывает PR на проверки при последующих push
Проверка при каждом push запускает наибольшее количество проверок и стоит дороже всего. Ручной режим полезен для репозиториев с высокой активностью, где вы хотите выбрать конкретные PR для проверки, или чтобы начать проверку ваших PR только после того, как они будут готовы.
Таблица репозиториев также показывает среднюю стоимость проверки для каждого репо на основе недавней активности. Используйте меню действий строки, чтобы включить или отключить Code Review для каждого репозитория или полностью удалить репозиторий. Чтобы проверить настройку, откройте тестовый PR. Если вы выбрали автоматический триггер, проверка с именем Claude Code Review появится в течение нескольких минут. Если вы выбрали Manual, прокомментируйте @claude review на PR, чтобы запустить первую проверку. Если проверка не появляется, подтвердите, что репозиторий указан в параметрах администратора и Claude GitHub App имеет доступ к нему.

​
Ручной запуск проверок

Две команды комментариев запускают проверку по требованию. Обе работают независимо от настроенного триггера репозитория, поэтому вы можете использовать их, чтобы выбрать конкретные PR для проверки в ручном режиме или получить немедленную повторную проверку в других режимах.
КомандаЧто она делает
@claude reviewЗапускает проверку и подписывает PR на проверки, запускаемые при push, в дальнейшем
@claude review onceЗапускает одну проверку без подписки PR на будущие push
Используйте @claude review once, когда вы хотите получить отзыв о текущем состоянии PR, но не хотите, чтобы каждый последующий push вызывал проверку. Это полезно для долгоживущих PR с частыми push или когда вы хотите получить одноразовое второе мнение без изменения поведения проверки PR. Для запуска проверки любой командой:
  • Опубликуйте её как комментарий верхнего уровня PR, а не встроенный комментарий на строке diff
  • Поместите команду в начало комментария, с once на той же строке, если вы используете одноразовую форму
  • У вас должен быть доступ владельца, члена или сотрудника к репозиторию
  • PR должен быть открыт
В отличие от автоматических триггеров, ручные триггеры запускаются на черновиках PR, так как явный запрос сигнализирует, что вы хотите проверку сейчас независимо от статуса черновика. Если проверка уже запущена на этом PR, запрос ставится в очередь до завершения текущей проверки. Вы можете отслеживать прогресс через проверку на PR.

​
Настройка проверок

Code Review читает два файла из вашего репозитория, чтобы направить то, что он помечает. Они отличаются тем, насколько сильно они влияют на проверку:
  • CLAUDE.md: общие инструкции проекта, которые Claude Code использует для всех задач, а не только для проверок. Code Review читает его как контекст проекта и помечает вновь введённые нарушения как nits.
  • REVIEW.md: инструкции только для проверок, внедряемые непосредственно в каждого агента в конвейере проверки как наивысший приоритет. Используйте его, чтобы изменить то, что помечается, с какой серьёзностью и как сообщаются результаты.

​
CLAUDE.md

Code Review читает файлы CLAUDE.md вашего репозитория и рассматривает вновь введённые нарушения как результаты уровня nit. Это работает двусторонне: если ваш PR изменяет код таким образом, что делает утверждение CLAUDE.md устаревшим, Claude помечает, что документы нужно обновить. Claude читает файлы CLAUDE.md на каждом уровне иерархии вашего каталога, поэтому правила в CLAUDE.md подкаталога применяются только к файлам под этим путём. Дополнительную информацию о том, как работает CLAUDE.md, см. в документации памяти. Для руководства, специфичного для проверок, которое вы не хотите применять к общим сеансам Claude Code, используйте REVIEW.md вместо этого.

​
REVIEW.md

REVIEW.md — это файл в корне вашего репозитория, который переопределяет поведение Code Review в вашем репо. Его содержимое внедряется в системный запрос каждого агента в конвейере проверки как блок инструкций с наивысшим приоритетом, имеющий приоритет над руководством проверки по умолчанию. Поскольку он вставляется дословно, REVIEW.md — это простые инструкции: синтаксис @ import не расширяется, и на файлы не читаются в подсказку. Поместите правила, которые вы хотите применить, непосредственно в файл.

​
Что вы можете настроить

REVIEW.md — это свободный markdown, поэтому всё, что вы можете выразить как инструкцию проверки, находится в области действия. Приведённые ниже шаблоны имеют наибольшее влияние на практике. Серьёзность: переопределите, что означает 🔴 Important для вашего репо. Калибровка по умолчанию нацелена на production код; репо документации, репо конфигурации или прототип могут захотеть гораздо более узкое определение. Явно укажите, какие классы результатов являются Important, а какие — Nit максимум. Вы также можете повысить в другом направлении, например рассматривая любое нарушение CLAUDE.md как Important, а не как nit по умолчанию. Объём Nit: ограничьте, сколько комментариев 🟡 Nit одна проверка публикует. Проза и файлы конфигурации можно полировать вечно. Ограничение вроде «сообщайте максимум пять nits, упомяните остальное как подсчёт в резюме» делает проверки действенными. Правила пропуска: перечислите пути, шаблоны ветвей и категории результатов, где Claude не должен публиковать результаты. Обычные кандидаты — это сгенерированный код, файлы блокировки, поставляемые зависимости и ветви, созданные машиной, наряду с чем-либо, что ваш CI уже применяет, например линтинг или проверка орфографии. Для путей, которые требуют некоторой проверки, но не полного контроля, установите более высокую планку вместо полного пропуска: «в scripts/, сообщайте только если почти уверены и серьёзно». Проверки, специфичные для репо: добавьте правила, которые вы хотите помечать на каждом PR, например «новые маршруты API должны иметь интеграционный тест». Поскольку REVIEW.md внедряется как наивысший приоритет, эти правила приземляются более надёжно, чем те же правила в длинном CLAUDE.md. Планка проверки: требуйте доказательства перед публикацией класса результатов. Например, «утверждения о поведении нуждаются в цитировании file:line в исходном коде, а не в выводе из именования» сокращает ложные срабатывания, которые в противном случае стоили бы автору круговорота. Сходимость повторной проверки: скажите Claude, как вести себя, когда PR уже был проверен. Правило вроде «после первой проверки подавляйте новые nits и публикуйте только результаты Important» останавливает однострочное исправление от достижения седьмого раунда только по стилю. Форма резюме: попросите тело проверки открыться с однострочным подсчётом, например 2 factual, 4 style, и начать с «no factual issues», когда это так. Автор хочет знать форму работы перед деталями.

​
Пример

Этот REVIEW.md пересчитывает серьёзность для backend сервиса, ограничивает nits, пропускает сгенерированные файлы и добавляет проверки, специфичные для репо. 
# Инструкции проверки

## Что Important означает здесь

Зарезервируйте Important для результатов, которые нарушат поведение, утекут данные
или заблокируют откат: неправильная логика, неограниченные запросы к базе данных, PII
в логах или сообщениях об ошибках, и миграции, которые не являются обратно
совместимыми. Стиль, именование и предложения по рефакторингу — это Nit максимум.

## Ограничьте nits

Сообщайте максимум пять Nits за проверку. Если вы нашли больше, скажите «плюс N
похожих элементов» в резюме вместо публикации их встроенно. Если всё, что вы нашли,
это Nit, начните резюме с «No blocking issues».

## Не сообщайте

- Ничего, что CI уже применяет: lint, форматирование, ошибки типов
- Сгенерированные файлы под `src/gen/` и любой файл `*.lock`
- Код только для тестов, который намеренно нарушает production правила

## Всегда проверяйте

- Новые маршруты API имеют интеграционный тест
- Строки логов не включают адреса электронной почты, ID пользователей или тела запросов
- Запросы к базе данных ограничены вызывающим абонентом

​
Держите это сосредоточенным

Длина имеет стоимость: длинный REVIEW.md разбавляет правила, которые имеют наибольшее значение. Держите его на инструкциях, которые изменяют поведение проверки, и оставляйте общий контекст проекта в CLAUDE.md.

​
Просмотр использования

Перейдите на claude.ai/analytics/code-review, чтобы увидеть активность Code Review во всей вашей организации. Панель показывает:
РазделЧто он показывает
PRs reviewedЕжедневное количество проверенных pull-запросов за выбранный период времени
Cost weeklyЕженедельные расходы на Code Review
FeedbackКоличество комментариев проверки, которые были автоматически разрешены, потому что разработчик решил проблему
Repository breakdownКоличество проверенных PR и разрешённых комментариев для каждого репо
Таблица репозиториев в параметрах администратора также показывает среднюю стоимость проверки для каждого репо. Цифры стоимости панели — это оценки для мониторинга активности; для точной по счёту траты обратитесь к вашему счёту Anthropic.

​
Цены

Code Review выставляется счёт на основе использования токенов. Каждая проверка в среднем стоит $15-25, масштабируясь в зависимости от размера PR, сложности кодовой базы и количества проблем, требующих проверки. Использование Code Review выставляется отдельно через дополнительное использование и не учитывается в использовании, включённом в ваш план. Выбранный вами триггер проверки влияет на общую стоимость:
  • Once after PR creation: запускается один раз для каждого PR
  • After every push: запускается при каждом push, умножая стоимость на количество push
  • Manual: нет проверок до тех пор, пока кто-то не прокомментирует @claude review на PR
В любом режиме комментарий @claude review выбирает PR для проверок, запускаемых при push, поэтому дополнительные затраты накапливаются при каждом push после этого комментария. Чтобы запустить одну проверку без подписки на будущие push, прокомментируйте @claude review once вместо этого. Затраты появляются в вашем счёте Anthropic независимо от того, использует ли ваша организация Amazon Bedrock или Google Vertex AI для других функций Claude Code. Чтобы установить ежемесячный лимит расходов для Code Review, перейдите на claude.ai/admin-settings/usage и настройте лимит для сервиса Claude Code Review. Отслеживайте расходы через еженедельную диаграмму затрат в аналитике или столбец средней стоимости для каждого репо в параметрах администратора.

​
Устранение неполадок

Запуски проверок выполняются по принципу best-effort. Сбой запуска никогда не блокирует ваш PR, но он также не повторяется автоматически. Этот раздел охватывает, как восстановиться после сбоя запуска и где искать, когда проверка сообщает о проблемах, которые вы не можете найти.

​
Повторный запуск сбойной или истёкшей по времени проверки

Когда инфраструктура проверки сталкивается с внутренней ошибкой или превышает лимит времени, проверка завершается с названием Code review encountered an error или Code review timed out. Вывод по-прежнему нейтральный, поэтому ничто не блокирует ваше слияние, но результаты не публикуются. Чтобы запустить проверку снова, прокомментируйте @claude review once на PR. Это запускает свежую проверку без подписки PR на будущие push. Если PR уже подписан на проверки, запускаемые при push, push нового коммита также запускает новую проверку. Кнопка Re-run на вкладке Checks в GitHub не повторно запускает Code Review. Используйте команду комментария или новый push вместо этого.

​
Проверка не запустилась и PR показывает сообщение о лимите расходов

Когда достигнут ежемесячный лимит расходов вашей организации, Code Review публикует один комментарий на PR, объясняя, что проверка была пропущена. Проверки возобновляются автоматически в начале следующего периода выставления счётов или немедленно, когда администратор повышает лимит на claude.ai/admin-settings/usage.

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

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

​
Связанные ресурсы

Code Review разработан для работы вместе с остальной частью Claude Code. Если вы хотите запустить проверки локально перед открытием PR, вам нужна самостоятельно размещённая установка или вы хотите глубже разобраться в том, как CLAUDE.md формирует поведение Claude во всех инструментах, эти страницы — хорошие следующие остановки:
  • Plugins: просмотрите marketplace плагинов, включая плагин code-review для запуска проверок по требованию локально перед push
  • GitHub Actions: запустите Claude в ваших собственных рабочих процессах GitHub Actions для пользовательской автоматизации за пределами проверки кода
  • GitLab CI/CD: самостоятельно размещённая интеграция Claude для конвейеров GitLab
  • Memory: как работают файлы CLAUDE.md во всём Claude Code
  • Analytics: отслеживайте использование Claude Code за пределами проверки кода