Codex 주요 오류와 해결 방법

1. 작업 진행 상황을 저장하고 다른 모델로 전환하거나 나중에 재시도하세요. OpenAI 서비스 상태도 확인하세요.
2. 기존 스레드만 계속 실패하면 인계 요약으로 새 스레드를 시작하세요. 모든 모델이 계속 실패하면 /feedback에 시간, 버전, 오류 유형을 제출하세요.

/model

1. 현재 계정, workspace, 사용량 페이지의 5시간/주간 복구 시각을 확인하세요.
2. 한도가 남아 있다면 진행 상황을 저장한 뒤 올바른 계정으로 다시 로그인하세요. 불일치가 지속되면 민감 정보를 가린 스크린샷과 시각을 남기세요.

API Key는 ChatGPT의 Codex 한도가 아닌 OpenAI Platform 요금과 한도를 사용합니다. 사용자 지정 provider는 자체 규칙도 확인하세요.

codex login status

codex logout
codex login

1. 로그인 방식을 확인하세요. ChatGPT 사용자는 먼저 재인증하세요. dummy 때문에 API Key를 새로 만들 필요는 없습니다.
2. 사용자 지정 provider나 API Key를 사용한다면 제공자 인증 설정을 확인하세요. dummy가 로컬 임시 값일 수도 있습니다.

codex login status

codex logout
codex login

1. 로그인 상태와 대상 provider를 확인하고 ChatGPT 로그인인지 API Key인지 구분하세요.
2. ChatGPT 사용자는 작업을 저장하고 다시 로그인하세요. API Key 사용자는 키 상태, 조직, 엔드포인트를 확인하세요.

API Key는 ChatGPT의 Codex 한도가 아닌 OpenAI Platform 요금과 한도를 사용합니다. 사용자 지정 provider는 자체 규칙도 확인하세요.

codex login status

codex logout
codex login

1. Doctor로 VPN, 프록시, DNS, 방화벽, 사용자 지정 CA를 확인하고 휴대폰 핫스팟과 비교하세요.
2. 같은 계정과 네트워크에서 CLI와 Desktop을 비교하세요. 둘 다 실패하면 서비스 상태와 사용자 지정 provider를 확인하세요.

codex doctor --summary

1. Doctor를 실행하고 다른 네트워크와 비교하세요. 프록시나 방화벽이 WSS를 허용하는지 확인하세요.
2. 현재 네트워크에서만 실패하면 DNS, 인증서, IPv4/IPv6 라우팅을 확인하세요. IPv6 영구 비활성화를 기본 해결책으로 삼지 마세요.

codex doctor --summary

1. 실제 적용된 사용자 설정의 openai_base_url, model_provider, provider의 base_url을 확인하세요.
2. 주소와 수신 프로세스가 여전히 필요한지 확인하세요. 설정을 백업한 뒤 오래된 값을 수정하고 재시작하세요. 공유 전 키와 비공개 주소를 지우세요.

printenv CODEX_HOME

$env:CODEX_HOME

1. 저장한 작업 요약으로 새 스레드를 시작하세요. 저장소 상태를 확인한 뒤 미완료 단계를 계속하세요.
2. 단계별로 docs/codex-handoff.md를 갱신하고 도구 출력을 줄이며 지속적인 규칙은 AGENTS.md에 저장하세요.

1. 같은 로그 구간에서 server_overloaded, context_window_exceeded 또는 연결 오류를 찾아 해당 절차를 따르세요.
2. 클라이언트를 업데이트하세요. 기존 스레드가 계속 멈추면 /compact 반복 대신 저장소와 인계 요약으로 새 스레드에서 재개하세요.

1. /permissions와 실제 작업 디렉터리를 확인하고 대상 파일이 쓰기 허용 범위 안에 있는지 확인하세요.
2. 채팅은 되지만 의존성 설치나 curl이 실패하면 명령의 network_access를 확인하세요. 작업에 필요한 권한만 조정하세요.

/permissions

1. 저장소 루트, worktree, Git 상태를 확인하고 실패 경로가 Git 메타데이터인지 확인하세요.
2. 편집과 테스트 후 해당 Git 작업에 허용된 승인 방식을 사용하거나 직접 터미널에서 커밋하세요. 잠금 삭제로 권한 오류를 해결할 수는 없습니다.

git rev-parse --show-toplevel
git status --short
git worktree list

1. IDE, Git 클라이언트, 터미널에 미완료 Git 작업이 있는지 확인하고 먼저 완료를 기다리세요.
2. Git 프로세스가 없고 잠금이 잔여 파일임을 확인한 뒤에만 해당 잠금을 수동 처리하세요. .git 전체를 삭제하지 마세요.

git rev-parse --show-toplevel
git status --short
git worktree list

1. MCP 서버 활성화 여부, 도구 목록, 인증 상태를 확인하세요. OAuth 서버는 mcp login을 다시 시도할 수 있습니다.
2. 계속 실패하면 환경 변수, 프로세스, 서버 로그를 확인한 뒤 프로토콜을 점검하세요. Codex 계정 로그인과 MCP 로그인은 별개입니다.

codex mcp list

codex mcp login SERVER_NAME

1. /status, CODEX_HOME, CLI 인수, 선택한 profile을 확인하세요. 프로젝트 설정은 신뢰한 프로젝트에서만 로드됩니다.
2. CLI → 프로젝트 → profile → 사용자 → 관리/시스템 → 기본값 순으로 확인하세요. provider와 인증 설정은 프로젝트 수준 재정의 허용 여부도 확인하세요.

printenv CODEX_HOME

$env:CODEX_HOME

1. 전역 지침과 현재 디렉터리 경로의 AGENTS.md / AGENTS.override.md를 확인하세요. 기본 병합 상한은 32 KiB입니다.
2. 수정 후 새 세션을 열고 Codex에 로드된 규칙을 요약하게 하세요. 작업 디렉터리와 CODEX_HOME도 확인하세요.

printenv CODEX_HOME

$env:CODEX_HOME

1. 버전과 모든 명령 경로를 비교하고 npm, Homebrew, standalone이 중복 설치되었는지 확인하세요.
2. 주 설치 방식을 확인하고 해당 버전을 업데이트하세요. npm EACCES는 디렉터리 소유권을 확인하고 무작정 sudo 재설치하지 마세요.

codex --version
command -v codex
type -a codex

codex --version
Get-Command codex -All
where.exe codex

1. 문제 클라이언트를 완전히 종료하고 다시 여세요. 업데이트 후 새 스레드로 테스트하세요.
2. CLI 비교 결과, 클라이언트 버전, 시각을 기록하세요. Windows 확장이 응답하지 않으면 네이티브 런타임을 확인하세요.

codex doctor --summary

1. 샌드박스 시작 실패 시 Codex를 재시작하고 공식 안내에 따라 elevated/unelevated 모드와 .sandbox/sandbox.log를 확인하세요.
2. 확장 무응답 또는 DLL 누락 시 C++ Build Tools와 x64 Redistributable을 확인하세요. .sandbox-secrets 내용은 공유하지 마세요.

codex doctor --summary

1. Setup은 인터넷으로 의존성을 설치할 수 있습니다. Agent 인터넷은 기본적으로 꺼져 있으므로 필요에 따라 환경 설정에서 허용하세요.
2. Secrets는 setup에서만 제공됩니다. 일반 export는 shell 간 유지되지 않습니다. 비민감 변수는 환경에 설정하고 secret을 저장소에 남기지 마세요.