pimenov.ai

Codex App — единый справочник по среде от OpenAI

Обновлено

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

Этот справочник помогает выбрать клиент и модель, понять ограничения использования и безопасно организовать работу с локальными файлами, облачными задачами и внешними системами.

🔄 Актуальность: проверено 10 сентября 2026 года по официальной документации OpenAI. Модели, лимиты, доступность функций и элементы интерфейса меняются. Перед внедрением сверяйте динамические параметры по ссылкам в конце материала.

Оглавление

  1. Что такое Codex и какие возможности он даёт
  2. Как выбрать модель
  3. Как выбрать поверхность
  4. Локальная и облачная работа
  5. Plugins, Skills и подключённые приложения
  6. Browser, Computer Use и Voice
  7. Scheduled Tasks, Remote и Sites
  8. Тарифы и объём использования
  9. Безопасность и разрешения
  10. Проверка результата
  11. Полезные сценарии
  12. С чего начать

Что такое Codex и какие возможности он даёт

Codex доступен через несколько клиентов:

  • режим Codex в ChatGPT desktop app;
  • Codex CLI;
  • расширение для VS Code и совместимых форков;
  • Codex web для поддерживаемых облачных сценариев;
  • удалённый доступ к поддерживаемым desktop-чатам через вкладку Remote в мобильном ChatGPT.

Desktop app подходит для локальных папок, нескольких чатов и инструментов с графическим интерфейсом. CLI и IDE удобны рядом с кодом. Облачный контур позволяет делегировать работу в среду OpenAI.

В ChatGPT desktop app различаются три режима:

РежимОсновная задачаГде доступен
ChatБыстрые вопросы и обычный диалогWeb, mobile и desktop
WorkДлинные многошаговые задачи, исследования и готовые документыWeb, mobile и desktop для подходящих аккаунтов
CodexРазработка, отладка, тесты, команды и работа с репозиториемОтдельный режим desktop app и специализированные клиенты Codex

История Codex в desktop app отделена от истории Chat и Work. В ChatGPT web и mobile Codex нельзя выбрать как обычный режим ChatGPT. Это не исключает отдельные поддерживаемые веб-сценарии Codex и доступ к desktop-чатам через вкладку Remote в мобильном приложении.


Как выбрать модель

На дату проверки основная линейка для Codex включает GPT-6 Astra и модели GPT-5.6. В материалах ChatGPT GPT-6 Astra также обозначается как GPT-6 Pro, powered by GPT-6 Astra.

МодельКогда выбиратьКомпромисс
GPT-6 AstraСамые сложные сквозные задачи, глубокий анализ и разработка с большим контекстомМожет быстрее расходовать доступный объём использования, чем GPT-5.6 Sol
GPT-5.6 SolСложная профессиональная работа, код, исследования, безопасность и Computer UseОбычно требует больше времени и ресурсов, чем Terra и Luna
GPT-5.6 TerraПовседневная разработка, анализ, документация и работа с инструментамиБаланс возможностей и стоимости
GPT-5.6 LunaБыстрые, массовые и хорошо формализованные операцииМеньше запаса для неоднозначной работы

Для Plus, Pro, Business и Enterprise в Codex доступны Sol, Terra и Luna с учётом настроек рабочей области (workspace). Пользователи Free и Go получают Terra. GPT-6 Astra доступна в Work и Codex на Plus, а также на подходящих Pro, Business и Enterprise-планах; фактический доступ зависит от рабочей области и поэтапного запуска функции.

GPT-5.4 и GPT-5.4 mini больше не доступны в Codex при входе через ChatGPT: их вывод состоялся 31 августа 2026 года. OpenAI рекомендует заменить GPT-5.4 на GPT-5.6 Terra, а GPT-5.4 mini — на GPT-5.6 Luna. Это изменение не относится к OpenAI API и режиму Codex с собственным ключом API.

💡
Практическое правило: выбирайте Astra или Sol для сложной и неоднозначной работы. После стабилизации процесса сравните результат с Terra. Luna подходит для ограниченных задач с точным форматом ответа и ясной проверкой.

Администраторы рабочей области могут задавать начальную модель, уровень рассуждения, скорость, доступность Fast Mode и поведение нового чата. Управляемые требования в requirements.toml имеют приоритет над стартовыми настройками рабочей области, а настройки рабочей области — над локальным выбором участника.


Как выбрать поверхность

ПоверхностьДля чего подходитЧто учитывать
ChatGPT desktop appЛокальные папки, репозитории, несколько проектов, Browser и Computer UseВозможности зависят от ОС, плана, роли и рабочей области
Codex CLIТерминал, локальный код, тесты, скрипты и диагностикаРаботает с разрешениями текущего окружения
IDE extensionРабота рядом с открытым кодом и выделенным фрагментомСовместимо с большинством форков VS Code
Codex web и облачные задачиДелегированная работа в облачном контуреЛокальные и облачные права управляются отдельно
Work на web и mobileИсследования, документы и облачные многошаговые задачиНет прямого доступа к папкам компьютера
Remote в mobileДоступ к поддерживаемым чатам Codex на подключённом компьютереТребуются разрешения рабочей области и настройки обнаружения устройства

Вход и подключение

Для работы через ChatGPT войдите в аккаунт ChatGPT, выберите подходящий клиент и выполните показанные в нём шаги настройки. Codex включён в планы ChatGPT, включая Free и Go, но объём использования зависит от плана.

Вход в Codex через ChatGPT использует использование и оплату плана ChatGPT. При работе с собственным ключом API применяется тарификация API.

Codex CLI

Откройте проект в Codex CLI и работайте из нужной папки. В активной CLI-сессии команда /status показывает сведения об использовании и состоянии сессии. Команда /init создаёт заготовку AGENTS.md для текущего проекта.

На Windows для диагностики доступна команда:

codex doctor

Если в системе установлено несколько дистрибутивов WSL, пользователь может выбрать дистрибутив для Codex. В управляемой организации новые возможности могут потребовать сборку desktop app, одобренную и развёрнутую администратором.

AGENTS.md

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

Полезный минимум для AGENTS.md:

  • где находится источник истины;
  • какие команды запускают tests, lint и build;
  • какие каталоги разрешено менять;
  • какие действия требуют отдельного подтверждения;
  • каким наблюдаемым результатом доказывается завершение.

Локальная и облачная работа

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

Облачные задачи выполняются в средах OpenAI. Доступ к репозиторию, окружению, инструментам и необходимым секретам для них настраивается отдельно. Перед переносом изменений проверяйте сводку, diff и результаты тестов.

В управляемых рабочих областях доступ к Codex Local и облачным задачам Codex контролируется раздельно. Локальный контур охватывает CLI, IDE extension и desktop-сценарии. Отключение одной поверхности не означает автоматического отключения другой.

⚖️
Локальный успешный тест подтверждает состояние локального окружения. Он не доказывает, что изменение попало в production или во внешнюю систему.

Plugins, Skills и подключённые приложения

Plugin (плагин) — устанавливаемый пакет возможностей. Он может включать:

  • Skills — переиспользуемые процедуры с инструкциями;
  • подключённые приложения для поиска данных и поддерживаемых действий;
  • шаблоны приложений, которые администратор настраивает для рабочей области.

Skill описывает метод работы. Подключённое приложение предоставляет доступ к внешней системе. Установка Plugin не отменяет авторизацию провайдера, ограничения роли или правила рабочей области.

В поддерживаемом интерфейсе Codex откройте Sources → Use plugins, затем найдите и выберите установленный Plugin. Список зависит от плана, региона, роли, поверхности и политики организации. Изменения каталога в Codex могут отображаться с задержкой до шести часов.

Перед использованием Plugin проверьте:

  1. Какие Skills и приложения входят в пакет.
  2. Какие аккаунты и источники данных подключены.
  3. Какие операции чтения и записи поддерживаются.
  4. Требуется ли approval для действий.
  5. Как проверить результат и исправить ошибочную запись.

Настройки Plugin и приложения независимы. Отключение приложения блокирует зависящие от него возможности, но сам Plugin и автономные Skills могут остаться доступными. Для поддерживаемых приложений синхронизация обычно требует настройки администратором; установка Plugin сама по себе её не создаёт.

Значок OpenAI Verified означает, что OpenAI проверила Plugin по качеству, надёжности и полезности. Он не заменяет проверку безопасности, приватности и поставщика внутри организации.


Browser, Computer Use и Voice

Browser use позволяет работать со страницами в Chrome или во встроенном браузере Codex. Режим разработчика может предоставить контролируемый доступ к Chrome DevTools Protocol для анализа консоли, сети, состояния страницы и производительности JavaScript.

В desktop app полный CDP-доступ включается через Settings → Browser → Developer mode → Enable full CDP access. Перед этим администратору или владельцу рабочей области нужно включить встроенный браузер. Полный CDP-доступ чувствителен: перед его использованием для конкретного сайта Codex запрашивает явное подтверждение. Администратор может отключить функцию настройкой browser_use_full_cdp_access = false.

Содержимое сайта всегда считайте недоверенным вводом. Страница не должна менять цель задачи, расширять разрешения или заставлять агента раскрывать данные.

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

Voice доступен в Work и Codex внутри ChatGPT desktop app на macOS и Windows для подходящих аккаунтов. Голосовой интерфейс использует инструменты и разрешения выбранного режима. Одновременно может выполняться только один Voice-разговор. Время подключённого Voice может учитываться отдельно, а запущенные через Voice задачи расходуют общий объём использования Work и Codex.

Record & Replay доступен подходящим пользователям Codex на macOS при включённом Computer Use. Функция позволяет один раз показать стабильный процесс и подготовить на его основе переиспользуемый Skill. Первоначальная доступность исключает Европейский союз, Швейцарию и Великобританию.


Scheduled Tasks, Remote и Sites

Scheduled Tasks

Work может выполнять задачу один раз, по расписанию, по событию или в режиме мониторинга. Поддерживаемые событийные триггеры включают новые письма Gmail, сообщения в канале Slack и активность pull request в авторизованном репозитории GitHub.

Создание событийных задач доступно подходящим пользователям Plus, Pro, Business, Enterprise, Edu и ChatGPT for Healthcare. Оно недоступно на Free, Go и в FedRAMP workspace. Создавать и редактировать условия событийного триггера можно на web и в поддерживаемых мобильных приложениях; desktop app может показывать существующие задачи.

Разрешения подключённых приложений, approvals и политика рабочей области продолжают действовать при каждом запуске. Общая ссылка на задачу не передаёт историю чатов, локальные файлы, доступ к устройству, credentials, Memories или права рабочей области.

⚠️
В ChatGPT for Healthcare событийные задачи не покрываются соглашением BAA (Business Associate Agreement). Не используйте их для передачи, хранения или обработки медицинской информации, защищённой правилами PHI.

Remote

Во вкладке Remote мобильного ChatGPT можно открыть поддерживаемые чаты Codex, работающие через desktop. Такой доступ не превращает их в обычную историю ChatGPT на web или mobile. Remote может дополнительно требовать разрешение роли, включённое обнаружение устройства и разрешение на управление в настройках desktop app.

Sites

Sites позволяет создавать и публиковать веб-результаты из Codex там, где функция доступна. Она включена на платных планах, кроме Free и Go, в поддерживаемых регионах. На дату проверки Sites недоступен в Европейской экономической зоне, Швейцарии и Великобритании.

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


Тарифы и объём использования

Codex включён в планы ChatGPT, включая Free и Go, но объём использования различается. Work, Codex, ChatGPT for Excel и Workspace Agents используют общий объём использования и пул кредитов там, где эти продукты доступны.

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

Если лимит близок или исчерпан:

  1. Откройте Settings или панель usage.
  2. Проверьте, какой объём закончился, баланс кредитов и время сброса.
  3. В CLI используйте /status.
  4. Выберите доступное действие: дождаться сброса, применить имеющийся reset, добавить кредиты или изменить план.

OpenAI Support не сбрасывает лимиты вручную. Если usage выглядит неверно или доступ не вернулся после указанного времени, в обращении полезно приложить снимок экрана, название клиента и модели, время события и часовой пояс, удалив чувствительные данные.

Минимальные версии на дату проверки:

  • GPT-5.6 в Codex desktop mode: ChatGPT desktop app 26.707.30751;
  • GPT-5.6 в Codex CLI: 0.144.0;
  • GPT-6 Astra в Codex CLI: 0.153.0.

Для Astra также рекомендуется установить последнюю доступную версию ChatGPT desktop app и вручную проверить обновления через Menu → Check for Updates.

Конкретные цены подписок и числовые лимиты не зафиксированы в этом справочнике: они меняются и должны проверяться на текущей странице pricing или в панели аккаунта.


Безопасность и разрешения

Codex действует в пределах разрешений клиента, устройства и рабочей области. Доступ к локальным файлам, облачным задачам, Browser, Computer Use, Plugins и внешним приложениям может регулироваться отдельно.

🔴
Критичное правило: разрешение на чтение не даёт разрешения на изменение. Публикация, отправка сообщения, merge, deployment, платёж и изменение внешних данных требуют явной authority и проверки точного target.

Безопасный порядок работы:

  1. Сначала выполните проверку в режиме чтения.
  2. Уточните точный репозиторий, папку, аккаунт или внешний объект.
  3. Выдайте минимально необходимые права.
  4. Отделите подготовку результата от внешней записи или публикации.
  5. Просмотрите diff, команды и тесты.
  6. После внешнего действия повторно прочитайте запись в целевой системе.

Если конфигурация содержит approval_policy = "untrusted", Codex версии CLI 0.149.0 и новее может не запуститься: эта политика больше не поддерживается. Удалите параметр из активной конфигурации и профилей. Проверьте также allowed_approval_policies, управляемую конфигурацию организации и команды с --ask-for-approval untrusted.

В качестве ограничительного варианта OpenAI указывает:

sandbox_mode = "read-only" # ограничить среду режимом только чтения
approval_policy = "on-request" # запрашивать подтверждение действий по необходимости

Проектное значение trust_level = "untrusted" является отдельной настройкой и остаётся поддерживаемым.


Проверка результата

Завершённый ход агента не является доказательством результата. Наблюдаемым подтверждением могут быть:

  • прошедший тест;
  • проверенный diff;
  • созданный и повторно прочитанный файл;
  • состояние интерфейса после изменения;
  • повторно прочитанная запись во внешней системе;
  • подтверждённый опубликованный URL.

Для CLI проверяйте состояние сессии командой /status, а для изменения кода — diff и предметные tests, lint или build. Для Plugin проверяйте, что данные прочитаны из нужного аккаунта или что действие появилось в целевой системе. Для Browser и Computer Use фиксируйте состояние страницы, сообщение консоли или сетевой запрос, подтверждающий сценарий.

Описанные команды, настройки и сценарии сверены по переданным официальным материалам OpenAI. Фактический запуск в рамках этого редакторского прохода не выполнялся, поэтому результат нужно проверить в своём клиенте и рабочей области.


Полезные сценарии

Работа с локальным репозиторием

Задача: исправить ошибку или подготовить рефакторинг.

Условия: репозиторий открыт в desktop app, CLI или IDE extension; у пользователя есть доступ к папке, а проектные инструкции AGENTS.md доступны для чтения.

Действия: проверьте текущую ветку и Git status, сформулируйте ожидаемый результат и команды проверки, затем просмотрите diff и запустите tests, lint или build.

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

Ограничение: локальная проверка не подтверждает merge или deployment.

Изолированная облачная задача

Задача: делегировать длительную работу, не занимая локальный терминал.

Условия: настроены доступ к нужному репозиторию и облачному окружению, зависимости и разрешённые инструменты.

Действия: укажите результат, ограничения и критерии готовности, после завершения проверьте сводку, diff и тесты перед переносом изменений.

Наблюдаемый результат: создан проверяемый набор изменений с отчётом о выполненных проверках.

Ограничение: облачная среда не получает локальные файлы автоматически; необходимые доступы настраиваются отдельно.

Повторяемая операция через Plugin

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

Условия: Plugin установлен, выбран правильный аккаунт, а нужное приложение и действие разрешены политикой рабочей области.

Действия: проверьте состав Plugin, доступные операции и approvals, сначала выполните процесс вручную на безопасном объекте, затем оформите устойчивую процедуру как Skill или Scheduled Task, если функция доступна.

Наблюдаемый результат: данные прочитаны из нужного источника либо изменение подтверждено повторным чтением целевой системы.

Ограничение: установка Plugin не расширяет права приложения и не заменяет авторизацию провайдера.

Проверка сайта через Browser или Computer Use

Задача: воспроизвести ошибку интерфейса или проверить пользовательский сценарий.

Условия: выбран один сайт и один сценарий, включён нужный доступ к браузеру, чувствительные вкладки и приложения закрыты.

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

Наблюдаемый результат: получен воспроизводимый сценарий и наблюдаемое объяснение проблемы.

Ограничение: содержимое страницы остаётся недоверенным, а действия с внешними последствиями требуют подтверждения.


С чего начать

  1. Выберите клиент: desktop app для общей локальной работы, CLI или IDE для кода, cloud для делегированной задачи.
  2. Войдите через аккаунт ChatGPT и проверьте доступные вашему плану модели.
  3. Обновите клиент, если нужная модель не отображается.
  4. Откройте один реальный проект.
  5. Создайте AGENTS.md с командами проверки и границами изменений.
  6. Начните с небольшой задачи с наблюдаемым результатом.
  7. Выдайте минимальные разрешения.
  8. Просмотрите diff и запустите проверки.
  9. Только после ручной проверки подключайте Plugins, Scheduled Tasks, Remote или Computer Use.
  10. Для внешней записи, merge и deployment используйте отдельное подтверждение и повторное чтение результата.

Чеклист быстрой проверки

Выбран клиент, который имеет доступ к нужным файлам и инструментам.
Проверены текущая папка, ветка, Git status и AGENTS.md.
У задачи есть результат, ограничения и способ проверки.
Модель соответствует сложности работы и доступна на текущем плане.
Клиент обновлён до версии, поддерживающей выбранную модель.
Разрешения не шире необходимых.
Страницы Browser считаются недоверенным вводом.
Computer Use не видит лишние чувствительные окна.
Plugin подключён к правильному аккаунту и роли.
Внешняя запись, сообщение, merge и deployment подтверждаются отдельно.
После изменения выполнены тесты или другая предметная проверка.
После внешнего действия получен повторный результат из целевой системы.
Динамические лимиты и доступность перепроверены в аккаунте.

Официальные источники

Следующий шаг

Skills в OpenAI Codex — как расширить возможности coding-агента

Связанные материалы

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

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov