Codex Security — инструмент OpenAI для поиска уязвимостей в коде: он проверяет репозиторий, сохраняет отчёт и помогает разобраться с находками. Его можно использовать как плагин в Codex, запускать командой из терминала или подключать к автоматическим проверкам. Если вы пишете приложение с помощью ИИ, он добавляет отдельный этап проверки безопасности, но не заменяет разбор отчёта человеком.
Что Codex Security проверяет и сохраняет
Инструмент сканирует весь репозиторий, выбранные папки или изменения относительно указанной версии кода. Стандартный режим подходит для первой проверки. Глубокий режим повторяет стандартные проверки и возвращает находки без дублей — так его описывает README, но не обещает, что после сканирования в проекте не останется уязвимостей.
По результатам Codex Security сохраняет отчёт и отдельные находки. В отчёте нужно смотреть не только на обнаруженные проблемы, но и на доказательства в исходном коде и ограничения охвата: часть проекта могла не попасть в проверку. Инструмент также умеет проверять предполагаемую уязвимость, готовить патч — предложенное изменение кода — и проверять уже внесённое исправление.
Для повторных проверок можно открыть сохранённые сканы, найти дубли и оценить серьёзность находок по правилам своей команды. Codex Security предлагает ответственных, опираясь на исходники и историю Git. Он также помогает составить SECURITY.md: файл с правилами безопасности проекта, которые последующие сканы используют как ориентир.
Результаты можно выгрузить в JSON и CSV для дальнейшей обработки или в SARIF — формат отчётов, который применяют при проверках кода в CI. CI означает автоматические задачи при изменении проекта. README также описывает работу с GitHub Actions, Linear и Jira, импорт находок сторонних сканеров и публикацию поддерживаемых отчётов в Codex Security Cloud. Облачное подключение необязательно: локальные сканы работают без него.
Кому нужна отдельная проверка после написания кода
Если вы собираете приложение через вайб-кодинг, полезно проверить код перед выпуском, особенно части, отвечающие за вход пользователей и права доступа. Codex Security даст отчёт с указанием исходников, на которых основана находка. Это повод открыть конкретное место в проекте и решить, требуется ли исправление, а не считать любой ответ сканера окончательным вердиктом.
Если команда ведёт репозиторий и регулярно меняет код, можно проверять только изменения относительно основной ветки. Если за безопасность отвечают несколько человек, пригодятся сохранённые отчёты, поиск дублей и предложение ответственных по истории Git. Если вы поддерживаете несколько репозиториев, README описывает массовые проверки и запуск в контейнерах, хотя для первого знакомства достаточно одного проекта.
Инструмент рассчитан на работу с кодом. Если вы ищете навыки для Claude и других агентов для текстов, таблиц или повседневных задач, Codex Security вам не нужен. Это не MCP-сервер и не заявленный в README плагин для Claude Code: описанный сценарий работы с агентом относится именно к Codex.
Установка CLI и первый отчёт по репозиторию
Для командной строки нужны Node.js 22.13.0 или новее в ветке 22.x либо Node.js 24.x или 26.x, а также Python 3.10 или новее. При использовании Python 3.10 дополнительно нужен tomli. README не приводит команду установки Python или tomli, поэтому сначала проверьте эти зависимости на своей машине.
Установите пакет глобально и войдите в аккаунт:
npm install --global @openai/codex-security
cs login
Перейдите в каталог проверяемого репозитория и запустите сканирование. Команда ниже взята из README; точка означает текущий каталог:
cs scan .
После завершения откройте Markdown-файл по пути REPORT, который появится в терминале. Если закрыли вывод, из того же репозитория найдите последний завершённый скан:
cs scans show
Короткое имя cs и команда codex-security запускают один CLI. При конфликте имени с другой программой используйте длинный вариант. Если не хотите устанавливать пакет глобально или npm сообщает об ошибке EEXIST, README предлагает запускать пакет через npx @openai/codex-security вместо cs при входе и сканировании.
Для автоматического запуска в CI задайте OPENAI_API_KEY или CODEX_API_KEY в окружении процесса сканирования. У GitHub Action свой пример настройки: добавьте ключ OpenAI как секрет репозитория CODEX_SECURITY_API_KEY, затем перенесите пример еженедельного процесса в .github/workflows/codex-security.yml и замените REPLACE_WITH_REVIEWED_COMMIT на проверенный SHA коммита выпуска Action. Это уже настройка автоматизации, а не обязательный шаг для первого скана.
Три сценария из README: изменения, Codex и политика
Проверить только изменения в Git. Если перед выпуском нужно посмотреть код, изменившийся относительно основной ветки, README даёт такую команду:
cs scan . --diff origin/main
После завершения вы получите сохранённый отчёт. Откройте его и прочитайте, какие участки вошли в проверку, а какие исключены. Для проверки только выбранных каталогов в README есть другой пример:
cs scan . --path src --path tests
Попросить Codex сосредоточиться на доступе. Откройте репозиторий в сессии Codex с включённым плагином Codex Security и отправьте запрос из README:
Run a Codex Security scan on this repository, focusing on authentication and authorization. Return the saved report, source evidence, and coverage limits.
По-русски это просьба проверить вход пользователей и права доступа, вернуть сохранённый отчёт, доказательства в коде и границы проверки. После скана можно отдельно попросить подготовить патч или проверить уже сделанное исправление. README не утверждает, что предложенный патч нужно принимать без просмотра.
Подготовить правила безопасности. Если проекту нужен файл SECURITY.md, запустите:
cs policy .
cs policy . --path services/api --knowledge-base architecture.md
Второй вариант выбирает компонент и добавляет файл с описанием архитектуры как источник сведений. Команда сохраняет черновик вне репозитория и не меняет существующие файлы. Просмотрите различия и замечания, отредактируйте черновик и только затем скопируйте SECURITY.md по указанному командой пути Policy target. Если действующая политика подходит, переписывать её не требуется.
Доступ к коду, учётная запись и зрелость проекта
Сканер читает файлы репозитория, а функции подготовки патчей работают с изменениями кода. Перед запуском в рабочем проекте определите, какой код вы готовы передать выбранному поставщику модели, и проверьте условия своей организации. README перечисляет OpenAI, Amazon Bedrock, OpenRouter, Fireworks AI и Cheaper Inference; для Bedrock нужны учётные данные AWS, для трёх последних — ключ соответствующего провайдера и поддерживаемая модель. Некоторые запросы по кибербезопасности и защищённые находки требуют Trusted Access for Cyber.
На момент обзора репозиторий создан 13 июля 2026 года, последний коммит датирован 6 ноября 2026 года; у проекта 11 311 звёзд и лицензия Apache-2.0. Это молодой проект, поэтому перед внедрением в регулярные проверки полезно сверить инструкции с актуальным README. Пример GitHub Action в нём задаёт оценочный предел $5 за скан, причём уже выполняющиеся запросы могут его превысить. Для первого решения о применении важнее открыть отчёт и проверить его ограничения, чем ориентироваться на число звёзд.
Источник: репозиторий openai/codex-security.