環境変数¶

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`	macOS/Linux では `~/.local/bin`、Windows では `%LOCALAPPDATA%\Programs\OpenAI\Codex\bin`	表示される `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 キーを提供します。これは `codex exec` でのみサポートされます。リポジトリで管理されるコードを実行する場合は、ジョブ全体ではなくインラインで設定してください。
`CODEX_ACCESS_TOKEN`	CLI、app-server、信頼できるオートメーション	信頼できるオートメーションに ChatGPT または Codex のアクセストークンを提供します。永続的なログインには、`codex login --with-access-token` にパイプしてください。
`CODEX_CA_CERTIFICATE`	HTTPS、ログイン、WebSocket クライアント	企業の TLS インターセプションやプライベートルート CA がある環境向けに、PEM CA バンドルを指定します。`SSL_CERT_FILE` より優先されます。
`SSL_CERT_FILE`	HTTPS、ログイン、WebSocket クライアント	`CODEX_CA_CERTIFICATE` が設定されていない場合に使用する、フォールバックの PEM CA バンドルパスです。

プロバイダー API キーについては、モデルプロバイダーの設定で env_key を設定します。Codex はその設定で指定された変数を読み取るため、変数名自体は固定された Codex 環境変数ではありません。

オートメーションでのシークレットの扱いについては、 API キー認証を使用するを参照してください。アクセストークンの設定については、アクセストークンを参照してください。

変数	使用箇所	説明
`RUST_LOG`	CLI と app-server	Rust のログフィルタリングと詳細度を制御します。`codex exec` は、より詳細な値を設定しない限り、デフォルトで `error` の出力になります。

RUST_LOG は、error、warn、info、debug、trace などの値を受け付けます。また、codex_core=debug,codex_tui=debug のような、より対象を絞った Rust ロギングフィルターも受け付けます。

対話型 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 ログファイルに書き込む代わりに、メッセージをインラインで出力します。