클로드 코드 사용량 제한 정리 — 5시간·주간 한도 구조와 빨리 닳는 6가지 이유

클로드 코드 사용량 제한 정리 — 5시간·주간 한도 구조와 빨리 닳는 6가지 이유

AI 리뷰 & 가이드 2026. 07. 27. 약 22분 읽기

클로드 코드 사용량이 왜 이렇게 빨리 닳는지 공식 문서로 정리했습니다. 5시간 세션과 주간 한도 구조, 모델을 바꿔도 안 풀리는 이유, /usage 로 원인 찾는 법과 아끼는 법까지.

📌 2026-07 기준 앤스로픽 공식 문서와 헬프센터 원문을 정리한 글입니다. 공개되지 않은 수치는 추측하지 않고 "공개 안 됨" 으로 표기했습니다.

클로드 코드를 쓰다 보면 "You've hit your session limit" 이 뜹니다. 한 시간밖에 안 썼는데 뜨기도 하죠.

일단 결론부터 말하면 한도는 세 겹으로 걸려 있고, 대부분은 "많이 써서" 가 아니라 "대화를 안 끊어서" 닳습니다. 클로드 코드는 메시지를 보낼 때마다 그때까지의 대화 전체를 다시 보냅니다. 아침에 열어둔 창에서 저녁에 한 줄 물으면, 그 한 줄이 아니라 하루치 대화 전체가 계산됩니다.

구조부터 정리하고, 빨리 닳는 이유 6개와 아끼는 법을 순서대로 보겠습니다.

한도는 3층 구조입니다

공식 문서 기준으로 사용량 한도는 세 종류가 동시에 걸립니다.

층	이름	리셋
1층	세션 한도 (5시간 롤링 윈도우)	5시간마다
2층	주간 한도	매주 고정 시각 (계정마다 다르게 배정)
3층	모델별 한도 (예: Opus)	해당 모델 한도만 별도

세션 한도는 Pro·Max·Team·좌석 기반 Enterprise 전부 5시간 창으로 돌아갑니다. 5시간마다 리셋되고요.

주간 한도는 플랜에 따라 개수가 다릅니다. Pro는 전체 모델 대상 주간 한도 1개, Max는 2개 — 하나는 전체 모델 대상, 다른 하나는 Sonnet 모델 전용 입니다. 주간 리셋 시각은 계정마다 따로 배정되니 내 계정 기준으로 확인해야 합니다.

용어 풀이

롤링 윈도우(rolling window)는 "매일 자정 리셋" 같은 고정 시각이 아니라, 첫 사용 시점부터 5시간을 세는 방식이에요. 오후 2시에 처음 쓰기 시작했으면 오후 7시에 리셋됩니다. 그래서 사람마다 리셋 시각이 다릅니다.

그리고 가장 많이 놓치는 것 — 모든 클로드 제품이 한 통을 씁니다. 공식 문서 표현은 이렇습니다. claude.ai 웹, 클로드 코드, 클로드 데스크톱의 사용량이 같은 한도 로 들어갑니다. 낮에 웹에서 채팅 많이 했으면 저녁에 터미널에서 쓸 게 줄어듭니다.

Pro와 Max, 뭐가 다른가

공식 수치는 이게 전부입니다.

플랜	가격	세션 사용량	주간 한도
Pro	월 $20 (미국 기준)	기준값	1개 (전체 모델)
Max 5x	월 $100	Pro의 5배	2개 (전체 모델 + Sonnet 전용)
Max 20x	월 $200	Pro의 20배	2개 (전체 모델 + Sonnet 전용)

가격은 지역에 따라 다릅니다. 세션 리셋은 세 플랜 모두 5시간 주기로 같습니다.

"5배 / 20배" 는 세션당 사용량 기준입니다. 헬프센터 원문도 "Pro 플랜보다 세션당 5배(20배) 많은 사용량" 이라고 씁니다.

여기서 중요한 것 — 앤스로픽은 "몇 시간 쓸 수 있다", "메시지 몇 개" 같은 절대 수치를 공개하지 않습니다. 헬프센터의 사용량 관련 문서 네 곳을 다 찾아봤는데 없습니다. 플랜별 문서는 주간 한도가 있다는 사실만 적고 수량은 적지 않고, 공식 문서는 "정확한 모델명·버전·가용성은 시간에 따라 바뀌며, /model 명령이 항상 내 계정의 정본" 이라고 안내합니다.

대신 공식 문서가 알려주는 건 무엇이 사용량을 빨리 먹는지 입니다. 메시지 길이, 첨부 파일 크기, 현재 대화 길이, 도구 사용(리서치·웹 검색), 모델 선택, effort 수준, 아티팩트 생성 — 이 7개입니다. 수량 대신 이 요인들을 관리하라는 뜻이죠.

그러니 블로그나 유튜브에서 "Pro는 5시간에 몇 개" 같은 숫자를 보면 누군가의 실측 추정치 이지 공식 수치가 아닙니다. 본인 작업 성격에 따라 몇 배씩 차이 납니다. 저의 경우 같은 5시간이어도 리팩터링 작업일 때와 문서 작성일 때 체감이 완전히 달랐습니다.

한 가지 더. 헬프센터에는 앤스로픽이 "주간·월간 상한이나 모델·기능별 사용량을 자체 재량으로" 조정할 수 있다는 문구가 들어가 있습니다. 지금 수치가 영구적이지 않다는 뜻입니다.

모델을 바꿔도 안 풀리는 이유

한도에 걸리면 반사적으로 /model 로 Sonnet으로 내려봅니다. 그런데 안 풀립니다.

공식 문서가 이유를 명확히 적어뒀습니다. 세션·주간 창은 모든 모델에 걸쳐 공유 되기 때문입니다. 그래서 모델을 바꿔도 접근이 복구되지 않습니다.

단, 예외가 하나 있습니다. "You've hit your Opus limit" 처럼 모델별 한도 메시지가 뜬 경우입니다. 이때는 모델을 바꾸면 계속 작업할 수 있습니다. 세션·주간 창이 아니라 Opus 한도만 찬 상태니까요.

즉 메시지를 구분해서 읽어야 합니다.

메시지	의미	/model 로 해결?
You've hit your session limit	5시간 창 소진	❌ 안 됨
You've hit your weekly limit	주간 창 소진	❌ 안 됨
You've hit your Opus limit	Opus 한도만 소진	✅ 됨
컨텍스트·auto-compact 경고	한도 아님	해당 없음

마지막 줄도 중요합니다. auto-compact 경고는 사용량 한도가 아니라 대화가 모델 최대 입력 크기에 가까워졌다는 신호입니다. 클로드 코드가 옛 대화를 요약해 자리를 비우는 동작이고, 한도와는 별개입니다. 이걸 한도로 착각해서 플랜을 올리는 분들이 있습니다.

각 한도 메시지에는 언제 리셋되는지 가 같이 표시됩니다. 그 시각을 보고 쉬는 게 맞습니다.

---

빨리 닳는 6가지 이유

공식 문서의 "긴 세션에서 사용량이 오르는 이유" 항목이 사실상 정답지입니다. 순서대로 정리했습니다.

🔴 지금 당장 고칠 것

하루 종일 안 닫은 창 — 메시지마다 대화 전체가 다시 계산됩니다. 작업 바뀌면 /clear

🟡 설정 점검

예약 작업이 켜져 있는지, 에이전트 팀원이 남아 있는지, CLAUDE.md 가 200줄을 넘는지

🟢 신경 안 써도 됨

유휴 상태 백그라운드 토큰 — 공식 기준 세션당 $0.04 미만입니다

1) 긴 컨텍스트 — 압도적 1위

클로드 코드는 메시지마다 대화 전체를 다시 보냅니다. 하루 종일 열어둔 창에서 한 줄 물으면 그 한 줄이 아니라 전체 대화 만큼 씁니다. 이게 대부분의 원인입니다.

2) 캐시 미스

프롬프트 캐시 덕에 반복되는 앞부분은 싸게 처리됩니다. 그런데 캐시 수명보다 긴 휴식 뒤 첫 메시지는 캐시를 놓치고 전체 컨텍스트를 다시 처리합니다.

용어 풀이

프롬프트 캐시는 대화 앞부분처럼 매번 똑같이 반복되는 내용을 저장해두고 싸게 재사용하는 장치예요. 앞부분이 한 글자라도 바뀌면 그 뒤 전체가 무효가 되는 구조라, 오래 쉬었다 돌아오거나 초반 설정을 건드리면 전체를 다시 계산합니다.

캐시 수명은 구독 기준 1시간 입니다. 사용량 크레딧으로 넘어가면 5분 으로 줄고, API 키나 클라우드 공급자 경유는 기본 5분입니다. 점심 먹고 와서 첫 질문이 유독 비싼 이유가 이겁니다.

3) 예약 작업(scheduled tasks)

예약 작업은 세션이 유휴 상태여도 주기마다 발동하고, 그때마다 전체 컨텍스트를 보냅니다. 켜둔 걸 잊으면 안 쓰는 동안 계속 닳습니다.

4) 에이전트 팀 (agent teams)

각 팀원이 자기 컨텍스트 창을 따로 유지합니다. 공식 문서는 플랜 모드에서 표준 세션의 약 7배 토큰을 쓴다고 밝혔습니다. 팀원은 종료하거나 세션이 끝날 때까지 계속 소비합니다. 기본값은 꺼져 있고 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 로 켜는 기능입니다.

5) /compact 자체가 큰 요청

압축은 요약할 대화를 읽어야 하므로, 큰 컨텍스트를 압축하는 일 자체가 큰 요청입니다. 연속성이 필요 없다면 /compact 대신 /clear 가 낫습니다. 공식 문서 표현으로 /clear 는 비용이 없습니다.

6) MCP 서버·CLAUDE.md 상시 점유

MCP 도구 정의는 기본적으로 지연 로딩(deferred)이라 이름만 올라가지만, 서버를 많이 붙였으면 확인해볼 값어치가 있습니다. CLAUDE.md 는 세션 시작 시 전부 올라가므로, 특정 작업용 상세 지침이 들어 있으면 무관한 작업을 할 때도 그 토큰을 계속 냅니다.

/usage 로 원인부터 찾기

추측하지 말고 실행하면 됩니다. /usage 는 구독자에게 플랜 사용량 바와 활동 통계, 사용 내역 분해를 보여줍니다.

핵심 기능 두 개입니다.

• d / w 키 로 최근 24시간 ↔ 최근 7일 전환
• 사용량을 스킬·서브에이전트·플러그인·개별 MCP 서버별로 분해해 각각 비중(%)으로 표시

그리고 결정적인 것 — 긴 컨텍스트나 캐시 미스 같은 행동이 최근 사용량의 10% 이상을 차지하면 그걸 플래그로 띄워줍니다. 각각 줄이는 팁까지 붙습니다. 내 낭비 지점을 직접 알려주는 셈입니다.

주의할 점은 이 숫자가 이 PC의 로컬 세션 기록으로 계산한 근사치 라는 겁니다. 다른 기기나 claude.ai 웹에서 쓴 건 안 잡힙니다. 한 통을 공유하는데 표시는 부분만 되니, 웹에서도 많이 쓰는 분은 실제 소진이 더 빠르게 느껴집니다.

VS Code 확장에서는 Account & usage 대화상자에 Day/Week 토글로 같은 내용이 나옵니다 (v2.1.174 이상).

아끼는 법 — 효과 큰 순서로

공식 문서의 절감 항목 중 체감이 큰 것부터 정렬했습니다.

즉시 효과

• 작업 바뀌면 /clear — 가장 확실합니다. 무관한 작업으로 넘어갈 때 묵은 컨텍스트는 이후 모든 메시지에서 낭비됩니다. 나중에 찾을 거면 /rename 후 /clear, 돌아올 땐 /resume
• 기본 모델을 Sonnet으로 — Sonnet이 대부분의 코딩 작업을 잘 처리하고 Opus보다 쌉니다. Opus는 복잡한 아키텍처 결정이나 다단계 추론에만. /model 로 중간 전환, /config 로 기본값 지정
• /effort 로 사고 강도 낮추기 — 확장 사고(extended thinking)는 기본 켜져 있고 사고 토큰은 출력 토큰으로 과금됩니다. 단순 작업엔 /effort 나 /model 에서 낮추거나 /config 에서 끄면 됩니다. 고정 사고 예산 모델은 MAX_THINKING_TOKENS=8000 같이 환경변수로 조절합니다 (Fable 5는 사고를 끌 수 없습니다)

구조 개선

• CLAUDE.md 는 200줄 이하로 — 공식 권고 수치입니다. 특정 워크플로용 상세 지침은 스킬로 옮기세요. 스킬은 호출될 때만 로드됩니다
• MCP 대신 CLI 우선 — gh·aws·gcloud·sentry-cli 같은 CLI는 도구 목록을 컨텍스트에 얹지 않아 더 효율적입니다. /mcp 로 안 쓰는 서버는 끄고, /context 로 뭐가 자리를 먹는지 확인하세요
• 훅으로 전처리 — 클로드가 1만 줄 로그를 읽는 대신, 훅이 ERROR 만 grep해서 넘기면 수만 토큰이 수백 토큰이 됩니다
• 서브에이전트에 떠넘기기 — 테스트 실행, 문서 조회, 로그 처리처럼 출력이 큰 작업은 서브에이전트로 보내면 장황한 출력은 그쪽 컨텍스트에 남고 요약만 돌아옵니다

습관

• 플랜 모드 활용 — 복잡한 작업 전 Shift+Tab으로 플랜 모드. 방향이 틀렸을 때의 값비싼 재작업을 막습니다
• 일찍 끊기 — 엉뚱하게 가면 Esc로 즉시 정지. /rewind 나 Esc 두 번으로 이전 체크포인트 복구
• 구체적으로 요청 — "이 코드베이스 개선해줘" 는 광범위 스캔을 유발합니다. "auth.ts 의 login 함수에 입력 검증 추가" 처럼 쓰면 파일 읽기가 최소화됩니다

참고로 유휴 상태에서도 대화 요약 같은 백그라운드 작업에 토큰이 조금 들어가는데, 공식 문서 기준 세션당 보통 $0.04 미만 이라 신경 쓸 수준은 아닙니다.

그래도 부족하면 — 사용량 크레딧

한도를 넘겨서도 계속 작업하려면 사용량 크레딧(usage credits) 이 있습니다. /login 으로 claude.ai 구독 계정에 로그인한 뒤 /usage-credits 를 실행하면 됩니다. API 키 인증 상태에서는 이 명령을 못 씁니다.

역할별로 동작이 다릅니다.

내 역할	/usage-credits 동작
Pro·Max 구독자	브라우저에서 결제 설정 열림
Team·Enterprise (결제 권한 있음)	조직 사용량 설정 열림
Team·Enterprise (권한 없음)	확인 후 조직 관리자에게 요청 전송

Pro·Max에서 크레딧이 남았는데 지출 한도에 걸리면, CLI를 벗어나지 않고 한도를 올리거나 없앨지 물어봅니다.

다만 크레딧으로 넘어가면 캐시 수명이 1시간 → 5분으로 줄어듭니다. 긴 세션을 이어가는 작업이라면 이 부분이 은근히 아픕니다. 크레딧을 켜기 전에 위의 /clear 습관부터 잡는 게 순서라고 봅니다.

---

내 생각

플랜을 올리기 전에 /usage 를 먼저 열어보시라고 권하고 싶습니다.

한도 문제로 Max 20x까지 올리는 분들을 봤는데, 정작 원인이 "창을 하루 종일 안 닫아서" 인 경우가 꽤 됩니다. 공식 문서가 사용량 급증 원인 1번으로 긴 컨텍스트를 꼽고, /usage 가 10% 이상 기여 요인을 직접 플래그로 띄워주는 것도 그래서라고 봅니다. 월 $100씩 더 내기 전에 /clear 를 습관화하는 게 훨씬 값싼 해결책입니다.

한 가지 경계할 점은 절대 수치가 공개되지 않는다는 것입니다. "5시간에 몇 개" 를 알려주는 공식 자료는 없고, 앤스로픽은 상한을 자체 재량으로 조정할 수 있다고 명시해뒀습니다. 그러니 남의 실측치를 내 기준으로 삼기보다 /usage 의 내 숫자를 보는 게 맞습니다.

당장 뭘 할지 하나만 고르라면 작업 바뀔 때 /clear 입니다. 공식 문서에서 유일하게 "비용이 없다" 고 못 박은 명령입니다. 그럼 이만~

참고 자료

• Claude Code 비용 관리 공식 문서
• Max 플랜 안내 (Claude 헬프센터)
• 사용량·길이 한도 작동 방식 (헬프센터)
• Pro·Max 플랜으로 클로드 코드 쓰기 (헬프센터)
• 유료 플랜 사용량 크레딧 (헬프센터)
• 클로드 코드 모델·사용량·한도 (헬프센터)
• Pro 플랜 안내 (헬프센터)
• 사용량 한도 모범 사례 (헬프센터)
• 이 블로그 관련 글: 클로드 코드 완전 시작 가이드 · 클로드 코드 설치 오류 총정리 · AI 코더 MCP 도구 14선