문제 해결 · Codex CLI
Codex CLI Missing OPENAI_API_KEY — 커스텀 프로바이더 설정 방법
프로바이더가 기대하는 환경 변수가 설정되어 있지 않으면 Codex가 시작을 거부합니다. config.toml의 env_key 동작 방식, export가 셸 사이에서 사라지는 이유, 작동하는 프로필.
표시되는 내용
Missing OPENAI_API_KEY발생 원인
- 프로바이더의 env_key가 지정한 환경 변수가 codex를 실행하는 셸에 설정되어 있지 않습니다. 커스텀 프로바이더에서는 변수 이름이 무엇이든 될 수 있으며 — 오류는 빠져 있는 그 변수의 이름을 표시합니다.
- 키가 다른 터미널에서 export되었거나, 이 셸이 한 번도 source하지 않은 프로필 파일에 추가되었습니다.
- 변수가 설정되어 있지만 비어 있으며, 이는 없는 것으로 간주됩니다.
- 사용 중인 프로필이 생각과 다른 프로바이더를 가리켜, Codex가 당신이 export한 것과 다른 변수를 찾고 있습니다.
해결 방법
- 프로필에 프로바이더를 선언하고, 그 env_key가 지정한 정확한 변수를 같은 셸에서 codex 실행 전에 export하세요.
- 실행 직전에 변수를 출력해 살아 있는지 확인하세요: export는 셸 단위이지 전역이 아닙니다.
- 어떤 프로바이더 — 그리고 어떤 env_key — 가 활성인지 모호하지 않도록 프로필 이름을 명시해 codex를 실행하세요.
이 게이트웨이용 작동하는 프로필
# ~/.codex/apitoken.config.toml
model = "gpt-5.6-sol"
model_provider = "apitoken"
[model_providers.apitoken]
name = "apiToken.sale"
base_url = "https://openai.api.apitoken.sale/v1"
wire_api = "responses"
env_key = "APITOKEN_API_KEY"
# then, in the same shell:
export APITOKEN_API_KEY="sk-pool-•••"
codex --profile apitoken관련 검색어
OPENAI_API_KEY environment variable not setcodex api key not found
자주 묻는 질문
Codex CLI를 실행하려면 OpenAI 계정 키가 필요한가요?+
아니요. 커스텀 모델 프로바이더에서는 env_key가 당신이 정한 아무 변수나 지정할 수 있고, 키는 그 프로바이더에서 옵니다 — OPENAI_API_KEY 자체는 기본 프로바이더의 변수일 뿐입니다.
키를 export했는데도 Codex가 여전히 없다고 합니다 — 왜죠?+
export는 셸 단위입니다. codex가 다른 터미널, 멀티플렉서 패널, IDE 태스크에서 실행되면 그 환경은 당신의 export를 본 적이 없습니다. codex가 실제로 실행되는 곳에 설정하세요.
키는 TOML과 셸 중 어디에 두어야 하나요?+
셸입니다. config.toml은 env_key를 통해 변수의 이름만 저장하므로 비밀 값이 설정 파일에 담기지 않습니다.