Codex Security — это агент безопасности, который ищет возможные уязвимости в коде, проверяет доказательства и помогает перейти к исправлениям. Сначала важно различать два продукта: плагин, который вы используете с Codex локально, и Codex Security Cloud, который работает в облаке и подключается к GitHub. Хотя названия похожи, подготовка, место выполнения и источник информации о ценах у них разные. Есть также отдельная версия для командной строки, которую можно встраивать в CI и похожие конвейеры (@openai/codex-security, далее «отдельный CLI»).

Хочу проверить локальный код

Codex Security

Работает в десктопном приложении или в чате Codex CLI. Выберите область проверки: весь репозиторий, конкретную папку или изменённый diff.

Хочу непрерывно следить за изменениями на GitHub

Codex Security Cloud

Отдельный плагин. Он проверяет подключённый репозиторий GitHub в облаке: выполняет разовые сканирования или отслеживает новые коммиты.

В этой статье рассказывается, как выбрать вариант, о ценах и бесплатных кредитах, первом сканировании, нагрузке Deep-проверок, чтении результатов и проверке после исправлений.

Источник: OpenAI — обзор Codex Security и запуск локального плагина.

Выбор между локальной версией, Cloud и обычной проверкой

Для небольшого изменения можно просто передать diff и критерии проверки обычному Codex. Это не значит, что к результату автоматически прикладываются отчёт специализированного сканера или запись области проверки. Просьбу «проверь код» и запуск сканирования Codex Security следует считать разными действиями. О том, как выбирать между самими продуктами Codex, см. в статье сравнение Claude Code и Codex.

Проверить функции или изменения в реализацииОбычная проверка Codex, в которой вы указываете важные аспекты: спецификацию, тесты, читаемость и т. д. Если главная тема — безопасность, можно выбрать специальное сканирование «Changes».
Проверить локальный репозиторийСканирование «Codebase» с помощью плагина Codex Security. Для больших репозиториев область можно сузить до сервисов или папок с понятными владельцами и зонами ответственности.
Следить за коммитами на GitHubНепрерывное сканирование в Codex Security Cloud. Проверьте подключение к GitHub, права на использование, облачную среду и условия оплаты, которые отделены от обычного лимита использования.
Встроить в CI или собственные инструментыОпубликованы отдельный CLI (@openai/codex-security) и SDK. Они не совпадают с плагином внутри Codex CLI, поэтому способ аутентификации, права запуска и бюджет проверяйте отдельно.

Cloud находится в режиме исследовательского превью, и для его использования нужен доступ к целевому рабочему пространству. У отдельного CLI публикация пакета и наличие у аккаунта права на сканирование — тоже разные вещи. В зависимости от аккаунта и репозиториев для полного сканирования может понадобиться «Trusted Access for Cyber». По одному названию тарифа, например Pro, нельзя сделать вывод, что доступны все варианты. Если чего-то нет на экране, проверьте, включён ли плагин, права на использование и настройки администрирования организации.

Источник: OpenAI — обзор и требования к доступу и проверка безопасности изменений в коде.

Цены и бесплатные кредиты: для Pro всё равно нужна отдельная проверка

Сканирования Cloud не входят в обычный лимит тарифа

В FAQ Cloud от OpenAI сказано, что сканирование репозиториев и непрерывное сканирование, настроенные 1 октября 2026 года в 12:53 (по тихоокеанскому времени США) или позже, оплачиваются кредитами или в долларах США по стоимости токенов, принятой для тарифа. Они не входят в обычный лимит использования тарифа. Для подходящих аккаунтов бесплатные кредиты на сканирование расходуются раньше платного использования.

Непрерывный мониторинг был настроен до указанного времени

Существующий подходящий мониторинг бесплатен до 21 октября

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

Непрерывного мониторинга до указанного времени не было

Бесплатный кредит на сумму, эквивалентную 500 долларам США, для подходящих аккаунтов

Для подходящих аккаунтов. Один и тот же баланс используется для разовых и непрерывных сканирований и общий для рабочего пространства. Согласно FAQ, у этого бесплатного кредита на сканирование нет срока действия.

500 долларов США — это кредит на сканирование для подходящих аккаунтов. После его исчерпания применяется система оплаты для этого аккаунта или рабочего пространства. Перед началом проверьте на экране, подходите ли вы под условия, сколько бесплатного остатка осталось и каковы условия платного использования.

«Стоимость» на экране не всегда равна сумме списания

В Cloud можно открыть нужное сканирование из раздела «Scans» и посмотреть количество токенов и стоимость. При наведении на количество токенов появится разбивка на входные, кэшированные входные и выходные. Показанная стоимость указана до применения бесплатных кредитов или освобождений от оплаты, поэтому отдельно читайте, сколько списано из бесплатного кредита, и сколько реально списано с оплаты. Сканирования с пометкой «Exempt from billing. No charges apply.» не оплачиваются.

Источник для цен, бесплатных кредитов и отображения: OpenAI — Codex Security Cloud FAQ, раздел «Billing». Временной отсчёт ведётся по тихоокеанскому времени США, как указано в официальной документации.

Не применяйте бесплатный кредит Cloud к локальному плагину

Локальный плагин работает как задача Codex. По общим условиям использования Codex на расход влияют тариф, модель, объём обработки и способ аутентификации, а дополнительная локальная работа с API-ключом оплачивается по тарифам API. С другой стороны, в официальных материалах по запуску локальной версии, описании Standard и Deep и FAQ по CLI нет фиксированной цены одного сканирования и отдельного прайса для плагина. Не считайте, что «локально — значит расход нулевой» или что «можно использовать кредит 500 долларов Cloud».

Отдельный CLI может использовать API-ключ даже при входе в аккаунт. Если в окружении заданы OPENAI_API_KEY или CODEX_API_KEY, при неинтерактивных сканированиях и выводе в JSON/JSONL этот ключ выбирается по умолчанию. Если есть и ключ из окружения, и сохранённый вход в ChatGPT, в интерактивном режиме и при текстовом выводе программа спросит, какой вариант использовать. В официальной документации есть явные параметры --auth chatgpt и --auth api-key, поэтому определите плательщика до начала работы.

Остаток лимитов Codex можно посмотреть на экране использования, а в Codex CLI — командой /status. Расходы на сканирование Cloud нужно также проверять в самом Cloud. Сравнение тарифов — в статье о ценах и лимитах Pro.

Источник: OpenAI — цены и использование Codex и Work и выбор аутентификации в CLI.

Шаги и текст запроса для первого сканирования

Ниже приведено описание официальных шагов. Ограничивайте объекты сканирования кодом, которым вы владеете или на проверку которого получили разрешение. При первом запуске уточните целевую ветку, ревизию, папку для результатов и способ аутентификации. Разумная последовательность — начать со Standard.

Локальный плагин в десктопном приложении

  1. Найдите «Codex Security» в списке плагинов, установите и включите его. Cloud — отдельный плагин.
  2. Откройте в боковой панели «Security» → «Scans» → «+ Scan».
  3. Выберите репозиторий. Для полной проверки выберите «Codebase», при первом запуске отключите «Deep scan».
  4. Проверьте папку для анализа, текущую ветку и ревизию, модель и объём рассуждений.
  5. Только при необходимости добавьте в «Additional context» публичные точки входа, условия авторизации и важные операции.
  6. Запустите через «Start scan», следите за прогрессом по этапам и после завершения читайте область проверки и доказательства.

В Codex CLI установите плагин командой /plugins, а затем создайте новый чат для нужного репозитория командой /new. Вместо простого «проверь безопасность» лучше прямо указать, что нужно запустить специализированное сканирование и что является целью. Тогда в истории будет видно, что именно вы просили.

Запустите стандартное сканирование Codex Security с акцентом на services/billing.
Приоритет: пользовательский ввод, проверка владельца платёжных данных и операции только для администраторов.
На этот раз только проверка и отчёт. Не изменяйте исходный код, не делайте commit, push и публикацию и не меняйте настройки оплаты.
Сообщите целевую ревизию, проверенную область, исключённые или незавершённые области и доказательства для воспроизведения.
Если нужно изменить настройки, остановитесь и покажите, какие изменения и почему.

Запреты, записанные в запросе, не обеспечивают ограничения прав так, как это делает песочница. Права на выполнение проверяйте отдельно.

Облачная версия с GitHub

  1. Установите «Codex Security Cloud» и проверьте подключение GitHub к целевому репозиторию.
  2. В разделе «Scan» выберите репозиторий и среду. «Auto» создаёт среду при запуске; если нужно использовать уже подготовленную, проверьте её в «Customize».
  3. Для разовой проверки выберите «One-Time Scan». Чтобы отслеживать будущие коммиты, выберите «Continuous Scanning».
  4. Проверьте цены, остаток бесплатного баланса и объект проверки, затем начните через «Create».

Непрерывное сканирование охватывает основную ветку репозитория по умолчанию. Чем дальше в прошлое вы смотрите по коммитам, тем дольше идёт первое сканирование. Чтобы остановить мониторинг, откройте «Repositories» → нужный объект → «Monitoring settings», приостановите и сохраните. Не путайте закрытие окна с остановкой мониторинга.

Источник: OpenAI — шаги запуска плагина и настройка и мониторинг Cloud.

Standard и Deep: регулировка области и нагрузки

Сначала создайте базовый уровень

Standard

Обычная проверка репозитория или папки. Сначала выясните, что проверяется и какие доказательства появляются, и используйте это как основу для сравнения следующих проверок.

Углублённо проверить нужную область

Deep

Режим более широкого поиска, поэтому он заметно нагружает время и ресурсы. Использует независимые воркеры проверки и подчинённые им субагенты, а результаты собирает по заданным правилам.

В официальных настройках Deep по умолчанию одновременно работают 4 воркера, у каждого по 3 субагента, а максимальное время выполнения — 96 часов. 96 часов — это настроенный верхний предел, а не типичная продолжительность. Для задания ограничения времени нужен плагин версии 0.1.19 или новее. При достижении лимита времени незавершённые воркеры останавливаются, а готовые результаты собираются. Если остались непроверенные участки, они так и останутся в результатах.

Сначала сузьте объект до осмысленных сервисов, прочитайте результаты Standard и только потом решайте, нужен ли Deep. Можно глубоко проверить только критичные области, например оплату и аутентификацию. Уменьшение числа воркеров и времени снижает нагрузку, но часть проблем может остаться незамеченной, поэтому важно фиксировать, какая область была охвачена при более дешёвом и быстром сканировании.

Для проверки различий используйте «Changes». Можно выбрать незафиксированные изменения, один коммит или базовую и целевую ревизии, но в Changes режим Deep недоступен. Проверяется код, напрямую связанный с diff, и это не превращается автоматически в полный аудит.

Ограничение стоимости в отдельном CLI — это оценка. Официальный параметр --max-cost решает, когда остановиться, по оценочной стоимости в долларах США. Уже выполняющийся запрос может завершиться сверх лимита, поэтому это не строгий платёжный предел. Сочетайте его с ограничением времени, числом параллельных задач и областью проверки и не принимайте остановленное сканирование за полный результат.

Источник: OpenAI — Standard и Deep, значения по умолчанию, область «Changes» и оценочные ограничения стоимости.

Чтение области проверки и доказательств, а не количества находок

Количество найденных проблем само по себе не показывает, хорошо ли прошло сканирование. Проверка, которая была направлена не на тот код, остановилась на полпути или не учитывала правила авторизации, может показать ноль находок и всё же не давать уверенности. Официальные инструкции по стандартному сканированию тоже советуют сначала читать ревизию, исследованные области, отложенные области и каждое доказательство.

  1. Цель правильная? Проверьте репозиторий, ревизию и область. Результаты по старому коду не гарантируют безопасность текущей версии.
  2. Что не проверено? Посмотрите исключённые, отложенные и прерванные области. Не считайте, что всё проверено, только потому, что выведено «завершено».
  3. Доказательство состоятельно? Проверьте путь от входных данных до опасной обработки, существующую защиту, способ воспроизведения и результат.
  4. Нужно ли исправлять? Оцените реальные условия, при которых проблема проявляется, и её влияние, затем исправляйте принятые находки по одной.

Самая удобная точка входа — report.md. Структурированный coverage.json показывает проверенные области и отложенные пункты, а findings.json нужен, чтобы посмотреть место каждой находки, её серьёзность, доказательства и направление исправления. В папке findings/ могут находиться подробные отчёты и файлы для воспроизведения. При передаче сохраняйте связанные файлы вместе, а не только отчёт.

Пример чтения находки (условный): можно получить платёжные данные другого пользователя

Одного утверждения «нет авторизации» недостаточно для решения. Проверьте целевую конечную точку, условия входа, что происходит при изменении ID платёжных данных, где проверяется владение и какие проверки выполняются на другом уровне.

Пример, который подтверждается: при указании ID другого пользователя возвращаются данные, и это воспроизведено в разрешённой тестовой среде.

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

В отдельном CLI с помощью coverage.json проверяйте, какие области не были охвачены (исключённые пути и отложенные места). Даже если часть областей не охвачена, код завершения не меняется, поэтому код выхода 0 не означает, что проверены все файлы. Если находка исчезла в последующем сканировании, нельзя считать её «исправленной», пока вы не проверили исходный путь. Автоматическая проверка в Cloud тоже пытается воспроизвести проблему. Результат «не проверено» не означает «доказано, что безопасно».

Источник: OpenAI — оценка стандартного сканирования, область проверки и сравнение в CLI и автоматическая проверка в Cloud.

Исправление, повторная проверка и конфиденциальные данные

Если сообщить, кто и что может делать, отчёт легче оценить

В контекст сканирования добавьте, кто что должен иметь право делать. Например: «платёжные данные доступны только владельцу аккаунта и администраторам» или «публиковать файлы может только владелец». Для локальных плагинов SECURITY.md можно использовать как постоянную политику безопасности, а AGENTS.md — для инструкций по сборке и проверке. В Cloud пересмотрите созданную модель угроз и восполните пробелы в публичных точках входа, важных операциях и границах доверия.

Модель угроз — краткое описание структуры приложения и условий, которые он должен защищать. Правки в Cloud применяются к будущим сканированиям, поэтому исправление допущения не меняет того, что проверялось в старых отчётах.

Исправляйте по одной находке и проверяйте и воспроизведение, и нормальную работу

  1. Примите находку: проверьте доказательства и реальное влияние и выберите одну проблему для исправления.
  2. Создайте небольшое предложение исправления: в локальном интерфейсе выберите «Patch» → «Generate patch». Создание предложения — отдельный этап от применения к рабочей копии.
  3. Прочитайте diff: проверьте, нет ли несвязанных правок или изменений, ослабляющих другую защиту, и только после этого примените через «Apply patch».
  4. Повторно проверьте: через «Verify fix» проверьте исходный сценарий воспроизведения и нормальное поведение. По возможности также оставьте регрессионный тест, который падает до исправления и проходит после него.
  5. Закройте находку: одной проверки недостаточно для автоматического закрытия. Оцените оставшийся недостаток доказательств и либо закройте находку с указанием причины, либо продолжайте расследование.

Если в Cloud предоставлено предложение исправления, сначала проверьте его содержимое и только потом создавайте черновой PR. Отдельно фиксируйте, было ли предложение, применено ли оно, проверено ли повторно и выпущено ли в продакшн. Также используйте проверку перед публикацией приложений, созданных с помощью ИИ, чтобы не полагаться на один сканер.

«Локально» не означает, что ничего не отправляется наружу

Даже на пути, который работает локально, отдельно проверяйте запросы вывода, отправляемые модели, и данные, используемые для проверки. В официальных инструкциях по отдельному CLI сказано, что сканирование использует права локальной ОС, не останавливается для подтверждения каждого действия и может унаследовать переменные окружения. Не считайте, что у него те же права, что и в обычном чате Codex; подготовьте среду сканирования без ненужных учётных данных.

Сохранённые логи не всегда автоматически очищаются от секретных значений и могут содержать исходный код или учётные данные. Результаты также включают шаги воспроизведения и подробности уязвимостей, поэтому перед публичной ссылкой или передачей третьим лицам проверьте содержимое и круг получателей. О настройках использования для улучшения моделей см. отдельную статью: использование ChatGPT и Codex для обучения и конфиденциальность.

Источник: OpenAI — SECURITY.md и AGENTS.md, модель угроз Cloud, исправление и проверка и права, результаты и логи отдельного CLI.

Чек-лист перед началом

  • Путь: выберите локальный плагин, Cloud или отдельный CLI.
  • Права: убедитесь, что у вас есть разрешение на проверку кода и право на сканирование в аккаунте.
  • Оплата: не смешивайте обычный лимит использования, бесплатный кредит Cloud и оплату API.
  • Объект: зафиксируйте ревизию и область и рассмотрите начало со Standard.
  • Решение: читайте не количество находок, а область проверки, доказательства воспроизведения и оставшуюся неопределённость.
  • Исправление: принимайте исправление только после проверки каждого diff и повторной проверки по одному.

Если вы впервые, начните со Standard-сканирования нужной области, чтобы понять, можете ли вы сами оценить результаты. Нужен постоянный мониторинг — рассмотрите Cloud; хотите встроить проверку в автоматические процессы — отдельный CLI. Используйте это как инструмент, который дополняет поиск и проверку проблем, а не как доказательство безопасности, заменяющее существующий статический анализ (SAST) или проверку человеком.

Исходные условия статьи: написано 7 октября 2026 года на основе официальной документации OpenAI. Бесплатный период и коды выхода CLI перепроверены по официальному FAQ 19 октября. Сканирования продукта мы не запускали, поэтому точность обнаружения, время выполнения и расход проверьте сами: попробуйте сканирование на части своего репозитория.

Часто задаваемые вопросы

Q. Если у меня ChatGPT Pro, Codex Security Cloud входит без дополнительной оплаты?

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

Q. Разве недостаточно просто попросить обычный Codex проверить код?

Всё зависит от цели. Обычная проверка может оценить реализацию и тесты. Codex Security стоит рассмотреть, если нужны специальная область проверки, находки, доказательства воспроизведения и непрерывный мониторинг.

Q. Если сканирование дало ноль находок, можно считать код безопасным?

Нет. Сначала проверьте ревизию, целевую область, не прервалось ли сканирование досрочно и какие области были исключены. Если область проверки была неполной или вы не учли бизнес-правила авторизации, проблемы могут быть пропущены. Используйте результаты вместе с существующим статическим анализом и проверкой человеком.

Q. Если выбрать Deep-сканирование, можно ли надёжно проверить код при небольшом лимите использования?

Такой гарантии нет. Deep ищет шире, поэтому тратит больше времени и ресурсов, чем Standard. Настройте объект, параллельность и ограничения времени, а если сканирование остановилось, проверьте, какая область была охвачена. Ограничение оценочной стоимости в отдельном CLI — тоже не строгий платёжный предел.