Claude Code가 “usage limit reached” 메시지로 막아도, 그 뒤엔 한도가 하나만 있는 게 아니다. 셋이다. 5시간 세션 한도, 7일 주간 한도, 그리고 플랜 포함분을 넘겼을 때 쓰는 사용량 크레딧. 어느 벽에 막혔느냐에 따라 5시간을 기다리느냐 최대 7일을 기다리느냐가 갈린다. 대부분 놓치는 함정 하나. claude.ai 채팅, Claude Code, Claude Desktop이 같은 한도를 같이 쓴다.
이 글은 세 한도를 Anthropic 공식 문서 기준으로 분리한다. 추측이 아니다. 기존 가이드가 시점이나 구조를 헷갈리는 부분은 그대로 짚었다. 한도와 플랜 세부는 2026년 5월 기준이고 시간이 지나면 바뀌므로, 본인 계정의 정확한 값은 사용량 설정 페이지가 최종 기준이다.
이 글이 필요한 이유
Claude Code가 왜 막혔는지 검색하면, 세 한도를 뭉뚱그린 가이드가 나온다. 전부 “주간 한도"라 부르거나, 주간 한도가 언제 도입됐는지 시점을 틀리게 적는다. 그래서 엉뚱한 리셋을 기다린다. 세 층을 나눠 보면 구조는 깔끔하고, 각 층은 자기 시계로 리셋된다. Claude Code 과금이 다른 AI 코딩 도구와 어떻게 다른지는 AI 코딩 도구 과금 정리에서 다뤘다. 이 글은 한도 자체에 집중한다.
세 한도, 따로 보기
Claude Code 사용량은 서로 쌓이는 세 가지 방식으로 관리된다.
1. 5시간 세션 한도. 무거운 코딩 세션에서 가장 자주 부딪히는 층이다. 플랜 포함 사용량에 도달하면 포함 사용량 한도는 5시간마다 리셋된다. 고정 시각이 아니라 세션을 시작한 시점부터 굴러가는 롤링 방식이다.
2. 7일 주간 한도. Pro·Max 구독자에게 도입된, 5시간 한도에 더해지는 더 긴 예비분이다. Anthropic은 7일마다 리셋되는 주간 한도 두 종류를 도입했다. 하나는 전체 사용량 한도, 하나는 가장 고성능인 Opus 모델 전용 한도다. 그래서 5시간 창이 계속 갱신돼도, 사용량이 많으면 주간 한도가 먼저 바닥날 수 있다.
3. 사용량 크레딧(초과 사용). 플랜 포함분을 넘겨도 크레딧으로 작업을 이어갈 수 있다. 크레딧은 Pro·Max·Team·좌석제 Enterprise에서 쓸 수 있고, Claude 대화와 Claude Code 양쪽에 적용된다. 알아둘 디테일 하나. 크레딧을 꺼도 5시간 리셋 타이밍은 안 바뀐다. 그 창은 자기 일정대로 리셋된다.
아래 스크린샷이 앞의 두 층을 사용량 패널에서 실제로 보여준다. 5시간 세션 막대와 7일 주간 막대, 각각 자기 리셋 카운트다운이 붙어 있다. 크레딧 층은 포함분을 넘겨야 나타난다.
지금 막힌 건 어느 한도인가
막힘 메시지는 똑같아 보여도 대기 시간은 다르다. 5시간 창에 막혔다면 몇 시간이면 풀린다. 주간 한도를 다 썼다면 5시간을 기다려도 소용없다. 7일 창이 넘어갈 때까지 기다려야 하고, 그건 며칠 뒤일 수 있다.
구분하려면 사용량 패널을 보면 된다. Claude Code 터미널에서 /usage 슬래시 명령을 쓰거나, 브라우저에서 사용량 설정 페이지를 열면 남은 사용량과 주간 한도 상태를 볼 수 있다. 꽉 찬 막대가 지금 막고 있는 한도다. Opus 전용 주간 한도는 흔한 함정이다. 다른 모델은 여유가 있는데 Opus만 막힐 수 있다.
같은 한도를 나눠 쓰는 함정
claude.ai 채팅이 Claude Code 한도를 깎아먹나. 그렇다. 이게 개발자들이 가장 자주 헷갈리는 지점이다. Claude Code는 채팅 사용량과 따로 계산되지 않는다. claude.ai, Claude Code, Claude Desktop의 사용량이 전부 같은 한도로 합산된다.
오전에 길게 한 채팅 대화가, 오후에 Claude Code에 쓸 예산을 줄여놓는다. 코딩 마감 때문에 사용량을 아끼는 중이라면, 그 가벼운 claude.ai 세션은 공짜가 아니다. 같은 한도를 쓰는 것이다.
언제 리셋되나
시간 기반 두 한도는 리셋 방식이 다르고, 둘 다 매일 고정된 시각이 아니다.
5시간 창은 롤링 방식이다. 처음 쓴 시점부터 세서 5시간 뒤에 리셋된다. 그래서 시작 시각에 따라 리셋 시각이 매번 달라진다. 주간 한도는 7일 창이고, 특정 모델에서 한 번 바닥나면 그 7일이 다 차야 풀린다. 5시간 대기로는 건드려지지 않는다.
둘 다 자정 같은 고정 시각이 아니라 롤링이라, 정확한 리셋 시점을 아는 유일한 방법은 외워둔 시각이 아니라 사용량 패널의 카운트다운이다.
2026년 5월 중순, 계정 카운터가 일괄 리셋되고 주간 한도에 한시 프로모가 붙었다는 3자 보도가 있었다. 작성 시점 Anthropic 공식 문서엔 반영돼 있지 않아 미확인으로 둔다. 현재 값은 본인 사용량 패널을 기준으로 삼는 게 맞다.
막혔을 때 할 수 있는 것
노력 순으로 세 가지다. 한도에 도달하면 리셋을 기다리거나, 플랜을 업그레이드하거나, 사용량 크레딧을 구매할 수 있다.
그 너머의 더 오래가는 해법은 작업당 소비를 줄이는 것이다. Anthropic 자체 가이드도 재사용에 무게를 둔다. 여러 번 참조할 자료는 프로젝트에 올리고, 첫 메시지에 코딩 환경 맥락을 충분히 담으라는 것. 같은 내용을 재사용할수록 캐싱 이득이 커지기 때문이다. Claude Code라면 반복 작업을 스킬로 만들어두면 매번 다시 보내는 맥락이 줄어든다.
플랜·한도 정리표
| 한도 | 리셋 주기 | 적용 대상 | 확인 위치 |
|---|---|---|---|
| 세션(5시간) | 5시간마다, 세션 시작부터 롤링 | 전체 유료 플랜 | /usage 또는 사용량 설정 |
| 주간 — 전체 | 7일마다, 롤링 | Pro, Max (2025-08-28부터) | /usage 또는 사용량 설정 |
| 주간 — Opus 전용 | 7일마다, 롤링 | Pro, Max | /usage 또는 사용량 설정 |
| 사용량 크레딧 | 해당 없음 (포함분 초과 시 종량) | Pro, Max, Team, 좌석제 Enterprise | 사용량 설정 |
값과 적용 범위는 2026년 5월 Anthropic 문서 기준이며 바뀔 수 있다. 본인 계정은 사용량 설정 페이지가 최종 기준이다.
FAQ
한도에 막혔는데 5시간 지나도 안 풀려요. 왜죠?
5시간 창이 아니라 주간 한도일 가능성이 높다. 특정 모델의 주간 한도를 다 쓰면 5시간을 기다려도 복구되지 않고, 7일 창이 리셋될 때까지 기다려야 한다.
claude.ai 채팅이 Claude Code 한도를 쓰나요?
그렇다. claude.ai, Claude Code, Claude Desktop 사용량이 전부 같은 한도로 합산된다.
매일 고정된 리셋 시각이 있나요?
없다. 5시간 창은 쓰기 시작한 시점부터 굴러서 리셋 시각이 달라진다. 외운 시각 대신 사용량 패널 카운트다운을 보면 된다.
사용량 크레딧이 뭔가요?
플랜 포함 사용량을 넘겨도 작업을 이어가는 방법이다. Pro·Max·Team·좌석제 Enterprise에서 쓸 수 있고 Claude 대화와 Claude Code 양쪽에 적용된다.
남은 양은 어떻게 확인하나요?
Claude Code에서 /usage 슬래시 명령을 쓰거나 브라우저에서 사용량 설정 페이지를 열면 된다.
Opus만 막히고 다른 모델은 되는 경우가 있나요?
있다. 주간 한도엔 Opus 전용 한도가 따로 있어서, 다른 모델은 여유가 있어도 Opus만 바닥날 수 있다.
출처
- Anthropic — How usage and length limits work: https://support.claude.com/en/articles/11647753-how-do-usage-and-length-limits-work
- Anthropic — Manage usage credits for paid plans: https://support.claude.com/en/articles/12429409-manage-extra-usage-for-paid-claude-plans
- Anthropic — Usage limit best practices: https://support.claude.com/en/articles/9797557-usage-limit-best-practices
업데이트 기록
- 2026-05-21 — 초기 게시. 한도 구조(5시간 세션, 7일 주간 전체+Opus, 사용량 크레딧)는 Anthropic support 문서 기준. 주간 한도는 2025년 8월 28일 Pro·Max에 적용. 2026년 5월 중순의 일괄 리셋·프로모 보도는 공식 문서 확인 전까지 미확인으로 표기.
교육용 콘텐츠. 한도·플랜 세부는 바뀐다. 현재 값은 본인 Anthropic 사용량 설정 페이지에서 확인할 것.