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

Полный справочник по файлам 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 Включает или отключает аналитику для этого компьютера или профиля. В Codex CLI false также отключает пользовательские экспортёры метрик OTLP. Если значение не задано, применяется настройка клиента по умолчанию.
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.<name>]. Не сочетайте с 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.disable_paste_burst. Предпочитайте настройку в [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 Включает элементы управления режимом Fast, заявленные активной моделью (стабильная функция; включена по умолчанию), независимо от features.ultrafast_mode. Доступность по-прежнему зависит от модели и учётной записи.
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.prefer_mxc boolean Предпочитает MXC для локального выполнения в Windows, если это допускают нативные возможности и политика; иначе сохраняет настроенную прежнюю песочницу и её параметры. По умолчанию отключено в отдельном CLI; настольное приложение может включить эту функцию через конфигурацию развёртывания. Ошибки команд не приводят к переходу на резервный вариант.
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 Включает инструменты выполнения команд (стабильная функция; включена по умолчанию).
features.skill_mcp_dependency_install boolean Разрешает запросы на установку и установку недостающих зависимостей MCP для навыков (стабильная функция; включена по умолчанию).
features.ultrafast_mode boolean Включает элементы управления режимом Ultrafast (стабильная функция; включена по умолчанию), независимо от features.fast_mode. Доступность по-прежнему зависит от модели и учётной записи.
features.unified_exec boolean Использует возобновляемое выполнение команд (стабильная функция; включена на всех платформах). Пользовательское отключение игнорируется. Управляемые требования могут отключить возобновляемые процессы и write_stdin, сохранив доступность однократного exec_command.
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, в настроенном адресе обратного вызова которого отсутствует требуемый идентификатор, использует этот URL с добавленным идентификатором. Порт в URL обратного вызова не определяет порт прослушивания.
mcp_oauth_credentials_store auto | file | keyring Предпочтительное хранилище учётных данных MCP OAuth.
mcp_optional_startup_grace_ms integer (milliseconds) Общее время ожидания необязательных серверов MCP при формировании начального каталога инструментов. По умолчанию: 1000. Установите 0, чтобы вместо этого ожидать каждый сервер в течение его startup_timeout_sec.
mcp_servers.<id>.args array<string> Аргументы, передаваемые команде сервера MCP stdio.
mcp_servers.<id>.auth oauth | chatgpt Резервный способ аутентификации для сервера MCP HTTP после настроенных bearer-токенов и заголовков авторизации. oauth (по умолчанию) использует сохранённые учётные данные MCP OAuth, если они доступны. chatgpt использует текущий сеанс ChatGPT для доверенного собственного источника ChatGPT, а затем переходит к сохранённым данным OAuth. Оба режима допускают подключение без аутентификации, если ни один источник не предоставляет учётные данные.
mcp_servers.<id>.bearer_token_env_var string Переменная окружения, из которой берётся bearer-токен для сервера MCP HTTP.
mcp_servers.<id>.command string Команда запуска сервера MCP stdio.
mcp_servers.<id>.cwd string Рабочий каталог процесса сервера MCP stdio.
mcp_servers.<id>.default_tools_approval_mode auto | prompt | writes | approve Порядок подтверждения по умолчанию для инструментов MCP на этом сервере, если нет переопределения для отдельного инструмента.
mcp_servers.<id>.disabled_tools array<string> Список запретов, применяемый после enabled_tools для сервера MCP.
mcp_servers.<id>.enabled boolean Отключает сервер MCP, не удаляя его конфигурацию.
mcp_servers.<id>.enabled_tools array<string> Список разрешённых имён инструментов, предоставляемых сервером MCP.
mcp_servers.<id>.env map<string,string> Переменные окружения, передаваемые серверу MCP stdio.
mcp_servers.<id>.env_http_headers map<string,string> Заголовки HTTP, заполняемые из переменных окружения для сервера MCP HTTP.
mcp_servers.<id>.env_vars array<string | { name = string, source = "local" | "remote" }> Дополнительные переменные окружения для включения в список разрешённых для сервера MCP stdio. Для строковых записей по умолчанию используется source = "local"; используйте source = "remote" только с удалённым stdio через исполнитель.
mcp_servers.<id>.experimental_environment local | remote Экспериментальное размещение сервера MCP. 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 с локальным подключением. Явно заданные bearer-токены и учётные данные OAuth имеют приоритет над заголовками Authorization, предоставляемыми вспомогательной командой.
mcp_servers.<id>.oauth_resource string Необязательный параметр ресурса OAuth по RFC 8707, включаемый при входе в MCP.
mcp_servers.<id>.oauth.callback_port integer Фиксированный порт прослушивания обратного вызова OAuth для этого сервера MCP. Переопределяет 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.
mcp_servers.<id>.oauth.client_secret string Секрет клиента OAuth для обмена токенами с предварительно зарегистрированным клиентом. Требует непустого oauth.client_id; секрет также не должен быть пустым. Хранится в конфигурации.
mcp_servers.<id>.required boolean При true запуск или возобновление завершается ошибкой, если этот включённый сервер MCP не может инициализироваться.
mcp_servers.<id>.scopes array<string> Области доступа OAuth, запрашиваемые при аутентификации на этом сервере MCP.
mcp_servers.<id>.startup_timeout_ms number Псевдоним для startup_timeout_sec в миллисекундах.
mcp_servers.<id>.startup_timeout_sec number Переопределяет тайм-аут запуска сервера MCP, который по умолчанию составляет 10 с.
mcp_servers.<id>.tool_timeout_sec number Переопределяет тайм-аут отдельного инструмента сервера MCP, который по умолчанию составляет 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 с транспортом 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>.capabilities.external_web_access boolean Может ли размещённый у провайдера веб-поиск обращаться к актуальным веб-страницам. Не указывайте, чтобы сохранить настройки провайдера по умолчанию; настройки модели и хода могут дополнительно ограничивать доступ.
model_providers.<id>.capabilities.remote_compaction unsupported | v2 Протокол сжатия провайдера. unsupported использует локальное сжатие; v2 отправляет сигналы запуска сжатия через Responses. Не указывайте, чтобы сохранить настройки провайдера по умолчанию; настройки модели и хода могут дополнительно ограничивать поддержку.
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>.model_catalog_url string Полный URL каталога моделей в собственном формате Codex. Не указывайте, чтобы сохранить стандартный способ обнаружения моделей провайдера.
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 Путь к сертификату центра сертификации для 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). В Codex CLI analytics.enabled = false отключает этот экспортёр, включая пользовательские экспортёры OTLP. Установите none, чтобы отключить экспорт метрик отдельно.
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 Путь к сертификату центра сертификации для 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.
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 Устаревшая настройка совместимости. friendly и pragmatic больше не выбирают стиль. none исключает встроенный раздел 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, предоставляемого плагином.
plugins.<plugin>.mcp_servers.<server>.disabled_tools array<string> Список запретов, применяемый после enabled_tools для сервера MCP, предоставляемого плагином.
plugins.<plugin>.mcp_servers.<server>.enabled boolean Включает или отключает сервер MCP, входящий в установленный плагин, без изменения манифеста плагина.
plugins.<plugin>.mcp_servers.<server>.enabled_tools array<string> Список разрешённых инструментов сервера MCP, предоставляемого плагином.
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.
tui table Параметры TUI, например включение встроенных уведомлений рабочего стола.
tui.alternate_screen auto | always | never Управляет использованием альтернативного экрана для TUI (по умолчанию: auto; в режиме auto он не используется в Zellij, чтобы сохранить историю прокрутки).
tui.animations boolean Включает анимации терминала (экран приветствия, мерцание, индикатор загрузки) (по умолчанию: true).
tui.auto_recap boolean Автоматически создаёт краткие сводки беседы, пока терминал не в фокусе (по умолчанию: true). Установите false, чтобы отключить автоматические сводки; /recap остаётся доступным.
tui.disable_paste_burst boolean Отключает обнаружение быстрой вставки текста в TUI (по умолчанию: false). Имеет приоритет над устаревшей настройкой верхнего уровня disable_paste_burst.
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_server_version_notice boolean Показывает информационные уведомления о различиях версий подключённого app-server (по умолчанию: true). Не скрывает ошибки совместимости и сведения о версии.
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 mxc | elevated | unelevated Нативная реализация песочницы Windows. Явный выбор mxc приводит к ошибке, если MXC недоступен или запрещён управляемыми требованиями. Используйте features.prefer_mxc вместе с выбором прежней реализации для автоматического выбора MXC с резервным вариантом.

Актуальную схему 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. Пропущенные ключи остаются без ограничений.

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

Для управляемых списков разрешённых профилей разрешений требуется 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.
application table Централизованно управляемые требования к настольному приложению.
application.network table Ограничения адресов назначения для сетевых запросов настольного приложения, независимые от сетевого доступа команд и правил для источников веб-контента в браузере. Они не ограничивают адреса назначения для нативных модулей или запускаемых процессов.
application.network.domains table<allow | deny> Правила для точных доменных имён в запросах настольного приложения. Включённые политики разрешают запросы HTTPS и WSS только к явно разрешённым доменам; поддомены не разрешаются автоматически.
application.network.domains.<domain> allow | deny Разрешить или запретить точный домен. Используйте доменные имена без схем URL, портов или подстановочных знаков.
application.network.enabled boolean Если таблица присутствует, по умолчанию используется true. При значении true внешние запросы настольного приложения требуют явно разрешённого домена. Пустая таблица доменов не разрешает ни одного внешнего адреса назначения. Если сетевая политика приложения отсутствует или задано значение false, эта политика не ограничивает адреса назначения.
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.allow_webmcp boolean Установите значение true, чтобы разрешить встроенному браузеру настольного приложения использовать инструменты сайтов (WebMCP). Значение false или отсутствие параметра сохраняет обычные проверки доступности функции; false не устанавливает запрет. Пользовательские настройки и разрешения сайтов по-прежнему применяются.
browser_use.default_origin_policy table Резервное значение каждого параметра Browser Use, если ни одна подходящая запись в browser_use.origins его не задаёт. Подходящее правило для источника веб-контента заменяет резервное значение в этом источнике политики. Затем Codex применяет более строгое из значений централизованно управляемых требований и пользовательской конфигурации.
browser_use.default_origin_policy.access allow | deny Используйте deny, чтобы заблокировать Browser Use для источников веб-контента, использующих резервное значение. Запрет источника также блокирует отправку и скачивание файлов, полный доступ к отладке браузера и автоматическую проверку для него. 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, чтобы пропускать автоматическую проверку для источников веб-контента, использующих резервное значение, и вместо неё запрашивать одобрение пользователя. allow сохраняет доступность автоматической проверки, если её разрешают другие настройки.
browser_use.default_origin_policy.downloads allow | deny Используйте deny, чтобы запретить скачивание файлов через Browser Use для источников веб-контента, использующих резервное значение. allow лишь позволяет продолжить обычные проверки одобрений и политик.
browser_use.default_origin_policy.full_cdp_access allow | deny Используйте deny, чтобы заблокировать полный доступ к Chrome DevTools Protocol (CDP) для источников веб-контента, использующих резервное значение. allow лишь позволяет продолжить обычные проверки явного включения и одобрений.
browser_use.default_origin_policy.persistent_approval boolean Установите false, чтобы запретить Browser Use сохранять или учитывать одобрение Always allow для источников веб-контента, использующих резервное значение. Одобрения для текущего хода или диалога по-прежнему могут применяться. true делает Always allow доступным, если это разрешено остальными настройками, но не создаёт одобрение.
browser_use.default_origin_policy.uploads allow | deny Используйте deny, чтобы запретить отправку файлов через Browser Use для источников веб-контента, использующих резервное значение. allow лишь позволяет продолжить обычные проверки одобрений и политик.
browser_use.disable_auto_review boolean Установите true, чтобы пропускать автоматическую проверку для Browser Use и вместо неё запрашивать одобрение пользователя. Значение false или отсутствие параметра сохраняет доступность автоматической проверки, если её разрешают другие настройки.
browser_use.origins map<string, table> Политики Browser Use для конкретных источников веб-контента. Ключи используют <scheme>://<host-pattern>[:<port>] с 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 Политика для источников веб-контента, соответствующих этому шаблону. Если совпадают несколько шаблонов, Codex использует наиболее строгое значение для каждой возможности: deny вместо allow, false вместо true и turn вместо thread.
browser_use.origins.<pattern>.access allow | deny Используйте deny, чтобы заблокировать Browser Use для подходящих источников веб-контента. Запрет также блокирует отправку и скачивание файлов, полный доступ к отладке браузера и автоматическую проверку для них. allow лишь позволяет продолжить обычные проверки одобрений и политик.
browser_use.origins.<pattern>.access_approval_lifetime turn | thread Задайте срок действия непостоянного одобрения доступа к сайту для подходящих источников веб-контента: turn ограничивает его текущим ходом, а thread сохраняет до конца текущего диалога. persistent_approval отдельно определяет доступность Always allow.
browser_use.origins.<pattern>.auto_review allow | deny Используйте deny, чтобы пропускать автоматическую проверку для подходящих источников веб-контента и вместо неё запрашивать одобрение пользователя. allow сохраняет доступность автоматической проверки, если её разрешают другие настройки.
browser_use.origins.<pattern>.downloads allow | deny Используйте deny, чтобы запретить скачивание файлов через Browser Use для подходящих источников веб-контента. allow лишь позволяет продолжить обычные проверки одобрений и политик.
browser_use.origins.<pattern>.full_cdp_access allow | deny Используйте deny, чтобы заблокировать полный доступ к Chrome DevTools Protocol (CDP) для подходящих источников веб-контента. allow лишь позволяет продолжить обычные проверки явного включения и одобрений.
browser_use.origins.<pattern>.persistent_approval boolean Установите false, чтобы запретить Browser Use сохранять или учитывать одобрение Always allow для подходящих источников веб-контента. Одобрения для текущего хода или диалога по-прежнему могут применяться. true делает Always allow доступным, если это разрешено остальными настройками, но не создаёт одобрение.
browser_use.origins.<pattern>.uploads allow | deny Используйте deny, чтобы запретить отправку файлов через Browser Use для подходящих источников веб-контента. 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, трафиком нативных приложений или другим трафиком отдельных функций. В поддерживаемых управляемых средах 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. Не сочетайте с 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, которые можно включать. Для включения сервера MCP должны совпадать и его имя (<id>), и его идентичность. Любой настроенный сервер MCP, отсутствующий в списке разрешений или имеющий несовпадающую идентичность, отключается.
mcp_servers.<id>.identity table Правило идентичности для одного сервера MCP. Задайте либо command (stdio), либо url (streamable HTTP).
mcp_servers.<id>.identity.command string | table Разрешите сервер MCP 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 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.
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 для отдельных плагинов с идентификаторами плагинов в качестве ключей. Если эта таблица присутствует, входящие в состав плагинов серверы без соответствующей записи плагина и сервера отключаются.
plugins.<plugin>.mcp_servers table Список разрешённых серверов MCP, входящих в состав одного плагина. Требования к серверам плагина используют те же формы точной идентичности и условий сопоставления, что и требования mcp_servers верхнего уровня.
plugins.<plugin>.mcp_servers.<server>.identity table Правило идентичности для одного сервера MCP, входящего в состав плагина. Задайте либо command (stdio), либо url (streamable HTTP).
plugins.<plugin>.mcp_servers.<server>.identity.command string | table Разрешите сервер MCP 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 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, входящего в состав плагина.
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.allow_mxc boolean Установите false, чтобы запретить как явный выбор MXC, так и автоматический выбор через features.prefer_mxc. Если требование не указано или имеет значение true, MXC разрешён, но не включается и не становится обязательным. При переходе к резервной реализации ограничения прежних реализаций продолжают действовать.
windows.allowed_sandbox_implementations array<string> Разрешённые прежние реализации нативной песочницы Windows (elevated и unelevated). Список не должен быть пустым. Если разрешены обе реализации и режим не выбран, Codex предпочитает elevated. Этот список не ограничивает песочницу mxc, когда она доступна.