환경 변수
환경 변수
Codex에서 지원하는 환경 변수
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 |
Exec, 검토, TypeScript SDK, 원격 exec-server | 비대화형 Codex 프로세스에 API key를 제공합니다. 리포지토리가 제어하는 코드를 실행할 때는 작업 전체에 설정하지 말고 인라인으로 설정하세요. |
CODEX_ACCESS_TOKEN |
CLI, app-server, 신뢰할 수 있는 자동화 | 신뢰할 수 있는 자동화에 ChatGPT 또는 Codex 액세스 토큰을 제공합니다. 로그인을 유지하려면 codex login --with-access-token으로 파이프하세요. |
OPENAI_FEDERATION_RULE_ID |
워크로드 ID | 워크로드에 구성된 페더레이션 규칙을 선택합니다. |
OPENAI_IDENTITY_TOKEN_FILE |
워크로드 ID | 현재 OIDC 토큰 또는 SPIFFE JWT-SVID가 포함된 파일의 절대 경로를 가리킵니다. |
OPENAI_WORKLOAD_IDENTITY_CONTEXT |
워크로드 ID | 클라이언트가 보고하는 감사 귀속에 사용할 범위가 제한된 JSON 식별자를 선택적으로 제공합니다. 인증이나 권한 부여에는 영향을 주지 않습니다. |
CODEX_CA_CERTIFICATE |
HTTPS, 로그인 및 WebSocket 클라이언트 | 기업 TLS 가로채기 또는 비공개 루트 인증서를 사용하는 환경의 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 로그 파일에 기록하는 대신
메시지를 인라인으로 출력합니다.