Codex가 사용량 한도에서 중단되면 먼저 어떤 계정의 어떤 한도가 요청을 중단했는지 확인하세요. ChatGPT 허용량, API 잔액, 지출 상한, 요청 속도 제한은 각각 다른 해결책이 필요합니다. 크레딧을 구매하거나 설정을 바꾸기 전에 아래에서 일치하는 행을 찾아 의도한 작업 흐름을 복구할 수 있는 조치를 선택하세요.
메시지를 올바른 한도에 대응시키기
| 표시되는 내용 | 확인할 위치 | 유용한 다음 조치 |
|---|---|---|
| 요금제 사용량 소진 또는 재설정 시간 | Codex 사용량 대시보드 및 활성 계정 | 해당 재설정을 기다리거나 계정의 추가 사용 옵션 검토 |
| 크레딧 잔액 소진 | API 프로바이더의 결제 대시보드 | 실제로 요청을 받는 계정에 자금 충전 |
| 프로젝트 또는 조직의 지출 상한 도달 | 해당 프로젝트의 지출 제어 | 예산 담당자에게 상한 검토 요청 |
| 요청 또는 토큰이 너무 빠르게 유입됨 | 오류 세부 정보 및 재시도 안내 | 동시성을 낮추고 기다린 후 재시도 |
| 401 또는 잘못된 인증 | 로그인 방식, 프로바이더, 인증 정보의 출처 | 크레딧 추가 대신 인증 문제 해결 절차 따르기 |
OpenAI의 API 오류 참고 문서는 잔액, 지출, 속도, 인증 오류를 구분합니다. HTTP 상태뿐 아니라 실제 메시지도 읽으세요. 서로 다른 여러 오류가 같은 상태 코드를 공유할 수 있습니다. 사용자 지정 프로바이더는 자체 오류 이름을 사용할 수 있습니다.
카운터보다 먼저 계정 확인
# In your terminal: identify the CLI and login method
codex --version
codex login status
# Inside an active Codex CLI session:
/statusChatGPT 액세스의 경우 Codex 사용량 대시보드를 열고 CLI 로그인 계정과 비교하세요. OpenAI의 가격 문서는 로컬 작업과 클라우드 작업이 요금제 사용량을 공유하며 작업 크기와 모델 선택이 소비량에 영향을 준다고 설명합니다. 5시간 추정치는 보장된 메시지 수가 아니며 주간 한도도 적용될 수 있습니다.
재설정 시간과 차단된 작업을 기록하세요. 예를 들어 「작은 로컬 작업은 시작할 수 있지만 이 클라우드 작업은 사용할 수 없다」는 「Codex에 토큰이 없다」보다 유용합니다. 무엇을 복구해야 하는지 알려 주며 다른 작업 흐름에 필요한 옵션을 구매하는 일을 피할 수 있습니다. 관리형 작업 공간에서는 관리자에게 액세스를 확인할 때 작업 공간 이름도 포함하세요.
계속하는 방법 선택
- 기한을 기다릴 수 있다면: 현재 diff와 다음 단계에 대한 짧은 메모를 보존한 뒤 표시된 재설정 후 재개하세요.
- 요금제가 적합하지만 오늘 유난히 사용량이 많다면: 추가 크레딧을 확인하세요. OpenAI는 Plus와 Pro에 이 옵션을 문서화하고 있으며, 자격을 갖춘 비즈니스 요금제에는 별도의 작업 공간 설정이 있습니다.
- 이 문제가 반복된다면: 업그레이드하기 전에 더 높은 허용량의 비용과 최근 실제 작업량을 비교하세요.
- 로컬 작업에 사용량 기반 결제를 원한다면: 모델 액세스, 요금, 필요한 기능을 포함해 API 경로를 별도로 평가하세요.
API 경로에는 자체 잔액과 한도가 있습니다. 실패한 시도와 수정 작업을 위한 여유를 체험 예산에 남겨 두세요. 성공한 응답 하나만으로 작업 완료 비용을 알 수는 없습니다. Codex 가격 가이드는 API 키를 무제한 사용으로 간주하지 않고 결제 방식을 비교하는 데 도움을 줍니다.
재시도 폭주 없이 API 속도 제한 처리
먼저 병렬 재시도를 중지하세요. 프로바이더가 재시도 지연 시간을 제공하면 사용하고, 그렇지 않으면 시도 간격을 두며 재시도 루프에 상한을 설정하세요. OpenAI의 속도 제한 가이드는 백오프를 권장하며 실패한 요청도 분당 한도에 포함될 수 있다고 경고합니다. 결제 오류에는 결제 조치가 필요하므로 끝없이 재시도하면 원래 문제만 가려집니다.
그다음 작업량을 살펴보세요. 여러 터미널, 백그라운드 스크립트, IDE 확장이 모두 같은 API 프로젝트를 사용하고 있을 수 있습니다. 한 번에 하나의 출처만 일시 중지하세요. 모델, 키, 동시성을 동시에 바꾸는 것보다 통제된 단일 요청이 더 명확한 진단을 제공합니다.
다음 세션의 예산 관리를 쉽게 만들기
시작 전에 변경 사항과 승인 검사를 정의하세요. Codex가 관련 파일을 가리키도록 하고, 관련 없는 작업은 별도 작업으로 분리하며, 선택적 개선을 요청하기 전에 체크포인트를 검토하세요. 승인된 결과와 총 사용량을 함께 기록하세요. 이를 통해 요금제와 API 지출 중 어떤 방식이 프로젝트에 더 적합한지 판단할 실용적인 기준을 얻을 수 있습니다.
로컬 Codex CLI 작업에 Kunavo를 평가하려면 계정을 생성한 후 Responses 프로바이더 설정을 따르세요. 별도의 프로바이더 시험으로 취급하세요. Kunavo 잔액은 ChatGPT 사용량을 충전하거나 OpenAI 클라우드 기능을 잠금 해제하지 않습니다. 로그인이 거부되면 Codex 401 문제 해결 가이드를 사용하세요.
자주 묻는 질문
Codex 사용량 한도는 언제 재설정되나요?
계정의 Codex 사용량 대시보드 또는 /status에 표시된 재설정 시간을 확인하세요. 더 짧은 사용량 창과 주간 한도가 동시에 적용될 수 있습니다. 한 창의 재설정이 모든 한도가 재설정되었다는 뜻은 아닙니다.
새 API 키를 만들면 Codex 한도가 재설정되나요?
아니요. 인증 정보를 교체해도 ChatGPT 요금제의 사용량이나 API 프로젝트의 한도가 충전되거나 늘어나지 않습니다. 별도 청구되는 API 액세스를 선택하면 지원되는 로컬 작업의 청구 경로가 바뀔 뿐, 원래 계정이 재설정되지는 않습니다.
다른 사용자보다 적은 메시지를 보냈는데 왜 한도에 도달하나요?
메시지는 고정된 작업 단위가 아닙니다. 모델, 컨텍스트, 도구 활동, 작업 복잡도가 사용량에 영향을 줍니다. 다른 사람의 메시지 수를 허용량으로 간주하지 말고 같은 종류의 작업을 비교하며 계정의 사용량 표시를 확인하세요.
API 크레딧을 추가하면 401 오류가 해결되나요?
401 오류는 먼저 인증을 진단해야 합니다. 계정 또는 프로바이더, 인증 정보의 출처, 대상 호스트를 확인하세요. 잔액을 추가해도 거부된 인증 정보는 수정되지 않습니다. 잔액 또는 지출 오류에는 별도의 결제 조치가 필요합니다.
2026년 9월 17일 확인한 공식 문서입니다. 현재 허용량과 재설정 시간은 계정 대시보드에서 확인하세요.