Codex 액세스 토큰을 갱신하지 못할 때: 실제 실행 호스트에서 인증을 다시 만드세요

AI Free API Team

•2026년 8월 25일•4 min read•OpenAI Codex

브라우저에서 로그아웃하는 것만으로는 부족할 수 있습니다. 오류를 낸 프로세스와 자격 증명 저장소를 찾고, 한 번 다시 인증한 뒤 실제 작업으로 확인하세요.

Codex 액세스 토큰 갱신 실패를 실제 실행 호스트의 인증 경계에서 복구하고 작은 작업으로 확인하는 흐름

“Your access token could not be refreshed. Please log out and sign in again”은 현재 Codex 프로세스가 저장된 세션으로 더 이상 요청을 이어갈 수 없다는 뜻입니다. 하지만 이 문장만으로 리프레시 토큰이 이미 사용됐는지, 폐기됐는지, 다른 계정으로 전환하면서 무효화됐는지까지는 알 수 없습니다. 로컬이 아닌 다른 호스트의 오래된 자격 증명을 읽는 경우도 있습니다.

따라서 여러 환경에서 동시에 로그아웃하거나 .codex 전체를 지우기 전에 한 가지를 분명히 해야 합니다. 지금 오류를 낸 Codex 프로세스는 어디서 실행되고, 어떤 저장소의 인증 정보를 사용하고 있는가?

인증을 바꾸기 전에 작업 상태부터 보존하세요

인증 오류가 이미 작성된 파일을 되돌리지는 않습니다. 손실은 대개 여러 창에서 같은 작업을 중복 실행하거나, 캐시를 지운다는 이유로 프로젝트 파일까지 건드릴 때 생깁니다.

먼저 다음을 기록합니다.

저장소의 미커밋 변경 사항
개인 정보와 비밀을 지운 전체 오류 문구
발생 시간과 시간대
Codex App, CLI, IDE 중 어떤 표면인지와 버전
프로젝트 경로와 마지막으로 완료된 동작

auth.json, access token, refresh token, API key, OTP, Cookie, 정리되지 않은 HAR는 게시물이나 지원 채팅에 올리지 마세요. OpenAI 인증 문서는 파일 기반 auth.json에 액세스 토큰이 들어 있으므로 비밀번호처럼 다루라고 안내합니다.

화면이 있는 컴퓨터와 실행 호스트를 구분하세요

노트북에 VS Code 창이 보여도 extension host는 Remote SSH 서버에 있을 수 있습니다. 터미널은 WSL이나 dev container 안일 수 있고, 별도 에이전트나 gateway는 Codex CLI와 다른 OAuth profile을 가질 수 있습니다.

오류가 보이는 곳	먼저 확인할 인증 경계	로그아웃 증거가 아닌 것
Codex App	App의 현재 profile과 로컬 자격 증명 저장소	다른 브라우저 profile의 ChatGPT 로그아웃
Codex CLI	해당 shell의 OS 사용자와 `CODEX_HOME`	웹 ChatGPT가 정상인 상태
IDE 확장	extension host가 local인지 remote인지	에디터 UI만 재설치한 것
WSL, SSH, container, VM	그 환경 안의 home 또는 keyring	호스트 PC에서만 로그아웃한 것
외부 harness	그 도구의 자체 auth profile	독립 Codex CLI가 정상인 상태

공식 문서에 따르면 Codex CLI와 IDE 확장은 캐시된 로그인 정보를 공유할 수 있습니다. 저장 위치는 ~/.codex/auth.json일 수도 있고 OS 자격 증명 저장소일 수도 있습니다. 그래서 파일을 추측해 수동 삭제하는 것보다 지원되는 logout을 먼저 쓰는 편이 안전합니다.

외부 harness에서만 오류가 난다면 그 도구의 profile도 별도로 확인해야 합니다. 다만 직접 Codex 복구가 우선이며, OpenClaw 같은 다른 제품의 캐시 삭제법을 Codex 공식 절차로 섞어서는 안 됩니다.

CLI와 IDE의 저장 자격 증명을 다시 만드세요

오류를 낸 프로세스가 실제로 실행되는 환경에서 현재 인증 방식을 확인합니다.

bash
codex login status

이 명령은 자격 증명 존재 여부와 활성 인증 모드를 보여 줍니다. ChatGPT 구독으로 로그인했다고 생각했지만 실제로는 API key를 쓰는 경우, Remote SSH에서 다른 OS 사용자로 실행되는 경우를 여기서 발견할 수 있습니다. 다만 status 성공은 실제 모델 요청 성공을 보장하지 않습니다.

그다음 저장된 인증을 지원되는 명령으로 지우고 다시 로그인합니다.

bash
codex logout
codex login

브라우저에서 의도한 ChatGPT 계정과 workspace를 확인합니다. 완료되면 codex login status를 다시 실행하세요.

현재 OpenAI Developer commands는 codex logout이 저장된 ChatGPT 및 API-key 자격 증명을 제거한다고 설명합니다. CLI와 IDE가 캐시를 공유하더라도 이미 실행 중인 extension host는 오래된 상태를 붙잡고 있을 수 있으므로 IDE를 완전히 종료했다가 다시 엽니다.

Codex App에서는 profile 메뉴에서 계정 또는 API key 상태를 확인하고 App 안에서 로그아웃합니다. App을 완전히 종료한 뒤 다시 실행해 의도한 방식으로 로그인하세요. 한 브라우저의 chatgpt.com에서 로그아웃한 것만으로 App의 로컬 자격 증명이 사라졌다고 볼 수 없습니다.

API key 로그인은 ChatGPT 로그인 오류를 우회하는 만능 수단이 아닙니다. API 사용량은 Platform 계정에 청구되고, ChatGPT workspace나 cloud 기능에 의존하는 일부 기능은 제한될 수 있습니다. 원래 사용하려던 인증 경로가 무엇인지 먼저 확정해야 합니다.

새 로그인 자체가 끝나지 않는다면

오래된 자격 증명을 지운 뒤 브라우저가 Codex로 돌아오지 못한다면 문제는 token refresh에서 새 로그인 단계로 이동했습니다.

Remote SSH나 headless CLI에서는 로컬 콜백 엔드포인트를 사용할 수 없을 수 있습니다. 계정 또는 workspace에서 허용한다면 device code 흐름을 사용합니다.

bash
codex login --device-auth

표시된 링크를 열고 로그인한 다음 일회용 code를 입력합니다. code를 다른 사람에게 보내지 마세요. 기능이 꺼져 있으면 개인 보안 설정이나 workspace 관리자가 활성화해야 합니다.

회사 네트워크가 TLS proxy 또는 private root CA를 사용한다면 공식 가이드는 신뢰할 PEM bundle을 지정하는 CODEX_CA_CERTIFICATE를 제공합니다. 직접 실행한 codex login은 설정된 로그 디렉터리에 codex-login.log도 작성합니다. callback, 인증서, 브라우저 로그인을 진단할 때 유용하지만 공유 전에 token, 이메일, workspace 식별자와 비공개 경로를 제거해야 합니다.

관리형 환경은 ChatGPT 또는 API key 방식을 강제하거나 특정 ChatGPT workspace만 허용할 수 있습니다. 새 계정이 즉시 거부되거나 로그아웃되면 로컬 캐시를 계속 지우지 말고 관리자에게 membership, provisioning, 허용 인증 방식, 대상 workspace를 확인하세요.

workload identity를 쓰는 환경에서는 프로세스가 인증을 공급하므로 사용자 codex login과 codex logout이 거부됩니다. 이때 고칠 대상은 로컬 파일이 아니라 identity provider, federation rule, runtime 환경입니다.