클로드 코드(Claude Code)를 본격적으로 쓰기 시작하시면 가장 빨리 부딪히는 벽이 “사용량 한도”입니다. 그런데 여기서 한 단계 더 헷갈리는 게 있습니다. 클로드 코드의 한도는 한 가지가 아니라 세 가지입니다. 5시간 단위로 차오르는 세션 한도, 7일 단위로 차오르는 위클리 한도, 그리고 매 호출에서 그냥 깎이는 단순 사용량(토큰)이 동시에 적용됩니다. 셋을 헷갈리시면 “왜 갑자기 막혔지”, “왜 곧 풀린다더니 안 풀려” 같은 답답함이 생깁니다. 이 글에서는 세 한도를 한 번에 구분해 드리고, 본인 플랜에서 실제로 얼마나 쓸 수 있는지까지 정리해 드립니다. 본문 수치는 2026년 4월 기준 참고용입니다.
목차
한 줄 요약: 세 한도가 동시에 작동한다
핵심부터 짚고 가시면 이해가 빠릅니다.
| 구분 | 주기 | 측정 단위 | 역할 |
|---|---|---|---|
| 5시간 세션 한도 | 첫 프롬프트로부터 5시간 롤링 | 메시지·토큰 | 단기 폭주 방지 |
| 위클리(주간) 한도 | 7일 롤링 | active compute hours | 장기 총량 통제 |
| 단순 사용량 | 매 호출마다 | 토큰 | 실제 소비량 그 자체 |
세 가지는 서로 독립입니다. 5시간 한도가 안 차도 위클리에 도달하면 막히고, 위클리가 안 차도 5시간 안에 폭주하면 또 막힙니다. 세 종류를 분리해서 보셔야 본인 상황을 정확히 파악할 수 있습니다.
5시간 세션 한도: 단기 폭주를 막는 안전장치
가장 자주 마주치는 한도입니다. 본인의 첫 프롬프트가 들어간 시점을 기준으로 5시간이 지나면 자동으로 차오릅니다. 정해진 시각에 풀리는 것이 아니라 “내가 처음 친 시각 + 5시간”이 리셋 시점입니다.
플랜별 5시간당 가용량(참고치)은 다음과 같습니다.
- Pro: 약 10~40개 클로드 코드 프롬프트 또는 약 44,000 토큰
- Max 5x: Pro의 약 5배, 약 88,000 토큰
- Max 20x: Pro의 약 20배, 약 220,000 토큰
같은 메시지여도 컨텍스트가 길거나 Extended Thinking을 켜면 토큰 소모가 빠르게 늘어 한도에 일찍 닿습니다. 또 평일 오전 5~11시(PT) 같은 피크 시간대에는 같은 양을 써도 더 빠르게 깎이는 식의 조정이 들어갑니다.
위클리(주간) 한도: 장기 총량을 다루는 캡
위클리 한도는 5시간 한도 위에 한 층 더 얹힌 캡입니다. 7일 단위로 본인의 누적 사용량을 따로 세어, 그 총량이 일정선을 넘어가면 다음 주기까지 막히는 구조입니다.
여기서 핵심 개념은 “active compute hours“입니다. 이는 모델이 실제로 토큰을 처리하거나 코드 작업을 하는 시간만 계산한 값입니다. 본인이 채팅창을 열어 둔 시간이 아니라, 클로드가 실제로 일하고 있는 시간만 누적됩니다.
- Pro: Sonnet 기준 주당 약 40~80 active hours
- Max 5x: Sonnet 약 140~280 hours, Opus 약 15~35 hours (별도 캡)
- Max 20x: Sonnet 최대 약 480 hours, Opus 약 40 hours까지 확장
Max 플랜에는 Sonnet 전체 한도와 별개로 Opus만의 주간 한도가 따로 있습니다. Opus는 가장 비싼 모델이라 별도로 통제되는 셈입니다. 주간 한도는 사용 시작 후 7일이 지나면 리셋되며, 일부 사용자들은 리셋 시점이 약간 변동된다고 보고합니다.
단순 사용량: 매 호출마다 깎이는 토큰
위 두 한도와 별개로, 모든 호출은 그 자체로 토큰을 소모합니다. 같은 5시간 안에서도 본인이 보내는 프롬프트 종류에 따라 한도 소진 속도가 크게 달라집니다.
- 코드베이스 전체 읽기: 입력 토큰이 한 번에 수만~수십만 단위로 들어갑니다.
- Extended Thinking: 모델이 길게 추론할수록 출력 토큰이 늘어 한도가 급격히 깎입니다.
- 긴 컨텍스트 유지: 같은 세션을 길게 이어 가면 직전 메시지가 매번 다시 들어가 누적 부담이 큽니다.
- 도구 호출: MCP 서버 응답, 파일 읽기 결과도 모두 컨텍스트에 들어가 토큰을 차지합니다.
그래서 “오늘 하루 종일 일했는데 왜 한도에 안 닿지?”와 “30분 만에 한도가 끝났네?”가 같은 플랜에서도 나란히 일어납니다. 한도 자체가 문제가 아니라 본인의 호출 패턴이 변수입니다.
현재 사용량 확인하는 법
지금 어떤 한도가 얼마나 남았는지는 클로드 코드 안에서 직접 확인할 수 있습니다.
- 클로드 코드 세션에서
/usage명령 입력 → 5시간/위클리 사용량 그래프 표시 - Anthropic 콘솔의 사용량 페이지에서 더 상세한 통계 확인
- 한도에 가까워지면 클로드 코드가 사용량 경고를 자동으로 띄움
한도가 얼마 안 남았다면 큰 작업을 시작하기 전에 미리 본인의 잔여량을 보시는 것이 안전합니다.
한도에 닿았을 때 선택지
막혔다고 해서 무조건 다음 리셋까지 기다려야 하는 것은 아닙니다.
| 상황 | 선택지 |
|---|---|
| 5시간 한도 도달 | 리셋까지 기다리거나(평균 1~5시간), 추가 사용량 결제 |
| 위클리 한도 도달 | 다음 주기까지 기다리거나, 상위 플랜으로 업그레이드 |
| 특정 모델만 막힘(Opus 등) | Sonnet·Haiku로 전환해 작업 이어 가기 |
| 당장 끝내야 하는 작업 | Pro·Max 사용자는 “추가 사용량(extra usage)” 옵션 활성화 가능 (표준 API 요금) |
추가 사용량은 본인의 신용카드로 표준 API 요금이 청구되므로, 평소 정액제처럼 부담 없이 쓰시기보다는 마감 직전에만 쓰시는 편이 합리적입니다.
한도를 효율적으로 쓰는 5가지 팁
같은 플랜으로도 한도 소진 속도를 크게 늦출 수 있는 실용적 방법입니다.
- 긴 세션은 자주 끊기: 컨텍스트가 누적되면 매 호출 비용이 커집니다. 작업 단위가 끝나면 새 세션으로 전환하십시오.
- 모델 단계적 사용: 코드 자동완성·간단 질의는 Haiku, 일반 작업은 Sonnet, 정말 어려운 추론에만 Opus를 씁니다.
- Extended Thinking 절제: 정말 필요한 순간에만 켜십시오. 매 호출 자동 활성화는 토큰을 빠르게 잡아먹습니다.
- 코드베이스 읽기 범위 제한: “프로젝트 전체 읽어 봐”보다 “이 폴더만 읽어 봐”가 훨씬 효율적입니다.
- 피크 시간 회피: 평일 오전(PT 기준) 한국 시간 새벽~오전이 피크입니다. 가능하면 한국 시간 저녁·밤 작업이 한도 측면에서 유리합니다.
자주 묻는 질문
5시간 한도가 차도 위클리는 멀쩡할 수 있나요?
네. 두 한도는 독립이라 5시간 한도가 다 차도 위클리는 아직 여유 있는 경우가 많습니다. 이때는 5시간 리셋만 기다리시면 다시 시작할 수 있습니다.
위클리 한도는 정확히 언제 리셋되나요?
본인이 위클리 사용을 처음 시작한 시점부터 7일 후입니다. 모든 사용자에게 같은 요일·시각에 일제히 리셋되는 것이 아니라 개인별 시점으로 굴러갑니다. 일부 사용자들은 리셋 시점이 약간 앞당겨지거나 늦춰지는 경우도 보고합니다.
막힌 작업을 다른 모델로 이어서 할 수 있나요?
특정 모델만 막힌 경우(예: Max의 Opus 별도 한도)에는 같은 세션에서 Sonnet이나 Haiku로 전환해 작업을 이어 갈 수 있습니다. 모든 모델이 다 막혔다면 5시간/위클리 리셋을 기다리거나 추가 사용량을 결제하셔야 합니다.
한도 정보가 정확하지 않은 것 같습니다.
앤트로픽이 공식 수치를 모두 공개하지는 않습니다. 본문 수치도 사용자 보고와 공개 자료를 종합한 참고치이므로, 본인의 실제 한도는 항상 /usage나 콘솔에서 확인하시는 것이 가장 정확합니다.
정리
클로드 코드의 한도는 5시간 세션, 위클리 주간, 단순 사용량(토큰) 세 가지가 동시에 작동하는 구조입니다. 셋을 분리해서 보시면 “왜 막혔지”, “언제 풀리지”라는 의문이 한결 명확해집니다. 같은 플랜으로도 모델 선택, Extended Thinking 절제, 세션 분리 같은 작은 습관 차이가 한도 소진 속도를 크게 바꿉니다. 한도가 자주 답답하시다면 상위 플랜 결제 전에 본인 호출 패턴부터 한 번 점검해 보시는 것을 권해 드립니다.