frontmatter

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 ↗