문제 해결
Codex CLI 오류 — Missing OPENAI_API_KEY, config.toml, stream error 해결
Codex CLI는 ~/.codex/config.toml을 읽고, 모델 프로바이더를 결정한 뒤, Responses API로 스트리밍합니다. 각 단계는 서로 다르게 실패합니다: 누락된 환경 변수, 잘못된 프로필, 만료된 로그인, 스트림 중간의 HTTP 오류. 아래 페이지는 이 순서대로 다룹니다.
| 오류 | 의미 |
|---|---|
Missing OPENAI_API_KEY | 프로바이더가 기대하는 환경 변수가 설정되어 있지 않으면 Codex가 시작을 거부합니다. config.toml의 env_key 동작 방식, export가 셸 사이에서 사라지는 이유, 작동하는 프로필. |
codex config.toml error | Codex는 잘못된 ~/.codex/config.toml을 로드하지 못합니다: 알 수 없는 프로바이더 이름, 잘못된 wire_api, 누락된 섹션. 커스텀 프로바이더에 필요한 정확한 구조. |
codex auth.json error | Codex 로그인 상태는 ~/.codex/auth.json에 있으며, 오래되거나 없는 파일은 로그인 프롬프트와 인증 실패를 만듭니다. 언제 재로그인해야 하고 언제 커스텀 프로바이더가 이를 완전히 건너뛰는지 설명합니다. |
stream error: unexpected status 401 Unauthorized | Codex에서 스트림 중간의 HTTP 실패는 stream error: unexpected status로 출력됩니다. 여기서 401, 404, 429가 무엇을 뜻하는지, 그리고 curl로 재현해 고장 난 쪽을 찾는 방법. |
Codex CLI Missing OPENAI_API_KEY — 커스텀 프로바이더 설정 방법
프로바이더가 기대하는 환경 변수가 설정되어 있지 않으면 Codex가 시작을 거부합니다. config.toml의 env_key 동작 방식, export가 셸 사이에서 사라지는 이유, 작동하는 프로필.
Codex config.toml 오류 — 작동하는 model_providers 설정
Codex는 잘못된 ~/.codex/config.toml을 로드하지 못합니다: 알 수 없는 프로바이더 이름, 잘못된 wire_api, 누락된 섹션. 커스텀 프로바이더에 필요한 정확한 구조.
Codex auth.json / 로그인 오류 — API 키 인증으로 해결
Codex 로그인 상태는 ~/.codex/auth.json에 있으며, 오래되거나 없는 파일은 로그인 프롬프트와 인증 실패를 만듭니다. 언제 재로그인해야 하고 언제 커스텀 프로바이더가 이를 완전히 건너뛰는지 설명합니다.
Codex stream error: unexpected status 401/404 해결 방법
Codex에서 스트림 중간의 HTTP 실패는 stream error: unexpected status로 출력됩니다. 여기서 401, 404, 429가 무엇을 뜻하는지, 그리고 curl로 재현해 고장 난 쪽을 찾는 방법.