돈 내도 안 풀리는 한도 초과 에러 — 비슷하게 생긴 일곱 개를 갈라봤습니다

한도 초과 에러 · 갈라 보기

돈을 더 내도
안 풀리는 에러가 있습니다.

문서가 아예 "이건 당신 사용량 한도가 아닙니다"라고 적어둔 것들이 있습니다. 하나는 모델만 바꾸면 공짜로 풀립니다.

작업 중에 빨간 에러가 뜨면 대개 "아, 한도 다 썼구나" 하고 결제 화면부터 엽니다. 그런데 공식 에러 문서를 열어보니, 비슷하게 생겼는데 원인이 전혀 다른 메시지가 일곱 개였습니다. 그중 넷은 돈을 더 내도 안 풀립니다. 한도 숫자가 문서에 없다는 글을 쓴 적이 있는데, 이번엔 한도에 걸렸을 때 화면에 뜨는 문장 쪽입니다.

📌 30초 요약

• ⚠️ 529는 내 한도가 아닙니다. 문서 원문 — "할당량에 카운트되지도 않는다".
• ⚠️ 429도 플랜 한도가 아닙니다. API 키·클라우드 프로젝트 쪽 제한이라 동시성을 낮추는 게 해법입니다.
• ⚠️ "긴 컨텍스트에 크레딧 필요"는 소진이 아니라 자격 확인입니다. 모델만 바꾸면 공짜로 풀립니다.
• ⚠️ 메시지에 "(당신 사용량 한도 아님)"이라고 괄호로 적어둔 것도 있습니다.
• Opus 한도는 모델을 바꾸면 계속 쓸 수 있지만, 세션·주간 한도는 모델을 바꿔도 안 풀립니다.
• 진짜 결제가 필요한 건 일곱 개 중 둘뿐이었습니다.

① 일곱 개를 갈라 놓습니다

화면에 뜨는 말	내 한도인가	먼저 할 것
세션·주간 한도 소진	예	리셋 시각까지 대기 · 크레딧
선불 크레딧 잔액 부족	예	크레딧 충전 · 자동 충전
Opus 한도 소진	부분	모델 전환 — 계속 쓸 수 있음
긴 컨텍스트에 크레딧 필요	아니오	모델 전환 — 돈 안 듦
서버가 일시적으로 제한 중	아니오	잠깐 기다렸다 재시도
429 요청 거부	아니오	동시 실행 수를 낮추기
529 과부하	아니오	기다리기 · 상태 페이지 확인

공식 에러 문서 기준 · 위 둘만 실제로 지갑을 열어야 하는 경우입니다

② 문서가 직접 부정하는 것들

📄 529 — 원문이 한 문장으로 못박습니다

"A 529 is not your usage limit and doesn't count against your quota."

→ 내 한도도 아니고 할당량에서 차감되지도 않습니다. 서버가 붐비는 상황이라 기다리는 것 말고는 할 게 없습니다. 여기서 플랜을 올려도 달라지는 게 없습니다.

📄 서버 스로틀 — 메시지에 괄호로 적어둡니다

"Server is temporarily limiting requests (not your usage limit)"

→ 괄호 안이 전부입니다. 오해가 워낙 잦으니 메시지에 직접 넣어둔 것으로 보입니다. 문서에는 구분 방법도 적혀 있는데, 진짜 한도 응답에만 붙는 헤더가 있는지로 갈라낸다고 합니다.

📄 429 — 이건 내 쪽 설정 문제일 수 있습니다

문서가 꼽은 원인은 내 API 키나 클라우드 프로젝트에 걸린 분당 제한입니다. 구독 플랜 할당량과 다른 층위예요.

→ 해법도 다릅니다. 결제가 아니라 동시에 돌리는 도구 호출 수를 줄이라고 되어 있습니다. 에이전트를 여러 개 띄워 쓰고 계셨다면 여기가 원인일 수 있습니다.

✅ 이건 공짜로 풀립니다 — "긴 컨텍스트에 크레딧 필요"

"This is an entitlement check, not a quota exhaustion."

→ "자격 확인이지 할당량 소진이 아니다"라고 문서가 못박습니다. 100만 토큰짜리 확장 컨텍스트 모델을 골라놨는데 내 플랜에서는 그게 크레딧을 켜야 되는 항목이라 막힌 겁니다. → 모델 목록에서 이름 뒤에 표시가 없는 쪽을 고르면 그냥 됩니다. 아예 확장 컨텍스트 모델을 목록에서 빼는 환경변수도 있습니다.

③ 세션 한도와 Opus 한도는 대처가 정반대입니다

같은 "한도에 도달했습니다"인데 모델을 바꿔서 될 때와 안 될 때가 갈립니다. 이 구분이 실무에서 제일 쓸모 있었습니다.

종류	모델을 바꾸면	왜
Opus 한도	계속 쓸 수 있음	그 모델에만 걸린 한도라서
세션 한도	안 풀림	모든 모델이 같은 창을 공유해서
주간 한도	안 풀림	위와 같음

Opus 한도만 모델 전환으로 넘어갑니다. 나머지 둘은 어떤 모델로 바꿔도 같은 벽에 부딪힙니다. 반대로 말하면, 비싼 모델을 계속 쓰다가 그것만 먼저 소진되는 상황이라면 싼 모델로 내려서 하던 일을 마칠 수 있다는 뜻입니다.

④ 결제 화면을 열기 전에 세 줄

# 1) 지금 어떤 자격으로 붙어 있는지 (구독인가 API 키인가)
/status

# 2) 내 플랜 한도와 남은 양 — 리셋 시각까지 나옴
/usage

# 3) 모델을 바꿔서 넘어갈 수 있는 상황인지
/model

# 이 셋으로 안 풀리면 그때 결제를 봐도 늦지 않습니다.

1번이 의외로 중요합니다. 구독으로 붙어 있는지 API 키로 붙어 있는지에 따라 같은 에러의 원인이 달라집니다. 429는 API 키 쪽 제한이고, 세션·주간 한도는 구독 쪽 개념이거든요. 사용량 화면 읽는 법에서 다룬 것과 같은 화면입니다.

회사에서 쓰신다면 "지출 상한에 도달했습니다"가 또 다른 경우입니다. 이건 내 플랜 한도가 아니라 관리자가 걸어둔 상한이라 내가 결제해도 안 풀립니다. 상한을 건 사람에게 얘기해야 합니다. 지출 상한을 거는 쪽은 따로 정리해뒀습니다.

📏 내 한도가 실제로 얼마인지 확인하는 법 (8월 27일 추가)

여기서 갈래를 나눠봤지만, 애초에 내게 걸린 한도가 얼마인지를 알면 판단이 빨라집니다. 조직 계정이라면 그 값을 프로그램으로 읽어올 수 있게 됐습니다. 알아둘 함정이 둘인데 — 팀별 설정에서 안 보이는 항목은 무제한이 아니라 조직 값을 물려받은 것이고(문서가 굳이 못 박아둔 대목입니다), 한도는 모델 하나가 아니라 여러 버전이 공유하는 묶음에 걸립니다. 그래서 같은 묶음 안에서 모델을 바꿔 써도 한도는 나뉘지 않습니다. 정리는 한도를 코드로 읽기에 담았습니다.

🔁 여덟 번째가 하나 더 있습니다 — 한도가 아니라 안전 동작

위 일곱 가지 말고, 돈으로도 프롬프트로도 안 풀리는 경우가 하나 더 있습니다. 모델에 박힌 안전 동작이 응답을 거절하는 것입니다. 검열이나 분류 작업을 맡겼을 때 특히 자주 보이는데, 「이건 판정만 해라, 거르지 마라」고 적어도 그 지시가 안 먹습니다. 한도 화면을 아무리 들여다봐도 원인이 안 나오는 쪽이라, 위 일곱 개와 먼저 갈라 두시는 게 좋습니다.

자주 묻는 것

Q. 이 에러들을 직접 겪어보고 쓴 건가요?

전부는 아닙니다. 이 글은 공식 에러 문서에 적힌 메시지·원인·대처를 갈라 정리한 것입니다. 일곱 개를 제 계정에서 재현해본 게 아닙니다. 메시지 문구는 버전이나 접속 방식에 따라 조금씩 다를 수 있으니, 화면에 뜬 문장을 그대로 문서에서 찾아보시는 게 정확합니다.

Q. 429가 자꾸 뜨는데 동시성을 어디서 줄이나요?

문서에 도구 호출 동시 실행 수를 낮추는 환경변수가 안내돼 있습니다. 다만 적정값은 제시돼 있지 않고 제가 시험해본 것도 아닙니다. 그전에 제공사 콘솔에서 내 키의 분당 한도부터 확인하라는 게 문서 순서입니다 — 상향 요청이 가능한 경우도 있습니다.

Q. 결국 플랜을 올려야 하는 건 언제인가요?

세션·주간 한도가 반복해서 일찍 소진될 때입니다. 그 외에는 올려도 같은 에러를 다시 봅니다. 그리고 올리기 전에 왜 빨리 닳는지부터 보는 게 순서라고 생각합니다 — 긴 대화가 매 요청에 통째로 실려 가는 구조가 원인일 때가 많습니다.

🧱 여덟 번째가 있습니다 — 우리 회사가 건 벽 (8월 16일 추가)

이 글은 비슷하게 생긴 한도 초과 에러 일곱 개를 갈라본 것이었습니다. 여덟 번째를 더해야겠습니다 — 회사가 중계 서버를 직접 돌리는 곳이라면, 사람별 지출 상한을 넘겼을 때도 429가 옵니다. 종류가 결제 관련 오류로 찍히고 "다시 시도하지 말 것" 표시가 붙는 게 특징이고요. 앞의 일곱 개와 결정적으로 다른 점은 모델 회사가 아니라 우리 회사가 건 벽이라는 것입니다 — 기다린다고 안 풀리고, 관리자가 올려줘야 풀립니다. 메시지에 기간과 리셋 시각이 적혀 나오는데 그것도 버전이 맞아야 하고요. 구분법은 지출 상한을 뜯어본 글에 적었습니다.

✨ 정리하면

한도 초과처럼 생긴 일곱 개 중 실제로 지갑을 열어야 하는 건 둘이었습니다.

529는 할당량에 카운트되지도 않고, 429는 동시성을 낮추는 문제이고, "긴 컨텍스트에 크레딧 필요"는 모델만 바꾸면 공짜로 풀립니다.

Opus 한도는 모델을 내리면 계속 쓸 수 있지만, 세션·주간 한도는 그렇지 않습니다. 결제 화면을 열기 전에 /status · /usage · /model 세 줄만 먼저요.

🧭 AI 지출 전체 그림

안 내도 될 돈을 안 내는 것도 절약입니다. 단계별로 새는 곳을 일곱 단계로 묶어뒀습니다 → AI에 쓰는 돈 총정리 — 숨은 비용 7가지

🔗 결제 전에 같이 볼 글

• '20배'는 무엇의 20배인가 — 한도 숫자가 문서에 없습니다
• 사용량 화면의 숫자가 전부가 아닙니다 — /usage 읽는 법
• 컨텍스트의 92퍼센트는 화면에 안 보입니다 — 왜 빨리 닳는가
• 지출 상한 거는 법 — 관리자 쪽 상한
• AI 팀원 다섯 명을 붙이기 전에 — 429의 흔한 원인

---

확인 시점 — 2026년 8월 14일. ✅ 1차 확인 : Claude Code 공식 에러 문서 — 사용량 한도·인증·요청 오류 절의 메시지 원문과 각각의 원인·대처. 본문에 인용한 "A 529 is not your usage limit and doesn't count against your quota." · "Server is temporarily limiting requests (not your usage limit)" · "This is an entitlement check, not a quota exhaustion." 는 문서 표현 그대로입니다. 세션·주간 한도가 모델 간 공유이고 Opus 한도만 모델 전환으로 우회된다는 구분, 429의 원인이 API 키·클라우드 프로젝트 쪽 제한이라는 점, 지출 상한이 게이트웨이 운영자가 거는 별도 개념이라는 점도 문서 기재입니다. 확인하지 않은 것 : 일곱 개 에러를 제 계정에서 재현 · 동시성 환경변수의 적정값(문서에 값 제시가 없고 제가 시험하지도 않았습니다) · 버전·접속 방식별 메시지 문구 차이 · 상향 요청의 실제 승인 여부. 범위 한정 : 이 글은 문서에 적힌 분류를 옮긴 것이며 개별 상황 진단이 아닙니다. 화면에 뜬 문장이 본문과 조금 다르면 그 문장을 그대로 문서에서 찾아보세요. 메시지와 정책은 예고 없이 바뀝니다. 제휴·협찬 없습니다.