Claude Code 사용 한도에 너무 빨리 도달하는 이유와 7가지 해결 방법 (2026)

점심시간이 되기도 전에 Claude Code 사용 한도가 소진되었나요? Opus는 Sonnet보다 몇 배 더 많은 토큰을 소모하며, subagents(하위 에이전트)는 7배의 토큰을 사용하고, MCP는 컨텍스트(Context)의 33%를 잡아먹습니다. /usage 명령어로 확인하고 7가지 해결 방법을 적용해 보세요.

오전 9시에 Claude Code를 열어 리팩터링(refactor)을 시켰는데, 점심시간이 되자 사용 한도에 도달했다는 메시지가 떴나요? 유료 플랜을 사용 중인데 말이죠. 이는 현재 Claude Code 이슈 트래커에서 가장 흔하게 접할 수 있는 불만 사항 중 하나이며, 그 원인은 결제 버그인 경우가 거의 없습니다. 원인은 할당량(quota)이 구조화된 방식과, 조용히 할당량을 소모하는 몇 가지 기본 동작 때문입니다.

Claude Code 플랜을 가장 빠르게 소진하는 방법은 세 명의 subagents(하위 에이전트)가 뒤에서 작업을 펼치는 동안 일상적인 업무에 Opus를 실행하는 것입니다. 이 각각의 에이전트는 여러분이 사용하고 있다고 생각하는 토큰 소모량의 몇 배에 달합니다.

이 가이드는 구독 플랜(subscription plan) 한도, 즉 Pro 및 Max 플랜에서 발생하는 "사용 한도에 도달했습니다(You've hit your usage limit)" 벽에 대한 문제 해결 가이드입니다. 만약 API 키를 사용 중이며 대신 429 Rate Limit Reached 오류가 발생한다면, 이는 다른 해결 방법이 필요한 별개의 문제이며 Claude Code rate limit reached error: causes and fixes에서 다루고 있습니다.

30초 진단법

두 가지 명령어를 실행한 다음, 증상을 아래의 원인과 대조해 보세요.

사용량이 통제 가능한 수준이며 지금 당장 여유 공간(headroom)만 확보하고 싶다면, 에스컬레이션 경로(escalation path)로 바로 이동하세요. 여기서부터 그 사이의 모든 내용은 플랜을 오래 유지하는 방법에 관한 것입니다.

언제 해결하고, 언제 전환하며, 언제 멈춰야 하는가

모든 한도를 극복할 가치가 있는 것은 아니므로, 오후 시간을 최적화에 쏟기 전에 전략을 세우세요. 올바른 조치는 여러분이 세션 캡(session cap)에 걸리고 있는지, 아니면 주간 캡(weekly cap)에 걸리고 있는지에 따라 전적으로 달라집니다.

• 세션 내에서 해결 (Fix it in-session): /usage 명령어를 통해 확인했을 때, 집중적인 작업 중 5시간 세션 캡(session cap)이 최대치에 도달했지만 주간 바(weekly bar)에는 여유가 있는 경우입니다. 기본 모델을 Sonnet으로 설정하고, 공격적으로 압축(compact)하며, MCP를 축소(trim)하세요. 그렇게 하면 보통 세션 범위 내에서 계속 유지할 수 있습니다.
• 모델 전환 (Switch models): 단일 Opus 기반 워크플로우 자체가 문제인 경우입니다. 서브 에이전트(subagents)를 고정하고 기본 모델을 Sonnet으로 설정하는 것만으로도, 다른 변경 없이 계획(plan)의 지속 시간을 두 배 또는 세 배로 늘릴 수 있는 경우가 많습니다.
• 결제 방식 변경 (Switch billing): /usage에서 모든 모델에 대한 주간 캡(weekly all-models cap)이 소진되었고 7일 리셋까지 며칠이 남은 경우입니다. 세션 내 최적화로는 주간 캡을 조기에 회복할 수 없습니다. 이 시점에서는 티어(tier)를 업그레이드하거나 종량제(pay-as-you-go)로 전환해야 합니다.
• 최적화 중단 (Stop optimizing): MCP를 축소하고 모델 경로를 조정했음에도 /usage가 여전히 빠르게 소진된다면 최적화를 멈추세요. 실제 사용량이 현재 플랜의 규모를 넘어선 것이므로, 상위 단계로의 전환(escalation)이 정답입니다.

간단한 자가 진단: 만약 오류 및 재시도율(error and retry rate)이 낮고 가끔 발생하는 집중적인 스프린트(sprints) 기간에만 캡에 도달한다면, 세션 내 해결 방법만으로 충분합니다. 하지만 매일 오후 중반쯤 벽에 부딪힌다면, 이는 관리(hygiene)의 문제가 아니라 결제 모델의 문제입니다.

한도가 왜 이렇게 빨리 소진되는가: 하나가 아닌 두 개의 캡

사람들이 놀라는 핵심 이유는 Claude Code가 두 개의 독립적인 제한을 적용하며, 주간 제한은 실제로 문제가 발생하기 전까지는 보이지 않기 때문입니다. 5시간 제한은 첫 메시지부터 시작되어 5시간 후에 리셋되는 순환 세션 윈도우(rolling session window)입니다. 주간 제한은 별도의 7일 캡이며, Max 플랜의 경우 Anthropic의 자체 사용 문서에 따라 두 종류가 있습니다. 하나는 모든 모델에 적용되는 캡이고, 다른 하나는 Sonnet 전용 캡입니다.

이들은 서로 다른 시계에 따라 리셋됩니다. 주말에 집중적으로 사용하면 월요일에 주간 여유분은 남아있지만 세션 캡에 걸릴 수 있고, 반대로 세션 여유는 있지만 주간 캡에 걸릴 수도 있습니다. 주간 캡에 도달하면 현재의 5시간 세션에 여유가 있더라도 7일 리셋이 될 때까지 사용이 차단됩니다. 이 경우 5시간을 기다리는 것은 아무런 도움이 되지 않습니다.

사람들을 더욱 당혹스럽게 만드는 또 다른 점은 Anthropic이 윈도우당 고정 프롬프트 수(prompts-per-window)나 주당 시간(hours-per-week) 수치를 더 이상 공개하지 않는다는 것입니다. 현재 그들이 공개하는 것은 상대적 용량(relative capacity)입니다. FrankX의 가격 분석에 따르면, Max 5x ($100/mo)는 Pro의 세션당 사용량의 5배를 제공하며, Max 20x ($200/mo)는 20배를 제공합니다. 따라서 예산을 세우기 위해 참고할 수 있는 공개된 토큰 수치는 없습니다. /usage를 읽고 자신만의 한계치를 파악해야 합니다.

만약 /usage에서 세션 잔여량이 낮게 표시되는데도 여전히 벽에 부딪힌다면, 그것은 주간 한도(weekly cap) 때문입니다. 세션 바(session bar)는 2%로 표시되는데 주간 한도는 32%에서 작동하는 알려진 Claude Code 이슈가 있습니다. 이 경우 해결책은 세션 바가 아닌 주간 수치를 신뢰하는 것입니다.

당신이 보게 될 한도 상태와 각 상태의 의미

이것들은 HTTP 에러 코드가 아니라, Claude Code가 표면화하는 한도 상태(limit states)입니다. 이를 정확히 읽어야 기다릴지, 모델을 바꿀지, 아니면 결제 플랜을 바꿀지를 결정할 수 있습니다.

함정은 네 번째 줄에 있습니다. 사람들은 새로운 세션 바를 보고 "한도 도달(limit reached)"이라는 메시지를 읽은 뒤 버그 리포트를 제출합니다. 거의 모든 경우 이는 세션 바에 표시되지 않는 주간 한도 때문입니다. 무언가 고장되었다고 가정하기 전에 /usage를 실행하고 주간 라인을 확인하십시오.

증상, 원인, 해결책

이 표는 기사 전체의 내용을 한곳에 모아놓은 것입니다. 각 원인은 아래의 해결책 섹션과 매칭됩니다.

해결책 1: Sonnet을 기본으로 사용하고, Opus는 어려운 부분에 남겨두기

기본 모델을 전환하는 것이 가장 큰 영향력을 발휘하는 단일 요소입니다. Opus는 Sonnet보다 턴(turn)당 비용이 몇 배 더 높으며, Sonnet은 Haiku보다 더 비쌉니다. FrankX 가격 책정에 따른 API 요율을 보면, Opus는 입력/출력 토큰 100만 개당 $5/$25로 4.8배, Sonnet은 $3/$15로 4.6배, Haiku는 $1/$5로 4.5배입니다. Opus의 더 무거운 추론 (reasoning) 비용까지 고려하면, 실제 턴당 비용 격차는 표기된 비율보다 더 벌어집니다.

Sonnet을 작업 기본값으로 설정하고, 아키텍처 결정, 까다로운 디버깅 (debugging), 잘못된 답변이 한 시간의 손실을 초래하는 작업 등 진정으로 어려운 부분에만 Opus를 사용하세요. /model 명령어를 사용하여 전환할 수 있습니다. 대부분의 수정, 리팩터링 (refactors), 테스트 작성 작업에서 Sonnet의 출력은 구별하기 어려울 정도이며, 이를 통해 주간 한도를 몇 배 더 길게 사용할 수 있습니다. Opus가 실제로 비용을 정당화하는 시점에 대한 더 깊은 메커니즘은 당사의 Claude Code 토큰 최적화 가이드에서 확인할 수 있습니다.

변경할 가치가 있는 설정이 하나 더 있습니다: 추론 노력 (reasoning effort)입니다. 기본 추론 설정은 대부분의 작업에서 중간 (medium) 설정보다 약 2배의 토큰을 소모합니다. 전역적으로 높음 (high) 설정을 유지하는 대신 프롬프트당 노력을 설정하고, 진정으로 필요한 문제에만 높은 노력을 할당하세요.

해결책 2: 서브에이전트 (Subagents)가 Opus를 병렬로 소모하는 것을 방지하기

서브에이전트 팬아웃 (fan-out)은 사용자가 타이핑하는 동안에는 나타나지 않기 때문에 가장 조용한 소모 요인입니다. 각 서브에이전트는 새로운 컨텍스트 윈도우 (context window)에서 자체적인 API 요청을 실행합니다. 서브에이전트는 사용자의 세션을 상속받지 않으므로, 필요한 내용을 다시 읽고 자체 호출에 대한 비용을 청구합니다. 에이전트 팀이 플랜 모드 (plan mode)에서 실행될 때 표준 세션보다 약 7배 많은 토큰을 사용할 수 있습니다. 최대 한도의 20배를 써버린 한 개발자는 사용량의 85%가 서브에이전트가 집중된 세션에서 발생했다는 것을 발견했습니다.

함정은 다음과 같습니다: 대부분의 설정은 모든 서브에이전트가 메인 세션의 모델을 상속받도록 되어 있으며, 이는 보통 Opus입니다. 따라서 모든 작업자가 Opus의 품질이 필요하지 않은 작업에도 Opus 가격을 지불하게 됩니다. 각 작업자의 프런트매터 (frontmatter)에서 명시적으로 경로를 지정하세요:

---
name: test-writer
model: sonnet   # 부모 모델인 Opus가 아님
...

모델 라우팅 (Model routing)만으로도 서브에이전트 (subagent) 비용 항목을 약 30% 절감할 수 있습니다. 이름 변경, 반복적인 편집, 또는 문서 조회와 같은 기계적인 작업에는 해당 작업자들을 Haiku로 낮추세요. 무거운 계획 (planning) 단계와 저렴한 실행 (execution) 단계를 분리하는 패턴은 당사의 Claude Code 하이브리드 라우팅 패턴 (Claude Code hybrid routing pattern)에서 다루고 있습니다.

두 번째로 더 교묘한 서브에이전트 비용은 바로 재독 (re-reads)입니다. 서브에이전트는 콜드 스타트 (cold start) 상태로 시작하기 때문에, 부모 모델이 이미 로드한 파일들을 다시 읽습니다. 서브에이전트가 저장소 (repo)의 절반을 다시 스캔하지 않도록 프롬프트 (prompt)를 좁게 유지하세요. "auth_test.py에서 실패하는 테스트를 수정하라"는 지시를 받은 작업자는 파일 하나를 읽지만, "테스트 커버리지를 개선하라"는 지시를 받은 작업자는 20개를 읽습니다.

해결 방법 3: 컨텍스트 윈도우 (Context window)를 잠식하기 전에 MCP 서버 정리하기

MCP 서버는 당신이 무엇을 하기도 전에 비용을 청구합니다. 7개의 연결된 MCP 서버는 세션 시작 시점에 도구 정의 (tool definitions)로만 67,300 토큰을 소비할 수 있으며, 이는 200k 컨텍스트 윈도우의 33.7%에 달합니다. Async Let's 분석에 따르면, 각 도구의 카탈로그는 서술형 텍스트와 스키마 (schema)를 합쳐 200~800 토큰을 사용하며, 이는 서버당 약 50개의 도구에 대해 곱해집니다. 이 오버헤드 (overhead)는 매 턴 (turn)마다 따라붙기 때문에, 주간 한도에 빠르게 도달하게 만듭니다.

두 가지 조치:

1. 감사 및 비활성화. /context를 실행하고 "MCP tools" 라인을 확인하세요. 2주 동안 사용하지 않은 서버는 모두 비활성화하십시오. 프로젝트 수준의 설정 (project-level config)을 사용하여 현재 저장소 로드에 관련 있는 서버만 사용하세요.
2. 도구 검색 (Tool Search) 지연 활용. Claude Code의 MCP 도구 검색 (MCP Tool Search, v2.1.7+)은 활성화된 MCP 도구 설명이 컨텍스트 예산의 10%를 초과하면 도구 로딩을 자동으로 지연시킵니다. 이 기능이 작동하기 시작하면 /context의 "MCP tools" 라인이 급격히 줄어들 것입니다. 이를 통해 기능이 제대로 작동하는지 바로 확인할 수 있습니다.

만약 여러 개의 서버를 상시 실행 중이라면, /context가 가장 빠른 감사 방법입니다. 흔히 발생하는 결과는 연결해 놓고 잊어버린 두세 개의 서버를 발견하는 것이며, 각 서버는 세션당 수만 토큰을 조용히 소모하고 있습니다.

해결 방법 4: /compact 및 /clear 습관을 통한 캐시 유지 (Keep the Cache Warm)

컨텍스트 위생(Context hygiene)은 프롬프트 캐시(Prompt cache)를 보호하며, 따뜻하게 유지된(warm) 캐시가 비용 절감의 핵심입니다. 프롬프트 캐싱은 캐싱된 입력 비용을 극적으로 줄여줍니다. Product Compass 비용 가이드에 따르면, 기본값인 5분 TTL(Time To Live)에서는 약 90%의 캐시 히트율(Cache hit rate)이 건강한 수준이며, 1시간 TTL에서는 약 97~99%까지 올라갑니다. 캐시를 망치는 주범은 세션 중간에 도구를 추가하거나 제거하는 것입니다. 이는 캐싱된 접두사(Prefix)를 무효화하여 전체를 다시 읽도록 강제합니다. 세션 시작 시 도구(Tool)와 모델을 고정하세요.

그다음, 컨텍스트 창(Window)을 의도적으로 관리하십시오:

• 사용량이 약 50%에 도달했을 때 또는 각각의 개별 작업이 끝난 후 /compact를 실행하세요. 이렇게 하면 이전 대화 내용이 매 턴마다 전체가 다시 전송되는 대신 요약됩니다.
• 서로 관련 없는 작업 사이에는 /clear를 사용하세요. 새로운 작업을 시작할 때 한 시간 동안 쌓인 오래된 컨텍스트를 끌고 가는 것보다 새로운 창을 시작하는 것이 훨씬 낫습니다.
• 자동 승인(Auto-accept) 및 백그라운드 루프(Background loops)를 주의 깊게 살피세요. 방치된 루프가 계속해서 재프롬프트(Re-prompting)를 수행하면, 당신이 잠든 사이 밤새도록 세션을 소모할 수 있습니다. 자리를 비우기 전에 작업량을 제한하고 유휴 백그라운드 태스크를 종료하세요.

플랜 등급별 해결 방법

모든 플랜에서 동일한 소모 요인이 적용되지만, 등급이 올라감에 따라 적절한 대응 수단이 달라집니다. 각 등급에서 우선적으로 집중해야 할 부분은 다음과 같습니다.

Free / Pro 등급

Pro 등급은 주간 사용 한도가 가장 타이트하므로 모델 관리(Model discipline)가 가장 중요합니다. 기본적으로 Sonnet을 사용하고, Pro 플랜에서는 서브 에이전트 팬아웃(Subagent fan-out)을 완전히 건너뛰세요(이는 작은 한도를 가장 빠르게 비우는 방법입니다). 또한 /compact를 조기에 실행하세요. Pro 등급은 일상적인 작업에 Opus를 사용할 경우 비용을 두 배로 지불하는 셈이 되므로 의존할 수 없습니다. 만약 여기서 주간 한도에 부딪힌다면, Max 플랜으로 업그레이드하거나 작업량이 많은 날에는 종량제 API 결제(Metered API billing)를 고려해야 할 시점입니다.

Max 5x / Max 20x 등급

Max 플랜은 서브에이전트 (subagents)를 실행할 수 있는 여유 공간을 가지고 있지만, 바로 그 지점에서 Max 사용자들의 비용이 급격히 상승합니다. Max 사용자만을 위한 가장 큰 해결책은 모든 서브에이전트의 모델을 프런트매터 (frontmatter)에서 라우팅하여, 이들이 Opus 모델을 상속받지 않도록 하는 것입니다. 또한 Max 플랜에는 두 번째 제한 사항인 Sonnet 전용 주간 한도가 적용되므로, 모든 모델 통합 한도 (all-models cap)를 아끼기 위해 모든 것을 Sonnet으로 전환한다면 /usage의 Sonnet 사용량 라인도 함께 확인해야 합니다. 모든 모델 통합 한도에 여유가 있더라도 Sonnet 한도를 모두 소진할 수 있기 때문입니다.

Team / Enterprise Tier

사용자 수 기반 플랜 (seat-based plans)의 경우, 사용량은 Anthropic의 문서에 따라 순환 윈도우 (rolling window) 방식으로 초기화되는 풀 (pool)에서 차감됩니다. 이 계층에서의 해결책은 조직적인 차원에서 접근해야 합니다: 팀 전체가 Sonnet을 기본값으로 사용하도록 하는 공유 모델 라우팅 컨벤션 (model-routing convention), 아무도 10개의 서버를 로드하지 않도록 리포지토리에 체크인된 최적화된 MCP 설정, 그리고 사용 풀이 바닥났을 때를 대비한 폴백 (fallback) API 키가 필요합니다. 정기적으로 사용 풀의 상한선에 도달하는 팀의 경우, 종량제 게이트웨이 (metered gateway)를 사용하면 사용자 수를 재협상하지 않고도 초과 사용을 위한 별도의 경로를 확보할 수 있습니다.

우리가 관찰한 일반적인 실패 패턴