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