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

> Установите Open Code Review, настройте модель и проверьте изменения Git. Разберитесь, как работает делегирование проверки ИИ-агенту.

Source: https://ailoot.ai/blog/ru/alibaba-open-code-review/
Canonical: https://ailoot.ai/blog/ru/alibaba-open-code-review/
Language: ru
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-187
Revision: sha256-7faef111091a1c36d9e8eedf2e2bb86b72fa92dc3fe174297f1217058c3c7fea


[Документация Ailoot: API, ключи и подключение](https://ailoot.ai/docs/).

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Главное в разделе">

Главное

Open Code Review (OCR) — это командная строка для анализа кода. Она считывает изменения Git, отправляет файлы выбранной языковой модели и показывает замечания с указанием строк. Такой анализ дополняет проверку, но не доказывает, что ошибок нет.

</div>

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

Сначала запусти проверку на своём коде и оцени её замечания. Экономию токенов на конкретном проекте здесь не измеряли. О том, зачем проверять результат работы агента отдельно, читай в [статье о ложном «готово»](https://ailoot.ai/blog/ru/ai-agent-says-done/).

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

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

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

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

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

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

```bash
ocr config provider
ocr config model
```

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

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

```bash
cd your-project
ocr review
```

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

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

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

```bash
ocr scan --path internal/agent
```

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

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

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

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

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

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

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

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

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

В репозитории описаны подключения к Claude Code, Codex и другим агентам. Пользователям Codex сначала стоит ознакомиться с [устройством навыков Codex](https://ailoot.ai/blog/ru/codex-skills/); для другого поддерживаемого инструмента смотри [введение в Kimi Code](https://ailoot.ai/blog/ru/kimi-code-install/). Подключай интеграцию, когда уже разобрался с обычным отчётом, и продолжай читать его самостоятельно.

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

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

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

<div class="section" role="doc-bibliography" aria-label="Источники">

### Источники

- [Официальная документация](https://raw.githubusercontent.com/alibaba/open-code-review/486022daaf14f7142275eddb9b3cacc3cc5dadfa/README.md)

</div>



Если нужен доступ к нейросетям через Ailoot, посетите [сайт Ailoot](https://ailoot.ai/).

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

### Доказывает ли отсутствие замечаний OCR правильность кода?

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

### Делает ли режим делегирования проверку бесплатной?

Нет. Он передаёт анализ подключённому агенту и избавляет от отдельной настройки модели OCR, но условия оплаты и лимиты агента действуют. Команды предпросмотра и правил только готовят передачу, а не завершают проверку.


## Ailoot · Компания и портфель её проектов

Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI.

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.