Как защитить репозиторий от тихих багов, сломанных контрактов и утекших ключей, когда кодинг-агент за полминуты переписывает дюжину файлов — и не тратить вечер на построчную вычитку каждого коммита? Допустим, ты просишь агента в Cursor поменять сигнатуру функции списания в платёжном шлюзе на ветке feature/payment-gateway. Тесты в модуле оплаты зелёные, дифф выглядит аккуратно, а нейросеть рапортует, что изменения готовы к отправке. Но в соседней папке остался внутренний контроллер подписок, который всё ещё вызывает старый контракт или не проверяет нулевую сумму.
Эту слепую зону закрывает OpenQodex — открытый инструмент локального код-ревью под лицензией Apache-2.0 от команды Qodex. Он пропускает твои незакоммиченные правки и неотправленные коммиты через два независимых слоя: детерминированные статические сканеры строго по изменённым строкам и отдельный процесс модели-рецензента с картой вызовов проекта.
Почему один и тот же агент не видит собственные ошибки
При работе с Claude Code, Cursor, Codex, Cline или Goose команды часто попадают в две ловушки подряд. Первая — перегрузка вниманием: когда агент выкатывает дифф на сотни строк сразу по нескольким модулям, глаз замыливается, и разработчик аппрувит правки почти на автомате. Вторая ловушка кажется решением, но только маскирует проблему: просить в том же окне чата «проверь свой код на баги и уязвимости».
Такая самопроверка упирается в подтверждающее искажение (confirmation bias). Модель остаётся внутри собственной истории рассуждений, помнит, почему выбрала текущую реализацию, и охотно оправдывает собственные допущения — пропуская забытый вызов вроде нашего контроллера подписок. Голые линтеры тоже не спасают: в тестах авторов OpenQodex на базе с намеренно внесёнными багами (planted bugs) статические сканеры без LLM находили только 32 из 51 ошибки (62,7%). Они уверенно ловят захардкоженный токен, но слепы к рассогласованию логики между файлами.
Граф кода, сканеры и изолированный цикл проверки под капотом
Чтобы убрать эффект самооправдания, OpenQodex разделяет аудит на три связанных этапа.
Первый уровень — 22 встроенных статических сканера без языковых моделей. Утилита сама подбирает анализаторы под изменённые файлы: gitleaks ищет секреты, semgrep ловит шаблоны уязвимостей, osv-scanner сверяет lock-файлы репозитория с базой osv.dev, а под конкретные стеки подключаются ruff, shellcheck, golangci-lint, cargo-deny, kubeconform и проверки SQL-миграций. Важная деталь — жёсткая фильтрация шума: замечания остаются только на изменённых строках, тестовые фикстуры и отключённые правила отбрасываются, а уязвимости зависимостей за пределами диффа выводятся лишь справочно, не попадая в отчёт ревьюера.
Второй элемент — граф кодовой базы (openqodex graph). Это локальная карта связей проекта, отвечающая на вопрос «кто и откуда вызывает эту функцию». При инициализации OpenQodex подключает к кодинг-агенту локальный MCP-сервер (Model Context Protocol — стандартный интерфейс инструментов для LLM), чтобы модель запрашивала нужные связи точечно, а не забивала контекст всем репозиторием. Этот же контекст вызовов получает ревьюер: в случае с платёжным шлюзом карта сразу покажет забытый контроллер подписок, даже если сам файл контроллера в дифф не попал.
Третий уровень — независимый LLM-ревьюер, который стартует в свежем изолированном процессе Claude Code или Codex CLI под твоей локальной авторизацией, без отдельного API-ключа и аккаунта на сайте OpenQodex. Меня в этой схеме больше всего зацепила двухступенчатая верификация вместо обычного списка советов от нейросети:
- Сессии Finder (поисковики) читают каждую часть диффа вместе с вызывающим её кодом и предлагают кандидатов на баги с точной цитатой строки. Следом скрипт сверяет каждую цитату с реальным файлом на диске, сразу отсекая выдуманные ссылки.
- Сессии Verifier (верификаторы) проверяют кандидатов от Finder и все сигналы статических сканеров, подтверждая или опровергая каждый пункт с аргументацией. Контрольные скрипты следят, чтобы ни одна находка сканера не осталась без ответа и каждая изменённая строка прошла ревью. Заметки по стилю выводятся как наблюдения и отправку кода не блокируют.
Запуск в терминале, push-ворота и честные ограничения
Утилита требует Node.js 22+, Git и macOS или Ubuntu Linux (Windows и WSL в CI не тестируются). Мастер настройки в корне проекта сам находит установленные агентские среды, скачивает сканеры и прописывает локальный лаунчер ~/.openqodex/bin/openqodex, поскольку npx не добавляет пакет в PATH:
# Интерактивная установка для разработчика
npx openqodex init
# Неинтерактивная настройка под Cursor
npx -y openqodex@0.18.0 init --yes --agent cursor
Учитывай особенность песочницы Codex CLI: по умолчанию она режет сетевые запросы команд, поэтому первичную установку там лучше запускать из собственного терминала. А если хочешь сначала посмотреть механику без риска для рабочего проекта, npx openqodex demo соберёт учебный репозиторий с заложенными ошибками и сразу его просканирует.
Когда агент закончил правки в платёжном шлюзе, аудит запускается одной командой — для текущих изменений, конкретной ветки или пуллреквеста:
# Проверка незакоммиченных и неотправленных изменений
npx openqodex review
# Ревью ветки платёжного шлюза или пуллреквеста #42
npx openqodex review feature/payment-gateway
npx openqodex review '#42'
На выходе появляются report.html, report.md, report.json и report.sarif (SARIF — стандартный JSON-формат отчётов для CI/CD), а в консоль печатается короткий чек с вердиктом. Встроенный навык просит агента показать этот чек и спросить, исправлять всё или только выбранные тобой пункты — без самовольного переписывания проекта.
Здесь важно различать хуки и роли сред. Локальный pre-commit запускает только сканеры, тогда как полный аудит с графом и моделью привязан к проверке перед git push. Claude Code и Codex CLI умеют и запускать ревью, и проверять код (кроме запуска второго процесса Codex внутри его же песочницы). А вот Cursor, Cline и Goose рецензентом быть не могут, поэтому рядом с ними должен стоять авторизованный Claude Code или Codex CLI; иначе ревью завершится кодом 2, сохранит сырые находки в unchecked-candidates.json и предложит запасной вызов review --agent.
Кроме того, по умолчанию и агентские правила, и git-хук pre-push лишь предупреждают о проблемах. Чтобы нерабочий контроллер подписок реально остановил отправку ветки, в .openqodex/config.yaml задают порог блокировки (critical, major, minor, nitpick или info):
review:
block_on_severity: major
С таким порогом находки уровня major и critical заблокируют git push (экстренный обход остаётся через --no-verify). Стоит помнить и об ограничениях версии 0.18.0: флаги и конфиг до 1.0 могут меняться; сканерам под Ruby (brakeman, rubocop), Go (golangci-lint) и Rust (cargo-deny) нужны локальные рантаймы этих языков; флаг --offline отключает сетевые сканеры (semgrep, osv-scanner, kubeconform, cargo-deny), но LLM-ревьюер всё равно отправляет дифф провайдеру твоего Claude или Codex. И по замерам авторов стоит сохранять трезвый взгляд: на искусственных багах claude-opus-5-5 с графом нашла 98,0% проблем (150 из 153) примерно за $0,4371 за ревью, тогда как на реальных сложных PR из AACR-Bench семантическая полнота gpt-6.1-sol составила 5,2% при 77,2% шума. Для расширения контекста о работе с графами кода и несколькими консольными агентами загляни в наш разбор графа Gortex через MCP и обзор интерфейса codeg для параллельных сессий Claude Code и Codex.
Подобный инструмент не даёт стопроцентной гарантии безупречного кода и не заменяет инженерное мышление. Но он забирает на себя изнурительную роль живого линтера, который перед каждым пушем судорожно высматривает в гигантском диффе забытый вызов или утекший ключ — оставляя тебе спокойную голову для архитектуры и реальных продуктовых задач.



