환경 변수

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 key를 제공합니다. 이는 `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 key의 경우 모델 공급자 구성에서 env_key을 설정하세요. Codex는 해당 구성에서 지정한 이름의 변수를 읽으므로 변수 이름 자체는 고정된 Codex 환경 변수가 아닙니다.

자동화 시크릿 처리에 대해서는 API key 인증 사용을 참조하세요. 액세스 토큰 설정에 대해서는 액세스 토큰을 참조하세요.

변수	사용 주체	설명
`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 로그 파일에 기록하는 대신 메시지를 인라인으로 출력합니다.