문제 해결 · Codex CLI
Codex auth.json / 로그인 오류 — API 키 인증으로 해결
Codex 로그인 상태는 ~/.codex/auth.json에 있으며, 오래되거나 없는 파일은 로그인 프롬프트와 인증 실패를 만듭니다. 언제 재로그인해야 하고 언제 커스텀 프로바이더가 이를 완전히 건너뛰는지 설명합니다.
표시되는 내용
codex auth.json error발생 원인
- auth.json이 없거나, 읽을 수 없거나, 오래되어 기본 프로바이더에 작동하는 로그인이 없습니다.
- 로그인이 세션이 기대하는 것과 다른 계정 또는 요금제 상태의 것입니다 — 토큰 갱신이 더 이상 성공하지 않습니다.
- 실패가 잘못 귀속된 경우입니다: 커스텀 프로바이더와 env_key를 쓸 때 ChatGPT 로그인 상태는 무관하며, 진짜 문제는 환경 변수나 프로필입니다.
해결 방법
- 기본 프로바이더라면 로그인 플로를 다시 실행해 auth.json이 새로 작성되게 하세요.
- 커스텀 프로바이더에서는 auth.json이 관여하지 않습니다: 인증은 env_key 변수입니다. 프로필이 실제로 선택되어 있는지, 변수가 실행 중인 셸에 설정되어 있는지 확인하세요.
- 두 경로를 머릿속에서 분리해 두세요 — 기본 프로바이더는 구독 로그인, 커스텀 프로바이더는 API 키. 한쪽의 오류는 다른 쪽에서 고쳐지지 않습니다.
관련 검색어
codex not logged incodex login failed
자주 묻는 질문
Codex의 커스텀 프로바이더는 auth.json을 사용하나요?+
아니요. [model_providers.*] 항목은 env_key가 지정한 환경 변수로 인증합니다. auth.json은 기본 ChatGPT 로그인만 담습니다.
Codex가 왜 계속 로그인하라고 하나요?+
저장된 로그인 상태를 갱신할 수 없기 때문입니다. 재로그인해 다시 쓰거나 — 커스텀 프로바이더를 쓰려던 것이라면 로그인이 필요 없도록 프로필을 명시적으로 선택하세요.
ChatGPT 구독 없이 Codex를 실행할 수 있나요?+
네 — 커스텀 프로바이더 프로필과 그 프로바이더의 API 키가 환경에 있으면, Codex는 전적으로 API 키 인증으로 실행됩니다.