Codex 사용량 제한에 도달했을 때 해결 방법

Codex에 “usage limit reached”가 표시되면 결제하기 전에 남은 사용량과 초기화 시간을 확인하세요. ChatGPT 구독으로 사용 중이라면 해당 한도가 회복될 때까지 기다리거나, 계정에서 지원하는 추가 크레딧을 구매하거나, 상위 요금제를 검토할 수 있습니다. 지원되는 로컬 작업은 별도 요금이 청구되는 API 키로도 실행할 수 있습니다.

구독 한도, API 속도 제한, API 잔액 부족은 해결법이 다릅니다. 키를 추가한다고 구독 한도가 충전되거나 Codex cloud 이용 권한이 늘어나지는 않습니다.

먼저 어떤 제한인지 확인하세요

로그인 방식과 전체 오류 메시지부터 확인하세요. ChatGPT 구독 경고는 로그인한 계정에, API 오류는 요청을 처리하는 조직·프로젝트·게이트웨이에 해당합니다.

HTTP 429만 보고 속도 제한이라고 단정하면 안 됩니다. OpenAI의 오류 문서는 credit_balance_exhausted, project_spend_limit_exceeded에도 429를 사용하며 상위 오류 유형은 insufficient_quota일 수 있습니다. 재시도한다고 잔액이 생기지는 않습니다. 게이트웨이마다 오류 이름이 다를 수 있으니 실제 응답을 읽어야 합니다.

실제 속도 제한이라면 Retry-After를 우선 따르세요. 이 헤더가 없으면 무작위 대기 시간을 더한 지수 백오프를 사용하고 재시도 횟수를 제한하세요. OpenAI는 실패한 요청도 분당 한도에 포함될 수 있다고 설명합니다. 빠른 반복 요청은 복구에 도움이 되지 않습니다.

Codex 사용량 확인과 초기화 시간

ChatGPT 구독을 사용한다면 개발에 쓰는 계정과 워크스페이스의 Codex 사용량 대시보드를 여세요. 실행 중인 Codex CLI에서는 다음을 입력할 수 있습니다.

/status

공식 요금 안내는 두 확인 방법을 모두 설명합니다. CLI에 저장된 인증 방식을 확인하려면 다음 명령을 실행하세요.

codex login status

사용자 지정 공급자를 설정했다면 현재 선택된 model_provider, 모델, API 주소도 확인해야 합니다. ChatGPT 로그인 정보가 저장되어 있다는 사실만으로 해당 요청이 구독에 청구된다고 판단할 수는 없습니다. API 요청은 실제 공급자의 사용 기록으로 청구 위치를 확인하세요.

5시간 한도와 주간 한도는 다릅니다

OpenAI가 공개하는 수치는 5시간당 로컬 메시지 수의 추정 범위이며, 주간 제한이 추가로 적용될 수 있습니다. 로컬 메시지와 클라우드 작업은 요금제의 사용량을 공유합니다. 매일 정해진 횟수를 쓸 수 있다는 뜻이 아닙니다. 모델, 작업 난이도, 누적 문맥, 추론, 도구 사용이 모두 소비량에 영향을 줍니다.

짧은 시간 구간의 한도가 초기화되어도 별도 주간 한도가 회복됐다고 볼 수는 없습니다. 각각의 표시 시간을 확인하세요. 여기서 확인한 공식 문서는 모든 계정이 월요일 자정에 초기화된다는 공통 규칙을 제시하지 않습니다.

“Codex 주간 한도 초기화”를 찾고 있다면 다른 사람의 스크린샷보다 본인 계정의 주간 한도 옆 시간을 기준으로 삼으세요. 같은 열 개의 메시지도 간단한 질문과 대규모 코드 수정에서 소비량이 달라집니다.

제한에 도달한 뒤 선택할 수 있는 방법

바로 작업을 재개해야 하는지, 클라우드 기능이 필요한지부터 판단하세요.

OpenAI는 현재 Plus와 Pro 사용자가 한도에 도달한 후 추가 크레딧을 구매할 수 있다고 안내합니다. 유연한 요금제를 사용하는 적격 Business·Edu·Enterprise 워크스페이스도 크레딧을 구매할 수 있습니다. 실제 구매 가능 여부는 본인 계정에서 확인하세요.

같은 문서는 진행 중인 turn에서 한도에 도달해도 공정 사용 제한 안에서 해당 turn을 계속할 수 있다고 설명합니다. 새 작업을 무제한으로 시작할 수 있다는 의미는 아닙니다. 작업이 아직 진행 중이라면 클라이언트를 재시작하거나 과금 경로를 바꾸기 전에 코드 변경을 확인하고 저장하세요.

일시적인 초과에는 추가 크레딧이 간편할 수 있습니다. 지속적으로 많이 쓴다면 상위 요금제를 비교할 만합니다. 로컬 작업 비용을 따로 관리하려면 API가 선택지가 되지만, 모든 작업에서 가장 저렴한 방식은 아닙니다.

Codex API 키와 ChatGPT 구독의 과금 차이

OpenAI 인증 문서는 ChatGPT 로그인에 따른 구독 접근과 API 키에 따른 사용량 과금을 구분합니다. CLI와 IDE 확장은 로컬 작업에서 두 방식을 지원합니다. Codex cloud에는 ChatGPT 로그인이 필요합니다.

다음 세 가지 청구 경로를 나눠 보세요.

• ChatGPT 구독 및 추가 크레딧: 해당 ChatGPT 계정이나 워크스페이스의 규칙을 따릅니다.
• OpenAI API 직접 연결: 키에 연결된 API 조직과 프로젝트에 청구됩니다.
• OmniaKey 사용자 지정 공급자: 지원되는 요청은 현재 OmniaKey 단가에 따라 해당 키와 잔액에 기록됩니다.

Plus를 구독해도 별도로 구성한 API 경로가 무료가 되지는 않습니다. OmniaKey 충전은 ChatGPT 한도를 초기화하지 않습니다. OmniaKey 키는 자체 공급자 설정에 넣어야 하며 OpenAI 직접 연결용 키 입력란과 혼동하면 안 됩니다.

전체 작업 흐름의 차이는 Claude Code와 Codex 비교에서 다룹니다. 여기서는 한도 도달 후의 결정에 집중합니다.

로컬 Codex용 OmniaKey 프로필 만들기

먼저 codex --version으로 버전을 확인하세요. Codex CLI 0.134.0 이상은 이름이 있는 프로필에 독립 파일을 사용합니다. 기존 기본 설정을 유지하면서 ~/.codex/omniakey.config.toml을 만들거나 기존 내용에 신중히 병합하세요.

model = "gpt-6-sol"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
base_url = "https://api.omniakey.com/v1"
env_key = "OMNIAKEY_API_KEY"
wire_api = "responses"
requires_openai_auth = false

실행할 로컬 셸의 OMNIAKEY_API_KEY에 본인의 OmniaKey 키를 설정하고 작은 새 작업부터 시작하세요.

codex --profile omniakey

현재 프로필 문서는 0.134.0부터 --profile이 기본 config.toml의 기존 [profiles.name] 테이블을 읽지 않는다고 명시합니다. 이전 CLI라면 업데이트하거나 해당 버전의 설정 안내를 따르세요.

ChatGPT 자격 증명을 삭제할 필요는 없습니다. 세션이 OmniaKey와 gpt-6-sol을 선택했는지, 첫 호출이 OmniaKey 사용량 화면에 기록되는지 확인한 다음 큰 작업을 시작하세요. 워크스페이스 정책, 프로젝트 설정, 명령줄 덮어쓰기도 최종 구성에 영향을 줄 수 있습니다.

이 환경 변수 인증에 requires_openai_auth = true를 함께 쓰지 마세요. 공식 문서는 이 설정에서 env_key를 무시한다고 설명합니다. 전체 키 설정은 Codex CLI 연결 가이드, 정확한 모델 ID는 현재 모델 목록에서 확인할 수 있습니다.

API로 바꾸면 비용은 얼마나 들까요?

사용자 메시지 한 개를 API 호출 한 번으로 계산하지 마세요. 파일 읽기, 도구 호출, 재시도와 후속 작업이 여러 모델 요청을 만들고 문맥을 반복 전송할 수 있습니다. 실제 청구 토큰을 모두 합쳐야 합니다.

2026년 9월 27일 GPT-6 Sol 페이지의 OmniaKey 단가는 입력 백만 토큰당 $0.225, 출력 백만 토큰당 $1.35입니다. 캐시를 사용하지 않은 입력 100,000토큰과 청구 대상 출력 10,000토큰이면 다음과 같습니다.

(100,000 / 1,000,000 × $0.225)
+ (10,000 / 1,000,000 × $1.35)
= $0.036 USD

게이트웨이 공개 단가로 계산한 예시이며, 코딩 작업 한 건을 완료한 실측 비용이나 OpenAI 구독 가격은 아닙니다. 캐시 읽기는 별도 단가가 적용됩니다. 추가 청구 토큰, 재시도, 해당되는 도구 요금까지 집계하고 예산을 정하기 전에 현재 단가를 확인하세요.

추가 ChatGPT 크레딧과 비교할 때는 같은 일을 끝내는 총비용을 보세요. 구독의 추정 메시지 수를 고정 토큰 할당량으로 바꾸면 안 됩니다. 작은 초기 예산으로 시작해 검수를 통과한 수정과 재작업 시간을 함께 비교하세요.

모델 선택은 GPT-6 Sol과 Luna 비교 및 현재 가격을 참고하세요. 토큰 단가가 낮아도 어려운 작업에서 시도 횟수가 늘어날 수 있습니다.

자주 묻는 질문

Codex를 재시작하면 사용량 제한이 초기화되나요?

재시작 자체가 서버의 사용 한도를 회복시키지는 않습니다. 대시보드부터 확인하세요. 표시된 초기화 시간이 지난 뒤에도 상태가 오래된 것 같다면 올바른 계정인지 확인하고 상태를 갱신한 다음 결제 설정을 검토하세요.

주간 한도를 다 쓰면 계속 사용할 수 있나요?

계정에서 추가 크레딧을 구매할 수 있는지 확인하세요. 지원되는 로컬 작업에는 별도 과금 API도 사용할 수 있습니다. 어느 방식도 주간 한도 자체를 초기화하거나 cloud 권한을 추가하지는 않습니다.

몇 번 쓰지도 않았는데 왜 한도가 끝났나요?

화면에 보이는 메시지 수와 실제 작업량은 다릅니다. 긴 문맥, 도구 결과, 추론, 반복 실행이 자원을 사용합니다. 공식 문서에 따르면 속도 설정과 이미지 생성도 한도를 더 빨리 소비할 수 있습니다. 작업 범위와 제공 파일을 줄인 다음 작은 모델을 검토하세요.

API 키를 넣었는데 왜 계속 제한이 표시되나요?

세션에 적용된 공급자, 프로필, 환경 변수, 우선순위가 높은 덮어쓰기를 확인하세요. 그다음 API 자체의 속도·잔액·프로젝트·조직 한도를 구분해야 합니다. 모델을 찾지 못한다면 Codex 호환성 가이드를 참고하세요.

API를 쓰면 Codex가 무제한인가요?

아닙니다. 사용량 과금, 공급자 한도, 잔액, 모델 접근 권한과 해당 워크스페이스 제어가 적용됩니다. 로컬 작업의 과금 경로를 분리하는 것이며 무제한 처리량이나 모든 ChatGPT 기능을 보장하지 않습니다.

확인한 출처

• OpenAI: 요금, 사용 한도와 추가 크레딧
• OpenAI: 인증과 사용자 지정 공급자
• OpenAI: 프로필과 고급 설정
• OpenAI API: 오류 코드
• OpenAI API: 속도 제한과 재시도