Справочник по конфигурации

Полный справочник по файлам Codex config.toml и requirements.toml

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

Настройки доступа к локальному компьютеру через Work Cloud

Когда включён доступ к локальному компьютеру через Work Cloud, облако OpenAI координирует задачу, а поддерживаемые инструменты выполняются в облаке или на подключённом компьютере. Требования задают ограничения, а значения конфигурации — настройки по умолчанию.

Используйте API политик для управления настройками Global. Для управления настройками Local или Codex Cloud используйте интерфейс Agent Security. Существующие процессы работы с API для Global остаются доступны после миграции. Протестируйте свои скрипты и интеграции с Terraform и убедитесь, что назначения политик и их порядок не изменились. Сама по себе поддержка поля requirements.toml не означает совместимости с API.

Настройка или группа настроек Область действия при доступе к локальному компьютеру через Work Cloud Рекомендации
Политики одобрения и требования к проверке Политика оркестратора из Global, когда включена управляемая политика Сохраняйте настройки одобрения и проверки в Global. Переопределения для сред не могут менять настройки оркестратора. Для локального выполнения и выполнения в облачных контейнерах действуют отдельные области применения политик.
Управляемые приложения, MCP servers, плагины, маркетплейсы и правила команд Политика Global Сохраняйте эти настройки на глобальном уровне. Наличие поля в схеме не означает, что его можно редактировать для каждой среды.
Требования к файлам, песочнице и переносимые сетевые требования Локальное выполнение При локальном выполнении требования MDM и устаревшие требования для управляемых устройств имеют более высокий приоритет, чем Agent Security. Системный файл требований устройства имеет более низкий приоритет, чем Agent Security. Новая корпоративная конфигурация requirements.toml не применяется к облачным контейнерам Work: для них сохраняются существующие политики Work Cloud.
Настройки исполнителя, зависящие от платформы Компьютер, на котором выполняется шаг Поддержка зависит от исполнителя и платформы.
Управляемые хуки Если включены — заданные администратором хуки MCP, выполняемые на облачном координаторе (оркестраторе) для поддерживаемых событий жизненного цикла и инструментов. Прежде чем полагаться на эти хуки, протестируйте соединение для обратных вызовов, убедитесь, какие события оно получает, и проверьте, как сбои влияют на задачу. Хуки MCP не обеспечивают полного журнала аудита Compliance API. Хуки команд, локальной конфигурации и плагинов не поддерживаются при облачной оркестрации, даже если инструменты выполняются локально. Существующие поддерживаемые хуки по-прежнему применяются к полностью локальным веткам Work и Codex, где и оркестрация, и выполнение происходят локально.
Адреса и порты прослушивания прокси, а также настройки процессов Не относятся к переносимой политике среды Облачная среда выполнения не поддерживает управляемые порты прослушивания HTTP/SOCKS и прослушивание прокси на адресах вне loopback; поддержка правил сокетов зависит от способа выполнения. Пользовательская конфигурация прокси задаётся отдельно от поддерживаемых ограничений адресов назначения.
Настройки только для приложения и обычные локальные значения по умолчанию Не обязательно учитываются при облачной координации Ограничения, применяемые приложением, могут оставаться в силе, даже если доступ к локальному компьютеру через Work Cloud их не учитывает. Доставку в облако и поведение облачного браузера необходимо проверять отдельно.

Требования Agent Security для доступа к локальному компьютеру через Work Cloud

Для Work с локальным доступом и dots поддерживаемая политика Global применяется к общему облачному оркестратору, когда включена управляемая политика. Требования к локальному выполнению действуют на подключённом компьютере. Облачные контейнеры Work и облачные компьютеры dots используют собственные конфигурации и требования к выполнению. Тестируйте локальные и облачные ограничения отдельно.

Доступно в интерфейсе Agent Security

  • Разрешённые политики одобрения
  • Разрешённые режимы веб-поиска

Настраивается через TOML

  • allowed_approvals_reviewers
  • auto_review
  • guardian_policy_config
  • apps
  • mcp_servers
  • plugins
  • rules

Эти требования к оркестратору остаются в Global. Они не задают разрешения на использование общих облачных возможностей и не обеспечивают перенос настроек локального выполнения в облачные контейнеры Work или на облачные компьютеры dots.

Ограничения совместимости при доступе к локальному компьютеру через Work Cloud

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

Внутри политики порядок приоритета от высшего к низшему таков: переопределение для среды с конкретной ОС → переопределение для среды со всеми ОС → Global. Политика с более высоким приоритетом имеет преимущество, даже если политика с более низким приоритетом более конкретна.

При локальном выполнении требования MDM и устаревшие требования для управляемых устройств имеют приоритет над Agent Security, а Agent Security — над системным файлом требований устройства. Для некоторых требований, включая сетевые, действуют особые для каждого поля правила слияния и ограничения среды выполнения. Примеры см. в разделе Управляемая конфигурация.

Настройка или группа настроек Совместимость с доступом к локальному компьютеру через Work Cloud Рекомендации для администраторов
sqlite_home, log_dir, model_catalog_json Не поддерживаются в качестве управляемых облачных переопределений. Локальные пути не могут изменить расположение облачного хранилища или журналов. Локальный каталог моделей не переносится.
model_provider, model_providers Не поддерживаются в управляемых требованиях или конфигурации доступа к локальному компьютеру через Work Cloud. Пользовательские шлюзы инференса и подключения к провайдерам не переносятся через эти поля. Это не связано с выбором модели.
enforce_residency Блокирует доступ к локальному компьютеру через Work Cloud, если включено в любой облачной политике. Если enforce_residency включено в любой облачной политике, параметр Разрешить доступ к локальному компьютеру отключается и для Work, и для dots. Эта защитная мера не задаёт регион хранения данных рабочего пространства и сама по себе не отключает Work Cloud или dots.
application.network.enabled и application.network.domains Не поддерживаются при доступе к локальному компьютеру через Work Cloud. Не используйте эти ограничения адресов назначения для приложений в качестве средств управления сетевым доступом команд при доступе к локальному компьютеру через Work Cloud.
allow_browser_and_computer_use, in_app_browser, additional_developer_instructions Доставку облачной политики необходимо проверить. Доступ к локальному компьютеру через Work Cloud отклоняет эти ключи управляемых требований. Ограничения браузера проверяются на стороне приложения. Это не подтверждает их доставку в облако или применение в облачном браузере. additional_developer_instructions требует поддержки со стороны оркестратора.
experimental_network и permissions.<profile>.network Частичная. Поддерживаемые ограничения адресов назначения и исполнителя отличаются от пользовательской конфигурации прокси. Облачная среда выполнения не поддерживает управляемые порты прослушивания HTTP/SOCKS и прослушивание прокси на адресах вне loopback; поддержка правил сокетов зависит от способа выполнения. Правила слияния при локальном выполнении рассматриваются отдельно. Ограничения сетевого доступа команд не отключают поиск на стороне сервиса, MCP или инструменты приложений.
Функции / feature_requirements, модели, computer_use Частичная. Выведенные из использования переключатели, такие как tool_search = false, tool_search_always_defer_mcp_tools = false, js_repl = true и remote_control = true, отклоняются. Некоторые настройки использования компьютера всё ещё требуют сквозной проверки.
browser_use, allow_appshots, обратная связь, allow_remote_control, ограничения источников маркетплейса Приложение или app-server применяет эти ограничения при некоторых способах доставки политик. Ограничения приложения могут продолжать действовать, даже если доступ к локальному компьютеру через Work Cloud игнорирует поле. Правила сайтов для браузера настольного приложения не применяются к облачным контейнерам Work. Проверяйте фактически используемый интерфейс и способ доставки политики.

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

config.toml

Конфигурация уровня пользователя хранится в ~/.codex/config.toml. Вы также можете добавить переопределения для отдельных проектов в файлы .codex/config.toml. Codex загружает файлы конфигурации проекта только в том случае, если вы доверяете проекту.

Конфигурация проекта не может переопределять локальные для компьютера параметры провайдера и аутентификации, метаданные запросов приложений, задаваемые хостом, уведомления, выбор профиля конфигурации или ключи маршрутизации телеметрии. Codex игнорирует openai_base_url, chatgpt_base_url, apps_mcp_product_sku, model_provider, model_providers, notify, profile, profiles, experimental_realtime_ws_base_url и otel, если они указаны в локальном для проекта .codex/config.toml; вместо этого помещайте ключи провайдера, уведомлений и телеметрии в конфигурацию уровня пользователя. Файлы профилей конфигурации располагаются рядом с config.toml под именами $CODEX_HOME/profile-name.config.toml; выберите нужный с помощью --profile profile-name.

При работе с ключами песочницы и подтверждений (approval_policy, sandbox_mode и sandbox_workspace_write.*) используйте этот справочник вместе с разделами Песочница и подтверждения, Защищённые пути в корнях с правом записи и Доступ к сети. О профилях разрешений на стадии бета-тестирования см. в разделе Разрешения.

Codex и ChatGPT Work больше не поддерживают approval_policy = "untrusted". Удалите эту настройку или выберите поддерживаемую политику. Записи проектов с trust_level = "untrusted" в пользовательском файле ~/.codex/config.toml по-прежнему поддерживаются. См. раздел Переход с упразднённой политики одобрения untrusted с примерами и описанием компромиссов при выборе настроек одобрения.

Укажите в model модель, доступную вашей текущей учётной записи или рабочему пространству. См. раздел Доступность GPT-6.1 Sol, прежде чем использовать значение из примера.

Ключ Тип / значения Описание
agents table Настройки нескольких агентов и объявления пользовательских ролей. Имена скалярных параметров зарезервированы и не могут использоваться как имена пользовательских ролей.
agents.<name>.config_file string (path) Путь к слою конфигурации TOML для этой роли; относительные пути разрешаются относительно файла конфигурации, объявляющего роль.
agents.<name>.description string Инструкции по роли, показываемые Codex при выборе и создании агента этого типа.
agents.default_subagent_model string Модель по умолчанию для создаваемых агентов. Модель, явно указанная при создании, имеет приоритет.
agents.default_subagent_reasoning_effort string Уровень усилий на рассуждение по умолчанию для создаваемых агентов. Уровень, явно указанный при создании, имеет приоритет.
agents.enabled boolean Включает или отключает инструменты работы с несколькими агентами (по умолчанию: true).
agents.interrupt_message boolean Записывает видимое модели сообщение, когда ход агента прерывается (по умолчанию: true).
agents.max_concurrent_threads_per_session number Максимальное количество одновременно открытых потоков созданных агентов, не считая основного потока. Если не задано, Codex выбирает значение по умолчанию.
agents.max_threads number Устаревший псевдоним для agents.max_concurrent_threads_per_session.
allow_login_shell boolean Разрешает инструментам оболочки использовать семантику оболочки входа. По умолчанию — true; при false запросы login = true отклоняются, а если login не указан, по умолчанию используются оболочки без режима входа.
analytics.enabled boolean Включает или отключает аналитику для этого компьютера или профиля. Если не задано, применяется значение клиента по умолчанию.
approval_policy on-request | never | { granular = { sandbox_approval = bool, rules = bool, mcp_elicitations = bool, request_permissions = bool, skill_approval = bool } } Определяет, когда Codex приостанавливает работу для запроса подтверждения перед выполнением команд. Также можно использовать approval_policy = { granular = { ... } }, чтобы разрешать или автоматически отклонять определённые категории запросов, сохраняя интерактивное подтверждение для остальных. untrusted не поддерживается, а on-failure устарело; используйте on-request для интерактивных запусков или never для неинтерактивных.
approval_policy.granular.mcp_elicitations boolean При true разрешён показ запросов дополнительных сведений MCP вместо их автоматического отклонения.
approval_policy.granular.request_permissions boolean При true разрешён показ запросов от инструмента request_permissions.
approval_policy.granular.rules boolean При true разрешён показ запросов подтверждения, вызванных правилами execpolicy prompt.
approval_policy.granular.sandbox_approval boolean При true разрешён показ запросов на расширение прав за пределы песочницы.
approval_policy.granular.skill_approval boolean При true разрешён показ запросов подтверждения для скриптов навыков.
approvals_reviewer user | auto_review Определяет, кто рассматривает соответствующие запросы подтверждения при on-request или детализированных политиках подтверждения. По умолчанию — user; auto_review использует субагента проверки. Этот параметр не меняет ограничения песочницы и не запускает проверку действий, уже разрешённых внутри неё.
apps._default.approvals_reviewer user | auto_review Проверяющий по умолчанию для запросов подтверждения инструментов приложений, если он не переопределён для конкретного приложения. Если не указан, приложения наследуют значение approvals_reviewer верхнего уровня.
apps._default.default_tools_approval_mode auto | prompt | writes | approve Порядок подтверждения по умолчанию для инструментов приложений без переопределений на уровне приложения или инструмента.
apps._default.destructive_enabled boolean Разрешение или запрет по умолчанию для инструментов приложений с destructive_hint = true.
apps._default.enabled boolean Состояние включения по умолчанию для всех приложений, если оно не переопределено для конкретного приложения.
apps._default.open_world_enabled boolean Разрешение или запрет по умолчанию для инструментов приложений с open_world_hint = true.
apps.<id>.approvals_reviewer user | auto_review Проверяющий для запросов подтверждения инструментов этого приложения. Переопределяет apps._default.approvals_reviewer.
apps.<id>.default_tools_approval_mode auto | prompt | writes | approve Порядок подтверждения по умолчанию для инструментов этого приложения, если нет переопределения для конкретного инструмента.
apps.<id>.default_tools_enabled boolean Состояние включения по умолчанию для инструментов этого приложения, если нет переопределения для конкретного инструмента.
apps.<id>.destructive_enabled boolean Разрешает или блокирует инструменты этого приложения, заявляющие destructive_hint = true.
apps.<id>.enabled boolean Включает или отключает конкретное приложение или коннектор по идентификатору (по умолчанию: true).
apps.<id>.open_world_enabled boolean Разрешает или блокирует инструменты этого приложения, заявляющие open_world_hint = true.
apps.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Переопределение порядка подтверждения для отдельного инструмента приложения.
apps.<id>.tools.<tool>.enabled boolean Переопределение включения отдельного инструмента приложения (например, repos/list).
auto_review.extra_policy string Дополнительная локальная политика в формате Markdown для автоматической проверки, включаемая вместе с основной политикой. Управляемый параметр guardian_extra_policy имеет приоритет. Пустые значения игнорируются.
auto_review.policy string Локальные инструкции политики в формате Markdown для автоматической проверки. Управляемый параметр guardian_policy_config имеет приоритет. Пустые значения игнорируются.
background_terminal_max_timeout number Максимальное время ожидания в миллисекундах для пустых запросов write_stdin (фоновый опрос терминала). По умолчанию: 300000 (5 минут). Заменяет прежний ключ background_terminal_timeout.
browser_use.allow_history_access boolean Установите false, чтобы ограничить доступ к истории браузера. Управляемые требования могут принудительно применять это ограничение.
browser_use.default_origin_policy table Резервные ограничения для источников браузера. Поддерживаются access, uploads, downloads и full_cdp_access, каждому из которых задаётся значение allow или deny.
browser_use.origins.<origin> table Ограничения браузера для отдельных источников с теми же полями, что и у browser_use.default_origin_policy. Укажите схему HTTP или HTTPS и, при необходимости, порт; не указывайте пути, параметры запроса и фрагменты. Локальные значения не могут ослаблять управляемые запреты.
chatgpt_base_url string Переопределяет базовый URL, используемый при входе в ChatGPT.
check_for_update_on_startup boolean Проверяет наличие обновлений Codex при запуске (устанавливайте false только при централизованном управлении обновлениями).
cli_auth_credentials_store file | keyring | auto | ephemeral Определяет, где CLI хранит кэшированные учётные данные.
compact_prompt string Переопределение запроса на сжатие истории, заданное непосредственно в конфигурации.
computer_use.default_app_access allow | deny Резервная политика доступа к нативным приложениям для Computer Use. Политику можно задать в записях отдельных приложений; локальная конфигурация не может ослаблять управляемые ограничения.
computer_use.macos.bundle_ids map<string, allow | deny> Доступ к нативным приложениям macOS с идентификатором пакета в качестве ключа.
computer_use.windows.always_allowed_app_ids array<string> Идентификаторы приложений Windows, которые Computer Use может открывать без запроса. Приложения, отсутствующие в списке, требуют подтверждения; сохранённые записи можно удалить в настройках Computer Use настольного приложения ChatGPT.
computer_use.windows.aumids map<string, allow | deny> Доступ к пакетным приложениям Windows с Application User Model ID (AUMID) в качестве ключа.
computer_use.windows.exes array<table> Правила доступа к исполняемым файлам Windows. Для каждого правила обязательны publisher_name, product_name и access (allow или deny); binary_name необязателен.
default_permissions string Имя профиля разрешений по умолчанию для вызовов инструментов в песочнице. Встроенные профили: :read-only, :workspace и :danger-full-access; пользовательские имена профилей требуют соответствующих таблиц [permissions.&lt;name&gt;]. Не сочетайте с sandbox_mode или [sandbox_workspace_write].
desktop.custom_file_handlers.<id> table Только на уровне пользователя. Определяет дополнительный вариант Открыть в для настольного приложения ChatGPT. Примеры и ограничения идентификаторов обработчиков см. в разделе Добавление пользовательских обработчиков файлов.
desktop.custom_file_handlers.<id>.args array<string> Аргументы, вставляемые между командой и входными данными файла (по умолчанию: []).
desktop.custom_file_handlers.<id>.command string Путь к исполняемому файлу или имя команды для обнаружения и запуска. Обязательно.
desktop.custom_file_handlers.<id>.icon string Путь к ресурсу из комплекта поставки, URL data:image/... с кодированием Base64, URI файла или абсолютный локальный путь к значку обработчика. Обязателен; для неподдерживаемых источников используется стандартный значок VS Code.
desktop.custom_file_handlers.<id>.input path | json_argument | json_stdin Способ передачи входных данных файла из приложения обработчику (по умолчанию: path).
desktop.custom_file_handlers.<id>.label string Отображаемое имя в меню Открыть в. Обязательно.
desktop.custom_file_handlers.<id>.supports_ssh boolean Предлагает обработчик для файлов в рабочих пространствах SSH (по умолчанию: false).
developer_instructions string Дополнительные инструкции разработчика, добавляемые в сеанс (необязательно).
disable_paste_burst boolean Отключает обнаружение пакетной вставки в TUI.
experimental_compact_prompt_file string (path) Загружает переопределение запроса на сжатие из файла (экспериментальная возможность).
experimental_use_unified_exec_tool boolean Устаревшее имя для включения унифицированного exec; используйте [features].unified_exec или codex --enable unified_exec.
features.apps boolean Включает интеграции с приложениями (коннекторами) (стабильная возможность; включена по умолчанию). Трафик приложений и коннекторов не контролируется сетевым прокси команд в песочнице или его списком разрешённых доменов.
features.code_mode.direct_only_tool_namespaces array<string> Пространства имён инструментов, которые режим кода может использовать только через прямые вызовы инструментов.
features.code_mode.enabled boolean Включает настройку режима кода. Эта возможность находится в разработке и отключена по умолчанию.
features.code_mode.excluded_tool_namespaces array<string> Пространства имён инструментов, которые режим кода исключает из инструкций по вложенным вызовам инструментов и из набора инструментов, доступных исполнителю.
features.context_management.experimental_mode boolean Экспериментальный параметр управления контекстом. Эта возможность сейчас недоступна.
features.enable_request_compression boolean Сжимает тела потоковых запросов с помощью zstd, когда это поддерживается (стабильная возможность; включена по умолчанию).
features.fast_mode boolean Включает в TUI выбор уровня обслуживания из каталога моделей, в том числе команды уровня Fast, если активная модель заявляет их поддержку (стабильная возможность; включена по умолчанию).
features.goals boolean Включает сохранение целей и автоматическое продолжение (стабильная возможность; включена по умолчанию).
features.hooks boolean Включает хуки жизненного цикла, загружаемые из hooks.json или заданные непосредственно в конфигурации [hooks]. features.codex_hooks — устаревший псевдоним.
features.memories boolean Включает Память (отключена по умолчанию).
features.multi_agent boolean Включает инструменты совместной работы нескольких агентов (spawn_agent, send_input, resume_agent, wait_agent и close_agent) (стабильная возможность; включена по умолчанию).
features.network_proxy boolean | table Запускает сетевой прокси для команд в песочнице (экспериментальная возможность; отключена по умолчанию). Необходим для применения доменных правил профиля разрешений, если прокси не запускается включёнными требованиями experimental_network, управляемыми администратором. Используйте таблицу при задании параметров политики на уровне возможности, таких как domains. Не фильтрует веб-поиск, приложения, MCP и другие размещённые инструменты.
features.network_proxy.allow_local_binding boolean Разрешает более широкий доступ к локальной или частной сети. По умолчанию — false; разрешающие правила с точным локальным IP-адресом или localhost всё равно могут разрешать отдельные локальные адреса.
features.network_proxy.allow_upstream_proxy boolean Разрешает цепочку подключения через вышестоящий прокси из окружения. По умолчанию — true.
features.network_proxy.dangerously_allow_all_unix_sockets boolean Разрешает произвольные сокеты Unix вместо доступа только по списку разрешённых. По умолчанию — false; используйте только в строго контролируемых средах.
features.network_proxy.dangerously_allow_non_loopback_proxy boolean Разрешает адреса прослушивания вне loopback. По умолчанию — false; включение может сделать прослушивающие порты прокси доступными за пределами localhost.
features.network_proxy.domains map<string, allow | deny> Доменная политика для сети в песочнице. По умолчанию не задана: внешние адреса недоступны, пока вы не добавите правила allow. Поддерживаются точные имена хостов, *.example.com только для поддоменов, **.example.com для корневого домена и поддоменов, а также глобальные разрешающие правила *. Предпочитайте правила с ограниченной областью действия, поскольку * широко открывает исходящий доступ к публичной сети. Добавляйте правила deny для заблокированных адресов; при конфликтах приоритет имеет deny.
features.network_proxy.enable_socks5 boolean Предоставляет поддержку SOCKS5. По умолчанию — true.
features.network_proxy.enable_socks5_udp boolean Разрешает UDP через SOCKS5. По умолчанию — true.
features.network_proxy.enabled boolean Запускает сетевой прокси команд в песочнице, когда для команд включён сетевой доступ. По умолчанию — false; пока прокси отключён, доменные правила профиля разрешений не применяются.
features.network_proxy.proxy_url string URL прослушивания HTTP для сети в песочнице. По умолчанию — "http://127.0.0.1:3128".
features.network_proxy.socks_url string URL прослушивания SOCKS5. По умолчанию — "http://127.0.0.1:8081".
features.network_proxy.unix_sockets map<string, allow | deny> Политика сокетов Unix для сети в песочнице. По умолчанию не задана; добавьте записи allow для разрешённых сокетов.
features.personality boolean Включает элементы выбора стиля общения (стабильная возможность; включена по умолчанию).
features.prevent_idle_sleep boolean Предотвращает переход компьютера в спящий режим во время выполнения хода (экспериментальная возможность; отключена по умолчанию).
features.remote_plugin boolean Включает удалённый каталог плагинов (стабильная возможность; включена по умолчанию).
features.rollout_budget.enabled boolean Включает отслеживание бюджета выполнения. Эта возможность находится в разработке и отключена по умолчанию. При включении требуется features.rollout_budget.limit_tokens.
features.rollout_budget.limit_tokens integer Положительный лимит токенов для отслеживания бюджета выполнения. Обязателен, если бюджет выполнения включён.
features.rollout_budget.prefill_token_weight number Конечный неотрицательный множитель для токенов предварительного заполнения при учёте бюджета выполнения. По умолчанию — 1.0.
features.rollout_budget.reminder_interval_tokens integer Положительный интервал в токенах между напоминаниями о бюджете выполнения. По умолчанию — 10% от limit_tokens, но не менее 1 токена.
features.rollout_budget.sampling_token_weight number Конечный неотрицательный множитель для сгенерированных токенов при учёте бюджета выполнения. По умолчанию — 1.0.
features.shell_snapshot boolean Создаёт снимок окружения оболочки для ускорения повторных команд (стабильная возможность; включена по умолчанию).
features.shell_tool boolean Включает стандартный инструмент shell для выполнения команд (стабильная возможность; включена по умолчанию).
features.skill_mcp_dependency_install boolean Разрешает запросы и установку недостающих зависимостей MCP для навыков (стабильная возможность; включена по умолчанию).
features.unified_exec boolean Использует унифицированный инструмент exec на базе PTY (стабильная возможность; включена по умолчанию, кроме Windows).
features.web_search boolean Устаревший переключатель; используйте параметр верхнего уровня web_search.
features.web_search_cached boolean Устаревший переключатель. Если web_search не задан, true соответствует web_search = "cached".
features.web_search_request boolean Устаревший переключатель. Если web_search не задан, true соответствует web_search = "live".
feedback.enabled boolean Включает отправку отзывов через /feedback во всех локальных клиентах (по умолчанию: true).
file_opener vscode | vscode-insiders | windsurf | cursor | none Схема URI для открытия ссылок на источники из вывода Codex (по умолчанию: vscode).
forced_chatgpt_workspace_id string (uuid) Ограничивает вход в ChatGPT определённым идентификатором рабочего пространства.
forced_login_method chatgpt | api Ограничивает Codex определённым способом аутентификации.
hide_agent_reasoning boolean Скрывает события рассуждений как в TUI, так и в выводе codex exec.
history.max_bytes number Если задано, ограничивает размер файла истории в байтах, удаляя самые старые записи.
history.persistence save-all | none Определяет, сохраняет ли Codex записи сеансов в history.jsonl.
hooks table Хуки жизненного цикла, заданные непосредственно в config.toml. Используют ту же схему событий, что и hooks.json; примеры и поддерживаемые события см. в руководстве по хукам.
hooks.<Event> array<table> Группы условий сопоставления для событий хуков, таких как PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit, Stop или Interrupt.
hooks.<Event>[].hooks array<table> Обработчики хуков для группы условий сопоставления. Поддерживаются хуки команд и инструментов MCP; обработчики хуков запросов и агентов разбираются, но пропускаются.
hooks.<Event>[].hooks[].additionalContextLimit integer Приблизительный порог токенов для каждого обработчика, при превышении которого слишком большой additionalContext сохраняется на диск, а модели показывается сокращённое представление. По умолчанию — 2500; 0 передаёт полный контекст непосредственно модели. См. Большой объём вывода хуков.
hooks.<Event>[].hooks[].async boolean Запускает хук команды в фоновом режиме, не задерживая вызвавшую его операцию. По умолчанию — false; SessionEnd всегда выполняется синхронно. См. Запуск хуков в фоновом режиме.
hooks.<Event>[].hooks[].commandWindows string Переопределение команды для хуков команд, применяемое только в Windows. Также допускается псевдоним TOML command_windows.
instructions string Зарезервировано для будущего использования; используйте model_instructions_file или AGENTS.md.
log_dir string (path) Каталог, в который Codex записывает файлы журналов; по умолчанию — $CODEX_HOME/log. Явное задание этого параметра также включает в этом каталоге текстовый журнал TUI codex-tui.log, который по умолчанию отключён.
marketplaces.<name>.ref string Необязательная ветка, тег или коммит Git для каталога плагинов.
marketplaces.<name>.source string Адрес репозитория Git или корневой каталог локального каталога плагинов. Для локального источника используйте абсолютный путь; каталог содержит .agents/plugins/marketplace.json.
marketplaces.<name>.source_type git | local Тип источника настроенного каталога плагинов. Каталоги можно определять в системном, облачном управляемом, пользовательском config.toml или config.toml доверенного проекта.
marketplaces.<name>.sparse_paths array<string> Необязательные пути частичного извлечения для каталога плагинов из Git. Включите файл каталога и все локальные каталоги плагинов, на которые он ссылается.
mcp_oauth_callback_port integer Необязательный глобальный фиксированный порт локального HTTP-сервера обратного вызова, используемого при входе через MCP OAuth. Параметр oauth.callback_port конкретного сервера имеет приоритет. Если ни один из них не задан, Codex использует временный порт, выбранный ОС.
mcp_oauth_callback_url string Необязательный базовый URL обратного вызова для входа через MCP OAuth, например входящий URL среды разработки. Вновь добавленные предварительно зарегистрированные клиенты используют этот URL без изменений, если сервер авторизации поддерживает идентификацию издателя; существующие клиенты без сохранённого адреса обратного вызова добавляют идентификатор обратного вызова для конкретного сервера. Без поддержки идентификации издателя любой предварительно зарегистрированный MCP server, в настроенном адресе обратного вызова которого нет необходимого идентификатора, использует этот URL с добавленным идентификатором. Порты в URL обратного вызова не определяют порт прослушивания.
mcp_oauth_credentials_store auto | file | keyring Предпочтительное хранилище учётных данных MCP OAuth.
mcp_optional_startup_grace_ms integer (milliseconds) Общее время ожидания необязательных MCP servers при формировании начального каталога инструментов. По умолчанию — 1000. Установите 0, чтобы вместо этого ждать в течение startup_timeout_sec каждого сервера.
mcp_servers.<id>.args array<string> Аргументы, передаваемые команде MCP server stdio.
mcp_servers.<id>.auth oauth | chatgpt Резервный способ аутентификации для MCP server HTTP после настроенных bearer-токенов и заголовков авторизации. oauth (по умолчанию) использует сохранённые учётные данные MCP OAuth, если они доступны. chatgpt использует текущий сеанс ChatGPT для доверенного собственного источника ChatGPT, а затем переходит к сохранённым данным OAuth. Оба режима могут подключаться без аутентификации, если ни один источник не предоставил учётные данные.
mcp_servers.<id>.bearer_token_env_var string Переменная окружения, из которой берётся bearer-токен для MCP server HTTP.
mcp_servers.<id>.command string Команда запуска MCP server stdio.
mcp_servers.<id>.cwd string Рабочий каталог процесса MCP server stdio.
mcp_servers.<id>.default_tools_approval_mode auto | prompt | writes | approve Порядок подтверждения по умолчанию для инструментов MCP на этом сервере, если нет переопределения для конкретного инструмента.
mcp_servers.<id>.disabled_tools array<string> Список запрещённых инструментов, применяемый после enabled_tools для MCP server.
mcp_servers.<id>.enabled boolean Отключает MCP server без удаления его конфигурации.
mcp_servers.<id>.enabled_tools array<string> Список разрешённых имён инструментов, предоставляемых MCP server.
mcp_servers.<id>.env map<string,string> Переменные окружения, передаваемые MCP server stdio.
mcp_servers.<id>.env_http_headers map<string,string> Заголовки HTTP, заполняемые из переменных окружения для MCP server HTTP.
mcp_servers.<id>.env_vars array<string | { name = string, source = "local" | "remote" }> Дополнительные переменные окружения, включаемые в список разрешённых для MCP server stdio. Для строковых записей по умолчанию используется source = "local"; используйте source = "remote" только для удалённого stdio через исполнитель.
mcp_servers.<id>.experimental_environment local | remote Экспериментальное размещение MCP server. remote запускает серверы stdio через среду удалённого исполнителя; удалённое размещение streamable HTTP не реализовано.
mcp_servers.<id>.http_headers map<string,string> Статические заголовки HTTP, включаемые в каждый запрос MCP HTTP.
mcp_servers.<id>.http_headers_helper string (command) Локальная команда, выводящая объект JSON с именами и значениями заголовков HTTP. Поддерживается только для локально подключённых HTTP MCP servers. Явно заданные bearer-токены и учётные данные OAuth имеют приоритет над заголовками Authorization, предоставленными вспомогательной командой.
mcp_servers.<id>.oauth_resource string Необязательный параметр ресурса OAuth по RFC 8707, включаемый при входе в MCP.
mcp_servers.<id>.oauth.callback_port integer Фиксированный порт прослушивания обратного вызова OAuth для этого MCP server. Переопределяет mcp_oauth_callback_port. Для прямого обратного вызова через loopback с явно заданным портом в URL настройте такой же порт прослушивания.
mcp_servers.<id>.oauth.callback_url string Адрес обратного вызова OAuth для конкретного сервера. Предварительно зарегистрированные клиенты повторно используют его, если поддерживается идентификация издателя или URL уже заканчивается идентификатором обратного вызова для этого сервера. В противном случае Codex использует глобальный адрес обратного вызова или адрес по умолчанию, добавляя к нему этот идентификатор. Клиенты без предварительно зарегистрированного идентификатора используют этот адрес обратного вызова при регистрации клиента.
mcp_servers.<id>.oauth.client_id string Предварительно зарегистрированный идентификатор клиента OAuth, используемый для авторизации и обмена токенами с этим MCP server.
mcp_servers.<id>.required boolean При значении true запуск или возобновление завершается ошибкой, если этот включённый MCP server не удаётся инициализировать.
mcp_servers.<id>.scopes array<string> Области доступа OAuth, запрашиваемые при аутентификации на этом MCP server.
mcp_servers.<id>.startup_timeout_ms number Псевдоним для startup_timeout_sec в миллисекундах.
mcp_servers.<id>.startup_timeout_sec number Переопределяет время ожидания запуска MCP server, по умолчанию равное 10 с.
mcp_servers.<id>.tool_timeout_sec number Переопределяет время ожидания каждого инструмента MCP server, по умолчанию равное 60 с.
mcp_servers.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Переопределение порядка подтверждения для отдельного инструмента MCP на этом сервере.
mcp_servers.<id>.tools.<tool>.output_token_limit integer (positive) Бюджет токенов для вывода одного инструмента MCP до добавления стандартного запаса 20% на сериализацию. Переопределяет заданный моделью бюджет усечения вывода по умолчанию для этого инструмента.
mcp_servers.<id>.url string Конечная точка MCP server streamable HTTP.
memories.consolidation_model string Необязательное переопределение модели для глобальной консолидации памяти.
memories.disable_on_external_context boolean При true потоки, использующие внешний контекст, например вызовы инструментов MCP, веб-поиск или поиск инструментов, исключаются из формирования памяти. По умолчанию — false. Устаревший псевдоним: memories.no_memories_if_mcp_or_web_search.
memories.extract_model string Необязательное переопределение модели для извлечения памяти из отдельных потоков.
memories.generate_memories boolean При false вновь созданные потоки не сохраняются как входные данные для формирования памяти. По умолчанию — true.
memories.max_raw_memories_for_consolidation number Максимальное количество недавних необработанных записей памяти, сохраняемых для глобальной консолидации. По умолчанию — 256, верхний предел — 4096.
memories.max_rollout_age_days number Максимальный возраст потоков, рассматриваемых для формирования памяти. По умолчанию — 30, значение ограничивается диапазоном 0-90.
memories.max_rollouts_per_startup number Максимальное количество кандидатов среди записей выполнения, обрабатываемых за один проход при запуске. По умолчанию — 16, верхний предел — 128.
memories.max_unused_days number Максимальное количество дней с последнего использования записи памяти, после которого она перестаёт участвовать в консолидации. По умолчанию — 30, значение ограничивается диапазоном 0-365.
memories.min_rate_limit_remaining_percent number Минимальный оставшийся процент квоты в окнах лимитов Codex, необходимый для начала формирования памяти. По умолчанию — 25, значение ограничивается диапазоном 0-100.
memories.min_rollout_idle_hours number Минимальное время бездействия, после которого поток рассматривается для формирования памяти. По умолчанию — 6, значение ограничивается диапазоном 1-48.
memories.use_memories boolean При false Codex не добавляет существующую память в будущие сеансы. По умолчанию — true.
model string Используемая модель (например, gpt-6.1-sol).
model_auto_compact_token_limit number Порог количества токенов, при котором запускается автоматическое сжатие истории (если не задан, используются значения модели по умолчанию).
model_auto_compact_token_limit_scope total | body_after_prefix Определяет, учитывает ли порог автоматического сжатия весь активный контекст (total, по умолчанию) или только прирост после перенесённого префикса окна сжатия (body_after_prefix).
model_catalog_json string (path) Необязательный путь к каталогу моделей в формате JSON, загружаемому при запуске. Выбранный файл профиля $CODEX_HOME/profile-name.config.toml может переопределить это значение для конкретного профиля.
model_context_window number Размер контекстного окна активной модели в токенах.
model_instructions_file string (path) Замена встроенных инструкций вместо AGENTS.md.
model_provider string Идентификатор провайдера из model_providers (по умолчанию: openai).
model_providers.<id> table Определение пользовательского провайдера. Идентификаторы встроенных провайдеров (openai, ollama и lmstudio) зарезервированы и не могут быть переопределены.
model_providers.<id>.auth table Конфигурация получения bearer-токена через команду для пользовательского провайдера. Не сочетайте с env_key, experimental_bearer_token или requires_openai_auth.
model_providers.<id>.auth.args array<string> Аргументы, передаваемые команде получения токена.
model_providers.<id>.auth.command string Команда, выполняемая, когда Codex нужен bearer-токен. Команда должна выводить токен в stdout.
model_providers.<id>.auth.cwd string (path) Рабочий каталог команды получения токена.
model_providers.<id>.auth.refresh_interval_ms number Интервал упреждающего обновления токена Codex в миллисекундах (по умолчанию: 300000). Установите 0, чтобы обновлять токен только после повторной попытки аутентификации.
model_providers.<id>.auth.timeout_ms number Максимальное время выполнения команды получения токена в миллисекундах (по умолчанию: 5000).
model_providers.<id>.base_url string Базовый URL API провайдера моделей.
model_providers.<id>.env_http_headers map<string,string> Заголовки HTTP, заполняемые из переменных окружения при их наличии.
model_providers.<id>.env_key string Переменная окружения, предоставляющая API key провайдера.
model_providers.<id>.env_key_instructions string Необязательные инструкции по настройке API key провайдера.
model_providers.<id>.experimental_bearer_token string Непосредственно заданный bearer-токен провайдера (не рекомендуется; используйте env_key).
model_providers.<id>.http_headers map<string,string> Статические заголовки HTTP, добавляемые к запросам провайдера.
model_providers.<id>.name string Отображаемое имя пользовательского провайдера моделей.
model_providers.<id>.query_params map<string,string> Дополнительные параметры строки запроса, добавляемые к запросам провайдера.
model_providers.<id>.request_max_retries number Количество повторных попыток HTTP-запросов к провайдеру (по умолчанию: 4).
model_providers.<id>.requires_openai_auth boolean Провайдер использует аутентификацию OpenAI (по умолчанию: false).
model_providers.<id>.stream_idle_timeout_ms number Время ожидания при бездействии потоков SSE в миллисекундах (по умолчанию: 300000).
model_providers.<id>.stream_max_retries number Количество повторных попыток при прерывании потоков SSE (по умолчанию: 5).
model_providers.<id>.supports_standalone_web_search boolean Заявляет поддержку совместимой отдельной конечной точки веб-поиска (по умолчанию: false). Отдельный поиск по-прежнему находится в разработке и отключён по умолчанию; одна лишь совместимость провайдера его не включает.
model_providers.<id>.supports_websockets boolean Определяет, поддерживает ли этот провайдер транспорт WebSocket для Responses API.
model_providers.<id>.wire_api responses Протокол, используемый провайдером. responses — единственное поддерживаемое значение; оно используется по умолчанию, если параметр не указан.
model_providers.amazon-bedrock.aws.profile string Имя профиля AWS, используемого встроенным провайдером amazon-bedrock.
model_providers.amazon-bedrock.aws.region string Регион AWS, используемый встроенным провайдером amazon-bedrock.
model_reasoning_effort string Уровень усилий на рассуждение, заявленный выбранной моделью, например low, medium, high, xhigh, max или ultra. Доступные уровни зависят от модели и клиента.
model_reasoning_summary auto | concise | detailed | none Выбирает подробность сводок рассуждений или полностью отключает их.
model_supports_reasoning_summaries boolean Принудительно включает или отключает отправку метаданных рассуждений Codex.
model_verbosity low | medium | high Необязательное переопределение подробности ответа GPT-5 Responses API; если не задано, используется значение по умолчанию выбранной модели или предустановки.
notice.hide_full_access_warning boolean Отслеживает подтверждение предупреждения о полном доступе.
notice.hide_gpt-5.1-codex-max_migration_prompt boolean Отслеживает подтверждение уведомления о переходе на gpt-5.1-codex-max.
notice.hide_gpt5_1_migration_prompt boolean Отслеживает подтверждение уведомления о переходе на GPT-5.1.
notice.hide_rate_limit_model_nudge boolean Отслеживает отказ от напоминания о смене модели при достижении лимита запросов.
notice.hide_world_writable_warning boolean Отслеживает подтверждение предупреждения о каталогах Windows, доступных для записи всем пользователям.
notice.model_migrations map<string,string> Отслеживает подтверждённые переходы между моделями в виде соответствий старая->новая.
notify array<string> Команда для уведомлений; получает данные в формате JSON от Codex.
openai_base_url string Переопределение базового URL для встроенного провайдера моделей openai.
oss_provider lmstudio | ollama Локальный провайдер по умолчанию при запуске с --oss (если не задан, по умолчанию запрашивается выбор).
otel.environment string Метка окружения, добавляемая к отправляемым событиям OpenTelemetry (по умолчанию: dev).
otel.exporter none | otlp-http | otlp-grpc Выбирает экспортёр OpenTelemetry и задаёт метаданные конечной точки.
otel.exporter.<id>.endpoint string Конечная точка экспортёра журналов OTEL.
otel.exporter.<id>.headers map<string,string> Статические заголовки, включаемые в запросы экспортёра OTEL.
otel.exporter.<id>.protocol binary | json Протокол экспортёра OTLP/HTTP.
otel.exporter.<id>.tls.ca-certificate string Путь к сертификату CA для TLS экспортёра OTEL.
otel.exporter.<id>.tls.client-certificate string Путь к клиентскому сертификату для TLS экспортёра OTEL.
otel.exporter.<id>.tls.client-private-key string Путь к закрытому ключу клиента для TLS экспортёра OTEL.
otel.log_user_prompt boolean Включает экспорт исходных пользовательских запросов вместе с журналами OpenTelemetry.
otel.metrics_exporter none | statsig | otlp-http | otlp-grpc Выбирает экспортёр метрик OpenTelemetry (по умолчанию: statsig).
otel.trace_exporter none | otlp-http | otlp-grpc Выбирает экспортёр трассировок OpenTelemetry и задаёт метаданные конечной точки.
otel.trace_exporter.<id>.endpoint string Конечная точка экспортёра трассировок для журналов OTEL.
otel.trace_exporter.<id>.headers map<string,string> Статические заголовки, включаемые в запросы экспортёра трассировок OTEL.
otel.trace_exporter.<id>.protocol binary | json Протокол экспортёра трассировок OTLP/HTTP.
otel.trace_exporter.<id>.tls.ca-certificate string Путь к сертификату CA для TLS экспортёра трассировок OTEL.
otel.trace_exporter.<id>.tls.client-certificate string Путь к клиентскому сертификату для TLS экспортёра трассировок OTEL.
otel.trace_exporter.<id>.tls.client-private-key string Путь к закрытому ключу клиента для TLS экспортёра трассировок OTEL.
permissions.<name>.description string Понятное человеку описание этого именованного профиля. Профиль не наследует описание родителя через extends.
permissions.<name>.extends string Необязательный родительский профиль, применяемый перед этим именованным профилем. Укажите другой именованный профиль, :read-only или :workspace; :danger-full-access, неопределённые родители и циклические зависимости отклоняются.
permissions.<name>.filesystem table Именованный профиль разрешений файловой системы. Каждый ключ — абсолютный путь или специальный токен, например :minimal или :workspace_roots.
permissions.<name>.filesystem.":workspace_roots".<subpath-or-glob> "read" | "write" | "deny" Доступ к файловой системе относительно каждого действующего корневого каталога рабочего пространства. Используйте "." для самого корня; вложенные glob-пути, например "**/*.env", могут запрещать чтение с помощью "deny".
permissions.<name>.filesystem.<path-or-glob> "read" | "write" | "deny" | table Предоставляет прямой доступ для пути, glob-шаблона или специального токена либо ограничивает область вложенных записей этим корнем. Используйте "deny", чтобы запретить чтение по совпадающим путям.
permissions.<name>.filesystem.glob_scan_max_depth number Максимальная глубина раскрытия glob-шаблонов запрета чтения на платформах, которые фиксируют совпадения перед запуском песочницы. Если задана, должна быть не меньше 1.
permissions.<name>.network.allow_local_binding boolean Разрешает более широкий доступ к локальной или частной сети через сеть в песочнице. Разрешающие правила с точным локальным IP-адресом или localhost всё равно могут разрешать отдельные локальные адреса, когда здесь остаётся false.
permissions.<name>.network.allow_upstream_proxy boolean Разрешает сети в песочнице подключаться через другой вышестоящий прокси.
permissions.<name>.network.dangerously_allow_all_unix_sockets boolean Разрешает произвольные сокеты Unix вместо ограниченного набора по умолчанию. Используйте только в строго контролируемых средах.
permissions.<name>.network.dangerously_allow_non_loopback_proxy boolean Разрешает привязку прослушивающих портов сети в песочнице к адресам вне loopback. Включение может сделать их доступными за пределами localhost.
permissions.<name>.network.domains table Доменные правила для команд в песочнице. Применяются только тогда, когда features.network_proxy или включённые сетевые требования, управляемые администратором, активируют прокси. Поддерживаются точные имена хостов, *.example.com, **.example.com и глобальные разрешающие правила *; приоритет имеет deny. Не ограничивает веб-поиск, приложения или MCP servers.
permissions.<name>.network.domains.<pattern> allow | deny Разрешает или запрещает конкретный хост либо шаблон с подстановочными знаками и ограниченной областью действия, например *.example.com или **.example.com.
permissions.<name>.network.enable_socks5 boolean Предоставляет поддержку SOCKS5, когда этот профиль разрешений включает сеть в песочнице.
permissions.<name>.network.enable_socks5_udp boolean Разрешает UDP через прослушивающий порт SOCKS5, когда он включён.
permissions.<name>.network.enabled boolean Включает сетевой доступ для команд в этом профиле разрешений. Не запускает сетевой прокси. Без features.network_proxy или включённых сетевых требований, управляемых администратором, команды получают прямой сетевой доступ, а доменные правила профиля не применяются.
permissions.<name>.network.mode limited | full Режим сетевого прокси для трафика дочерних процессов.
permissions.<name>.network.proxy_url string URL прослушивания HTTP, используемый, когда этот профиль разрешений включает сеть в песочнице.
permissions.<name>.network.socks_url string Конечная точка прокси SOCKS5, используемая этим профилем разрешений.
permissions.<name>.network.unix_sockets table Переопределения списка разрешённых сокетов Unix для сети в песочнице. Используйте пути сокетов в качестве ключей; allow добавляет путь, а deny запрещает его.
permissions.<name>.network.unix_sockets.<path> allow | deny Добавляет абсолютный путь сокета Unix в действующий список разрешённых с помощью allow или запрещает его с помощью deny. Запрещённые записи не включаются в действующий список разрешённых.
permissions.<name>.workspace_roots table Корневые каталоги рабочего пространства, определённые профилем, к которым применяются правила файловой системы :workspace_roots наряду с корневыми каталогами рабочего пространства текущего сеанса.
permissions.<name>.workspace_roots.<path> boolean Включает путь в набор корневых каталогов рабочего пространства профиля при true. Отключённые записи остаются неактивными.
personality none | friendly | pragmatic Стиль общения по умолчанию для моделей, заявляющих поддержку supportsPersonality; можно переопределить для отдельного потока или хода либо через /personality.
plan_mode_reasoning_effort string Переопределение уровня усилий на рассуждение для режима планирования с использованием уровня, поддерживаемого выбранной моделью. Если не задано, режим планирования использует встроенную предустановку по умолчанию.
plugins.<plugin>.enabled boolean Включает или отключает плагин из локального каталога с помощью ключа plugin-name@marketplace-name. Читается из итоговой объединённой конфигурации; настройки доверенного проекта могут переопределять пользовательские, облачные управляемые и системные значения по умолчанию. Обновление каталога может устанавливать или обновлять настроенные плагины, даже если они отключены. Этот параметр не переопределяет состояния включения, управляемые рабочим пространством.
plugins.<plugin>.mcp_servers.<server>.default_tools_approval_mode auto | prompt | writes | approve Порядок подтверждения по умолчанию для инструментов MCP server, предоставляемого плагином.
plugins.<plugin>.mcp_servers.<server>.disabled_tools array<string> Список запрещённых инструментов, применяемый после enabled_tools для MCP server, предоставляемого плагином.
plugins.<plugin>.mcp_servers.<server>.enabled boolean Включает или отключает MCP server, входящий в состав установленного плагина, без изменения манифеста плагина.
plugins.<plugin>.mcp_servers.<server>.enabled_tools array<string> Список разрешённых инструментов MCP server, предоставляемого плагином.
plugins.<plugin>.mcp_servers.<server>.tools.<tool>.approval_mode auto | prompt | writes | approve Переопределение порядка подтверждения для отдельного инструмента MCP, предоставляемого плагином.
project_doc_fallback_filenames array<string> Дополнительные имена файлов для поиска, если AGENTS.md отсутствует.
project_doc_max_bytes number Максимальное количество байтов, считываемых из AGENTS.md при формировании инструкций проекта.
project_root_markers array<string> Список имён файлов — маркеров корня проекта; используется при поиске корня проекта в родительских каталогах.
projects.<path>.trust_level string Помечает проект или рабочее дерево как доверенные или недоверенные ("trusted" | "untrusted"). В недоверенных проектах пропускаются слои .codex/ уровня проекта, включая локальную конфигурацию проекта, хуки и правила.
review_model string Необязательное переопределение модели для /review (по умолчанию используется модель текущего сеанса).
sandbox_mode read-only | workspace-write | danger-full-access Политика песочницы для доступа к файловой системе и сети во время выполнения команд.
sandbox_workspace_write.exclude_slash_tmp boolean Исключает /tmp из корневых каталогов с правом записи в режиме workspace-write.
sandbox_workspace_write.exclude_tmpdir_env_var boolean Исключает $TMPDIR из корневых каталогов с правом записи в режиме workspace-write.
sandbox_workspace_write.network_access boolean Разрешает исходящий сетевой доступ внутри песочницы workspace-write.
sandbox_workspace_write.writable_roots array<string> Дополнительные корневые каталоги с правом записи при sandbox_mode = "workspace-write".
service_tier string Предпочтительный уровень обслуживания для новых ходов. Используйте fast или другой уровень, заявленный активной моделью; fast соответствует значению запроса priority.
shell_environment_policy.exclude array<string> Устаревшие шаблоны исключения переменных окружения. Для новой конфигурации используйте shell_environment_policy.filters; не сочетайте обе формы в одном слое.
shell_environment_policy.experimental_use_profile boolean Использует профиль пользовательской оболочки при запуске дочерних процессов.
shell_environment_policy.filters map<string, include | exclude> Основные фильтры шаблонов имён переменных окружения без учёта регистра. Включающие записи создают список разрешённых и не могут восстановить исключённые значения. Явные значения set применяются после исключений. Не сочетайте фильтры с устаревшими массивами exclude или include_only в одном слое.
shell_environment_policy.ignore_default_excludes boolean Сохраняет переменные, содержащие KEY, SECRET или TOKEN, до применения остальных фильтров (по умолчанию: true). Установите false, чтобы применять автоматическое исключение по именам секретов.
shell_environment_policy.include_only array<string> Устаревший список разрешающих шаблонов переменных окружения. Для новой конфигурации используйте shell_environment_policy.filters; не сочетайте обе формы в одном слое.
shell_environment_policy.inherit all | core | none Базовый режим наследования окружения при запуске дочерних процессов.
shell_environment_policy.set map<string,string> Явные значения переменных окружения, добавляемые после исключений; включающие фильтры всё ещё могут их удалить.
show_raw_agent_reasoning boolean Показывает исходное содержимое рассуждений, когда активная модель его выдаёт.
skills.config array<object> Переопределения включения отдельных навыков, хранящиеся в config.toml.
skills.config.<index>.enabled boolean Включает или отключает указанный навык.
skills.config.<index>.path string (path) Путь к папке навыка, содержащей SKILL.md.
skills.max_context_tokens integer (positive) Бюджет токенов для каталога доступных навыков. По умолчанию — 2% контекстного окна модели. Явно заданные значения ограничены 10000 токенами.
sqlite_home string (path) Каталог, в котором Codex хранит базу данных состояния SQLite для заданий агентов и другого состояния выполнения, допускающего возобновление.
suppress_unstable_features_warning boolean Скрывает предупреждение, появляющееся при включении флагов возможностей, находящихся в разработке.
tool_output_token_limit number Бюджет токенов для хранения в истории отдельных результатов инструментов и функций.
tool_suggest.disabled_tools array<table> Отключает предложения определённых доступных для обнаружения коннекторов или плагинов. Каждая запись использует type = "connector" или "plugin" и id.
tool_suggest.discoverables array<table> Разрешает инструментам предлагать дополнительные доступные для обнаружения коннекторы или плагины. Каждая запись использует type = "connector" или "plugin" и id.
tools.view_image boolean Включает инструмент прикрепления локальных изображений view_image.
tools.web_search boolean | { context_size = "low|medium|high", allowed_domains = [string], location = { country, region, city, timezone } } Необязательная конфигурация инструмента веб-поиска. Объектная форма позволяет задать размер контекста поиска, разрешённые домены поиска и приблизительное местоположение пользователя. Эти фильтры доменов поиска отделены от доменных правил сети для команд в песочнице и не ограничивают коннекторы или MCP servers.
tui table Параметры TUI, например включение встроенных уведомлений рабочего стола.
tui.alternate_screen auto | always | never Управляет использованием альтернативного экрана для TUI (по умолчанию: auto; в режиме auto он не используется в Zellij, чтобы сохранить историю прокрутки).
tui.animations boolean Включает анимации терминала (экран приветствия, мерцание, индикатор загрузки) (по умолчанию: true).
tui.keymap.<context>.<action> string | array<string> Назначение сочетания клавиш действию TUI. Поддерживаемые контексты: global, chat, composer, editor, vim_normal, vim_operator, vim_text_object, pager, list и approval. Для некоторых действий редактора ввода при отсутствии назначения используются соответствующие сочетания tui.keymap.global; назначения для конкретного контекста имеют приоритет, если поддерживаются.
tui.keymap.<context>.<action> = [] empty array Отменяет назначение клавиш действию в этом контексте раскладки. Имена клавиш задаются нормализованными строками, такими как ctrl-a, shift-enter, page-down или minus.
tui.model_availability_nux.<model> integer Внутреннее состояние подсказок при запуске с кратким идентификатором модели в качестве ключа.
tui.notification_condition unfocused | always Определяет, отправляются ли уведомления TUI только при отсутствии фокуса на терминале или независимо от фокуса. По умолчанию — unfocused.
tui.notification_method auto | osc9 | bel Способ отправки уведомлений терминала (по умолчанию: auto).
tui.notifications boolean | array<string> Включает уведомления TUI; при необходимости ограничивает их определёнными типами событий.
tui.raw_output_mode boolean Запускает TUI в режиме необработанной истории прокрутки для удобного выделения и копирования текста терминала (по умолчанию: false). Его можно переключать с помощью /raw или стандартного сочетания клавиш alt-r.
tui.resume_cwd current | session Рабочий каталог при возобновлении сеанса или создании его ответвления. Если не задан и текущий каталог отличается от сохранённого каталога сеанса, Codex предлагает выбрать каталог.
tui.show_tooltips boolean Показывает обучающие подсказки на экране приветствия TUI (по умолчанию: true).
tui.status_line array<string> | null Упорядоченный список идентификаторов элементов строки состояния в нижней части TUI. null отключает строку состояния.
tui.terminal_title array<string> | null Упорядоченный список идентификаторов элементов заголовка окна или вкладки терминала. По умолчанию — ["spinner", "project"]; null отключает обновление заголовка.
tui.theme string Переопределение темы подсветки синтаксиса (имя темы в формате kebab-case).
tui.vim_mode_default boolean Запускает редактор ввода в обычном режиме Vim вместо режима вставки (по умолчанию: false). Режим по-прежнему можно переключать для отдельного сеанса с помощью /vim.
web_search disabled | cached | indexed | live Режим веб-поиска (по умолчанию: "cached"; cached использует индекс OpenAI без доступа к внешним веб-ресурсам; indexed допускает внешний доступ только через ограничения поискового индекса; при использовании --yolo или другой настройки песочницы с полным доступом по умолчанию применяется "live"). Используйте "live" для неограниченного получения актуальных данных или "disabled" для удаления инструмента.
windows_wsl_setup_acknowledged boolean Отслеживает подтверждение ознакомления с вводными сведениями для Windows (только Windows).
windows.sandbox unelevated | elevated | mxc Режим встроенной песочницы Windows при запуске Codex непосредственно в Windows.

Актуальную схему JSON для config.toml можно найти здесь.

Чтобы получить автодополнение и диагностику при редактировании config.toml в VS Code или Cursor, установите расширение Even Better TOML и добавьте следующую строку в начало файла config.toml:

#:schema https://developers.openai.com/codex/config-schema.json

Примечание. Переименуйте experimental_instructions_file в model_instructions_file. Codex объявляет старый ключ устаревшим; обновите существующие конфигурации, указав новое имя.

requirements.toml

requirements.toml — это принудительно задаваемый администратором файл конфигурации, который ограничивает чувствительные к безопасности параметры, недоступные для переопределения пользователями. Подробные сведения, расположения файлов и примеры приведены в разделе Требования, задаваемые администратором.

Для пользователей ChatGPT Business и Enterprise Codex также может применять требования, полученные из облака. Сведения о приоритетах приведены на странице, посвящённой безопасности.

Используйте [features] в requirements.toml, чтобы зафиксировать флаги функций среды выполнения по тем же каноническим ключам, которые использует config.toml. Требования также могут включать документированные ключи, предназначенные только для приложения и не входящие в config.toml. Пропущенные ключи остаются без ограничений.

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

Для управляемых списков разрешённых профилей разрешений требуется Codex 0.138.0 или новее. Codex 0.137.0 и более ранних версий игнорирует allowed_permission_profiles и управляемый default_permissions.

Используйте allowed_sandbox_modes вместе с sandbox_mode. Для развёртываний с профилями разрешений используйте allowed_permission_profiles вместе с управляемым default_permissions.

Значение untrusted в allowed_approval_policies по-прежнему допустимо для более строгого порядка одобрения действий, который Codex применяет, когда проект использует trust_level = "untrusted". Оно не разрешает явно задавать approval_policy = "untrusted".

Таблица [models.new_thread] задаёт управляемые значения по умолчанию, но не обеспечивает их принудительное применение. Если вы явно переопределяете модель или уровень усилий рассуждения с помощью --model, --config или --profile, Codex игнорирует как model, так и model_reasoning_effort в [models.new_thread]. Параметр service_tier действует независимо.

Требования к браузеру охватывают три отдельные области. in_app_browser управляет панелью браузера, которую пользователь открывает и использует напрямую. browser_use управляет работой агента в браузере. computer_use управляет работой агента в нативных настольных приложениях.

Вложенные значения политик Browser Use и Computer Use сами по себе не предоставляют доступ. Зависящий от источника или приложения параметр allow может переопределить резервное значение для того же источника политики, однако обычные проверки функций, подтверждений и других политик по-прежнему применяются. Если одновременно действуют управляемые требования и config.toml, значение deny из любого из них имеет приоритет.

Ключ Тип / значения Описание
additional_developer_instructions string Управляемые инструкции разработчика, добавляемые отдельным сообщением разработчика. Codex отклоняет инструкции, превышающие лимит в 10 000 токенов по приблизительной оценке, включая маркеры контекста.
allow_appshots boolean Установите false, чтобы отключить Appshots для управляемых пользователей. Если параметр не указан, требования не ограничивают Appshots и действует обычная доступность продукта.
allow_browser_and_computer_use boolean Установите false, чтобы заблокировать как Browser Use под управлением агента, так и Computer Use для нативных приложений. Значение true или отсутствие параметра не включает ни одну из этих функций; остальные проверки функций, политик и подтверждений продолжают действовать.
allow_login_shell boolean Принудительно задать, могут ли инструменты оболочки запускать оболочку входа.
allow_managed_hooks_only boolean При true Codex пропускает пользовательские хуки, хуки проекта, сеанса и плагинов, но по-прежнему разрешает управляемые хуки из requirements.toml и других управляемых слоёв конфигурации.
allow_remote_control boolean Установите false, чтобы отключить удалённое управление устройством для управляемых пользователей. Если параметр не указан, требования не ограничивают удалённое управление устройством и действует обычная доступность продукта.
allowed_approval_policies array<string> Разрешённые политики подтверждения, например on-request, never и granular. Включите untrusted, чтобы разрешить более строгую политику, применяемую для недоверенного проекта; её нельзя выбрать напрямую с помощью approval_policy.
allowed_approvals_reviewers array<string> Разрешённые значения для approvals_reviewer, например user и auto_review.
allowed_chatgpt_workspaces array<string> Ограничить вход через ChatGPT, включая токены доступа Codex, перечисленными идентификаторами рабочих пространств. Пустой список отключает вход через ChatGPT; аутентификация через API остаётся доступной, если она разрешена. Задаётся через локальный файл системных требований или macOS MDM; значения, управляемые из облака, игнорируются.
allowed_login_methods array<string> Разрешить chatgpt, api или оба способа. Если параметр не указан, он не ограничивает способы входа. Если указан, список должен содержать хотя бы один способ. api разрешает аутентификацию через API, включая Amazon Bedrock. Задаётся через локальный файл системных требований или macOS MDM. Значения, управляемые из облака, игнорируются.
allowed_permission_profiles table<boolean> Полный список разрешённых профилей разрешений. Профили со значением true разрешены. Профили, которые не указаны или имеют значение false, запрещены, включая профили, добавленные в будущих версиях. При объединении источников требований записи сопоставляются по имени профиля.
allowed_permission_profiles.<name> boolean Разрешить или запретить встроенный либо пользовательский профиль разрешений, определённый в загруженной конфигурации или источнике требований. Более поздний источник требований с более высоким приоритетом может использовать false, чтобы отключить профиль, разрешённый более ранним источником с более низким приоритетом.
allowed_sandbox_modes array<string> Разрешённые значения для sandbox_mode.
allowed_web_search_modes array<string> Разрешённые значения для web_search (disabled, cached, indexed, live). disabled разрешено всегда; пустой список фактически разрешает только disabled.
apps table Управляемые требования к приложениям с идентификаторами приложений в качестве ключей. Требования могут отключить приложение или ограничить порядок подтверждения для отдельных инструментов.
apps.<id>.enabled boolean Установите false, чтобы отключить приложение. Требование об отключении сохраняет ограничительную силу при объединении нескольких источников требований.
apps.<id>.tools.<tool>.approval_mode auto | prompt | writes | approve Задать управляемый режим подтверждения для одного инструмента приложения.
auto_review table Управляемые требования к автоматической проверке.
auto_review.ignore_rules array<string> Полные идентификаторы моделей, для которых Codex игнорирует правила префиксов allow в политике выполнения команд. Идентификатор должен совпадать точно, включая пространство имён провайдера, если оно есть; в отличие от required_on_models, псевдоним без пространства имён здесь не принимается. Правила запрета и сетевые правила продолжают действовать.
auto_review.required_on_models array<string> Идентификаторы моделей, для которых обязательна автоматическая проверка. Идентификаторы должны быть непустыми, не содержать пространств имён провайдеров и пробелов по краям. Списки из нескольких источников требований объединяются.
browser_use table Управляемые требования к Browser Use под управлением агента.
browser_use.allow_global_persistent_approval boolean Установите false, чтобы запретить Browser Use создавать или учитывать подтверждения Always allow, распространяющиеся на все сайты, например разрешение скачивать файлы с любого сайта. Существующие сохранённые подтверждения игнорируются, но не удаляются. Значение true или отсутствие параметра не создаёт подтверждение.
browser_use.allow_history_access boolean Установите false, чтобы запретить Browser Use читать историю браузера. Значение true или отсутствие параметра сохраняет обычные настройки истории и проверки доступности.
browser_use.default_origin_policy table Резервное значение для каждой настройки Browser Use, если ни одна подходящая запись в browser_use.origins её не определяет. Подходящее правило для источника URL заменяет резервное значение для данного источника политики. Затем Codex применяет более строгое из значений управляемых требований и пользовательской конфигурации.
browser_use.default_origin_policy.access allow | deny Используйте deny, чтобы заблокировать Browser Use для источников URL, использующих резервное значение. Запрет источника URL также блокирует для него отправку и скачивание файлов, полный доступ к отладке браузера и автоматическую проверку. allow лишь позволяет продолжить обычные проверки подтверждений и политик.
browser_use.default_origin_policy.access_approval_lifetime turn | thread Задайте срок действия непостоянного подтверждения доступа к сайту: turn ограничивает его текущим ходом, а thread сохраняет до конца текущей ветки диалога. persistent_approval отдельно управляет доступностью Always allow. Значение по умолчанию в продукте — thread.
browser_use.default_origin_policy.auto_review allow | deny Используйте deny, чтобы пропускать автоматическую проверку для источников URL, использующих резервное значение, и вместо неё запрашивать подтверждение пользователя. allow сохраняет доступность автоматической проверки, если её разрешают другие настройки.
browser_use.default_origin_policy.downloads allow | deny Используйте deny, чтобы заблокировать скачивание файлов через Browser Use для источников URL, использующих резервное значение. allow лишь позволяет продолжить обычные проверки подтверждений и политик.
browser_use.default_origin_policy.full_cdp_access allow | deny Используйте deny, чтобы заблокировать полный доступ к Chrome DevTools Protocol (CDP) для источников URL, использующих резервное значение. allow лишь позволяет продолжить обычные проверки явного включения и подтверждений.
browser_use.default_origin_policy.persistent_approval boolean Установите false, чтобы запретить Browser Use сохранять или учитывать подтверждение Always allow для источников URL, использующих резервное значение. Подтверждения для текущего хода или ветки диалога по-прежнему могут применяться. true делает Always allow доступным, если это разрешено остальными условиями, но не создаёт подтверждение.
browser_use.default_origin_policy.uploads allow | deny Используйте deny, чтобы заблокировать отправку файлов через Browser Use для источников URL, использующих резервное значение. allow лишь позволяет продолжить обычные проверки подтверждений и политик.
browser_use.disable_auto_review boolean Установите true, чтобы пропускать автоматическую проверку для Browser Use и вместо неё запрашивать подтверждение пользователя. Значение false или отсутствие параметра сохраняет доступность автоматической проверки, если её разрешают другие настройки.
browser_use.origins map<string, table> Политики Browser Use для отдельных источников URL. Ключи используют &lt;scheme&gt;://&lt;host-pattern&gt;[:&lt;port&gt;] с http или https. Укажите точное имя хоста, *.example.com только для поддоменов или **.example.com для основного домена и его поддоменов. Другие подстановочные знаки * могут охватывать точки, поэтому region*.example.com также соответствует region.api.example.com; имя хоста * соответствует любому хосту с этой схемой. Схемы и нестандартные порты значимы; явно указанные порты по умолчанию удаляются при нормализации. Пути, строки запросов, встроенные имена пользователей или пароли, а также подстановочные знаки в схемах или портах недопустимы. Заключайте шаблон в кавычки в TOML, например [browser_use.origins."https://**.example.com"].
browser_use.origins.<pattern> table Политика для источников URL, соответствующих этому шаблону. Если подходят несколько шаблонов, Codex использует наиболее ограничительное значение для каждой возможности: deny вместо allow, false вместо true и turn вместо thread.
browser_use.origins.<pattern>.access allow | deny Используйте deny, чтобы заблокировать Browser Use для соответствующих источников URL. Запрет также блокирует для них отправку и скачивание файлов, полный доступ к отладке браузера и автоматическую проверку. allow лишь позволяет продолжить обычные проверки подтверждений и политик.
browser_use.origins.<pattern>.access_approval_lifetime turn | thread Задайте срок действия непостоянного подтверждения доступа к сайту для соответствующих источников URL: turn ограничивает его текущим ходом, а thread сохраняет до конца текущей ветки диалога. persistent_approval отдельно управляет доступностью Always allow.
browser_use.origins.<pattern>.auto_review allow | deny Используйте deny, чтобы пропускать автоматическую проверку для соответствующих источников URL и вместо неё запрашивать подтверждение пользователя. allow сохраняет доступность автоматической проверки, если её разрешают другие настройки.
browser_use.origins.<pattern>.downloads allow | deny Используйте deny, чтобы заблокировать скачивание файлов через Browser Use для соответствующих источников URL. allow лишь позволяет продолжить обычные проверки подтверждений и политик.
browser_use.origins.<pattern>.full_cdp_access allow | deny Используйте deny, чтобы заблокировать полный доступ к Chrome DevTools Protocol (CDP) для соответствующих источников URL. allow лишь позволяет продолжить обычные проверки явного включения и подтверждений.
browser_use.origins.<pattern>.persistent_approval boolean Установите false, чтобы запретить Browser Use сохранять или учитывать подтверждение Always allow для соответствующих источников URL. Подтверждения для текущего хода или ветки диалога по-прежнему могут применяться. true делает Always allow доступным, если это разрешено остальными условиями, но не создаёт подтверждение.
browser_use.origins.<pattern>.uploads allow | deny Используйте deny, чтобы заблокировать отправку файлов через Browser Use для соответствующих источников URL. allow лишь позволяет продолжить обычные проверки подтверждений и политик.
chatgpt_base_url string Принудительно задать базовый URL сервиса ChatGPT до аутентификации и получения облачных политик. Этот параметр не настраивает все сетевые адреса назначения Codex. Задаётся через локальный файл системных требований или macOS MDM; значения, управляемые из облака, игнорируются.
check_for_update_on_startup boolean Принудительно задать, проверяет ли Codex наличие обновлений при запуске.
cli_auth_credentials_store file | keyring | auto | ephemeral Принудительно задать хранилище учётных данных CLI до загрузки аутентификации. file использует CODEX_HOME/auth.json; keyring требует хранилище учётных данных ОС; auto использует файл, если хранилище учётных данных недоступно; ephemeral хранит учётные данные в памяти текущего процесса. Задаётся через локальный файл системных требований или macOS MDM; значения, управляемые из облака, игнорируются.
computer_use table Управляемые требования к работе агента в нативных настольных приложениях. Применяются как управляемые правила для приложений, так и правила для приложений из config.toml; приложение должно быть разрешено каждым источником политики.
computer_use.allow_locked_computer_use boolean Установите false, чтобы запретить пользователям включать Locked Use на управляемом устройстве macOS. Это требование убирает элементы управления включением; оно не отключает Locked Use, если функция уже включена. Если параметр не указан, действует обычная доступность продукта.
computer_use.allow_persistent_approval boolean Установите false, чтобы убрать возможность сохранять подтверждения для приложений между сеансами. Подтверждения для текущего сеанса остаются доступными. Значение true или отсутствие параметра не подтверждает доступ к приложению.
computer_use.default_app_access allow | deny Резервный режим доступа для нативных приложений, не соответствующих ни одному правилу для платформы. deny блокирует доступ. allow лишь позволяет продолжить обычные проверки подтверждений и политик. Значение по умолчанию в продукте — allow.
computer_use.macos table Правила Computer Use для приложений macOS.
computer_use.macos.bundle_ids map<string, allow | deny> Сопоставьте точные идентификаторы пакетов macOS со значениями allow или deny. Подходящее правило заменяет computer_use.default_app_access в пределах того же источника политики. Запрет в управляемых требованиях или пользовательской конфигурации по-прежнему блокирует доступ.
computer_use.macos.bundle_ids.<bundle-id> allow | deny Используйте deny, чтобы заблокировать конкретный идентификатор пакета. allow переопределяет только значение по умолчанию этого источника политики; приложение по-прежнему должно быть разрешено всеми остальными источниками политики и обычным процессом подтверждения.
computer_use.windows table Правила Computer Use для упакованных и неупакованных приложений Windows.
computer_use.windows.aumids map<string, allow | deny> Сопоставьте точные зарегистрированные Application User Model IDs (AUMIDs) подписанных упакованных приложений со значениями allow или deny. Подходящее правило заменяет computer_use.default_app_access в пределах того же источника политики.
computer_use.windows.aumids.<aumid> allow | deny Используйте deny, чтобы заблокировать конкретную идентичность упакованного приложения. allow переопределяет только значение по умолчанию этого источника политики; приложение по-прежнему должно быть разрешено всеми остальными источниками политики и обычным процессом подтверждения.
computer_use.windows.exes array<table> Правила для подписанных неупакованных исполняемых файлов Windows. Правила сопоставляются с проверенным издателем исполняемого файла и подписанными сведениями о версии, а не с его путём или текущим именем файла. Подходящий запрет имеет приоритет над подходящими разрешениями. Для неподписанных исполняемых файлов используется computer_use.default_app_access; исполняемые файлы, чью подписанную идентичность нельзя однозначно проверить, блокируются.
computer_use.windows.exes[].access allow | deny Обязательное решение о доступе для соответствующих исполняемых файлов. deny блокирует доступ. allow переопределяет только значение по умолчанию этого источника политики; приложение по-прежнему должно быть разрешено всеми остальными источниками политики и обычным процессом подтверждения.
computer_use.windows.exes[].binary_name string Необязательное значение OriginalFilename из подписанных сведений о версии исполняемого файла. Сопоставление выполняется без учёта регистра. Если подходящее правило для издателя и продукта требует это значение, а исполняемый файл его не предоставляет, Computer Use блокирует исполняемый файл.
computer_use.windows.exes[].product_name string Обязательное точное значение ProductName из подписанных сведений о версии исполняемого файла.
computer_use.windows.exes[].publisher_name string Обязательное точное имя издателя из доверенного сертификата подписи исполняемого файла в формате отличительного имени Windows X.500.
default_permissions string Управляемый профиль разрешений по умолчанию. Профиль должен быть разрешён в allowed_permission_profiles. Задайте его явно для предсказуемого поведения; если он не указан, Codex по умолчанию использует :workspace только тогда, когда и :workspace, и :read-only явно разрешены.
enforce_residency string Требовать, чтобы трафик сервиса Codex использовал поддерживаемый регион размещения данных. Сейчас допускается us.
experimental_network table Сетевые требования, управляемые администратором, для локальных команд в песочнице, применяемые из requirements.toml. Если эти требования включены, они могут запускать сетевой прокси команд без features.network_proxy. Инструменты браузера отдельно проверяют управляемые сетевые запреты и исключительные списки разрешений. Эти требования не направляют трафик браузера через прокси и не управляют веб-поиском, приложениями, MCP servers, трафиком нативных приложений или другим трафиком отдельных возможностей. В поддерживаемых управляемых сценариях Codex Cloud эти требования ограничивают сетевой доступ команд наряду с отдельными настройками интернета облачной среды. Подтверждённое полное повышение привилегий за пределы песочницы может обходить прокси команд, если политика это разрешает. Work Cloud не наследует эти требования.
experimental_network.allow_local_binding boolean Разрешить более широкий доступ к локальной или частной сети из песочницы. В поддерживаемом сценарии прокси Codex Cloud явное значение false может предотвратить доступ через вышестоящий прокси, даже если домен разрешён. Значение по умолчанию — true, только если ни одно применимое требование, выбранный сетевой профиль или настройка функции прокси не задаёт значение. Унаследованное false остаётся явным значением. Поддерживаемое облачное переопределение с более высоким приоритетом может изменить его, не расширяя Global для Local и не добавляя записи Allow для доменов. Проверьте поддержку со стороны исполнителя. Не применяйте это облачное значение по умолчанию к Local.
experimental_network.allow_upstream_proxy boolean Разрешить сетевым подключениям из песочницы проходить через вышестоящий прокси, заданный в окружении.
experimental_network.allowed_domains array<string> Административные разрешающие правила для сетевого доступа команд в песочнице при включённом управляемом сетевом прокси. Эти правила не распространяются на веб-поиск, приложения или MCP servers. Не сочетайте с experimental_network.domains.
experimental_network.dangerously_allow_all_unix_sockets boolean Разрешить произвольные адреса назначения Unix-сокетов вместо доступа только по списку разрешений. Используйте только в строго контролируемых средах.
experimental_network.dangerously_allow_non_loopback_proxy boolean Разрешить адреса прослушивания вне loopback-интерфейса для требований [experimental_network]. Включение может сделать прослушивающие службы доступными за пределами localhost.
experimental_network.denied_domains array<string> Административные правила запрета в виде списка для сетевого доступа в песочнице. Не сочетайте с experimental_network.domains.
experimental_network.domains map<string, allow | deny> Административная политика доменов в виде отображения для сетевого доступа в песочнице. Поддерживает точные имена хостов, *.example.com только для поддоменов, **.example.com для корневого домена и поддоменов, а также глобальные разрешающие правила *. Предпочитайте правила с ограниченной областью действия, поскольку * широко открывает исходящий доступ к общедоступным ресурсам. Правила среды могут заменять тот же ключ домена Global в пределах политики. Значения с более высоким приоритетом заменяют тот же ключ, а остальные унаследованные ключи сохраняются. После объединения другое подходящее правило deny, включая унаследованное правило с подстановочным знаком, по-прежнему блокирует запрос. Пустые отображения среды не очищают правила Global. Проверьте поддержку со стороны исполнителя. Не сочетайте с experimental_network.allowed_domains или experimental_network.denied_domains.
experimental_network.domains.<pattern> allow | deny Разрешить или запретить сетевой доступ из песочницы для соответствующего шаблона домена. Если подходят несколько шаблонов, правило запрета имеет приоритет.
experimental_network.enabled boolean Включить требования к сетевому доступу в песочнице. Это не предоставляет сетевой доступ, если активная песочница отключает сеть для команд.
experimental_network.http_port integer Порт прослушивания HTTP на loopback-интерфейсе для требований [experimental_network].
experimental_network.managed_allowed_domains_only boolean Если сетевые требования включены и задано значение true, обычная пользовательская конфигурация и подтверждения для отдельных доменов не могут расширить список разрешений управляемого прокси. Если среди действующих настроенных или унаследованных записей нет записей Allow, у обычных управляемых команд нет разрешённых адресов назначения. Политика, содержащая только запреты, не разрешает доступ к остальному интернету. Это не охватывает все инструменты или подтверждённое полное повышение привилегий за пределы песочницы.
experimental_network.socks_port integer Порт прослушивания SOCKS5 на loopback-интерфейсе для требований [experimental_network].
experimental_network.unix_sockets map<string, allow | deny> Управляемый администратором список разрешённых Unix-сокетов для сетевого доступа в песочнице на macOS. Пути должны быть абсолютными.
experimental_network.unix_sockets.<path> allow | deny На macOS allow добавляет абсолютный путь Unix-сокета в список разрешений; deny не добавляет его. Запись deny не может заблокировать сокет, если включено разрешение всех Unix-сокетов.
features table Зафиксированные значения функций. Для функций среды выполнения используйте канонические имена из config.toml; здесь также поддерживаются документированные ключи требований, действующие только для приложения.
features.<name> boolean Требовать, чтобы документированная функция среды выполнения или приложения оставалась включённой либо отключённой.
features.apps boolean Зафиксировать включённое или отключённое состояние интеграции Apps для управляемых пользователей.
features.browser_use boolean Установите false в requirements.toml, чтобы отключить Browser Use под управлением агента.
features.browser_use_external boolean Установите false в requirements.toml, чтобы запретить Codex управлять поддерживаемыми браузерами через расширение ChatGPT для браузера, включая существующие вкладки и сеансы с выполненным входом.
features.browser_use_full_cdp_access boolean Установите false в requirements.toml, чтобы отключить полный доступ к Chrome DevTools Protocol в локальной среде выполнения, включая режим Browser Developer, и запретить настольному приложению ChatGPT включать соответствующую настройку. Если параметр не указан, действует обычная доступность продукта.
features.computer_use boolean Установите false в requirements.toml, чтобы отключить Computer Use, Record & Replay и связанные процессы установки или включения.
features.fast_mode boolean Зафиксировать включённое или отключённое состояние канонической функции fast_mode для управляемых пользователей.
features.guardian_approval boolean Зафиксировать доступность подтверждений Guardian для управляемых пользователей.
features.in_app_browser boolean Установите false в requirements.toml, чтобы отключить встроенную панель браузера, которую пользователи открывают и контролируют напрямую.
features.in_app_chat boolean Установите false, чтобы скрыть экраны диалогов ChatGPT и ChatGPT Work и связанный интерфейс облачной автоматизации в настольном приложении ChatGPT. Эта настройка не блокирует ChatGPT Voice и не останавливает существующие облачные задачи. Значение true не отменяет проверки учётной записи, разрешений рабочего пространства или поэтапного развёртывания.
features.in_app_dictation boolean Установите false, чтобы отключить диктовку в настольном приложении. Значение true не отменяет другие проверки доступности.
features.in_app_local_automation boolean Установите false, чтобы отключить локальные задачи по расписанию в настольном приложении. Значение true не отменяет другие проверки доступности.
features.in_app_updates boolean Установите false в requirements.toml, чтобы отключить обновления из приложения. Если это требование не указано, обновления по умолчанию остаются включёнными.
features.memories boolean Зафиксировать доступность Memories для управляемых пользователей.
features.multi_agent boolean Зафиксировать доступность работы с несколькими агентами для управляемых пользователей.
features.plugin_sharing boolean Установите false в управляемом из облака requirements.toml, чтобы отключить совместное использование локально созданных плагинов в рабочем пространстве.
features.plugins boolean Зафиксировать доступность плагинов для управляемых пользователей.
features.realtime_conversation boolean Установите false, чтобы отключить экспериментальную команду /voice в Codex CLI. Не полагайтесь на эту настройку для блокировки ChatGPT Voice в настольном приложении или голосовых сеансов app-server. Значение true не отменяет проверки клиента или поэтапного развёртывания.
features.remote_plugin boolean Зафиксировать доступность удалённого каталога плагинов для управляемых пользователей.
features.workspace_dependencies boolean Зафиксировать доступность встроенной среды выполнения зависимостей рабочего пространства для управляемых пользователей.
feedback table Управляемые настройки обратной связи.
feedback.enabled boolean Принудительно задать, могут ли пользователи отправлять отзывы во всех клиентах Codex.
guardian_extra_policy string Дополнительная управляемая политика автоматической проверки в формате Markdown, включаемая вместе с основной политикой. Имеет приоритет над локальным [auto_review].extra_policy. Пустые значения игнорируются.
guardian_policy_config string Управляемые инструкции политики автоматической проверки в формате Markdown. Имеют приоритет над локальным [auto_review].policy. Пустые значения игнорируются.
hooks table Управляемые хуки жизненного цикла, принудительно заданные администратором. Требуется каталог управляемых хуков; используется та же схема событий, что и для встроенных [hooks] в config.toml.
hooks.<Event> array<table> Группы условий сопоставления для события хука, например PreToolUse, PermissionRequest, PostToolUse, PreCompact, PostCompact, SessionStart, SessionEnd, SubagentStart, SubagentStop, UserPromptSubmit или Stop.
hooks.<Event>[].hooks array<table> Обработчики хуков для группы условий сопоставления. Поддерживаются хуки команд и инструментов MCP; обработчики хуков запросов и агентов разбираются, но пропускаются.
hooks.<Event>[].hooks[].additionalContextLimit integer Приблизительный порог числа токенов для каждого обработчика, при превышении которого слишком большой additionalContext сохраняется на диск, а модели показывается сокращённый вариант. По умолчанию — 2500; 0 передаёт полный контекст непосредственно модели. См. Большой объём вывода хука.
hooks.<Event>[].hooks[].async boolean Запускать хук команды в фоновом режиме, не задерживая вызвавшую его операцию. По умолчанию — false; SessionEnd всегда выполняется синхронно. См. Запуск хуков в фоновом режиме.
hooks.<Event>[].hooks[].commandWindows string Переопределение команды для хуков команд, действующее только в Windows. Также принимается псевдоним TOML command_windows.
hooks.managed_dir string (absolute path) Каталог со скриптами управляемых хуков на macOS и Linux. Перед загрузкой управляемых хуков Codex проверяет, что путь абсолютный и каталог существует.
hooks.windows_managed_dir string (absolute path) Каталог со скриптами управляемых хуков на Windows. Перед загрузкой управляемых хуков Codex проверяет, что путь абсолютный и каталог существует.
in_app_browser table Требования к встроенной панели браузера. Эти настройки не управляют Browser Use под управлением агента.
in_app_browser.allow_external_browser_settings_import boolean Установите false, чтобы запретить пользователям импортировать настройки или данные просмотра из внешнего браузера во встроенный. Значение true или отсутствие параметра сохраняет доступность импорта, если его разрешают другие проверки продукта. Эта настройка доступна только в управляемой конфигурации и не имеет переопределения через config.toml.
log_dir string (path) Принудительно задать каталог, в который Codex записывает локальные файлы журналов.
marketplaces table Требования администратора к источникам маркетплейсов плагинов. Правила действуют, когда restrict_to_allowed_sources имеет значение true.
marketplaces.allowed_sources table Разрешённые источники маркетплейсов с именами правил, выбранными администратором, в качестве ключей. Записи с разными именами накапливаются по слоям требований; для полей с одним и тем же именем действует обычный приоритет слоёв.
marketplaces.allowed_sources.<name> table Одно правило разрешённого источника. Итоговое значение source после объединения требований определяет, какие соседние поля Codex интерпретирует.
marketplaces.allowed_sources.<name>.host_pattern string Регулярное выражение, обязательное при source = "host_pattern". Codex сопоставляет его с приведённым к нижнему регистру именем хоста, извлечённым из источника Git в формате HTTPS, SSH или SCP. Используйте ^ и $, чтобы требовать совпадения полного имени хоста.
marketplaces.allowed_sources.<name>.path string (absolute path) Локальный каталог маркетплейса, обязательный при source = "local". Codex требует абсолютный путь и сравнивает пути после нормализации.
marketplaces.allowed_sources.<name>.ref string Необязательная точная ссылка Git для правила git. Если не указана, правило разрешает любую ссылку для соответствующего репозитория.
marketplaces.allowed_sources.<name>.source git | host_pattern | local Тип условия сопоставления источника маркетплейса. Используйте git для одного репозитория, host_pattern для хостов Git, сопоставляемых по регулярному выражению, или local для одного каталога.
marketplaces.allowed_sources.<name>.url string URL репозитория Git, обязательный при source = "git". Codex нормализует настроенный и разрешённый URL, прежде чем проверять точное совпадение репозитория.
marketplaces.restrict_to_allowed_sources boolean При true требовать, чтобы настроенные источники маркетплейсов соответствовали allowed_sources при добавлении маркетплейса, установке плагина, обновлении и загрузке во время выполнения. Курируемые OpenAI каталоги Git, включая каталог для API key, также должны соответствовать списку разрешений. Встроенные и удалённо установленные плагины рабочего пространства не относятся к этой политике курируемых источников Git.
mcp_servers table Список разрешённых MCP servers, которые можно включить. Для включения MCP server должны совпадать и имя сервера (&lt;id&gt;), и его идентичность. Любой настроенный MCP server, отсутствующий в списке разрешений или имеющий несовпадающую идентичность, отключается.
mcp_servers.<id>.identity table Правило идентичности для одного MCP server. Задайте либо command (stdio), либо url (streamable HTTP).
mcp_servers.<id>.identity.command string | table Разрешить MCP server stdio по точной строке команды или использовать таблицу условий сопоставления, требующую точного совпадения исполняемого файла и упорядоченных условий для аргументов. Строковая форма не проверяет аргументы, cwd, env или env_vars.
mcp_servers.<id>.identity.command.args array<table> Упорядоченные условия сопоставления аргументов для сервера stdio. Настроенный список аргументов должен иметь ту же длину, и каждая позиция должна соответствовать условию. Условия сопоставления команд не проверяют cwd, env или env_vars.
mcp_servers.<id>.identity.command.args[].expression string Регулярное выражение, используемое условием сопоставления аргумента regex. Выражение должно быть корректным и соответствовать полному значению аргумента.
mcp_servers.<id>.identity.command.args[].match exact | prefix | regex Операция сопоставления для аргумента в этой позиции.
mcp_servers.<id>.identity.command.args[].value string Значение, используемое условием сопоставления аргумента exact или prefix.
mcp_servers.<id>.identity.command.executable string Исполняемый файл, с которым должно точно совпадать настроенное значение command сервера stdio.
mcp_servers.<id>.identity.url string | table Разрешить MCP server streamable HTTP по точной строке URL или использовать таблицу условий сопоставления значений exact, prefix или regex.
mcp_servers.<id>.identity.url.expression string Регулярное выражение, используемое условием сопоставления URL regex. Выражение должно быть корректным и соответствовать полному значению URL.
mcp_servers.<id>.identity.url.match exact | prefix | regex Операция сопоставления для настроенного URL MCP server.
mcp_servers.<id>.identity.url.value string Значение, используемое условием сопоставления URL exact или prefix.
model_catalog_json string (path) Принудительно задать каталог моделей в формате JSON, который Codex использует при запуске.
model_provider string Принудительно задать идентификатор провайдера моделей, переопределив локальную конфигурацию и конфигурацию сеанса.
model_providers map<string, table> Управляемые определения провайдеров моделей. Каждая запись полностью заменяет настроенного провайдера с тем же идентификатором; поля не объединяются с пользовательским определением. Провайдеры с другими идентификаторами остаются доступными.
model_providers.<id> table Полное управляемое определение провайдера. Использует те же поля провайдера, что и config.toml, включая name, base_url, настройки аутентификации и транспорта.
models table Содержит таблицу [models.new_thread].
models.new_thread table Необязательные значения по умолчанию, применяемые при начале новой локальной ветки диалога. Они имеют приоритет над пользовательскими и проектными значениями по умолчанию, но могут быть заменены явными переопределениями.
models.new_thread.model string Модель по умолчанию для новых веток диалога. Явное переопределение модели или уровня усилий рассуждения приводит к игнорированию обоих полей.
models.new_thread.model_reasoning_effort string Уровень усилий рассуждения по умолчанию для новых веток диалога. Явное переопределение модели или уровня усилий рассуждения приводит к игнорированию обоих полей.
models.new_thread.service_tier string Уровень обслуживания по умолчанию для новых веток диалога. Явное переопределение уровня обслуживания приводит к игнорированию этого поля.
permissions table Профили разрешений, заданные администратором, с именами профилей в качестве ключей. Используют те же поля профиля, что и config.toml.
permissions.<name> table Профиль разрешений, заданный администратором. Имя не может начинаться с :, совпадать с зарезервированным именем filesystem или дублировать профиль из загруженной конфигурации. Использует те же поля профиля, что и config.toml; полную схему профиля см. в руководстве по разрешениям.
permissions.filesystem.deny_read array<string> Запреты чтения файловой системы, принудительно заданные администратором. Записи могут быть путями или glob-шаблонами, и пользователи не могут ослабить их локальной конфигурацией.
plugins table Списки разрешённых MCP servers для отдельных плагинов с идентификаторами плагинов в качестве ключей. Если эта таблица присутствует, серверы, поставляемые с плагинами, отключаются при отсутствии подходящей записи для плагина и сервера.
plugins.<plugin>.mcp_servers table Список разрешённых MCP servers, поставляемых с одним плагином. Требования к серверам плагинов используют те же формы точного сопоставления идентичности и условий сопоставления, что и требования mcp_servers верхнего уровня.
plugins.<plugin>.mcp_servers.<server>.identity table Правило идентичности для одного MCP server, поставляемого с плагином. Задайте либо command (stdio), либо url (streamable HTTP).
plugins.<plugin>.mcp_servers.<server>.identity.command string | table Разрешить MCP server stdio плагина по точной строке команды или использовать таблицу условий сопоставления, требующую точного совпадения исполняемого файла и упорядоченных условий для аргументов.
plugins.<plugin>.mcp_servers.<server>.identity.command.args array<table> Упорядоченные условия сопоставления аргументов для сервера stdio, поставляемого с плагином. Настроенный список аргументов должен иметь ту же длину, и каждая позиция должна соответствовать условию.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].expression string Регулярное выражение, используемое условием сопоставления аргумента regex. Выражение должно соответствовать полному значению аргумента.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].match exact | prefix | regex Операция сопоставления для аргумента в этой позиции.
plugins.<plugin>.mcp_servers.<server>.identity.command.args[].value string Значение, используемое условием сопоставления аргумента exact или prefix.
plugins.<plugin>.mcp_servers.<server>.identity.command.executable string Исполняемый файл, с которым должна точно совпадать настроенная команда сервера stdio, поставляемого с плагином.
plugins.<plugin>.mcp_servers.<server>.identity.url string | table Разрешить MCP server streamable HTTP плагина по точной строке URL или использовать таблицу условий сопоставления значений exact, prefix или regex.
plugins.<plugin>.mcp_servers.<server>.identity.url.expression string Регулярное выражение, используемое условием сопоставления URL regex. Выражение должно соответствовать полному значению URL.
plugins.<plugin>.mcp_servers.<server>.identity.url.match exact | prefix | regex Операция сопоставления для URL MCP server, поставляемого с плагином.
plugins.<plugin>.mcp_servers.<server>.identity.url.value string Значение, используемое условием сопоставления URL exact или prefix.
remote_sandbox_config array<table> Требования к песочнице для отдельных хостов. Первая запись, у которой hostname_patterns соответствуют определённому имени хоста, переопределяет allowed_sandbox_modes верхнего уровня для этого источника требований. Сейчас записи для отдельных хостов переопределяют только режимы песочницы.
remote_sandbox_config[].allowed_sandbox_modes array<string> Разрешённые режимы песочницы, применяемые при совпадении с этой записью для хоста.
remote_sandbox_config[].hostname_patterns array<string> Шаблоны имён хостов без учёта регистра. Поддерживаются * для любой последовательности символов и ? для одного символа.
rules table Правила команд, принудительно заданные администратором и объединяемые с файлами .rules. Правила требований должны быть ограничительными.
rules.prefix_rules array<table> Список принудительно применяемых правил префиксов. Каждое правило должно включать pattern и decision.
rules.prefix_rules[].decision prompt | forbidden Обязательно. Правила требований могут только запрашивать подтверждение или запрещать, но не разрешать.
rules.prefix_rules[].justification string Необязательное непустое обоснование, отображаемое в запросах подтверждения или сообщениях об отказе.
rules.prefix_rules[].pattern array<table> Префикс команды, выраженный токенами шаблона. Каждый токен задаёт либо token, либо any_of.
rules.prefix_rules[].pattern[].any_of array<string> Список разрешённых альтернативных токенов в этой позиции.
rules.prefix_rules[].pattern[].token string Один буквальный токен в этой позиции.
sqlite_home string (path) Принудительно задать каталог, в котором Codex хранит состояние среды выполнения на базе SQLite.
windows table Требования к нативной песочнице Windows.
windows.allowed_sandbox_implementations array<string> Разрешённые устаревшие реализации нативной песочницы Windows (elevated и unelevated). Список не должен быть пустым. Если разрешены обе реализации и режим не выбран, Codex предпочитает elevated. Этот список не ограничивает песочницу mxc, когда она доступна.