Codex "Selected model is at capacity" 오류 해결과 재시도 대기

Codex 처리 용량 오류와 사용 한도 소진을 구분하고, 클라이언트를 업데이트한 뒤 다른 모델을 테스트합니다. 특정 계정에서 반복되는 오류를 조사하고 Retry-After 변경 사항을 이해합니다. 복구 시도를 제한하고 별도 과금되는 대체 API를 준비해 장시간 실행과 CI 작업의 결과를 보존합니다.

목차
Codex "Selected model is at capacity" 오류 해결과 재시도 대기

Codex의 Selected model is at capacity. Please try a different model. 메시지는 처리 용량 오류를 뜻하며, 사용 한도를 모두 소진했다는 증거는 아닙니다. CLI, 데스크톱 앱, IDE 확장 프로그램에서 작업이 막혔다면 해당 클라이언트를 업데이트하고 사용 가능한 다른 모델을 테스트합니다. Codex가 이미 서버 지시에 따라 재시도를 기다리는 중이라면 새 요청을 보내기 전에 그 대기가 끝나도록 합니다.

처리 용량 오류인가요, 사용 한도 소진인가요?

Codex는 이 메시지를 ServerOverloaded로 분류합니다. API 오류 변환 코드는 server_is_overloaded를 이 오류에 대응시킵니다. 별도 유형인 UsageLimitReached는 클라이언트에 전달하는 프로토콜에서 UsageLimitExceeded가 됩니다.

오류 정의에는 PolicyCapacityUnavailable도 있습니다. 표시되는 메시지는 Policy-restricted capacity is unavailable. Please try again later.입니다. 처리 용량 오류와 같은 재시도 방침을 사용하지만 별개의 오류입니다. 두 메시지 중 어느 것도 그것만으로 계정이 차단됐다는 증거가 되지는 않습니다.

사용량 대시보드에서 남은 사용 한도를 확인합니다. 실제 오류가 사용 한도 소진을 가리킨다면 Codex 사용 한도와 초기화 안내를 따릅니다. 처리 용량 오류의 원인을 확인할 때 추가 사용량 구매부터 할 필요는 없습니다.

무엇부터 시도해야 하나요?

오류가 발생한 클라이언트를 업데이트합니다

2026-11-17 기준 OpenAI의 최신 Codex CLI 안정 버전은 0.169.0입니다. 이전 버전을 사용한다면 재시도 동작을 조사하기 전에 업데이트합니다.

npm으로 설치한 CLI라면 Bash에서 다음 명령을 실행합니다.

codex --version
npm install -g @openai/codex
codex --version

마지막 명령에서 업데이트된 버전이 표시되어야 합니다. 다른 설치 방법을 사용했다면 해당하는 공식 업데이트 안내를 따릅니다. Remote SSH를 사용한다면 원격 호스트의 CLI 버전도 확인합니다.

데스크톱 앱이나 IDE 확장 프로그램에서 오류가 발생했다면 해당 클라이언트를 별도로 업데이트한 뒤 다시 시작합니다. 조직에서 데스크톱 앱 업데이트를 관리한다면 관리자가 승인한 배포 절차가 필요할 수 있습니다. CLI, 앱, 확장 프로그램 비교를 통해 어느 인터페이스를 점검해야 하는지 구분할 수 있습니다.

사용 가능한 다른 모델을 테스트하거나 재시도를 기다립니다

CLI에서 /model을 사용해 목록에 있는 다른 모델을 선택합니다. 이후 명령어 참고 문서에 따라 /status로 선택 결과를 확인합니다. 중단된 작업으로 돌아가기 전에 Reply with OK. 같은 짧은 요청을 보냅니다.

응답이 완료되면 해당 요청에서 선택한 모델과 접속 경로가 작동했다는 점을 확인할 수 있습니다. 원래 모델이 복구됐다는 뜻은 아닙니다. 여러 모델에서 실패한다면 모델을 계속 바꾸지 말고 아래의 계정 점검으로 넘어갑니다.

클라이언트가 이미 재시도 중이라면 서버가 지정한 대기 시간을 지킵니다. 같은 요청을 계속 처음부터 실행하거나 동일한 요청을 여러 개 병렬로 실행하지 않습니다. OpenAI 상태 페이지에서 장애가 있는지도 확인합니다. 다만 전체 상태를 집계한 정보만으로 특정 계정에서 서비스를 사용할 수 있다고 판단할 수는 없습니다.

기다린 뒤에도 오류가 다시 발생하면 바로 /feedback을 제출합니다. 지원팀에 문의할 수 있도록 오류 발생 시각, 선택한 모델, 클라이언트 버전과 발급된 피드백 식별자를 보관합니다.

처리 용량이 회복될 때까지 어떤 경로를 선택해야 하나요?

대기 시간이 작업 기한 안에 들어온다면 현재 접속 경로를 유지합니다. 로컬 작업을 계속할 대안이 필요하다면 별도로 과금되는 API 경로를 고려합니다.

선택지필요한 조건과 과금선택할 상황
기다렸다가 재시도기존 계정과 접근 권한을 사용하며 새 결제 설정은 필요하지 않습니다. 서버가 대기 시간을 알려주면 이를 지킵니다.현재 모델이 필요하고 기다릴 수 있는 경우입니다.
다른 모델 선택계정과 워크스페이스에서 사용할 수 있고 /model에 표시되는 모델이 필요합니다. 기존 접근 조건은 계속 적용됩니다.짧은 테스트가 성공하고 대체 모델이 작업을 처리할 수 있는 경우입니다.
OpenAI APIAPI 키, API 과금 설정, 지원 국가 또는 지역에서의 접속이 필요합니다. 로컬 Codex 사용에는 API 토큰 요금이 적용됩니다.구독 대신 사용량에 따라 비용을 내는 직접 접속 경로가 필요한 경우입니다.
BetterToken API본인 소유의 BetterToken 계정과 API 키, 콘솔에 표시되는 결제 수단으로 충전한 잔액이 필요합니다. 문서에 안내된 Codex 사용자 지정 제공자는 Responses를 사용합니다. 요금은 모델의 토큰 과금 규칙을 따릅니다.종량제 API 게이트웨이를 사용하려 하며 실제 작업에 의존하기 전에 설정하고 테스트할 수 있는 경우입니다.

API 과금은 ChatGPT 구독의 사용량과 별개입니다. 접속 경로를 바꿔도 구독의 사용 한도가 다시 채워지지는 않습니다. 대체 경로에 쓸 잔액을 충전하기 전에 예상 작업량을 BetterToken API의 현재 요금과 비교합니다.

이 API 선택지는 로컬 Codex 작업에 해당합니다. OpenAI 인증 문서에 따르면 Codex Cloud는 ChatGPT 로그인이 필요합니다. 로컬 제공자를 바꾸면 기존 클라우드 작업도 함께 옮겨진다고 가정하지 않습니다.

설정은 Codex 사용자 지정 제공자 연결 안내를 따릅니다. 리포지토리의 미완료 작업을 넘기기 전에 선택한 엔드포인트를 짧은 요청으로 테스트합니다.

OpenAI는 무엇을 바꿨으며, 왜 대기 시간이 길어질 수 있나요?

보고된 개선은 응답 처리 단위인 턴이 처리 용량 오류로 끝나는 횟수가 줄었다는 뜻입니다. 즉시 처리된다는 보장은 아닙니다.

Tibo의 11월 16일 게시물에서 @thsottiaux는 팀이 반복되는 오류를 해결했을 수도 있다고 밝혔습니다. 첨부된 그래프는 일일 활성 사용자 가운데 하루에 한 번 이상 턴이 처리 용량 오류로 끝난 사용자의 비율을 보여줍니다. 2026년 10월 15일부터 11월 12일까지의 UTC 기준 기간에서 이 비율은 **10월 19일 6.82%**에서 **11월 12일 0.085%**로 낮아졌습니다. 전체 요청 가운데 실패한 요청의 비율은 아닙니다.

그래프에는 서버가 재시도 시점을 알려주는 Retry-After와 관련된 여섯 가지 변경이 표시되어 있습니다. 10월 15일에는 WebSocket 재시도 수정이 데스크톱 버전에 포함됐습니다. 10월 22일에는 일반 과부하에 대기 시간이 추가됐고, 10월 23일에는 서비스 티어 과부하에 재시도 시점이 추가됐습니다.

10월 24일에는 Codex가 재시도 및 중지 지시를 전달하기 시작했습니다. 10월 30일에는 NO_MORE_RETRY에 대기 시간이 추가됐습니다. 11월 6일 변경으로 WebSocket 오류에서도 이 대기 시간이 유지됐습니다.

현재 소스 코드는 ServerOverloaded, PolicyCapacityUnavailable, RetryLimit에 RetryPolicy::ServerDirected를 적용합니다. 출시된 0.169.0 코드도 이 오류들에 서버가 제공한 대기 시간을 사용합니다. 재시도 안내가 있으면 요청이 즉시 종료되는 대신 기다릴 수 있습니다.

따라서 턴을 끝내는 오류의 비율이 낮아지면서 대기 시간은 길어질 수도 있습니다. 그래프는 턴 소요 시간의 p95를 측정하지 않습니다. p95는 턴의 95%가 그보다 짧은 시간 안에 끝나는 기준값입니다. 전체 작업이 완료됐는지도 이 그래프만으로는 알 수 없습니다.

Codex의 재시도 처리 코드에는 재시도 횟수 제한도 남아 있습니다. 서버의 안내는 대기 시간을 정할 뿐, 무제한 재시도나 최종 성공을 보장하지는 않습니다.

특정 계정에서만 계속 실패하면 어떻게 하나요?

계정과 인증 경로를 조사하되 계정 제한이 확인된 원인이라고 단정하지 않습니다.

2026-11-17 기준 이슈 #60767은 아직 열려 있습니다. 작성자 xiaogu12138은 사용 한도가 남은 Plus 계정에서 CLI와 VS Code Remote SSH 모두 실패한다고 설명합니다. 같은 서버에서 다른 Plus 계정은 정상적으로 작동했다고 보고했습니다.

보고에는 자동 재시도 전 대기 시간이 약 314–317 seconds(초)였다는 내용이 있습니다. 이후 발생한 401 Unauthorized 응답과 별도의 token_revoked 오류도 언급합니다. 이 인증 오류들이 처리 용량 오류의 원인이었는지는 확인되지 않았습니다. 조사한 로그가 실제로 해당 계정의 기록인지도 독립적으로 확인할 수 없었습니다.

같은 원인이라고 가정하는 대신, 이 사례를 참고해 증거를 정리합니다.

  1. 비교 조건을 동일하게 유지합니다. 계정과 워크스페이스, 클라이언트 버전, 모델, 호스트, 시간대가 포함된 발생 시각을 비공개로 기록합니다. CLI와 확장 프로그램에서 같은 짧은 프롬프트를 테스트합니다. 접근 권한이 있는 동료는 본인 계정으로 따로 테스트할 수 있지만, 인증 정보는 서로 공유하지 않습니다.
  2. 인증 문제의 증거가 있을 때만 인증을 복구합니다. 저장된 ChatGPT 로그인 상태에서 401 또는 token_revoked가 표시되면 codex logout을 실행한 다음 codex login을 실행합니다. 이후 같은 짧은 요청을 다시 보냅니다. 처리 용량 메시지만으로 인증 파일을 삭제할 필요는 없습니다.
  3. 반복되는 실패를 지원팀에 전달합니다. 다시 실패한 직후 /feedback을 실행합니다. 피드백 식별자, 재현 단계, 재시도 대기 시간과 확보한 요청 ID를 OpenAI 지원팀에 전달합니다.

GitHub 이슈에 인증 정보, 인증 파일, 비공개 리포지토리 내용을 게시하지 않습니다. 한 번의 재시도 성공도 유용한 증거이지만, 간헐적 문제를 조사하려면 반복 발생 시각이 필요합니다.

처리 용량 오류로 긴 작업의 결과를 잃지 않으려면 어떻게 하나요?

작업을 결과를 검토할 수 있는 체크포인트로 나누고, 턴이 실패해도 상태를 보존합니다. 배포, 결제 등 외부 시스템에 영향을 주는 작업은 조건 없이 반복하는 재시도 루프에 넣지 않습니다.

다음 Bash 예제는 읽기 전용 진단을 실행하고 이벤트와 CLI 종료 코드를 보존합니다. 해당 작업만을 위한 리포지토리 작업 사본에서 실행합니다.

umask 077
status=0
codex exec --json --sandbox read-only \
  "Inspect the repository and report the next unfinished step. Do not edit files." \
  >codex-events.jsonl 2>codex-stderr.log || status=$?
printf '%s\n' "$status" >codex-exit-code.txt
exit "$status"

단계가 실패해도 이 파일들을 보관하도록 CI를 설정합니다. 비대화형 인터페이스는 thread.started, turn.completed, turn.failed, error 이벤트를 내보냅니다. 프로세스의 정상 종료와 턴 완료, 작업별 검증 성공을 모두 확인한 뒤에만 후속 작업을 진행합니다.

작업 사본과 Codex의 비공개 세션 저장소도 보존합니다. 이벤트 로그만으로는 저장된 세션을 대신할 수 없습니다. 재개할 작업에는 --ephemeral을 사용하지 않습니다. 인증 정보가 들어 있는 Codex 홈 디렉터리 전체를 공개 아티팩트로 업로드하지 않습니다.

재시도 대기가 끝나거나 근본 문제가 해결되면 마지막으로 실행된 작업을 임의로 선택하지 않고 기록해 둔 세션을 재개합니다. jq가 설치된 환경에서 원래 작업 사본으로 이동해 다음 Bash 명령을 실행합니다.

session_id=$(jq -ers \
  '[.[] | select(.type == "thread.started") | .thread_id] | first // empty' \
  codex-events.jsonl) &&
codex exec --sandbox read-only resume "$session_id" \
  "Inspect the existing work and report the next unfinished step. Do not edit files."

작업 실행 시스템에 전체 경과 시간 제한과 복구 시도 한도를 설정합니다. 일시적이라고 분류한 오류만 재시도하고, 서버가 시간 지침을 제공하면 이를 따릅니다. 인증, 권한, 사용 한도 소진 오류에서는 같은 요청을 반복하지 말고 중단합니다.

작업 기한 때문에 다른 제공자가 필요하다면 저장된 체크포인트에서 시작하고, 완료한 작업과 남은 검증 사항을 정리한 인계 정보를 전달합니다. 계속 진행하기 전에 기존 diff를 확인해, 대체 제공자가 이미 끝난 외부 작업을 반복하지 않도록 합니다.

LLM 워크플로를 최적화할 준비가 되셨나요?

하나의 API로 모델을 연결하고 키와 AI 비용을 관리하세요.

무료로 시작하기