Claude Code 사용량 확인하는 법: 5시간·주간 한도와 줄이는 순서 5가지

Claude Code로 한창 작업하다 "5-hour limit reached"를 만난 적이 있다면, 무엇이 얼마나 남았는지부터 궁금해집니다. 남은 사용량을 모른 채 큰 작업을 시작하면 중간에 끊기고, 다시 이어 가느라 사용량을 또 씁니다.

 

Claude Max로 주간 한도가 빠듯한 주를 겪은 뒤, 사용량 화면과 Claude Code 문서를 하나씩 맞춰 봤습니다. 이 순서대로 보면 Claude Code 사용량을 보는 곳 3군데와 먼저 줄일 5가지가 손에 잡힙니다.

한도는 두 가지, Max는 하나 더

한도	초기화	대상
세션 한도	5시간마다	Pro·Max, 모든 모델 합산
주간 한도	일주일에 한 번, 계정마다 정해진 시각	Pro·Max, 모든 모델 합산
Fable 주간 한도	일주일에 한 번	Max만, 주간 한도의 최대 50%까지

Claude Code 사용량은 claude.ai 웹·데스크톱·모바일 채팅과 같은 한도를 나눠 씁니다. Fable(Claude Fable 5.1)도 같은 주간 한도에서 빠지며 더 빨리 닳습니다.

 

정해진 메시지 개수는 없고, 대화 길이·모델·effort(생각하는 깊이)·기능에 따라 사용량이 달라집니다.

Claude Code 사용량을 보는 곳 3군데

어디서	보이는 것
claude.ai 설정 → 사용량	현재 세션·이번 주·Fable 막대, 초기화 시각, 사용 크레딧
Claude Code /usage	플랜 한도 막대 + 무엇이 사용량을 썼는지
상태 표시줄	5시간·7일 사용 비율을 화면 아래에 계속 표시

제 사용량 화면에는 '이번 주' 막대 옆에 금요일 초기화가 표시됩니다.

/usage에서 볼 것

/usage(/cost·/stats로 쳐도 같은 화면) 맨 위의 달러 금액은 API 사용자용 추정치입니다. 구독자는 이 금액이 청구되지 않습니다.

 

그 아래에는 스킬·서브에이전트·플러그인·MCP 서버가 몇 %씩 썼는지 나오고, 긴 대화나 저장해 둔 기록을 못 쓰고 다시 처리한 양이 최근 사용량의 10% 이상이면 줄이는 팁과 함께 표시됩니다.

 

d·w 키로 24시간·7일을 바꿔 보는 항목별 비율은 지금 PC의 기록만 세서 claude.ai 채팅은 빠집니다.

 

상태 표시줄은 /statusline 5시간·주간 사용 비율 보여 줘처럼 말로 요청하면 Claude Code가 설정을 만들어 줍니다(Pro·Max만).

한도에 닿으면

v2.1.234 이상에서는 한도에 막혀도 열린 세션이 기다렸다가, 초기화되면 하던 작업을 스스로 이어 갑니다. 구독 계정으로 로그인했다면 기본으로 켜져 있습니다. 다만 권한 확인 질문은 평소처럼 뜨기 때문에, 자리를 비우면 그 질문에서 멈춰 있을 수 있습니다.

 

기다리기 싫다면 /rate-limit-options에서 사용 크레딧이나 요금제 올리기를 고릅니다. 사용 크레딧은 한도를 넘긴 뒤 쓴 만큼 따로 결제되며 월 상한을 정할 수 있습니다. Max에 포함된 API 월 크레딧은 Claude Code에 쓸 수 없습니다.

증상: 구독 중인데 API 크레딧 구매 안내가 뜨거나 API 요금이 나감

원인: 환경 변수 ANTHROPIC_API_KEY가 있으면 Claude Code가 구독 대신 그 키를 써서 API 요금이 청구됨

해결: 변수를 지우고(Windows는 시스템 환경 변수에서 삭제) claude logout → claude login으로 구독 계정만 로그인

한도가 가까울 때 줄이는 순서

순서	할 일	줄어드는 이유
1	상관없는 작업 사이에 /clear	요청마다 대화 전체를 다시 보내기 때문
2	/effort 낮추기	생각하는 데 쓴 토큰도 출력으로 계산
3	쉬운 작업은 Sonnet	Opus보다 적게 씀
4	안 쓰는 MCP 끄기(/mcp)	도구 이름·안내문이 맥락에 들어감
5	예약 작업·서브에이전트 점검	각자 따로 요청을 보냄

/compact는 대화를 요약하느라 그 자체가 큰 요청입니다. 이어 갈 필요가 없으면 비용 0인 /clear가 낫습니다.

 

모델을 바꾸면 덜 쓰게 될 뿐 세션·주간 한도는 /model로 풀리지 않습니다. effort를 언제 낮춰도 되는지는 Opus 5.5 effort 고르는 법에 정리했습니다.

 

주간 사용량이 빠듯했던 주에 작은 버그 수정 하나를 클라우드 세션으로 넘겼더니, 주간 한도는 그대로 두고 클라우드 세션 크레딧에서만 빠졌습니다. 이 크레딧은 11월 초에 만료되고, 그 뒤로는 평소 한도에서 빠집니다.

한도에 막혔을 때 헷갈리는 3가지

Q. 5시간은 언제부터 세나요?
정확한 초기화 시각은 설정 → 사용량의 '현재 세션' 옆에 나옵니다.

 

Q. 채팅만 했는데 Claude Code가 막혔어요.
채팅까지 합친 양은 claude.ai 설정 → 사용량에서 보이고, /usage의 항목별 비율에는 채팅이 빠집니다.

 

Q. 한도를 자주 넘기면 무엇부터 하나요?
/usage에서 무엇이 Claude Code 사용량을 많이 썼는지 먼저 봅니다. 줄일 곳이 안 보이는데도 매주 막히면 요금제를 올릴 때입니다.

 

사용량 화면에서 내 주간 초기화 요일을 한 번 확인해 두면, 큰 작업을 언제 시작할지 정하기가 쉬워집니다.

팀에 들이면 한 달에 얼마나 들까

인원과 사용량을 넣으면 Claude·ChatGPT·Gemini 요금제별 월 비용을 비교해 줍니다. 개인 요금제 추천도 같이 볼 수 있습니다.

AI 코딩 비용 계산기 →

관련 글

• Claude Max 가격 정리 — Pro와 뭐가 다르고 누가 써야 하나
• Claude Max 3개월 진하게 써본 후기 — 월 $100 본전 뽑은 사용 패턴 7가지
• Graphify 사용법 — Claude Code 토큰 아끼는 코드 지식 그래프

설치 환경: Windows 11, Claude Code(VS Code 확장·터미널), Claude Max