Codex 사용량 제한: 제한에 도달하는 이유와 작업을 계속하는 방법

1분 안에 제한 유형 확인하기

429 상태만으로 원인을 추정하지 마세요. 구체적인 오류 코드와 응답 본문을 읽은 다음, 해당 오류에 관한 공급자의 최신 문서를 따르세요.

고정된 메시지 수를 기준으로 삼을 수 없는 이유

2026년 8월 14일에 확인한 OpenAI 고객센터에 따르면, Codex 사용량은 작업의 크기와 복잡성, 선택한 모델, 작업이 실행되는 위치에 따라 달라집니다. 작은 로컬 편집과 대규모 저장소가 관련된 긴 작업은 허용량을 서로 다르게 소비합니다. 따라서 ‘5시간마다 N개 메시지’와 같은 공식은 금세 오래된 정보가 될 수 있으며 실제 사용량을 안정적으로 예측하지 못합니다.

현재 토큰 기반 요금표에 따라 크레딧으로 결제하는 작업에서 측정 가능한 변수는 선택한 모델과 작업의 입력 토큰, 캐시된 입력 토큰, 출력 토큰입니다. 현재 Codex 요금표를 연 다음, 본인의 Workspace에 표시된 정보를 바탕으로 현재 적용되는 표와 단위를 확인한 후 비용을 예상하세요.

Codex 요금제 제한에 도달했을 때 해야 할 일

1. Usage 또는 제한 배너를 열고 계정에서 정확히 어떤 선택지를 제공하는지 기록하세요. 크레딧, 사용 가능한 초기화, 업그레이드 또는 제한 초기화까지 기다리기가 여기에 해당합니다. Workspace에서 이용할 수 있는 다른 에이전트형 기능도 공유 풀을 사용했는지 확인하세요. 현재 역할에서 크레딧을 추가하거나 결제를 관리할 수 없다면 Workspace 소유자 또는 관리자에게 문의하세요. 이용 가능한 조치는 여전히 요금제, Workspace 역할 및 관리자 권한에 따라 달라집니다.
2. 커밋하지 않은 변경 사항을 저장하고 작업의 다음 단계를 짧게 기록하세요. 혹시 통과할 것이라는 기대만으로 긴 작업을 다시 실행하지 마세요.
3. 계속할 방법을 선택하세요. 현재 요금제의 공식 옵션을 사용하거나 별도의 API 워크플로로 전환할 수 있습니다. 이 두 예산을 하나의 계산에 합치지 마세요.

긴급한 작업을 API 워크플로로 안전하게 옮기기

API 방식은 구독 기능을 추가하는 것이 아니라 별도로 측정할 수 있는 예산이 필요할 때 유용합니다. BetterToken을 사용하는 절차는 다음과 같습니다.

1. Workspace에서 본인만의 API Key를 만들고, 현재 Setup 페이지 또는 Workspace의 model plaza에서 현재 Model ID를 선택합니다. 고정된 그룹 이름을 전제로 삼지 마세요.
2. 먼저 실제 CODEX_HOME을 확인하세요. 현재 OpenAI Config Reference에서 이름이 있는 profile의 표준 경로는 $CODEX_HOME/bt.config.toml입니다. 기본적으로 macOS/Linux에서는 보통 ~/.codex, Windows에서는 %USERPROFILE%\.codex이지만, 사용자가 값을 지정했다면 그 값이 우선하며 실제 경로도 달라집니다.

macOS/Linux에서 변수를 변경하지 않고 디렉터리를 확인하세요.

printf '%s\n' "${CODEX_HOME:-$HOME/.codex}"

PowerShell에서는 다음을 실행합니다.

if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $env:USERPROFILE ".codex" }

표시된 디렉터리에 bt.config.toml을 정확히 만드세요.

model = "YOUR_MODEL_ID"
model_provider = "bettertoken"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1?utm_source=blog&utm_medium=organic_content&utm_campaign=SEO-093&utm_content=codex-usage-limits-kak-prodolzhit"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

$CODEX_HOME/bt.config.toml 파일은 --profile bt 명령과 대응하며 기본 $CODEX_HOME/config.toml을 대체하지 않습니다. 루트 수준의 model_provider = "bettertoken"은 [model_providers.bettertoken]과 정확히 일치해야 합니다.

이 bt.config.toml 및 codex --profile bt 절차는 Codex CLI용입니다. Codex Desktop의 현재 설정 방법은 최신 BetterToken Codex 가이드에서 확인하세요. Codex VS Code Extension에는 이 설정 블록을 그대로 적용하지 말고 별도 가이드를 따르세요.

3. 셸에서 키를 export하고, 값을 출력하지 않은 채 변수가 비어 있지 않은지만 확인합니다.

export BETTERTOKEN_API_KEY="YOUR_API_KEY"
test -n "$BETTERTOKEN_API_KEY" && echo "BETTERTOKEN_API_KEY is set"

4. 새 profile로 Codex를 시작합니다.

codex --profile bt

그런 다음 다음과 같은 작은 읽기 전용 요청 하나를 제출합니다.

Read README.md and summarize its purpose. Do not modify any files.

5. 더 큰 작업을 계속하기 전에 Workspace에서 요청과 사용량을 확인합니다. 현재의 전체 예시는 Codex 설정 가이드에서 확인할 수 있습니다.

실제 키를 저장소, 문서, 스크린샷 또는 config.toml에 넣지 마세요. 특히 설정 파일이 Git에 커밋될 수 있다면 더욱 주의해야 합니다. 값은 환경 변수에서 가져와야 합니다.

전환할 때 작업 내용이 사라지지 않게 하기

비밀 정보 없이 짧은 인계 파일을 만드세요.

Goal: fix failing test X.
Already checked: A and B.
Changed files: path/to/file.
Next safe step: run one targeted test.
Prohibited: commit, deploy, data deletion.

다른 작업 복사본을 열기 전에 현재 상태를 확인하고, 추적 중인 변경 사항을 바이너리 안전 패치로 저장한 다음, 추적되지 않은 파일을 별도로 나열하세요.

git status --short
git diff --binary HEAD > ../codex-handoff.patch
git ls-files --others --exclude-standard -z > ../codex-handoff-untracked.zlist

패치에는 추적되지 않은 파일이 포함되지 않습니다. 파일을 복사하기 전에 ../codex-handoff-untracked.zlist를 검토하고 .env 파일, 비공개 키, 자격 증명 및 기타 모든 비밀 정보를 제외하세요. 명시적으로 승인한 경로만 남기고, 추적되지 않은 파일을 폐기해도 되거나 안전하게 옮길 수 있다고 가정하지 마세요.

현재 HEAD에서 새 worktree를 만들고, 패치를 적용하기 전에 검사한 뒤, 적용 결과 상태를 확인하세요.

git worktree list
git branch --list codex/api-handoff
git worktree add -b codex/api-handoff ../project-api-handoff HEAD
if test -s ../codex-handoff.patch; then
  git -C ../project-api-handoff apply --check ../codex-handoff.patch
  git -C ../project-api-handoff apply ../codex-handoff.patch
fi
while IFS= read -r -d '' path; do
  mkdir -p -- "../project-api-handoff/$(dirname -- "$path")"
  cp -p -- "$path" "../project-api-handoff/$path"
done < ../codex-handoff-untracked.zlist
git -C ../project-api-handoff status --short

if 블록은 추적 중인 변경 사항의 패치가 비어 있으면 git apply를 건너뜁니다. 복사 루프는 이 블록 밖에 있으므로 검토를 마친 추적되지 않은 파일은 계속 전송됩니다. ../project-api-handoff 또는 codex/api-handoff가 이미 존재한다면, 사용하지 않은 새 경로나 브랜치 이름을 선택하세요. 충돌하는 이름을 재사용하려고 기존 worktree, 브랜치, 패치 또는 추적되지 않은 파일을 삭제하지 마세요.

전체 대화 기록 대신 인계 메모와 검증된 작업 상태로 새 API 세션을 시작하세요. 그러면 사용량이 줄고, 컨텍스트 초과 위험이 낮아지며, 이미 완료한 작업을 반복할 가능성도 줄어듭니다.

대신 429가 표시되는 경우

다음 순서대로 확인하세요.

1. 구체적인 오류 코드, 응답 본문, 응답 헤더 및 해당 오류에 관한 공급자 문서를 확인합니다.
2. 여러 에이전트 또는 CI 작업이 같은 키를 사용하고 있는지 확인합니다.
3. 잔액이 비어 있거나 Workspace 지출 예산에 도달했는지 확인합니다.
4. 해당 오류에 권장된 지연 시간이 있다면 기다린 후, 작은 요청 하나에서도 오류가 계속 발생하는지 확인합니다.

구체적인 오류와 공급자 문서에서 일시적인 속도 제한으로 확인된 경우, 지터를 포함한 제한적 지수 백오프를 사용하세요. 무기한 재시도하지 마세요. 반복 요청은 대기열을 늘리고 서비스가 복구된 뒤 예산을 소비할 수 있습니다.

최종 선택하기

• Codex 배너에서 크레딧이나 초기화를 제공하고 동일한 요금제 기반 워크플로를 유지하려면, 사용 가능한 공식 옵션을 이용하세요.
• 자동화, CI 또는 긴급 작업을 위한 별도 예산이 필요하다면 API 워크플로를 구성하고 사용량을 따로 추적하세요.
• 문제가 컨텍스트 창이라면 컨텍스트를 줄이거나 새 세션을 시작하세요. 더 많은 비용을 지출하거나 제한 초기화를 기다려도 해결되지 않습니다.
• 문제가 API 429라면 구체적인 오류 코드, 응답 본문 및 공급자 문서를 따르세요. 잔액이 0이라면 재시도하기 전에 예산을 수정하세요.

긴급 작업을 옮기기 전에 현재 BetterToken Codex 설정 가이드를 열고, 별도 키를 사용하는 사용자 지정 공급자를 독립된 $CODEX_HOME/bt.config.toml에 구성하세요. codex --profile bt로 시작해 작은 요청 하나를 확인하고, 성공한 뒤 작업용 지출 한도를 설정한 다음 더 긴 작업을 계속하세요.