Open Code Review от Alibaba: установка и первая проверка

Документация Ailoot: API, ключи и подключение.

Что умеет Open Code Review#

Alibaba опубликовала проект в официальном репозитории под лицензией Apache-2.0. В README разработчики описывают подход, который объединяет программный отбор файлов и правил с агентным анализом кода. Если подходящего diff — набора изменений Git — нет, целые файлы можно проверить командой ocr scan.

Сначала запусти проверку на своём коде и оцени её замечания. Экономию токенов на конкретном проекте здесь не измеряли. О том, зачем проверять результат работы агента отдельно, читай в статье о ложном «готово».

Подготовь репозиторий и установи OCR#

Для описанного способа установки нужны Git версии 2.41 или новее и npm. Начни с тестового репозитория, в котором нет секретов. Агент может читать файлы целиком и искать по кодовой базе; в режиме рабочей папки анализируются также неотслеживаемые файлы. Перед запуском осмотри весь репозиторий, включая новые файлы, и убедись, что в нём нет ключей или данных, которые нельзя передавать выбранной модели.

git --version
npm install -g @alibaba-group/open-code-review

После установки можно вызывать команду ocr. Способы установки и сам пакет сверяй с официальным README, чтобы не перепутать его с посторонним пакетом с похожим названием.

Настрой модель и запусти проверку#

Выполни в терминале:

ocr config provider
ocr config model

В интерактивном интерфейсе можно выбрать провайдера, указать API-ключ и настроить модель, а затем проверить подключение. Вводи ключ через предусмотренный интерфейс; не сохраняй его в файлах проекта и не вставляй в сообщения коммитов. До запуска узнай тарифы и условия оплаты выбранного провайдера: бесплатная лицензия OCR не делает бесплатными обращения к модели.

Перейди в каталог проекта и запусти проверку. Подставь путь к своему проекту вместо your-project:

cd your-project
ocr review

В этом режиме ocr review анализирует подготовленные к коммиту, неподготовленные и новые неотслеживаемые изменения. Сохранить результат в JSON можно так:

ocr review --format json --output result.json

Не включай отчёт в коммит автоматически: сперва проверь его на наличие чувствительного кода и данных. Если нужно проверить целые файлы в папке независимо от текущих изменений, воспользуйся отдельной командой:

ocr scan --path internal/agent

internal/agent — пример пути из README. Замени его на путь, который существует в твоём проекте. Начни с небольшой папки: так ты оценишь полезность замечаний и реальный расход ресурсов до проверки всего репозитория.

Как оценить пользу проверки#

Разбери каждое замечание: открой указанную строку и выясни, воспроизводится ли проблема. Исправление подтверди тестом, а ложное срабатывание зафиксируй отдельно. Отсутствие замечаний не отменяет функциональные тесты и проверку прав доступа.

В README разработчики сообщают, что в их сравнении OCR обнаруживал проблемы менее полно, чем универсальные агенты. Это вывод разработчиков в рамках их исследования, а не оценка качества твоего проекта. Независимых измерений точности OCR здесь не проводили.

Чем отличается режим делегирования#

В обычном режиме OCR обращается к настроенной в нём модели. При делегировании OCR отбирает файлы и задаёт правила, а анализ выполняет подключённый ИИ-агент на своей модели. Для такого режима не нужно отдельно настраивать модель и API-ключ в OCR.

Команды подготовки, приведённые в README:

ocr delegate preview
ocr delegate rule src/main.go src/handler.go

Укажи вместо примеров свои пути. После подготовки передай материалы подключённому агенту: сами команды ещё не проверяют код. Тарифы и лимиты агента продолжают действовать, поэтому отсутствие отдельного ключа для OCR не означает, что ревью будет бесплатным.

В репозитории описаны подключения к Claude Code, Codex и другим агентам. Пользователям Codex сначала стоит ознакомиться с устройством навыков Codex; для другого поддерживаемого инструмента смотри введение в Kimi Code. Подключай интеграцию, когда уже разобрался с обычным отчётом, и продолжай читать его самостоятельно.

Если проверка не дала результата#

Убедись, что установлена нужная версия Git, открыт каталог проекта и модель доступна. Если изменений нет, пустой результат не означает, что проверена вся кодовая база: для анализа целых файлов предназначена команда scan. Не блокируй коммиты автоматически на основании одного незнакомого отчёта.

Команды сверены с официальным README закреплённой версии репозитория. Платную проверку на пользовательском проекте не запускали. Удачный первый опыт — это понятные замечания, которые удалось подтвердить или аргументированно отклонить.

Если нужен доступ к нейросетям через Ailoot, посетите сайт Ailoot.