Codex에서 GPT-5.5를 찾을 수 없을 때: 404 오류 진단 방법
Codex에서 GPT-5.5가 없다는 오류가 뜨나요? 계정이나 API 키를 바꾸기 전에 로그인 방식, 적용된 모델, 제공업체와 설정 우선순위를 확인하세요.
Ofox 
Codex에서 gpt-5.5가 존재하지 않거나 접근 권한이 없다는 오류가 나오면 구독을 변경하기 전에 모델 ID, 제공업체, 인증 방식의 조합을 확인하세요. ChatGPT에 정상적으로 로그인했다고 해서 API 키로도 접근할 수 있는 것은 아닙니다. 제공업체의 키가 유효하더라도 해당 제공업체가 설정에 입력한 모델 ID를 지원한다는 뜻은 아닙니다.
이 글은 Codex CLI 세션에서 다음과 같은 오류가 발생하는 경우를 다룹니다.
unexpected status 404 Not Found: The model `gpt-5.5` does not exist or you do not have access to it.메시지에서 알 수 있는 것은 요청한 모델이며, 오류의 원인은 아닙니다. GPT-5.5 지원이 종료되었다는 증거도 아닙니다. 아래 절차는 2026년 9월 8일 확인한 Codex 공식 설정 및 인증 문서를 바탕으로 합니다. 모든 계정이나 제공업체에서 GPT-5.5를 사용할 수 있다는 의미는 아닙니다.
재설치에 앞서 연결 경로 확인하기
Codex 오류가 발생한 터미널에서 다음 확인 명령을 실행하세요.
codex --version
codex login status
codex --help버전과 인증 방식을 기록하세요. 실행한 디렉터리, 사용한 --model, --profile, -c 인수, IDE에서 세션을 시작했는지도 기록합니다. API 키, 액세스 토큰, auth.json 내용은 공유하지 마세요.
codex login status는 인증 상태를 보여 줍니다. 사용자 지정 제공업체에서 선택한 엔드포인트까지 모두 보여 주는 명령은 아니므로 제공업체 설정과 함께 확인해야 합니다.
| 사용하려는 연결 방식 | 먼저 확인할 항목 | 단정하면 안 되는 내용 |
|---|---|---|
| ChatGPT 로그인 | 올바른 계정·워크스페이스인지, 해당 세션에서 제공되는 모델인지 | ChatGPT를 구독하면 API에서도 같은 모델을 사용할 수 있다는 것 |
| OpenAI API 키 | 의도한 API 계정·프로젝트인지, 모델 이용 가능 여부와 OpenAI 엔드포인트 | ChatGPT 세션이 정상 작동하므로 이 API 키에도 접근 권한이 있다는 것 |
| 타사 제공업체 | 제공업체 URL, 해당 업체의 모델 ID, 키를 공급하는 환경 변수 | OpenAI 모델 ID나 OpenAI 키가 해당 제공업체에서도 그대로 작동한다는 것 |
OpenAI는 ChatGPT 구독을 통한 이용과 API 키를 통한 사용량 기반 이용의 차이를 문서로 설명합니다. 진단하는 동안 두 경로를 구분하세요.
Codex에 실제로 적용되는 설정 찾기
실행 명령이 여전히 다른 모델을 선택하고 있는데 사용자 설정만 수정하는 것은 흔한 실수입니다. 관련 설정 파일을 로컬에서 살펴보고 필요한 필드만 기록하세요.
model
model_provider
openai_base_url
model_providers.<provider>.base_url
model_providers.<provider>.env_key
model_providers.<provider>.requires_openai_auth현재 설정 기본 문서에 따르면 설정은 다음 순서로 우선 적용됩니다.
- CLI 플래그와
--config재정의. - 신뢰하도록 승인한 프로젝트의 설정. 작업 디렉터리에 가장 가까운 파일이 우선합니다.
--profile로 선택한 프로필 파일.~/.codex/config.toml의 사용자 설정.- 시스템 설정, 그리고 내장 기본값.
주의할 제한도 있습니다. 현재 고급 설정 문서에 따르면 프로젝트 설정에 있는 model_provider, model_providers, openai_base_url 등 제공업체 관련 키는 무시되며, 시작 시 경고가 표시됩니다. 제공업체 정의는 사용자 수준 설정에 두세요. 프로젝트는 모델을 비롯한 다른 허용 설정을 재정의할 수 있으므로 파일 하나만 확인하면 설정 불일치를 놓칠 수 있습니다.
현재 문서에 나오는 프로필 파일 경로는 ~/.codex/profile-name.config.toml입니다. 오래된 튜토리얼에서는 다른 프로필 구조를 사용할 수 있습니다. 어느 형식이든 복사하기 전에 설치된 버전을 확인하세요.
의도한 연결 방식에 맞게 수정하기
ChatGPT 로그인을 사용하려던 경우
계정과 워크스페이스를 확인한 다음 해당 세션에서 실제로 사용할 수 있는 모델을 선택하세요. 실행 명령이나 해당 값을 제공한 설정에서 더 이상 쓰지 않는 모델 지정 값을 제거하세요. 모델이 선택 목록에 없다면 gpt-5.5를 직접 입력하면 접근할 수 있다고 생각하지 말고, 계정에서 이용 가능한지 확인하세요.
활성 계정이 잘못되었거나 인증에 실패한 경우에만 다시 인증하세요. 모델 조회 오류가 발생했다고 해서 처음부터 Codex를 재설치하거나 인증 정보를 삭제할 필요는 없습니다.
OpenAI API 키를 사용하려던 경우
요청이 의도한 OpenAI 엔드포인트와 API 계정·프로젝트를 사용하는지 확인하세요. 요청한 ID와 해당 계정에서 현재 사용할 수 있는 모델을 비교합니다. OpenAI가 요청을 거부했다고 결론 내리기 전에 openai_base_url에 오래된 프록시 설정이 남아 있는지 확인하세요.
API 접근 권한과 과금은 ChatGPT 요금제에 포함된 사용량과 별개입니다. 같은 키로 다른 모델이 작동한다면 연결 경로를 확인하는 데 유용한 단서가 됩니다. 하지만 그것이 GPT-5.5에 대한 접근 권한을 입증하지는 않습니다.
타사 제공업체를 사용하려던 경우
URL, 모델 식별자, 키를 서로 맞는 한 세트로 확인하세요. 제공업체에 따라 네임스페이스가 포함된 모델 ID를 사용할 수 있습니다. 추측으로 접두사를 붙이거나 빼지 말고 해당 업체가 문서에 명시한 값을 사용하세요.
아래는 설정 템플릿입니다. 실제 작동하는 엔드포인트가 아니며 GPT-5.5 이용 가능 여부를 보장하지도 않습니다. 모델 ID와 URL의 예시 값을 제공업체에서 안내한 값으로 바꾸세요. 사용자 수준 설정에 항목을 넣되, 기존 섹션이 있다면 중복으로 만들지 말고 병합하세요.
model = "REPLACE_WITH_PROVIDER_MODEL_ID"
model_provider = "diagnostic_provider"
[model_providers.diagnostic_provider]
name = "My provider"
base_url = "https://api.example.com/v1"
env_key = "PROVIDER_API_KEY"
requires_openai_auth = false
wire_api = "responses"선택한 제공업체는 Responses API를 지원해야 합니다. 현재 Codex 설정 레퍼런스에서 지원하는 wire_api 값은 responses뿐입니다. Chat Completions만 제공하는 업체에는 이 템플릿을 사용할 수 없습니다. PROVIDER_API_KEY는 평소 사용하는 로컬 비밀 정보 관리 방식으로 설정하고, 공유하는 TOML 파일에 키를 붙여 넣지 마세요.
requires_openai_auth의 기본값은 false입니다. 여기서는 제공업체 키를 사용하는 경로임을 명확히 하려고 직접 적었습니다. 기존 제공업체 정의에서 이 값이 true라면 Codex는 OpenAI 인증을 사용하며 env_key를 무시합니다. 제공업체 키를 설정해도 효과가 없어 보일 때 이 항목을 확인하세요.
수정하기 전에 해당 설정 파일의 사본을 저장하세요. 관련 없는 설정은 유지합니다. 수정한 뒤에는 같은 디렉터리에서 새 세션을 시작하고 파일 편집을 요청하지 않는 간단한 프롬프트로 확인하세요. API 사용 요금이 발생할 수 있습니다. 변경으로 기존에 정상 작동하던 연결에 문제가 생기면 저장한 설정을 복원하세요.
전체 설정 과정은 Codex 사용자 지정 모델 제공업체 설정을 참고하세요. Ofox를 사용한다면 설정에 앞서 현재 모델 목록에서 정확한 ID와 지원 연결 방식을 확인하세요.
다음 응답으로 원인 좁히기
| 변경 후 결과 | 다음 단계 |
|---|---|
| 같은 모델 관련 404 | 실제 적용된 모델 ID, 호스트, 계정 접근 권한을 다시 확인하세요. 같은 요청을 반복해서 재시도하지 마세요. |
| HTML 404 또는 일반적인 경로 없음 응답 | 모델 권한 문제로 판단하기 전에 URL·경로 구성과 프록시 라우팅을 확인하세요. |
| 401 인증 오류 | 선택한 제공업체의 인증 정보를 확인하고 Codex 401 가이드를 따르세요. |
| 429 또는 사용량 제한 메시지 | 이제 모델 조회만이 문제가 아닙니다. 실제 할당량·요청 속도 제한 응답을 확인하세요. |
| 정상 응답 | 큰 작업을 재개하기 전에 의도한 계정·제공업체와 요청 기록을 확인하세요. |
직접 보낸 API 요청을 Codex와 비교하려면 호스트, 키, 모델, Responses 엔드포인트를 동일하게 맞추세요. 다른 호스트로 보낸 Chat Completions 요청이 성공했다고 해서 Codex만의 문제로 좁힐 수는 없습니다. 같은 경로의 직접 요청이 성공하면 Codex 설정이나 요청의 차이를 중심으로 살펴볼 수 있습니다. 다만 어떤 차이가 오류를 일으켰는지까지 입증되는 것은 아닙니다.
로컬에서 표시되는 model metadata ... not found 경고도 HTTP 404와는 다릅니다. 두 메시지의 원인이 같다고 가정하지 말고 최종 서버 응답을 기록하세요. Codex 이외의 SDK나 Azure 사례는 OpenAI 모델을 찾을 수 없을 때의 일반 오류 해결 가이드를 참고하세요.
지원을 요청할 때 포함할 정보
민감한 정보를 가린 보고서에 Codex 버전, 운영체제, 인증 유형, 선택한 모델·제공업체, 엔드포인트 호스트와 경로, 작업 디렉터리 관련 정보, 관련 시작 경고, 정확한 최종 오류를 담으세요. 제공업체가 요청 ID를 제공한다면 함께 넣습니다. 비밀 정보와 비공개 프롬프트는 제외하세요.
이 정보가 있으면 지원 담당자가 계정의 이용 가능 여부 문제인지, 오래된 재정의 설정이나 제공업체 불일치 문제인지 구분할 수 있습니다. 계정, 모델, 엔드포인트를 한꺼번에 바꾸면 처음 오류가 발생한 조건을 놓칠 수 있으므로, 먼저 이 정보를 정리하세요.
출처
자주 묻는 질문
- GPT-5.5에서 404 오류가 나면 모델이 삭제된 건가요?
- 오류 메시지만으로는 모델을 사용할 수 없는 것인지, 제공업체나 모델 ID가 잘못된 것인지, 계정에 접근 권한이 없는 것인지 구분할 수 없습니다. 요청 경로와 해당 계정에서 현재 이용할 수 있는 모델을 확인하세요.
- ChatGPT 구독에 API 요청 비용도 포함되나요?
- API 키로 Codex에 인증하면 ChatGPT 요금제에 포함된 사용량이 아니라 API 요금이 적용됩니다. 현재 세션에서 실제로 사용하는 인증 방식을 확인하세요.
- 문제를 해결하려면 auth.json을 삭제해야 하나요?
- 먼저 codex login status와 선택된 제공업체를 확인하세요. 인증 정보를 삭제해도 잘못된 모델 ID나 엔드포인트는 수정되지 않으며, 정상 작동하던 로그인이 끊길 수 있습니다.
