Переменные окружения Codex - мощный, но тупой рычаг: они действуют глобально на процесс, поэтому место их задания важно не меньше значения. Важная оговорка справочника: OpenAI публикует только стабильные публичные переменные, которые Codex читает напрямую. Внутренние переключатели для разработки и тестов, а также произвольные имена секретов провайдеров сюда не входят - на них не полагаются как на документированный интерфейс, потому что они могут меняться без предупреждения.
Основные переменные касаются расположения состояния и установки. CODEX_HOME задаёт корень состояния - config, auth, sessions, skills, logs, - и по умолчанию это ~/.codex. Инсталляторы понимают CODEX_INSTALL_DIR, меняющий место видимой команды, и CODEX_NON_INTERACTIVE, отключающий подсказки при установке. Эти три переменные встречались в главах про установку и удаление и определяют, где живёт состояние и как проходит неинтерактивная установка.
Переменные диагностики и провайдера трогают точечно. RUST_LOG управляет уровнем отладочного логирования и включает подробный вывод для локальной диагностики - с той же оговоркой, что логи могут содержать чувствительное. Провайдерские и облачные переменные настраивают доступ к моделям через соответствующий deployment, но их точный набор и семантику сверяют с официальной страницей провайдера, а не переносят по аналогии с другими инструментами.
Полезно один раз свести публичные переменные в таблицу. Ниже - карта: расположение, установка, диагностика. Пользоваться ей стоит с общей оговоркой справочника: полный и точный список публичных переменных - на официальной странице, а всё, чего там нет, документированным интерфейсом не считают. Секреты при этом задают через окружение или secret store, а не в закоммиченном config, и место задания переменной выбирают так же осознанно, как её значение.
| Категория | Переменная | Назначение |
|---|---|---|
| Расположение | CODEX_HOME | Корень состояния (config, auth, sessions, logs); по умолчанию ~/.codex |
| Установка | CODEX_INSTALL_DIR | Место видимой команды (инсталляторы) |
| CODEX_NON_INTERACTIVE | Отключить подсказки при установке |
| Диагностика | RUST_LOG | Уровень отладочного лога (логи чувствительны) |
|---|
| Провайдер | provider/cloud-переменные | Доступ к моделям через deployment (сверять с офиц. страницей) |
|---|