環境變數
Codex 使用 config.toml 儲存持久設定；環境變數適合 shell 作用域覆蓋、自動化金鑰、安裝器行為或診斷。
本頁列出 Codex 會直接讀取的穩定公開環境變數。不列出內部開發變數、測試變數，也不列出你通過 env_key 自行選擇的提供方專屬 secret 名稱。
核心位置
| 變數 | 使用方 | 預設值 | 說明 |
|---|---|---|---|
CODEX_HOME |
CLI、IDE 擴充套件、app-server、安裝器 | ~/.codex |
設定 Codex 狀態根目錄，包括設定、認證、日誌、會話、技能和 standalone package 後設資料。如果設定該變數，目錄必須已經存在。 |
CODEX_SQLITE_HOME |
CLI 與 app-server 狀態 | CODEX_HOME |
設定 SQLite-backed 狀態的儲存位置。sqlite_home 設定項優先生效。相對路徑會從當前工作目錄解析。 |
關於 CODEX_HOME 下儲存的檔案，參見設定與狀態檔案位置。
安裝器變數
這些變數適用於從 https://chatgpt.com/codex/install.sh 和 https://chatgpt.com/codex/install.ps1 提供的 standalone 安裝指令碼。
| 變數 | 預設值 | 說明 |
|---|---|---|
CODEX_NON_INTERACTIVE |
false |
設為 1、true 或 yes 可跳過安裝器提示。提示會使用預設回答，因此它適合指令碼化安裝和更新，不適合作為首次設定的替代。 |
CODEX_INSTALL_DIR |
macOS/Linux 上為 ~/.local/bin；Windows 上為 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin |
改變可見 codex 命令的安裝位置。standalone package cache 仍位於 CODEX_HOME/packages/standalone。 |
如需無人值守安裝，請在執行下載後安裝器的 shell 中設定 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；執行儲存庫可控程式碼時，請內聯設定它，而不是在整個 job 範圍內設定。 |
CODEX_ACCESS_TOKEN |
CLI、app-server、受信任自動化 | 為受信任自動化提供 ChatGPT 或 Codex 存取令牌。若要持久登入，請把它通過管道傳給 codex login --with-access-token。 |
CODEX_CA_CERTIFICATE |
HTTPS、登入和 WebSocket 客戶端 | 指向 PEM CA bundle，用於存在企業 TLS interception 或 private root CA 的環境。優先順序高於 SSL_CERT_FILE。 |
SSL_CERT_FILE |
HTTPS、登入和 WebSocket 客戶端 | 當 CODEX_CA_CERTIFICATE 未設定時使用的備用 PEM CA bundle 路徑。 |
對於提供方 API keys，請在模型提供方設定中設定 env_key。Codex 會讀取該設定命名的變數，因此變數名本身並不是固定的 Codex 環境變數。
關於自動化 secret 處理，參見使用 API key 認證。關於 access token 設定，參見Access tokens。
診斷
| 變數 | 使用方 | 說明 |
|---|---|---|
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 檔案是 opt-in。需要用於排障的明文日誌時，請顯式設定 log_dir：
RUST_LOG=debug codex -c log_dir=./.codex-log
tail -F ./.codex-log/codex-tui.log在非互動模式下，codex exec 會內聯列印訊息，而不是寫入單獨的 TUI 日誌檔案。
來源：</zh-TW/docs/config-file/environment-variables> 更新時間：2026-07-10（UTC）