PurpleSchool — курсы программирования онлайн
  • Пути
    • Frontend React разработчик
    • Frontend Vue разработчик
    • Backend разработчик Node.js
    • Fullstack разработчик React / Node.js
    • Mobile разработчик React Native
    • Backend разработчик Golang
    • Devops инженер
    • Backend разработчик Python
  • Подписка
  • AI для кодаНовое
  • О нас
    • Отзывы
    • Реферальная программа
    • О компании
    • Контакты
  • Иконка открытия меню
    • PurpleFlow
    • Сообщество
    • PurpleПлюс
    • AI Собеседование
    • AI тренажёр
    • Проекты
PurpleSchool — платформа бесплатных roadmap и курсов для разработчиков
ютуб иконка
Telegram иконка
VK иконка
VK иконка
Курсы
ГлавнаяКаталог курсовFrontendBackendFullstack
Практика
КарьераПроектыPurpleПлюсPurpleMax
Материалы
БлогБаза знаний
Документы
Договор офертаПолитика конфиденциальностиПроверка сертификатаМиграция курсовРеферальная программа
Реквизиты
ИП Ларичев Антон АндреевичИНН 773373765379contact@purpleschool.ru

PurpleSchool © 2020 -2026 Все права защищены

  • Курсы
    • FrontendИконка стрелки
    • AI разработкаИконка стрелки
    • BackendИконка стрелки
    • DevOpsИконка стрелки
    • MobileИконка стрелки
    • ТестированиеИконка стрелки
    • Soft-skillsИконка стрелки
    • ДизайнИконка стрелки
    Иконка слояПерейти в каталог курсов
  • Бесплатно
    • Курсы
    • JavaScript Основы разработкиPython Основы PythonCSS CSS FlexboxКарта развитияВопросы для собеседований
    • База знанийИконка стрелки
    • Новостные рассылкиИконка стрелки
  • PurpleSchool — курсы программирования онлайн
    • Подписка
    • AI для кодаНовое
    • Сообщество
    Главная
    Сообщество
    config.toml в Codex: настройки и профили

    config.toml в Codex: настройки и профили

    Аватар автора config.toml в Codex: настройки и профили

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

    Иконка календаря19 ноября 2026
    CodexAI-инструментыНастройкаmiddleИконка уровня middle
    Картинка поста config.toml в Codex: настройки и профили

    Настройки Codex хранятся в файле ~/.codex/config.toml, а для отдельного проекта — в .codex/config.toml. Профили лежат рядом с основным файлом как ~/.codex/имя.config.toml и подключаются флагом --profile имя. Для разового изменения используйте флаг -c. Значения из профиля накладываются поверх основного файла, поэтому в нём нужны только отличия.

    Важное изменение: с Codex 0.134 старый формат [profiles.имя] внутри config.toml больше не работает. Ниже — актуальная схема.

    Где лежат настройки и что важнее

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

    1. флаги командной строки и --config;
    2. .codex/config.toml в проекте, если проект доверенный;
    3. профиль ~/.codex/имя.config.toml;
    4. основной файл ~/.codex/config.toml;
    5. управляемые настройки организации;
    6. системный файл /etc/codex/config.toml;
    7. значения по умолчанию.

    Проектные настройки загружаются только для доверенных проектов. Это защита: чужой репозиторий не должен менять поведение агента при открытии.

    Настройки общие для 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: он помогает заметить ошибки в конфигурации сразу.

    Если параметр не применяется, проверьте по порядку:

    1. нет ли флага или настройки проекта с более высоким приоритетом;
    2. считается ли проект доверенным;
    3. правильно ли называется файл профиля;
    4. нет ли устаревшей секции.

    Устаревшее значение approval_policy = "untrusted" может помешать запуску Codex: удалите его из настроек.

    Частые вопросы

    Где находится config.toml на Windows? В папке .codex внутри профиля пользователя, обычно %USERPROFILE%\.codex\config.toml.

    Можно ли сделать профиль по умолчанию? Настройка profile = "имя" больше не поддерживается. Базовые значения храните в config.toml, а профили выбирайте флагом.

    Можно ли хранить ключ в config.toml? Лучше использовать переменную окружения, а в файле указать только её имя.

    Изменится ли настройка в уже запущенной сессии? Для надёжности начните новую сессию.

    Итог

    Держите общие значения в config.toml, отличия — в профилях, настройки репозитория — в .codex/config.toml, а разовые изменения передавайте через -c. Как собрать рабочую конфигурацию под реальный проект, разбираем в курсе «Продвинутый Codex».

    Иконка глаза16

    Комментарии

    0
    Бесплатный курс

    Учитесь программировать с AI-агентом — бесплатно

    Курс «AI в обучении: OpenCode и skills»: поставите агента и разберёте с ним любую тему — как эту статью.

    opencode

    >объясни этот код и дай задачу

    ◆Читаю src/server.ts…

    ✓Разбор готов: 4 шага

    ✓Задача → practice/01.md

    • Установка и настройка OpenCode
    • Агент и skills на практике
    • 13 уроков, 3 модуля
    Начать бесплатно

    0 ₽ · доступ сразу после регистрации

    Бесплатные лекции

    Лучшие курсы по теме

    изображение курса

    Основы Git

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.9
    3 999 ₽ 6 990 ₽
    Подробнее
    изображение курса

    HTML и CSS

    Антон Ларичев
    AI-тренажерыAI-тренажеры
    Практика в студииПрактика в студии
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.9
    3 999 ₽ 6 990 ₽
    Подробнее
    изображение курса

    CSS Flexbox

    Антон Ларичев
    Гарантия
    Бонусы
    иконка звёздочки рейтинга4.9
    бесплатно
    Подробнее

    Похожие статьи

    Картинка поста /goal в Codex: как поручить агенту долгую задачу
    Иконка аватараАнтон
    Иконка календаря18 ноября 2026
    CodexAI-инструментыАвтоматизацияmiddleИконка уровня middle

    /goal в Codex: как поручить агенту долгую задачу

    Как работает /goal в Codex: включение, команды, формулировка цели с условием остановки и отличие от Ralph Loop.

    Иконка чипа0
    Иконка глаза80
    Иконка комментариев0
    Картинка поста Что такое Codex и как им пользоваться: руководство
    Иконка аватараАнтон
    Иконка календаря17 ноября 2026
    CodexOpenAIAI-инструментыjuniorИконка уровня junior

    Что такое Codex и как им пользоваться: руководство

    Что такое Codex от OpenAI, чем он отличается от чата, как поставить задачу и какие команды нужны в повседневной работе.

    Иконка чипа0
    Иконка глаза227
    Иконка комментариев0
    Картинка поста Ralph Loop в Codex: цикл, который работает до зелёных тестов
    Иконка аватараАнтон
    Иконка календаря16 ноября 2026
    CodexAI-инструментыАвтоматизацияmiddleИконка уровня middle

    Ralph Loop в Codex: цикл, который работает до зелёных тестов

    Что такое Ralph Loop и как собрать его для Codex на Bash: проверка, повторы, лимит итераций и защита от поломки проекта.

    Иконка чипа0
    Иконка глаза175
    Иконка комментариев0
    Иконка чипа0