Codex CLI 401은 요청을 처리하는 서버가 인증을 거부했다는 뜻입니다. 가장 유용한 빠른 확인 방법은 대상 호스트, 선택한 제공업체, 자격 증명 출처를 함께 확인하는 것입니다. 빈 환경 변수도 가능한 원인 중 하나지만 모든 401의 원인은 아닙니다. 자신의 설정에 맞는 분기를 따르세요.
먼저 실패한 연결을 확인하세요
| 실패 지점 | 가능한 범위 | 첫 번째 확인 항목 |
|---|---|---|
| ChatGPT 로그인 또는 토큰 갱신 | 저장된 계정 세션 | 활성 로그인 및 의도한 워크스페이스 |
| OpenAI API 요청 | 플랫폼 자격 증명 및 프로젝트 | 키 유효성 및 프로젝트 액세스 |
| 사용자 지정 게이트웨이 요청 | 해당 제공업체의 구성 | 호스트, 제공업체 ID 및 지정된 환경 변수 |
| MCP 또는 외부 도구만 실패 | 해당 도구의 별도 로그인 | 도구 이름 및 인증 |
가능한 경우 상태, 오류 텍스트, 타임스탬프 및 요청 ID를 저장하세요. 세부 정보를 공유하기 전에 인증 헤더, 키 및 토큰을 제거하세요. 지원 티켓에 auth.json을 붙여 넣지 마세요. 자격 증명이 포함되어 있을 수 있습니다. 한 통합에서 발생한 오류만으로 모델 연결이 고장 났다고 결론 내릴 수는 없습니다.
1. CLI와 로그인 방법 확인
codex --version
codex login status
# POSIX shell: report presence only, without printing the secret
if [ -n "${KUNAVO_API_KEY:-}" ]; then
printf 'KUNAVO_API_KEY is set\n'
else
printf 'KUNAVO_API_KEY is missing or empty\n'
fiCodex를 실행하는 동일한 터미널에서 확인을 실행하세요. 제공업체가 다른 변수 이름을 사용한다면 존재 여부 확인 명령의 변수 이름을 env_key로 바꾸세요. “설정됨”은 값이 존재한다는 사실만 확인할 뿐, 해당 값이 최신이거나 대상에서 수락된다는 것을 입증하지는 않습니다.
새로 고침이 중단된 개인 ChatGPT 로그인이라면 codex logout을 실행한 다음 codex login을 실행하고, 의도한 계정으로 브라우저 절차를 완료하세요. 이는 저장된 로그인 상태를 변경하며 모든 사용자 지정 제공업체 오류에 필요한 단계는 아닙니다. 관리형 자동화에서는 관리자가 지정한 인증 방법을 따르세요. 공식 인증 가이드를 참조하세요.
2. API 키를 발급자 및 대상과 일치시키기
OpenAI Platform 키는 OpenAI API 경로에서 사용해야 합니다. Kunavo 키는 Kunavo 경로에서 사용해야 합니다. ChatGPT 브라우저 로그인에 성공했다고 해서 게이트웨이 키가 유효한 것은 아니며, 게이트웨이 잔액은 OpenAI Platform 잔액이 아닙니다. 무엇이든 교체하기 전에 오류에 표시된 실제 호스트를 확인하세요.
발급자의 대시보드에서 키가 아직 존재하고 활성 상태인지 확인하세요. 연결된 프로젝트와 액세스 제한도 확인하세요. OpenAI API 오류 참조에서는 인증 오류에 잘못된 자격 증명, 조직 멤버십 및 IP 허용 목록 실패가 포함됩니다. 함께 표시된 메시지를 바탕으로 수정 방법을 선택하세요. 키를 반복해서 생성해도 계정이나 네트워크 정책은 복구되지 않습니다.
3. Codex가 사용하는 제공업체 구성 확인
# Compare these non-secret fields with your intended provider.
model = "gpt-5-6-sol"
model_provider = "kunavo"
[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"
wire_api = "responses"선택한 model_provider은 제공업체 블록과 일치해야 합니다. env_key 필드는 변수 이름을 지정할 뿐 비밀 값을 포함하지 않습니다. 활성 구성과 프로필 또는 명령줄 재정의를 확인한 뒤 수정 후 Codex를 다시 시작하세요. 작동 중인 구성에 관련 없는 제공업체 블록을 복사해 덮어쓰지 마세요.
OpenAI의 구성 참조는 Responses 프로토콜을 설명합니다. /v1로 끝나는 기본 URL은 전체 /v1/responses 요청 URL과 다릅니다. 인증에 성공한 뒤에도 잘못된 경로는 엔드포인트 진단이 필요할 수 있습니다. 또한 requires_openai_auth도 확인하세요. 활성화되면 인증 가이드에 설명된 대로 OpenAI 인증이 env_key보다 우선합니다.
4. 한 가지를 변경하고 작은 작업 하나를 재시도
- 오류 세부 정보를 보존하고 선택한 경로를 확인하세요.
- 증거가 가리키는 로그인, 자격 증명 또는 제공업체 필드를 수정하세요.
- 영향을 받은 CLI 또는 편집기 프로세스를 다시 시작해 새 설정을 적용하세요.
- 긴 코딩 작업을 다시 시작하기 전에 작은 요청을 실행하세요.
- 오류가 계속되면 자격 증명이 아니라 수정한 오류와 요청 ID를 제공업체에 보내세요.
이후 발생한 429, 잔액 경고 또는 모델 누락 오류는 새로운 진단 분기입니다. 인증 수정 사항은 유지하고 다음 문제를 해결하세요. 모든 설정을 되돌릴 필요는 없습니다. Codex 제한 가이드에서 사례를 구분합니다. Kunavo 설정에서는 전체 Codex 통합을 사용하고 대시보드에서 키를 관리하세요.
자주 묻는 질문
Codex CLI 401은 무엇을 의미하나요?
요청을 받은 서버가 인증을 거부했다는 뜻입니다. 원인은 오래된 계정 세션, 유효하지 않거나 폐기된 키, 잘못된 제공업체로 전송된 자격 증명 또는 계정 제한일 수 있습니다. 자격 증명을 변경하기 전에 대상과 현재 인증 경로를 확인하세요.
codex login status로 사용자 지정 제공업체 키를 확인할 수 있나요?
CLI 로그인 상태는 보고하지만, 환경 변수 기반 사용자 지정 제공업체가 해당 키를 수락한다는 사실까지 입증하지는 않습니다. 해당 경로에서는 선택한 제공업체, 실행 프로세스의 env_key 변수, 제공업체의 계정 제어 설정을 확인하세요.
왜 한 터미널에서는 키가 작동하지만 IDE에서는 실패하나요?
프로세스마다 환경 변수, 프로필 또는 구성이 다를 수 있습니다. 변수를 설정하기 전에 시작한 편집기는 해당 변수를 상속하지 않을 수 있습니다. 선택한 제공업체와 실행 환경을 비교한 뒤 관련 설정을 수정하고 영향을 받은 프로세스를 다시 시작하세요.
인증 문제를 해결하려면 Codex 구성을 삭제해야 하나요?
먼저 잘못된 특정 로그인 또는 제공업체 설정부터 확인하세요. 전체 구성을 삭제하면 거부된 자격 증명 문제는 해결하지 못한 채 관련 없는 설정까지 제거할 수 있습니다. 구성을 보존하고 한 번에 하나씩 대상 설정만 수정하세요.
2026년 9월 17일에 공식 문서와 로컬 CLI 도움말을 확인했습니다. 이 확인 절차를 따르는 데 자격 증명을 공유할 필요는 없습니다.