Claude Code 사용 한도 완전 해설: 동작 방식과 초과를 피하는 법

Claude Code 사용 한도란?

Claude Code 사용량은 두 가지가 겹쳐서 관리됩니다:

• 5시간 롤링 세션 윈도우
• 하나 이상의 주간 사용 한도

이 중 하나라도 초과하면 레이트 리밋에 걸리게 됩니다.

5시간 롤링 윈도우

가장 눈에 띄는 한도는 5시간 롤링 윈도우입니다. 첫 프롬프트를 보낸 순간 윈도우가 시작됩니다. 이후 5시간 동안 하는 모든 작업은 동일한 사용량 풀에서 차감됩니다. 이 풀은 Claude Code와 Claude 채팅이 공유하므로, 한쪽의 활동이 다른 쪽에도 영향을 줍니다.

예를 들어:

• 첫 프롬프트: 오전 9:00
• 윈도우 종료: 오후 2:00

오전 10:30까지 사용량을 모두 소진했다면, 윈도우가 오후 2:00에 리셋될 때까지 접근이 일시 중지됩니다.

새 대화를 시작하면 사용량이 초기화된다고 오해하기 쉽지만, 그렇지 않습니다. /clear 명령은 새 대화 컨텍스트만 시작할 뿐, 사용 한도를 복원하거나 5시간 타이머를 리셋하지 않습니다.

주간 한도

시간 기반 세션 한도 외에도 Claude Code에는 주간 한도가 적용됩니다. 현재 세션에 여유가 남아 있더라도, 주간 한도에 도달하면 주간 리셋이 이루어질 때까지 일시적으로 사용이 차단될 수 있습니다. 

이렇게 이해하시면 됩니다. 5시간 한도는 사용의 타이밍을 제한하고, 주간 한도는 전체 사용량을 제한합니다.

즉, 현재 5시간 세션에 용량이 남아 있어도 주간 할당량을 소진했다면 막힐 수 있습니다. 대부분의 Pro 사용자에게는 이 구분이 비교적 단순합니다. 그러나 Max 요금제는 추가적인 복잡성이 있습니다.

Max 사용자용 Sonnet 주간 한도

Anthropic은 현재 Max 요금제에 대해 다음 한도를 적용합니다:

• 모든 모델에 적용되는 주간 한도
• Sonnet 사용에만 적용되는 별도의 주간 한도

이 구분이 중요한 이유는, 전체 모델 할당량을 소진했더라도 Sonnet 용량이 남아 있을 수 있고, 그 반대도 가능하기 때문입니다. 

예를 들어 일주일 대부분을 구현 작업에 Sonnet을 사용했다고 가정해 보겠습니다. 이 경우 Sonnet 전용 주간 할당량을 소진했더라도 전체 주간 할당량에는 여유가 남아 있을 수 있습니다. 그 시점에서는 남은 한도에 따라 다른 모델로 전환하거나, Sonnet 리셋을 기다리거나, 요금제를 업그레이드해야 할 수 있습니다.

반대의 상황도 가능합니다. 주중에 Opus를 많이 사용했다면, Sonnet 전용 할당량이 남아 있어도 전체 주간 한도에 먼저 도달할 수 있습니다. 전체 한도는 상위 한도이므로, 여기에 도달하면 Sonnet 용량이 얼마나 남았든 추가 사용이 불가능합니다.

Sonnet 요청이 성공하려면 다음 두 조건이 모두 충족되어야 합니다:

• 전체 주간 한도에 여유가 남아 있어야 합니다.
• Sonnet 주간 한도에도 여유가 남아 있어야 합니다.

반면 Opus 요청은 Opus 전용 할당량이 없으므로 전체 주간 풀만 소모합니다. 이 때문에 Claude.ai의 Usage 페이지가 중요합니다. 각 주간 한도와 그 리셋 시간을 각각 보여 주므로, 긴 코딩 세션 전에 어떤 한도에 근접하고 있는지 훨씬 쉽게 파악할 수 있습니다. 

요금제별 Claude Code 사용량

요금제를 비교할 때 한 가지 어려운 점은 Anthropic이 더 이상 단순한 "프롬프트 개수"를 공개하지 않는다는 것입니다.

대신 요금제는 상대적 용량 승수를 기준으로 설명됩니다. 이 승수는 Pro 요금제를 기준으로 했을 때 제공되는 사용 용량을 나타냅니다. 정확한 수치를 파악하기는 간단하지 않으며, 일부 사용자는 사용량을 퍼센트로 추적해 용량 대비 얼마나 많은 토큰을 사용했는지 대략적으로 파악합니다. 

2026년 5월 사용 한도 변경

Anthropic은 2026년 5월에 구독 사용 한도를 두 배로 늘리고, 이전에 Pro 및 Max 구독자에게 적용되던 피크 시간대 감산을 제거해 Claude Code 용량을 확장했습니다. 고정 프롬프트 개수를 공개하는 대신, 이제 요금제 차이는 상대적 용량 승수로 표현되며, 실제 사용량은 모델 선택, 컨텍스트 크기, 도구 사용에 따라 달라집니다.

그 이후로 Anthropic은 가끔 프로모션을 통해 주간 한도를 일시적으로 조정했습니다. 예를 들어 Claude Fable 5 출시 기간에는 적격 구독자에 대해 주간 Claude Code 한도가 50% 증가했습니다. 이러한 증가는 일시적이므로, 장시간 작업을 계획하기 전에는 항상 Claude Usage 대시보드에서 최신 한도를 확인하시기 바랍니다.

Agent SDK 크레딧(2026년 6월)

대화형 코딩 세션을 자동화된 에이전트 워크로드와 분리하려는 계획은 2026년 6월에 다소 혼란을 야기했습니다.

6월 15일 이전에는 모든 Claude Code 활동이 동일한 구독 풀에서 차감되었습니다. 터미널에서 대화형으로 채팅하든, GitHub Action을 실행하든, CI 파이프라인에서 claude -p를 호출하든, 모두 동일한 5시간 및 주간 한도를 두고 경쟁했습니다.

Anthropic은 2026년 6월 15일부터 이러한 워크로드를 분리하기 시작할 계획이었으나, 출시 당일에 변경을 일시 중지했습니다. 즉, 대화형 사용과 프로그래매틱 사용(Agent SDK, claude -p, GitHub Actions)은 여전히 예전과 같은 구독 풀에서 차감됩니다.

2026년 7월 기준으로, 별도의 Agent SDK 크레딧은 실시되지 않았으며, 신청할 수 있는 옵트인 크레딧도 없습니다.

실제로 할당량을 잠식하는 것은?

많은 개발자가 프롬프트 사용량과 토큰 튜닝에 집중합니다. 그러나 진짜 요인은 종종 컨텍스트입니다. 각 상호작용에는 사용자가 입력한 질문보다 훨씬 많은 정보가 포함됩니다.

CLAUDE.md와 규칙 파일

Claude Code는 다음 위치에서 지침을 자동으로 불러옵니다:

• CLAUDE.md

• 상위 디렉터리의 CLAUDE.md 파일

• 가져온 @ 참조

• .claude/rules/*.md 파일

이 모든 컨텍스트와 추가 지침이 요청마다 반복해서 포함됩니다. 즉, 과도하게 비대한 규칙 파일은 세션 전체에 걸쳐 토큰 소비를 조용히 늘립니다. Anthropic은 개별 CLAUDE.md 파일을 대략 200줄 이하로 유지할 것을 권장합니다.

더 큰 프로젝트에서는 경로 프론트매터를 사용하는 범위 지정 규칙으로 지침을 분리해, 관련될 때만 로드되도록 고려하세요. 더 자세한 내용은 최적의 CLAUDE.md 작성 가이드에서 효과적인 구성 전략을 확인하실 수 있습니다.

MCP 도구 정의

Model Context Protocol(MCP) 서버도 숨은 오버헤드의 또 다른 원인입니다. 연결된 MCP 서버는, 설령 해당 도구를 전혀 사용하지 않더라도, 도구 스키마를 Claude의 컨텍스트에 주입합니다.

가령 다음과 같다고 해봅시다:

• MCP 서버 5개
• 서버당 도구 10개

그렇다면 매 요청마다 50개의 도구 정의가 포함됩니다. 사용하지 않는 MCP 서버 연결을 해제하는 것이 Claude Code의 토큰 소비를 줄이는 가장 쉬운 방법 중 하나입니다.

중요한 주의사항: 활성 세션 중에는 MCP 서버를 추가하거나 제거하지 마세요. 이렇게 하면 프롬프트 캐시 프리픽스가 무효화되어 사용 비용이 증가할 수 있습니다.

자동 메모리

Claude Code v2.1.59부터 자동 메모리가 기본적으로 활성화됩니다. 메모리는 서로 다른 세션에서 Claude가 저장한 전역 지식으로, 추가 컨텍스트를 제공합니다. 이는 데이터베이스에서 데이터를 가져오는 방법부터 구현된 기술적 세부사항에 이르기까지 다양할 수 있습니다.

시작 시 Claude는 MEMORY.md에서 최대 다음 범위까지 내용을 로드합니다:

• 처음 200줄
• 처음 25 KB

일부 워크플로에서는 유용하지만, 다른 경우에는 단지 불필요한 추가 컨텍스트일 뿐입니다.

자동 메모리는 몇 가지 방법으로 비활성화할 수 있습니다. 다른 모든 설정을 무시하는 영구적인 킬 스위치가 필요하다면(CI 파이프라인 및 자동화 환경에 유용), 셸에서 환경 변수를 설정하세요:

export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1

또는 settings.json에 다음을 추가하세요. 모든 프로젝트에서 비활성화하려면 ~/.claude/settings.json을, 단일 프로젝트에만 적용하려면 .claude/settings.json을 사용하세요:

{ "autoMemoryEnabled": false }

메모리 파일을 적극적으로 사용하지 않는다면, 이 기능을 끄면 기본 컨텍스트 크기를 줄일 수 있습니다.

대화 기록과 검색

대화 기록은 계속 커집니다. 모든 도구 결과, 파일 읽기, grep 출력, 터미널 명령, 코드 검색이 세션 컨텍스트의 일부가 됩니다.

제 경험상, 리포지토리 탐색이 가장 큰 기여자입니다. Claude는 특정 함수를 찾기 위해 수십 개의 파일을 읽을 수 있습니다. 이 파일들은 컨텍스트에서 유지되며 이후 턴에서도 계속 토큰 오버헤드를 유발합니다.

자동화된 워크플로에서는 claude -p --bare를 사용하면 불필요한 세션 컨텍스트를 제거해 이러한 고정 오버헤드의 상당 부분을 줄일 수 있습니다. 이는 Claude가 파일을 검색하느라 소모했을 월간 Agent SDK 크레딧을 크게 절약해 줍니다.

Claude Code 사용량 확인 방법

사용량을 확인하기 가장 좋은 시점은 긴 코딩 세션을 시작하기 전입니다. 이렇게 하면 실제 코딩 전에 한도에 얼마나 근접했는지 파악할 수 있습니다.

/usage 사용하기

Claude Code에서 /usage를 입력하면 다음이 표시됩니다:

• 세션 사용량
• 주간 사용량
• 남은 할당량

이는 대화형 세션에서 남은 할당량을 한눈에 파악해 미리 계획하는 데 유용합니다. 한도에 거의 도달하기 직전에 크고 복잡한 작업을 시작하는 것은 현명하지 않을 수 있지만, 파일 정리 같은 단순 작업은 남은 할당량을 잘 활용하는 방법일 수 있습니다.

/status 사용하기

또한 /status를 실행하면 다음 정보를 확인할 수 있습니다:

• 현재 요금제
• 계정 정보
• 활성 사용 상태

요금제와 활성 상태를 알면 잠재적 제약을 파악하는 데 도움이 됩니다. 기준선의 5배인지 20배인지가 중요합니다.

Claude 대시보드에서 확인하기

가장 완전한 뷰는 Settings → Usage 메뉴로 이동한 Claude.ai 내에 있습니다.

이 대시보드는 다음을 통합해 보여줍니다:

• Claude 채팅 사용량
• Claude Code 사용량
• 주간 리셋 일정
• 모델별 한도

동시에 여러 한도가 존재할 수 있으므로, 이 대시보드를 신뢰 가능한 기준으로 삼으세요. 대규모 리팩터링, 긴 디버깅 세션, 자율 코딩 작업을 시작하기 전에 사용량을 확인하는 습관을 들이면 실무에 유리합니다.

Claude Code 한도를 최대한 활용하는 방법

요금제를 업그레이드하지 않고 사용 한도를 늘리는 방법을 살펴보겠습니다. 오버헤드를 줄이기만 해도 훨씬 효율적인 용량을 확보할 수 있습니다.

CLAUDE.md를 다이어트하세요

파일당 200줄 미만을 목표로 하여 전송되는 컨텍스트 양과 에이전트의 혼란을 최소화하세요. 다음을 점검해 보세요:

• 구식 프로젝트 지침
• 과거 기록 노트
• 개별 프롬프트에 넣는 편이 나은 규칙

특정 디렉터리에만 필요한 지침이라면 paths 프론트매터가 있는 범위 지정 규칙을 사용해 규칙이 항상 적용되지 않고 필요한 경로에서만 사용되도록 하세요. 전역 파일 대신 프로젝트 수준의 CLAUDE.md 파일을 둘 수도 있습니다.

MCP 서버 점검

실제로 사용하는 MCP 서버만 유지하세요. 연결된 서버 하나하나가 모든 상호작용에 스키마 오버헤드를 더합니다. MCP 구성은 브라우저 탭처럼 관리하세요. 지금 사용하지 않는다면 닫으세요. 

좋은 방법은 사용자 수준이 아니라 프로젝트 수준에 MCP 서버를 설치하는 것입니다. 이렇게 하면 특정 프로젝트에서만 필요한 MCP를 로드하게 되어, 모든 프로젝트나 세션에서 매번 로드하지 않게 됩니다.

/compact를 일찍 사용

/compact 명령은 대화 기록을 요약해 향후 토큰 비용을 줄여 줍니다. 매 턴마다 처리되는 컨텍스트 증가분을 줄이면, 한도 소모도 줄어듭니다. 

이미 소모한 한도를 복원해 주지는 않지만, 세션이 과도하게 커지기 전에 /compact를 사용하면 도움이 됩니다. 

작업에 맞는 모델 선택

모든 작업에 Opus나 Fable이 필요한 것은 아닙니다. 더 작은 모델이나 영리한 모델 사용법이 한도 관리에 도움이 될 수 있습니다. 고가 모델은 가치가 큰 작업에만 아껴 쓰면 사용 가능 용량을 크게 늘릴 수 있습니다. 

다음은 모델 최적화 전략 예시입니다:

• 아키텍처 결정, 복잡한 추론, 모호한 요구사항에는 Opus
• 편집, 검색, 구현 작업에는 Sonnet
• 가벼운 작업과 빠른 읽기에는 Haiku

다만 세션 중 모델을 잦게 바꾸는 것은 피하세요. 프롬프트 캐시는 모델별이므로, 모델을 바꿀 때마다 새 모델이 대화 기록 전체를 캐시 없이 처음부터 다시 처리해야 합니다. 이는 "더 저렴한" 모델로 바꾸더라도 그대로 유지할 때보다 한도를 더 빨리 소모할 수 있습니다.

한도에 막혔을 때: API로 폴백

구독 한도가 병목이 된다면 Claude API가 대안이 될 수 있습니다. API 사용은 5시간 세션 윈도우나 주간 구독 한도로 제한되지 않습니다. 대신 토큰 사용량에 따라 비용을 지불합니다.

다음과 같은 경우에 적합할 수 있습니다:

• CI 파이프라인
• 장시간 실행되는 자율 에이전트
• 대규모 자동화
• 예산이 예측 가능한 프로덕션 워크플로

주의할 점은 Claude Code 셸에 ANTHROPIC_API_KEY 환경 변수를 남겨 두는 것입니다. 이 키가 환경에 존재하면, Claude Code가 구독 계정이 아니라 API를 통해 인증할 수 있습니다.

이 경우 더 이상 구독 한도를 사용하지 않고 토큰 비용을 지불하게 되어 예상치 못한 API 요금이 청구될 수 있습니다. 비용이 평소와 다르게 보일 때는 인증 설정을 확인하는 것이 초기 트러블슈팅 단계가 되어야 합니다.

최신 모델 가격은 변동이 잦고 모델별로 다르므로, 항상 Anthropic의 공식 가격 문서를 참고하세요.

마무리 생각

Claude Code 사용 한도는 단순히 프롬프트 개수를 세는 문제가 아님을 이해하면 관리가 훨씬 쉬워집니다.

이 시스템은 다음을 결합합니다:

• 5시간 롤링 윈도우
• 주간 한도
• 모델별 할당량
• 컨텍스트 오버헤드

많은 개발자에게 가장 놀라운 점은 프롬프트가 전체 토큰 사용량에서 차지하는 비중이 종종 적다는 것입니다. 큰 CLAUDE.md 파일, MCP 도구 정의, 자동 메모리, 리포지토리 검색, 누적되는 대화 기록이 질문 자체보다 더 많은 용량을 소모하는 경우가 흔합니다.

실무에서는 비정상적으로 빠르게 한도에 도달하는 대부분의 경우, 용량 문제가 아니라 구성 문제인 경우가 많습니다. 요금제를 업그레이드하기 전에, 더 큰 한도를 구매하기보다는 컨텍스트를 정리해 오버헤드를 줄이세요.

워크플로를 계속 개선하려면 Claude Code 모범 사례 가이드와 Claude Code Hooks 튜토리얼을 추천합니다. 두 자료 모두 긴 개발 세션에서 Claude Code를 더 효율적이고 탄탄하게 만드는 기법을 다룹니다.