Антон Ларичев

Настройки Codex хранятся в файле ~/.codex/config.toml, а для отдельного проекта — в .codex/config.toml. Профили лежат рядом с основным файлом как ~/.codex/имя.config.toml и подключаются флагом --profile имя. Для разового изменения используйте флаг -c. Значения из профиля накладываются поверх основного файла, поэтому в нём нужны только отличия.
Важное изменение: с Codex 0.134 старый формат [profiles.имя] внутри config.toml больше не работает. Ниже — актуальная схема.
Где лежат настройки и что важнее
Codex применяет значения в таком порядке, от самого важного:
- флаги командной строки и
--config; .codex/config.tomlв проекте, если проект доверенный;- профиль
~/.codex/имя.config.toml; - основной файл
~/.codex/config.toml; - управляемые настройки организации;
- системный файл
/etc/codex/config.toml; - значения по умолчанию.
Проектные настройки загружаются только для доверенных проектов. Это защита: чужой репозиторий не должен менять поведение агента при открытии.
Настройки общие для CLI и расширения редактора.
Базовый config.toml
Минимальный рабочий файл для запуска через своего провайдера:
model = "gpt-6-luna"
model_provider = "purpleschool"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
[model_providers.purpleschool]
name = "PurpleSchool"
base_url = "https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1"
env_key = "PURPLESCHOOL_API_KEY"
wire_api = "responses"Сам ключ в файл не записывается: env_key содержит только название переменной окружения. Получить ключ с оплатой в рублях можно в AI для кода от PurpleSchool.
Что означают основные поля:
| Поле | Назначение |
|---|---|
model | модель по умолчанию |
model_provider | провайдер |
model_reasoning_effort | глубина рассуждений |
approval_policy | когда спрашивать подтверждение |
sandbox_mode | что разрешено технически |
Как создать профиль
Профиль — это отдельный TOML-файл. Настройки пишутся на верхнем уровне, без секции [profiles.имя].
Быстрый профиль для простых задач, ~/.codex/fast.config.toml:
model = "gpt-6-luna"
model_reasoning_effort = "low"Профиль для глубокой проверки, ~/.codex/deep-review.config.toml:
model = "gpt-6.1-sol"
model_reasoning_effort = "high"
sandbox_mode = "read-only"
approval_policy = "on-request"Запуск:
codex --profile fast
codex exec --profile deep-review "Проверь текущие изменения" < /dev/nullНазвание может содержать буквы, цифры, дефисы и подчёркивания. Запуск с профилем мы проверили на Codex CLI 0.167.
Если у вас остались старые настройки, перенесите их в отдельные файлы и удалите из основного [profiles.имя] и строку profile = "имя".
Разовые изменения
Для одного запуска не нужно править файлы. Если есть отдельный флаг, используйте его:
codex --model gpt-6.1-solДля любого другого параметра подойдёт -c:
codex -c model_reasoning_effort='"high"'
codex -c sandbox_workspace_write.network_access=trueЗначение разбирается как TOML, поэтому строки нужно заключать в кавычки так, чтобы их не убрала оболочка.
Настройки проекта
Файл .codex/config.toml хранит то, что важно для конкретного репозитория:
model_reasoning_effort = "medium"
[sandbox_workspace_write]
network_access = falseНе храните здесь секреты: файл часто попадает в git. Общие инструкции для агента лучше писать в AGENTS.md, а config.toml оставить для настроек программы.
Роли субагентов лежат отдельно — в папке .codex/agents/.
Полезные разделы
MCP-серверы:
[mcp_servers.docs]
url = "https://example.com/mcp"
bearer_token_env_var = "DOCS_TOKEN"Подключение разобрано в статье MCP в Codex CLI.
Функции:
[features]
goals = trueСостояние всех функций показывает команда:
codex features listСубагенты:
[agents]
max_concurrent_threads_per_session = 4Как проверить результат
Запустите диагностику:
codex doctorА при запуске в скриптах полезен флаг --strict-config: он помогает заметить ошибки в конфигурации сразу.
Если параметр не применяется, проверьте по порядку:
- нет ли флага или настройки проекта с более высоким приоритетом;
- считается ли проект доверенным;
- правильно ли называется файл профиля;
- нет ли устаревшей секции.
Устаревшее значение approval_policy = "untrusted" может помешать запуску Codex: удалите его из настроек.
Частые вопросы
Где находится config.toml на Windows? В папке .codex внутри профиля пользователя, обычно %USERPROFILE%\.codex\config.toml.
Можно ли сделать профиль по умолчанию? Настройка profile = "имя" больше не поддерживается. Базовые значения храните в config.toml, а профили выбирайте флагом.
Можно ли хранить ключ в config.toml? Лучше использовать переменную окружения, а в файле указать только её имя.
Изменится ли настройка в уже запущенной сессии? Для надёжности начните новую сессию.
Итог
Держите общие значения в config.toml, отличия — в профилях, настройки репозитория — в .codex/config.toml, а разовые изменения передавайте через -c. Как собрать рабочую конфигурацию под реальный проект, разбираем в курсе «Продвинутый Codex».






Комментарии
0