Переменные среды
Переменные среды
Переменные среды, поддерживаемые 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 |
Exec, проверка, TypeScript SDK, удаленный exec-server | Предоставляет API key неинтерактивному процессу Codex. При выполнении кода, контролируемого репозиторием, задавайте его непосредственно для команды, а не для всей задачи. |
CODEX_ACCESS_TOKEN |
CLI, app-server, доверенная автоматизация | Предоставляет токен доступа ChatGPT или Codex для доверенной автоматизации. Для постоянного входа передайте его в codex login --with-access-token через канал. |
OPENAI_FEDERATION_RULE_ID |
Идентификация рабочей нагрузки | Выбирает правило федерации, настроенное для рабочей нагрузки. |
OPENAI_IDENTITY_TOKEN_FILE |
Идентификация рабочей нагрузки | Указывает абсолютный путь к файлу, содержащему текущий токен OIDC или SPIFFE JWT-SVID. |
OPENAI_WORKLOAD_IDENTITY_CONTEXT |
Идентификация рабочей нагрузки | При необходимости предоставляет ограниченные идентификаторы JSON для атрибуции аудита, сообщаемой клиентом. Не влияет на аутентификацию или авторизацию. |
CODEX_CA_CERTIFICATE |
Клиенты HTTPS, входа и WebSocket | Указывает набор сертификатов ЦС в формате PEM для сред с корпоративным перехватом TLS или частными корневыми сертификатами. Имеет приоритет над SSL_CERT_FILE. |
SSL_CERT_FILE |
Клиенты HTTPS, входа и WebSocket | Резервный путь к набору сертификатов ЦС в формате PEM, если 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.