Основы конфигурации

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

Файл конфигурации Codex

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

Чтобы открыть файл конфигурации из расширения Codex для IDE, выберите значок шестерёнки в правом верхнем углу, затем выберите Codex Settings > Open config.toml.

CLI и расширение для IDE используют одни и те же слои конфигурации. С их помощью можно:

• Задать модель и провайдера по умолчанию.
• Настроить политики одобрения и параметры песочницы.
• Настроить серверы MCP.

Приоритет конфигурации

Codex определяет значения в следующем порядке (от наивысшего приоритета к наименьшему):

1. Флаги CLI и переопределения --config
2. Файлы конфигурации проекта: .codex/config.toml, в порядке от корня проекта до текущего рабочего каталога (побеждает ближайший; только для доверенных проектов)
3. Файлы профилей, выбранные с помощью --profile profile-name (~/.codex/profile-name.config.toml)
4. Пользовательская конфигурация: ~/.codex/config.toml
5. Системная конфигурация (при наличии): /etc/codex/config.toml в Unix
6. Встроенные значения по умолчанию

Используйте этот порядок приоритетов, чтобы задать общие настройки по умолчанию в config.toml, а в файлах профилей оставить только различающиеся значения.

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

Сведения об однократных переопределениях через -c/--config (включая правила заключения строк TOML в кавычки) см. в разделе Расширенная конфигурация.

Распространённые параметры конфигурации

Ниже приведены некоторые параметры, которые изменяют чаще всего:

Модель по умолчанию

Выберите модель, которую Codex по умолчанию использует в CLI и IDE.

model = "gpt-5.6"

Запросы на одобрение

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

approval_policy = "on-request"

Различия в поведении untrusted, on-request и never описаны в разделах Запуск без запросов на одобрение и Распространённые сочетания параметров песочницы и одобрения.

Уровень песочницы

Настройте объём доступа Codex к файловой системе и сети при выполнении команд.

sandbox_mode = "workspace-write"

Поведение каждого режима (включая защищённые пути .git/.codex и сетевые настройки по умолчанию) описано в разделах Песочница и одобрения, Защищённые пути в доступных для записи корневых каталогах и Доступ к сети.

Профили разрешений

Codex также поддерживает именованные профили разрешений для многократного использования политик файловой системы и сети. Встроенные профили: :read-only, :workspace и :danger-full-access. Пользовательские профили используют таблицы [permissions.<name>] и соответствующее значение default_permissions. См. раздел Разрешения.

Режим песочницы Windows

При запуске Codex непосредственно в Windows задайте для нативного режима песочницы значение elevated в таблице windows. Используйте unelevated только при отсутствии прав администратора или если настройка с повышенными привилегиями завершается сбоем.

[windows]
sandbox = "elevated"   # Recommended
# sandbox = "unelevated" # Fallback if admin permissions/setup are unavailable

Режим веб-поиска

По умолчанию Codex включает веб-поиск для локальных чатов и предоставляет результаты из кеша веб-поиска. Этот кеш представляет собой поддерживаемый OpenAI индекс веб-результатов, поэтому в режиме кеширования возвращаются предварительно проиндексированные результаты, а не загружаются актуальные страницы. Это снижает риск инъекции запросов из произвольного актуального содержимого, но веб-результаты всё равно следует считать недоверенными. Если вы используете --yolo или другой параметр песочницы с полным доступом, веб-поиск по умолчанию возвращает актуальные результаты. Выберите режим с помощью web_search:

• "cached" (по умолчанию) предоставляет результаты из кеша веб-поиска.
• "indexed" разрешает внешний веб-доступ, только когда запрос допущен индексом поиска.
• "live" получает из интернета самые свежие данные (аналогично --search).
• "disabled" отключает инструмент веб-поиска.

web_search = "cached"  # default; serves results from the web search cache
# web_search = "indexed" # gate external web access through the search index
# web_search = "live"  # fetch the most recent data from the web (same as --search)
# web_search = "disabled"

Интенсивность рассуждений

Настройте интенсивность рассуждений модели, если она поддерживает такую возможность.

model_reasoning_effort = "high"

Стиль общения

Задайте стиль общения по умолчанию для поддерживаемых моделей.

personality = "friendly" # or "pragmatic" or "none"

Позже его можно переопределить в активном сеансе с помощью /personality либо для отдельной ветки или итерации при использовании API app-server.

Раскладка клавиш TUI

Настройте сочетания клавиш терминала в разделе tui.keymap. Для выбранных действий редактора сообщений используются соответствующие привязки tui.keymap.global, если отдельные привязки отсутствуют; при наличии приоритет имеют контекстные привязки. Пустой список отменяет привязку действия.

[tui.keymap.global]
open_transcript = "ctrl-t"

[tui.keymap.composer]
submit = ["enter", "ctrl-m"]

[tui.keymap.chat]
interrupt_turn = "f12"

Среда команд

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

[shell_environment_policy]
ignore_default_excludes = false

[shell_environment_policy.filters]
"PATH" = "include"
"HOME" = "include"

По умолчанию ignore_default_excludes имеет значение true, поэтому автоматическая фильтрация имён переменных, содержащих KEY, SECRET или TOKEN, не выполняется. Задайте значение false, если нужна такая автоматическая фильтрация. Правила исключения, порядок приоритетов и устаревшая конфигурация описаны в разделе Политика среды оболочки.

Каталог журналов

Переопределите каталог, в который Codex записывает локальные файлы журналов. Явная настройка log_dir также включает необязательный текстовый журнал TUI codex-tui.log в этом каталоге.

log_dir = "/absolute/path/to/codex-logs"

Для однократных запусков его также можно задать из CLI:

codex -c log_dir=./.codex-log

Флаги функций

Используйте таблицу [features] в config.toml, чтобы включать и отключать необязательные и экспериментальные возможности.

Распространённые флаги функций

Сведения о настройке хуков жизненного цикла см. в разделе Хуки.

Включение функций

• В config.toml добавьте feature_name = true в разделе [features].
• В CLI выполните codex --enable feature_name.
• Чтобы включить несколько функций, выполните codex --enable feature_a --enable feature_b.
• Чтобы отключить функцию, задайте для ключа значение false в config.toml.