Codex CLI 설정 가이드
Codex CLI는 터미널에서 사용하는 Codex입니다. 로컬 프로젝트에서 코드를 읽고, 파일을 수정하며, 테스트를 실행하고, 에러를 분석하는 데 적합합니다. 데스크톱 클라이언트 설정은 Codex 클라이언트 페이지를 참고하시고, 본 섹션에서는 터미널 CLI만 다룹니다.
공식 정보 다운로드 및 문서는 공식 사이트를 기준으로 합니다.
이 도구의 역할과 용도
터미널 Codexconfig.toml커스텀 Provider프로젝트 내 사용
설정 파일 위치
| 운영체제 | 예시 경로 | 설명 |
|---|---|---|
| Windows | C: \Users\YourUsername\. codex\config.toml | 사용자명을 본인 컴퓨터의 계정 이름으로 변경하세요 |
| macOS / Linux | ~/. codex/config.toml | 해당 파일이 없으면 새 config.toml 파일을 생성하세요 |
커스텀 Provider 작성 방법
공식 계정만 사용하는 경우 먼저 공식 로그인 절차를 따르세요. Provider가 Codex / OpenAI 호환 설정을 명시적으로 제공하는 경우에만 커스텀 Provider를 추가하세요.
Codex CLI 로그인 테스트
codex login codex "Please reply only: Configuration successful"config.toml 예시
model = "MODEL_ID_FROM_PROVIDER_DASHBOARD" model_provider = "mz_proxy" [model_providers.mz_proxy] name = "Example AI Provider" base_url = "https://YOUR_PROVIDER_API_URL" env_key = "MZ_PROXY_API_KEY" wire_api = "responses"| 설정 항목 | 입력 방법 | 주의사항 |
|---|---|---|
| model | Provider 관리 페이지의 모델 목록에 있는 모델 ID / 모델명 | 임의로 표시명을 지정하지 말고, 대소문자, 하이픈, 마침표를 임의로 변경하지 마세요 |
| model_provider | 아래 Provider 섹션의 이름 | [model_providers.xxx]의 xxx 부분과 반드시 일치해야 합니다 |
| base_url | Provider 관리 페이지에서 제공하는 API 주소 | Provider의 예시에 따라 /v1 포함 여부를 결정하세요 |
| env_key | 로컬 환경 변수 이름 | 여기에는 키 값을 직접 넣지 말고 변수 이름만 입력하세요 |
| wire_api | 인터페이스 프로토콜 | 공식 Codex 문서 및 Provider 안내에 따라 선택하세요 |
키 설정 및 테스트
위의 env_key는 변수 이름일 뿐이며, 실제 API Key는 로컬 환경 변수에 저장해야 합니다. 먼저 임시로 설정하여 테스트를 진행하고 정상 작동을 확인한 후 영구 저장을 고려하세요.
PowerShell에서 임시 테스트
$env:MZ_PROXY_API_KEY = "YOUR_KEY" codex "Please reply only: Configuration successful"터미널에서 임시 테스트
MZ_PROXY_API_KEY="YOUR_KEY" codex "Please reply only: Configuration successful"TOML 파일에서 model과 model_provider는 파일 최상단에 배치해야 하며, [model_providers.xxx] 섹션 하단에 덧붙이지 마세요.
Codex CLI 공식 문서 공식 Codex CLI 시작 가이드를 확인하세요.
Codex 설정 기본 가이드 config.toml 파일 위치와 적용 범위를 확인하세요.
Codex 설정 레퍼런스 model_providers, base_url, env_key 등 필드 상세 정보를 확인하세요.