Claude Code가 멈췄다고 해서 모델이 고장난 것은 아닙니다. 2026년에는 Session Limit, 주간 한도, 또는 별도의 Opus 한도에 걸린 경우가 더 흔합니다. 세 한도가 동시에 돌아가고, 오류 문구는 비슷해 보여도 대처는 전혀 다릅니다.
Anthropic은 정확한 토큰 숫자를 공개하지 않고, 요금제를 「Pro 대비 배수」로 설명합니다. 이 글은 공식 메커니즘을 따라 Pro와 Max 5x / 20x의 주간 한도, 5시간 롤링 창, 토큰 소모, 초기화 시각, 그리고 한도에 걸린 뒤 API / Usage Credits로 이어갈 때의 비용을 정리합니다.
먼저 세 한도를 구분하세요
Claude Code 구독에는 세 개의 게이트가 동시에 있습니다. 세션과 주간 한도는 모든 모델이 공유하므로 /model로 바꿔도 풀리지 않습니다. Opus 한도만 해당 모델 전용입니다.
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
| 한도 | 역할 | 형태 | 모델 전환이 유효한가 |
|---|---|---|---|
| Session(5시간) | 단기 과다 사용 방지 | 롤링 창, 사용량이 점진적으로 만료 | 아니오, 전 모델 공유 |
| 주간 한도 | 일주일 총량 제어 | 계정 주기마다 초기화 | 아니오, 전 모델 공유 |
| Opus 한도 | 가장 비싼 모델 보호 | 별도 집계 | 예, Sonnet / Haiku로 계속 가능 |
Free 요금제에는 Claude Code가 포함되지 않습니다. 웹, Desktop, Claude Code는 같은 풀을 공유합니다.
Pro와 Max 주간 한도 비교
가격은 Claude 공식 요금 페이지를 기준으로 합니다(2026년 9월).
| 요금제 | 월 요금 | Pro 대비 | 누구에게 맞나 |
|---|---|---|---|
| Pro | $20(연 결제 시 약 $17) | 1× | 단일 세션, 간헐적 사용 |
| Max 5x | $100 | 5× Session + 주간 한도 | 매일 Claude Code를 전업으로 쓰는 경우 |
| Max 20x | $200 | 20× Session + 주간 한도 | 다중 세션, 대형 저장소, 장시간 Agent |
커뮤니티 체감(공식 토큰 표가 아닙니다): Pro는 주당 대략 Sonnet 유효 연산 40–80시간, Max 5x는 대략 Sonnet 140–240시간에 Opus 여유분이 따로 있고, Max 20x는 Sonnet 240–480시간까지 갈 수 있습니다. 실제 지속 시간은 모델, 컨텍스트 길이, 도구 출력량에 달리지, 「메시지를 몇 개 보냈는지」가 아닙니다.
2026년 5월 6일부터 유료 요금제의 5시간 창이 대략 두 배로 늘었고, 피크 시간대 축소도 없어졌습니다. 주간 한도에 +50% 프로모션이 있었던 적도 있으니, 계정 /usage 표시를 기준으로 하세요. 작년 글을 계약처럼 쓰지 마세요.
Fable 5를 주간 한도와 혼동하지 마세요
Fable 5는 더 비싼 상위 모델이며 기본 모델이 아닙니다. Max / 고급 시트에서는 주간 한도의 최대 50%를 Fable 5에 쓸 수 있습니다. 같은 풀에서 한 조각을 떼는 것이지, 추가로 50%가 생기는 것이 아닙니다. Pro에서 Fable 5는 보통 첫 요청부터 Usage Credits로 갑니다.
Cursor 구독이 값어치가 있는지는 Cursor Pro, 살 만한가? 실제 비용 분석과 맞춰 보세요.
Session Limit: 정각 초기화가 아닌 5시간 롤링
Session Limit은 지난 5시간 동안 소모한 토큰을 재며, 「매일 오전 9시에 한 번 리셋」이 아닙니다.
- 오전 9–11시에 한도를 채우면 오후에 점진적으로 돌아옵니다. 특정 정각에 한순간에 가득 차는 방식이 아닙니다.
- 오류에
resets 3:45pm처럼 시각이 나옵니다. 창이 비는 시점이며, 기다리는 동안에도 용량은 이미 회복 중입니다. - 같은 계정의 병렬 세션이 이 풀을 공유합니다. 창을 3개 열면 소모는 대략 ×3입니다. plan 모드의 Agent 팀은 공식 규모상 일반 세션의 약 7배입니다.
Max는 Session Limit을 없애지 않고 버킷만 5배 또는 20배로 키웁니다. Max 5x 계정 두 개($200)는 Max 20x 하나와 같은 돈이지만 독립 창이 두 세트입니다. 병렬로 일할 때는 이쪽이 더 나을 때가 많습니다.
토큰 소모: 한도를 실제로 태우는 다섯 가지
한도는 턴 수가 아니라 토큰 / 연산량으로 셉니다. 대형 저장소를 Opus로 한 번 훑는 비용이 짧은 Haiku 메시지 50개보다 클 수 있습니다.
- 모델 선택: Opus / Fable은 Sonnet, Haiku보다 몇 배 비쌉니다. 정형 작업은
/model sonnet또는 Haiku로 두고, 어려운 문제만 Opus로 되돌리세요. - 긴 컨텍스트: 대화 전체가 요청마다 다시 전송됩니다. 하루 종일 연 세션에서 「계속」 한 마디도 전체 이력을 다시 냅니다.
- 캐시 미스: 구독에서는 Prompt Cache가 약 1시간입니다. Usage Credits나 API Key로 가면 보통 5분으로 줄어듭니다. 점심을 너무 오래 비우면 오후 첫 요청이 전체 입력으로 과금됩니다.
- 도구 출력:
grep이 4000줄을 뱉거나, 테스트 로그 전체, 6000줄 소스 파일이 컨텍스트에 들어가 이후 턴마다 다시 전송됩니다. - 병렬과 예약 작업: 다중 Agent와 예약 작업은 매번 전체 컨텍스트를 들고 발사합니다. 유휴 세션은 거의 무료이고 백그라운드 요약도 보통 낮지만, scheduled task는 그렇지 않습니다.
한도를 아끼는 순서: 관련 없는 작업은 /clear(무료)를 쓰고, 먼저 /compact하지 마세요(압축 자체도 큰 요청입니다). CLAUDE.md는 약 200줄로 두고, 세부 사항은 Skill에 넣어 필요할 때 로드하세요. Skills 작성법은 2026 최신 Claude Code Skills 템플릿 모음을 참고하세요.
# 세션에서 모델과 사고 강도 전환
/model sonnet
/effort low
# 관련 없는 작업: 이름 바꾼 뒤 비우기, compact보다 저렴
/rename api-auth-fix
/clear
초기화 시각 보는 법
| 한도 | 초기화 방식 | 어디서 확인 |
|---|---|---|
| Session 5시간 | 롤링, 오류에 시각 표시 | 오류 문구, /usage, status line |
| 주간 한도 | 계정 주기(흔히 월요일 0시 등) | /usage, claude.ai → Settings → Usage |
| Opus 한도 | 독립 주기 | 위와 같음. 모델 전환 시 즉시 계속 가능 |
/usage는 이 기기 세션 기록에서 옵니다. 다른 컴퓨터나 claude.ai 사용량은 포함되지 않습니다. 계정 전체를 보려면 웹 Usage 페이지를 기준으로 하세요.
커스텀 status line으로 두 창을 계속 표시할 수 있습니다.
{
"rate_limits": {
"five_hour": { "used_percentage": 23.5, "resets_at": 1738425600 },
"seven_day": { "used_percentage": 41.2, "resets_at": 1738857600 }
}
}
한도에 걸린 뒤: 기다리기, 다운그레이드, 초과 구매
- Session / 주간 한도: 모델 전환은 무효입니다. 창이 회복되길 기다리거나
/usage-credits로 API 요금으로 계속하세요(월 상한 설정 가능, 일일 리딤 한도는 흔히 $2,000). - Opus 한도: 바로
/model sonnet또는 Haiku로 바꾸면 작업을 이어서 할 수 있습니다. - HTTP 429: API 처리량 제한이지 구독 창이 아닙니다. 환경에 잘못 설정된
ANTHROPIC_API_KEY가 있는지 확인한 뒤 동시성을 낮추세요.
Team / Enterprise에서 결제 권한이 없으면 /usage-credits가 관리자에게 요청을 보냅니다. Credits로 가면 캐시 수명이 짧아져 같은 작업이 더 「비싸」집니다.
「AI가 컴퓨터를 조작하는」 능력과의 관계는 Claude Code와 OpenAI Computer Use의 관계를 참고하세요.
구독 vs API: 어느 쪽이 더 저렴한가
구독에는 5시간과 주간 창이 있습니다. API Key에는 이 두 창이 없고 토큰과 분당 처리량으로만 과금됩니다. Usage Credits 초과 단가 = 표준 API 단가입니다.
공식 정가(100만 토큰당, 2026년 9월, Claude API Pricing):
| 모델 | 입력 | 출력 | 캐시 히트 |
|---|---|---|---|
| Haiku 4.5 | $1 | $5 | $0.10 |
| Sonnet 5 | $2 | $10 | $0.20 |
| Opus 5 / 4.8 | $5 | $25 | $0.50 |
| Fable 5 | $10 | $50 | $1(5.1은 더 낮음) |
대략 계산하면, 중간 규모 Agent 작업 한 번이 입력 약 80k + 출력 8k일 때 Sonnet 5는 약 $0.24, 같은 규모를 Opus 5로 가면 약 $0.60입니다. Prompt Cache가 맞으면 입력은 약 10%(Fable 5.1은 약 2.5%)까지 내려갑니다. Batch API는 추가로 50% 할인이지만 비동기라 대화형 코딩에는 맞지 않습니다.
선택 기준:
- 하루 한두 번의 집중 세션 → Pro로 보통 충분합니다.
- 평일에 한도를 채우고 Session에 자주 걸림 → Max 5x.
- 다중 창 병렬, 저장소가 큼 → Max 20x, 또는 Max 5x 두 계정으로 분리.
- 야간 배치, 비동기 가능 → API / Batch가 구독을 끝까지 밀어붙이는 것보다 싼 경우가 많습니다.
- 가끔 초과 → Usage Credits. 한 달 전체를 업그레이드할 필요는 없습니다.
자주 묻는 질문
Session Limit은 메시지 개수로 계산하나요?
아닙니다. 세 한도 모두 토큰 / 연산량입니다. 컨텍스트가 길고 도구 출력이 많으며 모델이 비쌀수록 더 빨리 소모됩니다.
Sonnet으로 바꾸면 Session / 주간 한도가 풀리나요?
풀리지 않습니다. 모델 전환으로 바로 재개되는 것은 Opus 전용 한도뿐입니다. Session과 주간 한도는 모든 모델이 공유합니다.
Max에도 한도가 있나요?
있습니다. Max는 Pro의 Session과 주간 한도를 5배 또는 20배로 키울 뿐이며 메커니즘은 같습니다.
API에도 5시간과 주간 창이 있나요?
없습니다. API는 토큰으로 과금되며, 걸리는 것은 조직 단위 처리량(429)이지 구독 창이 아닙니다.
한도 숫자는 무엇을 기준으로 하나요?
/usage와 claude.ai Usage 페이지를 기준으로 하세요. 제3자 글의 시간·메시지 수는 추정치이며, Anthropic은 배수와 프로모션을 언제든 바꿀 수 있습니다.
한도는 핵심 작업에, 기기도 안정적으로
Claude Code 한도는 클라우드 토큰을 따르지만, Agent는 로컬에서 저장소를 읽고 테스트를 돌리며 MCP를 엽니다. 노트북 뚜껑을 닫으면 세션이 끊기고 캐시가 무효가 되어, 오후 첫 요청이 전체 입력으로 과금됩니다. Mac mini 대기 전력은 약 4W라 터미널을 24시간 열어 두기에 맞습니다. /usage와 롤링 창이 뚜껑이 아니라 여러분의 리듬을 따르게 하세요.
Apple Silicon 통합 메모리는 대형 저장소 인덱싱과 병렬 테스트를 더 안정적으로 만듭니다. macOS 네이티브 Unix, Homebrew, Docker, SSH가 바로 쓸 수 있고, Claude Code의 computer-use도 macOS가 주 전장입니다. 같은 가격대 Windows 호스트보다 충돌이 적고 무인 운용이 맞으며, Gatekeeper와 SIP가 장시간 Agent를 걸어 둘 위험도 낮춥니다.
이미 주간 한도를 아끼고 있다면, 안정적이고 저전력인 클라우드 Mac이 「세션이 끊긴 뒤 컨텍스트를 다시 태우는」 낭비를 줄여 줍니다. 요금제를 바로 확인하세요. 토큰은 반복 워밍업이 아니라 코드 수정에 쓰세요.