Claude Code 사용량은 언제 초기화되나요? 5시간 창과 주간 한도 정리
Claude Code의 세션 한도는 5시간 롤링 창으로, 주간 한도는 계정마다 정해진 시각에 초기화됩니다. 내 정확한 초기화 시각을 확인하는 방법을 알아봅니다.
- CLI
- 0.2.17
- 프리뷰 ref
- a2c45c8
요약
Pro, Max, Team, Enterprise 좌석에서 쓰는 Claude Code에는 두 가지 한도가 있고, 초기화 방식이 다릅니다.
- 세션 한도는 5시간 롤링 창으로 초기화됩니다. 정시나 자정과는 상관이 없어서 초기화 시각이 날마다 달라집니다.
- 주간 한도는 계정에 배정된 정해진 요일과 시각에 초기화됩니다. Anthropic 도움말 센터에 따르면 Claude를 언제 쓰기 시작했는지, 구독이 언제 시작됐는지와 상관없이 그대로입니다.
정확한 시각은 Claude Code에서 /usage를 실행하거나 claude.ai에서 Settings → Usage를 열면 볼 수 있습니다. 한도 메시지 자체에도 You've hit your session limit · resets 3:45pm처럼 시각이 나옵니다.
문제
리팩터링 도중 한도에 걸렸고 메시지에는 오후 3시 45분에 초기화된다고 나옵니다. 당연히 몇 가지 질문이 생깁니다. 이건 5시간 한도인가, 주간 한도인가? 모델을 바꾸면 도움이 되나? 주간 한도라면 5시간 기다리는 게 의미가 있나? 그리고 어제는 왜 다른 시각에 초기화됐지?
두 창은 동시에 돌아가고 같은 사용량을 셉니다. 대부분의 혼란은 여기서 나옵니다.
Claude의 두 사용량 창이 동작하는 방식
2026년 10월 26일에 확인한 Anthropic 도움말 센터의 사용량 한도, Pro, Max 페이지 기준:
| 창 | 초기화 | 적용 대상 |
|---|---|---|
| 세션 한도 | 5시간마다, 롤링 창 | 모든 유료 요금제, 그리고 무료 요금제의 채팅 |
| 주간 한도 | 계정마다 정해진 요일과 시각 | 유료 요금제, 모든 모델 공통 |
| 모델별 한도 | 메시지에 표시 | 일부 요금제는 특정 모델에 별도 주간 한도가 있음 (예: Max의 Fable) |
문서의 세 가지 사실로 사람들이 겪는 일 대부분이 설명됩니다.
- 모든 사용처가 집계됩니다. 웹, 데스크톱, 모바일의 Claude와 터미널, IDE의 Claude Code는 같은 한도에서 차감됩니다.
- 사용량은 두 창에 동시에 집계됩니다. Anthropic 오류 레퍼런스에 따르면 대규모 워크플로 병렬 실행 같은 한 번의 집중 사용으로 세션 창이 초기화되기 전에 주간 할당량을 다 쓸 수도 있습니다.
- Anthropic은 다른 상한을 둘 수도 있습니다. 요금제 페이지에는 주간, 월간 상한이나 모델과 기능 사용 등 다른 방식으로도 사용량이 제한될 수 있다고 나와 있습니다.
"롤링"은 보통 초기화 후 첫 메시지부터 5시간이 시작된다고 해석됩니다. Anthropic 페이지는 "5시간 롤링 세션 창"이라고만 하고 시작점을 밝히지 않으므로, /usage에 표시된 시각을 기준으로 삼으세요.
내 Claude Code 초기화 시각 정확히 확인하기
Claude Code에서
실행:
/usage구독이라면 /usage는 세션 창과 주간 창의 사용량 막대를 초기화 시각과 함께 보여 줍니다. 요금제 한도 요청이 속도 제한에 걸리면, 이 머신에서 지난 한 시간 동안 마지막으로 불러온 막대를 Showing last-known usage 안내와 함께 보여 줍니다. r을 눌러 다시 시도하세요.
한도 메시지에서
창을 다 쓰면 메시지가 어느 창인지, 언제 초기화되는지 알려 줍니다.
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm그 전에 Claude Code가 You've used 85% of your session limit · resets 3:45pm 같은 줄로 경고할 수 있습니다.
claude.ai에서
Settings → Usage를 엽니다. 현재 세션과 다음 주간 초기화가 표시됩니다.
상태 표시줄에서
사용자 지정 상태 표시줄의 rate_limits 객체에는 five_hour와 seven_day 창이 있고, 각각 used_percentage와 Unix 타임스탬프인 resets_at을 담고 있습니다. Pro와 Max 구독자에게는 첫 API 응답 이후에 나타납니다. 동작하는 스크립트는 Claude Code 사용량 확인하는 방법에 있습니다.
메시지별로 기다리면 되는지
- 세션 한도: 표시된 시각까지 기다리면 다시 쓸 수 있습니다. 세션 한도는 모든 모델에 적용되므로 모델을 바꿔도 소용없습니다.
- 주간 한도: 5시간 기다려도 아무 변화가 없습니다. 메시지에 나온 주간 초기화 시각에 다시 쓸 수 있습니다.
- Opus 또는 Sonnet 한도: 모델 계열별 한도입니다.
/model로 그 계열이 아닌 모델로 바꾸면 계속 작업할 수 있습니다. 다음 요청은 캐시 없이 대화 전체를 다시 읽으므로 보통 턴보다 더 많이 씁니다. - 지출 한도 메시지: 사용량 크레딧이 있는 요금제에서 크레딧 지출이 본인이나 관리자가 정한 한도에 닿았다는 뜻입니다. 5시간 창이 아닙니다.
Server is temporarily limiting requests: 서버 측 제한입니다. Anthropic 오류 레퍼런스에 따르면 요금제 할당량과는 관계없습니다.
초기화 후 Claude Code가 이어서 작업하게 하기
Claude Code v2.1.234 이상에서는 claude.ai 구독으로 로그인한 대화형 세션이 초기화를 기다렸다가 스스로 이어 갈 수 있습니다. 자동 계속은 기본으로 켜져 있습니다. 기다리는 동안 세션 아래쪽에 다음이 표시됩니다.
Usage limit reached · limit resets 3:45pm
Continuing automatically at 3:45pm · esc to cancel세션을 열어 두세요. 초기화 시각이 되면 Claude Code가 Claude에게 멈춘 곳부터 이어 가라고 합니다. 마지막 메시지를 다시 보내는 건 아닙니다. 컴퓨터가 약 30분 넘게 절전 상태였고 그동안 한도가 초기화됐다면, 대신 Enter를 누르라고 합니다. 취소하려면 빈 프롬프트에서 Esc를 누르거나 /rate-limit-options를 쓰세요.
이어지는 턴에서도 평소처럼 권한을 묻기 때문에, 오후 3시 45분에 초기화돼도 돌아올 때까지 프롬프트에서 멈춰 있을 수 있습니다.
다른 기기에서 초기화 지켜보기
초기화는 Anthropic 쪽에서 일어나고, 그걸 기다리는 세션은 내 컴퓨터에 있습니다. 그 컴퓨터에서 떨어져 있다면 궁금한 건 한도가 언제 풀리는지, 그리고 세션이 작업을 다시 시작했는지입니다.
휴대폰에서 이를 지켜보고 싶다면, Happier는 휴대폰, 데스크톱, 웹에서 Claude Code, Codex 등 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다.
초기화 전후로 하는 일:
- 세션 안의 사용량 한도 배너. 제공자가 세션에 대기를 요청하면 Happier는 전달받은 초기화 시각과 함께 Usage limit reached를 표시하고, Resume when limit resets, Stop waiting, Check limit now 같은 동작을 보여 줍니다.
- 계정마다 하나의 초기화 시각. 제공자는 여러 종류의 초기화나 쿨다운 시각을 보고합니다. Happier는 이를 풀 안의 계정마다 하나의 초기화 시각으로 정리해, 배너와 풀 화면이 일치하게 합니다.
- 알림. Happier는 세션이 할당량 때문에 막혔을 때와 할당량이 회복됐을 때 알려 줄 수 있습니다. 토글은 Settings → Notifications의 Provider recovery 섹션에 있습니다.
- 권한 요청이 휴대폰으로 옵니다. 이어지는 턴이 프롬프트에서 멈추면 휴대폰에서 답할 수 있습니다. 휴대폰에서 Claude Code 권한 요청을 승인하는 방법을 참고하세요.
하지 못하는 일: Happier는 창을 더 빨리 초기화할 수 없고, 세션을 실행하는 컴퓨터가 꺼져 있는 동안 작업을 이어 갈 수도 없습니다. 설정은 휴대폰에서 Happier 사용하는 방법에 있습니다. GitHub에 있고, 여기서 다운로드할 수 있으며, Discord도 있습니다.
흔한 실수
- 주간 한도인데 5시간 기다리기. 먼저 메시지가 어떤 한도를 말하는지 읽으세요.
- 세션 한도에서 모델 바꾸기. 모델 간에 공유되므로 바꿔도 소용없습니다. Opus나 Sonnet 한도라면 도움이 됩니다.
- 채팅도 집계된다는 걸 잊기. claude.ai의 긴 대화도 터미널과 같은 한도를 씁니다.
자주 묻는 질문
Claude Code 사용량은 몇 시에 초기화되나요?
모두에게 같은 시각은 없습니다. 세션 창은 5시간마다 롤링되고, 주간 초기화는 계정마다 정해져 있습니다. /usage와 Settings → Usage에서 내 시각을 볼 수 있습니다.
주간 한도는 월요일에 초기화되나요?
계정에 배정된 초기화가 월요일인 경우에만 그렇습니다. Anthropic은 계정마다 정해진 요일과 시각을 배정합니다.
업그레이드하면 한도가 초기화되나요?
Anthropic 도움말 센터에 따르면 업그레이드하면 새 요금제의 한도가 바로 적용됩니다.
Claude 채팅과 Claude Code는 따로 초기화되나요?
아니요. 같은 세션 한도와 주간 한도를 공유하므로 함께 초기화됩니다.
API 사용자에게도 Claude Code 초기화가 있나요?
API 결제에는 5시간이나 주간 요금제 창이 없습니다. 속도 제한과 Console 워크스페이스에 설정한 지출 한도가 있을 뿐입니다.