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