Claude Code 사용량 한도 완전 정리: 세션, 주 단위, 해결책
5시간 세션 창과 주간 한도가 실제로 무엇을 재는지, 「Limit reached ∙ resets」 메시지가 어디서 오는지, 그리고 어느 쪽 시계가 다 닳았을 때도 개발을 계속할 수 있는 해결책을 정리했습니다.
요약
- Pro와 Max는 Claude Code를 동시에 두 가지로 셉니다. 굴러가는 5시간 창 위의 세션 한도, 그 위에 얹힌 주간 한도 — 둘 다 claude.ai 채팅과 공유됩니다.
- 메시지 개수로 세는 것은 없습니다. 긴 대화, 첨부 파일, 고른 모델, 높은 effort 수준이 모두 미터를 더 빨리 돌립니다.
- /status로 남은 사용량을, /context로 한 첫마디 치기 전에 새 세션이 이미 얼마를 쓰는지 확인하세요.
- 벽에 부딪히면: 재설정 시각을 읽고, MCP 서버와 skills를 정리하고, effort를 낮추고, /compact나 /clear를 쓰거나, usage credits — 또는 더 싼 API 엔드포인트로 물러납니다.
Claude Usage Limits Explained — Why You Hit Them So Fast
채널: Couture Code1:40
Stop Hitting Claude Code Usage Limits
채널: AI RoundTable17:24
DeepSeek v4 Pro on Claude Code - Full Setup Tutorial
채널: Prince does AI8:08
How do usage and length limits work? — official support article
공식 페이지: support.claude.com
Manage costs effectively — official documentation
공식 페이지: code.claude.com/docs
이 페이지의 사실은 Anthropic 공식 지원 문서와 Claude Code 문서와 대조했습니다. 영상과 공식 페이지가 다르면 공식이 우선입니다. 주간 한도 수치는 시기에 따라 바뀝니다 — 위에 링크된 지원 문서가 항상 현재 숫자입니다.
스크린샷은 위 YouTube 영상들의 프레임으로, 출처를 밝히고 각 단계마다 원본 타임스탬프에 연결했습니다.
Claude Code 사용량 한도, 하나씩
세션 한도가 실제로 재는 것
- 1
고정된 메시지 개수는 없다는 것부터 받아들이기
Claude Pro와 Max는 「하루에 N개의 메시지」를 약속하지 않습니다. 구독으로 사는 것은 턴마다 소모되는 사용 예산이고, 매일 깎이는 속도도 다릅니다. Anthropic 지원 문서든 커뮤니티 해설이든 결론은 같습니다. 예산이 얼마나 가는지는 카운터가 아니라 무엇을 보내는지로 정해집니다. 이것만 받아들이면 이 페이지의 나머지 해결책이 저절로 이해됩니다.

한도는 실재합니다 — 다만 보편적인 메시지 할당량은 없습니다.영상 0:01 지점 보기 - 2
미터를 움직이는 것 보기
세션이 예산을 태우는 속도를 정하는 건 다섯 가지입니다. 메시지 하나하나의 길이, 첨부하는 파일, 대화가 자란 길이, 쓰는 모델과 기능, 그리고 고른 effort 수준. 가장 무거운 모델에 높은 effort, 긴 대화에 큰 파일이 겹치면 몇 턴 만에 창이 비고, 가벼운 모델의 짧고 집중된 프롬프트는 바늘을 거의 움직이지 못합니다.

메시지 길이, 파일, 대화 길이가 같은 예산 링을 채웁니다.영상 0:17 지점 보기 - 3
두 개의 시계 알아두기: 5시간과 7일
공식 문서는 굴러가는 5시간 창과 주간 창으로 재설정되는 할당량을 설명합니다. 세션 시계는 첫 메시지에서 시작해 다섯 시간 뒤 전부 회복되고, 주간 상한은 세션을 넘어 누적되다가 일주일에 한 번 리셋됩니다. 어느 쪽이든 먼저 닿으면 그 창이 새로워질 때까지 Claude Code는 멈춥니다.

거의 다 닳은 5시간 바와 절반쯤 쓴 주간 바.영상 0:30 지점 보기 - 4
사용량 벽과 컨텍스트 벽을 구분하기
사용량 한도와 컨텍스트 한도는 다른 천장입니다. 사용량은 플랜의 예산으로 시계에 따라 회복됩니다. 컨텍스트는 모델의 창으로 /compact나 /clear로만 비웁니다. 그래서 사용량이 남았는데 컨텍스트가 차서 죽는 세션도, 창에 여유가 남은 채 사용량 벽에 먼저 부딪히는 세션도 생깁니다. 해결책은 각각 다릅니다.

플랜 쪽 남은 사용량 vs. 창 쪽 가득 찬 대화.영상 1:16 지점 보기
주간 한도와 리셋 리듬
- 5
모든 접점이 같은 웅덩이를 마신다는 것
사용량 한도는 claude.ai, 데스크톱 앱, Claude Code가 함께 씁니다. 오후 내내 웹 채팅을 하면 저녁 코딩 세션이 물려받을 예산이 조용히 줄어듭니다 — 반대도 마찬가지. 한도가 예상보다 일찍 오면, 터미널 밖에서 한 일부터 돌아보세요.

웹, 데스크톱, Claude Code가 하나의 공유 링에 연결됨.영상 0:44 지점 보기 - 6
내게 배정된 주간 리셋 시각 찾기
주간 한도는 모두가 자정에 함께 리셋되지 않습니다. 계정마다 고정된 요일과 시각이 배정되고, 주가 바뀌어도 그 자리에 있습니다 — 공식 지원은 이를 「늘 쓰던 요일과 시간」이라고 표현합니다. claude.ai의 Settings → Usage에서 확인하고, 무거운 빌드는 개인 리셋 직후에 배치하세요. 리셋 직전 몇 시간이 한 주 중 가장 비쌉니다.

주간 리셋은 달력이 아니라 계정에 고정됩니다.영상 0:31 지점 보기 - 7
벽에 닿으면 표시부터 읽기
할당량이 다 떨어지면 Claude Code는 「Limit reached ∙ resets <시각>」 계열의 메시지를 보여줍니다. 공식 문서가 인용한 원문은 「You've hit your session limit」, 「You've hit your weekly limit」 등이며, 각각 해제 시각이 붙어 있습니다. v2.1.234부터는 Claude Code가 기다렸다 스스로 계속하게 할 수도 있습니다(autoContinueAtUsageLimit). 재시도를 연타하지 마세요. 예산을 채우는 건 운이 아니라 시계입니다.

포함된 할당량 소진 — 다이얼이 붉은 표에서 멈춥니다.영상 1:03 지점 보기
할당량을 끝까지 짜내 쓰기
- 8
망가지는 대신 압축하기
/compact는 대화를 요약해 일부 토큰만으로 작업을 이어가고, Claude Code도 창 가장자리에 가까워지면 자동으로 압축합니다. 마일스톤마다 — 테스트가 모두 초록불인 직후처럼 — /compact를 의도적으로 돌려 요약에 중요한 것은 남기고 이제 필요 없는 잡음은 버리세요.

/compact 챕터: 요약하고, 계속 일한다.영상 3:34 지점 보기 - 9
자동 압축의 두 숫자 알아두기
문서와 코드를 뜯어본 커뮤니티 조사에서 두 숫자가 나왔습니다. 문서에 기재된 압축 시점은 약 95%, 그리고 어떤 조정도 조용히 잘라내는 약 83%의 클램프 — 트리거는 낮출 수 있어도 그 위로는 올릴 수 없습니다. 실전 교훈: 창의 마지막 5분의 1은 활주로로 취급하고, 도구가 대신 누르기 전에 스스로 압축하세요.

문서값 95% vs. 클램프 83% — 모순이 아니라 역할이 다릅니다.영상 11:43 지점 보기 - 10
루틴 작업은 effort 낮추기
effort 수준은 공식적으로 사용량 계산의 일부입니다. effort가 높으면 태스크당 토큰이 더 들고 한도에 더 빨리 닿습니다. 깊은 추론은 정말 어려운 문제에 아끼고, 일상적인 수정·조회·포매팅은 낮은 단계로 돌리세요 — 예산은 눈에 띄게 오래가고 쉬운 작업에서 품질이 떨어지지도 않습니다.

effort 한 단계 아래로, 실질 예산은 더 길게.영상 1:31 지점 보기 - 11
차선책: 더 싼 엔드포인트로 물러나기
Claude Code는 Anthropic 호환 API를 감싼 하네스일 뿐입니다. ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN을 다른 공급자(DeepSeek, OpenRouter, Console 계정)로 향하게 하고, ANTHROPIC_MODEL 계열 변수로 모델 슬롯을 매핑하면 됩니다. 사이트의 「Claude Code에서 DeepSeek 쓰기」 가이드에 전체 설정이 있습니다. 플랜 몫이 회복되는 동안 개발을 이어가는, 이 워크스루와 같은 요령입니다.

환경 변수가 Claude Code를 DeepSeek 엔드포인트로 향하게 함.영상 1:32 지점 보기
세션 한도 vs. 주간 한도 vs. 5시간 창
혼란의 대부분은 어휘를 나눠 쓰는 세 천장에서 옵니다. 나란히 정리하고, 사용량 한도가 전혀 아닌 닮은꼴 둘도 함께 짚습니다.
- 1세션 한도 — 한 번의 작업 스퍼트 예산. 첫 메시지에서 시작해 스스로 회복되는 5시간 굴러가는 창에 살며, 리셋 명령은 존재하지 않습니다.
- 2주간 한도 — 주 단위의 천장. 세션 위에 얹혀 계정에 배정된 요일과 시각에 리셋되며, 그것을 움직이는 명령은 없습니다.
- 3「Limit reached ∙ resets <시각>」 — 어느 벽을 쳤고 언제 풀리는지 UI가 알려주는 표시입니다. 세션 한도 리셋 명령은 없고, 메시지에 찍힌 재설정 시각 그 자체가 메커니즘입니다.
- 4컨텍스트 한도 — 사용량 한도가 아닙니다. 창이 가득 찬 것은 한 대화의 크기 문제로, /compact나 /clear로 즉시 해결되며 할당량을 쓰지 않습니다.
- 5모델별 한도 — Opus 몫을 다 썼다면 /model로 우회할 때가 많습니다. 다만 세션과 주간 웅덩이는 모델을 넘어 공유되므로, 바꾼다고 채워지지 않습니다.
한 가지 더: 접점을 바꿔도 웅덩이는 안 바뀝니다. claude.ai 채팅, 데스크톱 세션, Claude Code는 같은 할당량을 마시므로 「웹에서만 잠깐 물어볼게요」도 같은 예산을 씁니다.
「Limit reached ∙ resets」 응급처치와 가벼운 식단
벽 메시지는 오류가 아니라 일정입니다. 이 목록만 돌면 대부분의 한도 날이 다시 일하는 날로 돌아옵니다.
- 1리셋 시각을 읽고 자리를 뜹니다. 재시도 연타는 아무것도 하지 못합니다. v2.1.234부터는 autoContinueAtUsageLimit을 두고 창이 새로워지면 Claude Code가 알아서 재개하게 할 수 있습니다.
- 2어느 벽을 쳤는지부터 확인합니다. /context가 창은 거의 찼는데 사용량은 남았다고 하면 컨텍스트 문제입니다 — /compact나 /clear로 곧장 복귀합니다.
- 3상시 소모를 끊습니다. 이 세션에 필요 없는 MCP 서버를 끊고, skills와 CLAUDE.md를 다듬고, effort를 낮추세요 — 첫마디 치기 전에 이미 기본 토큰이 과금됩니다.
- 4그래도 오늘 안에 끝내야 하나요? usage credits를 켜거나, 플랜을 올리거나, 오후만 하네스를 더 싼 엔드포인트로 향하게 하세요 — 어떤 방법이든 플랜 몫이 회복될 때까지 세션을 살려 둡니다.
- 5숫자가 이상하면 버그부터 의심하지 말고 검증하세요. claude.ai의 Settings → Usage를 열고, 세션을 재시작하고, /status와 비교합니다. 그래도 어긋나면 /bug로 보고하세요. 실제 한도 버그도 있지만 대부분의 「이상한 한도」는 컨텍스트 태움의 변장입니다.
어떤 구조보다 습관이 낫습니다. 관련 없는 작업 사이에서 세션을 새로 열고, 큰 빌드 전에 plan하고, 무거운 읽기는 subagent에게 맡기세요. 아래 관련 가이드들 — 토큰 줄이기, auto compact, plan mode — 이 각 습관을 깊게 다룹니다.
