Зачем настраивать Codex

Codex работает сразу после установки: песочница, разумные одобрения, модель по умолчанию. Но «из коробки» он ничего не знает о вашем проекте — какие команды безопасны, куда ему можно ходить в сеть, какие сервисы нужны для задачи и какие правила команды нельзя нарушать. Этот курс о том, как превратить общий инструмент в среду, собранную под ваш репозиторий и ваших коллег.

Симптомы того, что пора настраивать

• Агент через шаг спрашивает разрешения на одни и те же безобидные команды — php artisan test, npm run lint, git status.
• Наоборот, вы включили полный доступ, «чтобы не мешал», и теперь не уверены, что он не трогает .env и не ходит куда не надо.
• Для ревью хочется модель посильнее, для рутины — побыстрее, и каждый раз приходится вспоминать флаги.
• Агент не видит задачу в трекере, макет или схему базы, и вы копируете всё это в чат руками.
• В каждой сессии вы повторяете одни и те же инструкции про структуру проекта.

Каждый пункт решается не промптом, а конфигурацией.

Три слоя настройки

Конфигурация — что агенту можно и на чём он работает. Файл config.toml, профили, модели и провайдеры, песочница и профили прав, правила для команд (rules). Это первый модуль курса.

Инструкции — что агент должен знать о проекте. AGENTS.md вы уже писали в курсе «Codex с нуля»; здесь — как его масштабировать на большой репозиторий.

Расширения — новые возможности. MCP-серверы подключают внешние системы, навыки (skills) упаковывают повторяемую работу, плагины распространяют всё это одним пакетом, хуки встраивают проверки в жизненный цикл агента, субагенты делят работу и контекст, память переносит знания между сессиями. Это второй модуль.

Личное и командное

Почти у каждой настройки есть два уровня. Личный живёт в ~/.codex/ и касается только вас: любимая модель, тема терминала, свои MCP-серверы с личными токенами. Проектный лежит в репозитории — .codex/config.toml, .codex/rules/, AGENTS.md, .agents/skills/ — и попадает к каждому, кто клонирует проект.

Хорошее правило: всё, что описывает проект (команды сборки, безопасные префиксы команд, нужные инструменты), — в репозиторий и через ревью, как обычный код. Всё, что описывает вас или содержит секреты, — в личный конфиг. Проектные слои Codex загружает только для доверенных (trusted) проектов, об этом подробно в следующем уроке.

Как проходить курс

Уроки идут от простого к сложному, и каждый следующий опирается на предыдущие. Практика рассчитана на ваш рабочий репозиторий: удобнее всего завести отдельную ветку и складывать туда изменения конфигурации. К концу курса у вас будет собранная конфигурация, которую можно показать команде и положить в проект.

Документация Codex переехала на learn.chatgpt.com, а ключи конфигурации в 2026 году менялись не раз. Сверяйтесь со справочником конфигурации и с codex --help вашей версии — в уроках мы отмечаем места, где это особенно важно.