Переменные среды
Переменные среды, поддерживаемые Codex
Codex использует config.toml для постоянных настроек. Используйте переменные среды для
переопределений в рамках оболочки, секретов автоматизации, управления поведением установщика или диагностики.
На этой странице перечислены стабильные общедоступные переменные среды, которые Codex считывает напрямую.
Здесь не перечислены внутренние переменные для разработки, тестовые переменные или
выбранные вами имена секретов для конкретных поставщиков, заданные с помощью
env_key.
Основные расположения
| Переменная | Где используется | Значение по умолчанию | Описание |
|---|---|---|---|
CODEX_HOME |
CLI, расширение IDE, app-server, установщики | ~/.codex |
Задаёт корневой каталог для состояния Codex, включая конфигурацию, аутентификацию, журналы, сеансы, навыки и метаданные автономного пакета. Если вы задаёте его, каталог уже должен существовать. |
CODEX_SQLITE_HOME |
Состояние CLI и app-server | CODEX_HOME |
Задаёт расположение состояния на основе SQLite. Параметр конфигурации sqlite_home имеет приоритет. Относительные пути разрешаются от текущего рабочего каталога. |
Подробнее о файлах, хранящихся в CODEX_HOME, см. в разделе
Расположение конфигурации и состояния.
Переменные установщика
Эти переменные применяются к автономным сценариям установки, доступным по адресам
https://chatgpt.com/codex/install.sh и
https://chatgpt.com/codex/install.ps1.
| Переменная | Значение по умолчанию | Описание |
|---|---|---|
CODEX_NON_INTERACTIVE |
false |
Установите значение 1, true или yes, чтобы пропустить запросы установщика. Для запросов используются ответы по умолчанию, поэтому применяйте эту переменную для установки и обновления по сценарию, а не для первоначальной настройки. |
CODEX_INSTALL_DIR |
~/.local/bin в macOS/Linux; %LOCALAPPDATA%\Programs\OpenAI\Codex\bin в Windows |
Изменяет расположение, в которое устанавливается доступная пользователю команда codex. Кэш автономного пакета по-прежнему находится в CODEX_HOME/packages/standalone. |
Для автоматической установки задайте CODEX_NON_INTERACTIVE=1 в оболочке, которая запускает
загруженный установщик:
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh$env:CODEX_NON_INTERACTIVE=1; irm https://chatgpt.com/codex/install.ps1 | iexАутентификация и сеть
| Переменная | Где используется | Описание |
|---|---|---|
CODEX_API_KEY |
codex exec |
Предоставляет API key для однократного неинтерактивного запуска. Поддерживается только в codex exec; при выполнении кода, управляемого репозиторием, задавайте переменную непосредственно для команды, а не для всего задания. |
CODEX_ACCESS_TOKEN |
CLI, app-server, доверенная автоматизация | Предоставляет токен доступа ChatGPT или Codex для доверенной автоматизации. Для сохранения учётных данных передайте его в codex login --with-access-token через канал. |
CODEX_CA_CERTIFICATE |
Клиенты HTTPS, входа и WebSocket | Указывает на пакет сертификатов PEM CA для сред с корпоративным перехватом TLS или частными корневыми CA. Имеет приоритет над SSL_CERT_FILE. |
SSL_CERT_FILE |
Клиенты HTTPS, входа и WebSocket | Резервный путь к пакету сертификатов PEM CA, используемый, если CODEX_CA_CERTIFICATE не задана. |
Для API key поставщика задайте
env_key в конфигурации поставщика модели.
Codex считывает переменную, имя которой указано в этой конфигурации, поэтому само имя
не является фиксированной переменной среды Codex.
Об обработке секретов автоматизации см. в разделе Использование аутентификации с помощью API key. О настройке токена доступа см. в разделе Токены доступа.
Диагностика
| Переменная | Где используется | Описание |
|---|---|---|
RUST_LOG |
CLI и app-server | Управляет фильтрацией и подробностью журналов Rust. Для вывода codex exec по умолчанию используется error, если не задано более подробное значение. |
RUST_LOG принимает такие значения, как error, warn, info, debug и
trace. Также поддерживаются более точечные фильтры журналирования Rust, например
codex_core=debug,codex_tui=debug.
По умолчанию интерактивный CLI записывает диагностические данные в локальные хранилища ограниченного размера, однако
запись в текстовый файл codex-tui.log необходимо включить явно. Явно задайте log_dir, когда
для устранения неполадок требуется текстовый журнал:
RUST_LOG=debug codex -c log_dir=./.codex-log
tail -F ./.codex-log/codex-tui.logВ неинтерактивном режиме codex exec выводит сообщения непосредственно в поток вместо записи
в отдельный файл журнала TUI.