Environment variables
Settings Vendor docs
config
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| CODEX_ACCESS_TOKEN | string |
Provides a ChatGPT or Codex access token for trusted automation. For persisted login, pipe it to `codex login --with-access-token`.
|
docs ↗ | ||
| CODEX_API_KEY | string |
Provides an API key for a single non-interactive run. This is only supported in `codex exec`; set it inline rather than job-wide when running repository-controlled code.
|
docs ↗ | ||
| CODEX_CA_CERTIFICATE | string |
Points to a PEM CA bundle for environments with corporate TLS interception or private root CAs. Takes precedence over `SSL_CERT_FILE`.
|
docs ↗ | ||
| CODEX_HOME | string |
Sets the root for Codex state, including config, auth, logs, sessions, skills, and standalone package metadata. If you set it, the directory must already exist.
|
docs ↗ | ||
| CODEX_INSTALL_DIR | string |
Changes where the visible `codex` command is installed. The standalone package cache still lives under `CODEX_HOME/packages/standalone`.
|
docs ↗ | ||
| CODEX_NON_INTERACTIVE | string |
Set to `1`, `true`, or `yes` to skip installer prompts. Prompts use their default response, so use this for scripted installs and updates, not first-run setup.
|
docs ↗ | ||
| CODEX_SQLITE_HOME | string |
Sets where SQLite-backed state is stored. The `sqlite_home` config option takes precedence. Relative paths resolve from the current working directory.
|
docs ↗ | ||
| RUST_LOG | string |
Controls Rust log filtering and verbosity. `codex exec` defaults to `error` output unless you set a more verbose value.
|
docs ↗ | ||
| SSL_CERT_FILE | string |
Fallback PEM CA bundle path when `CODEX_CA_CERTIFICATE` is unset.
|
docs ↗ |