Claude Code 한도를 다 썼을 때: Max 20x의 5시간 창과 주간 한도 계산법, 부족하면 API Key로 전환하세요

Claude Code 한도를 다 썼다면 먼저 어느 관문에 걸렸는지 구분해야 합니다. Pro와 Max에는 모두 「5시간 창」과 「주간 한도」라는 두 가지 제한이 있고, Claude 웹, 데스크톱 앱, Claude Code가 같은 한도를 공유합니다. Max 20x의 「20배」는 공식 문서상 5시간 창마다 Pro의 20배라는 뜻이며, 일주일 총량이 20배라는 뜻이 아닙니다. 5시간 창을 다 썼다면 초기화를 기다리면 됩니다. 주간 한도를 다 썼는데 작업을 멈추고 싶지 않다면 Claude Code를 API Key로 바꾸십시오. 종량제로 과금되며 구독의 5시간 창과 주간 한도에 영향을 받지 않습니다.

결론

Anthropic 도움말 센터 원문: 「Paid plans have two types of usage limits: a session limit that resets every five hours, and weekly limits that reset once every week.」 출처:How do usage and length limits work?

「20x」는 5시간 창을 가리킵니다. 원문: 「Max 20x includes 20 times the Pro plan's per-session usage allowance.」「Max plans also have a weekly usage limit that applies across all models.」 출처:What is the Max plan?

Claude와 Claude Code는 한도를 공유합니다. 원문: 「Both Pro and Max plans have a five-hour session limit and a weekly limit. Max plans also have a separate weekly limit for Fable. These limits are shared across Claude and Claude Code, meaning all activity in both tools counts against the same limits.」 출처:Use Claude Code with your Pro or Max plan

Max 20x의 주간 한도는 Pro의 몇 배인가

공식 문서에는 5시간 창이 20배라고만 적혀 있고, 주간 한도의 배수는 공개되어 있지 않습니다. 사용자 실측 결과는 20배보다 뚜렷하게 낮습니다.

• 사용자 피드백에 따르면 Max 20x의 주간 한도는 「측정해 보니 Pro의 약 9.7배 정도」이며, 원문은 「5시간 창과 주간 한도는 별개의 두 관문」이라고 합니다(@JkwuRmsl).
• 사용자 피드백에 따르면 「The "20x" doesn't mean you get 20 times more Claude for the whole week. It only means each 5 hour session is 20 times bigger than Pro's.」라고 하며, 20x의 주간 한도는 Max 5x의 두 배 정도에 불과하다고 합니다(@buildwithhassan).

따라서 Max 20x로 업그레이드하기 전에 평소 걸리는 한도가 5시간 창인지 주간 한도인지 먼저 따져 봐야 합니다. 5시간 창에만 걸린다면 20x가 큰 도움이 됩니다. 주간 한도에 자주 걸린다면 늘어나는 여유는 이름에서 기대하는 만큼 크지 않습니다.

남은 한도 확인 방법

Claude Code 공식 문서 원문: /usage 「Show session cost, plan usage limits, and activity stats. On a Pro, Max, Team, or Enterprise plan, includes a breakdown of what counts against your plan limits」, /status 「Open the Settings interface on the Status tab, showing version, model, account, and connectivity」. /cost와 /stats는 모두 /usage의 별칭입니다. 출처:Claude Code Docs: Commands.

도움말 센터 원문: 「The weekly limit resets at a fixed time each week that is assigned to your account. Your reset day and time stay the same regardless of when you start using Claude or when your subscription begins … You can see your next reset time in Settings > Usage.」

실측: API Key 사용 시 /status와 /usage에 표시되는 내용

Claude Code 2.1.308, 깨끗한 독립 HOME 환경에서 전역 settings.json으로 AI Code With의 API Key를 연결하고 두 명령을 실행해 봤습니다.

시작할 때 타이틀 바의 모델명 뒤에 API 과금 방식이라고 바로 표시됩니다.

Claude Code v2.1.308
Opus 5.5 · API Usage Billing

대화형 모드에서 /status를 입력하면 3초 안에 Status 페이지가 열립니다(캡처).

Version:                    2.1.308
Auth token:                 ANTHROPIC_AUTH_TOKEN
Anthropic base URL:         https://api.aicodewith.ai
Model:                      Default (claude-opus-5-5)
Setting sources:            User settings

한 마디 질문을 한 뒤 /usage를 입력하면 3초 안에 Usage 페이지가 열립니다(캡처, 금액 행은 생략).

Session
Total duration (API):  5s
Total duration (wall): 29s
Total code changes:    0 lines added, 0 lines removed
Usage by model:
     claude-opus-5-5:  8 input, 138 output, 10.4k cache read, 2.6k cache write

결론: API Key로 연결하면 /usage에는 이번 세션의 통계만 표시되고, 구독의 5시간 윈도우와 주간 한도 진행 막대는 나타나지 않습니다. /status에는 ANTHROPIC_AUTH_TOKEN과 사용자 지정 주소가 표시되며, 구독 계정 정보는 없습니다.

비대화형 모드인 claude -p로 이 두 명령을 실행하면 결과가 다릅니다:

/status isn't available in this environment.

claude -p "/usage"는 0.4초 만에 결과를 반환하며, 세션 통계만 나옵니다(당시에는 요청을 보내기 전이라 전부 0입니다):

Total duration (API):  0s
Total duration (wall): 0s
Total code changes:    0 lines added, 0 lines removed
Usage:                 0 input, 0 output, 0 cache read, 0 cache write

스크립트에서 한도를 확인하려면 /usage를 사용합니다. /status는 대화형 모드에서만 볼 수 있습니다.

최근 한도가 빨리 줄어드는 이유

1. SemiAnalysis 보도에 따르면 일부 Max 계정에서 A/B 테스트가 진행되고 있습니다. SemiAnalysis는 10월 22일 X에 다음과 같이 게시했습니다: 「We detected an A/B test going on that DECREASES your monthly API-value by ~20% while INCREASING your 5h usage limits by ~20%. This only affects SOME」(SemiAnalysis 원문 게시물). 보도에 따르면 두 개의 Max 20x 계정을 비교한 결과, 한쪽은 5시간 윈도우가 약 19% 컸고 주간 한도는 약 20% 적었습니다(Tech City Authority).

Anthropic은 이 테스트를 확인하지 않았습니다. 보도에 따르면 SemiAnalysis가 게시물을 올리기 전에 Anthropic의 Boris Cherny는 사용자에게 「No changes on our end」라고 답했고, Claude Code 팀의 Lydia Hallie도 「our limits haven't changed」라고 말했습니다(Tech City Authority). 두 답변 모두 SemiAnalysis의 게시물보다 앞선 것입니다.

누구에게 영향이 큰가: 5시간 윈도우는 하루에 여러 번 초기화되므로, 헤비 유저가 먼저 부딪히는 것은 주간 한도입니다. 주간 한도가 20% 줄면 실제로 그만큼 줄어든 셈입니다. 5시간 윈도우에 가끔 걸리는 정도라면 오히려 여유가 생겼다고 느낄 수 있습니다.

2. 오래 방치한 긴 대화를 재개하는 데 비용이 많이 듭니다. 사용자 보고에 따르면 Claude Code 클라이언트는 긴 대화를 재개하기 전에 다음과 같은 안내를 표시했습니다(@pumpccc, Opus 5.5):

This conversation has been inactive for 3h 4m and is 358.4k tokens long. Resuming it will use about 7% of your 5-hour usage limit.

즉, 35만 token짜리 이전 대화를 이어서 하는 것만으로도 5시간 윈도우의 약 7%를 먼저 소모합니다.

3. 한도는 웹과 Claude Code가 공유합니다. 낮에 웹에서 대화를 많이 하면 저녁에 Claude Code에서 쓸 수 있는 양이 줄어듭니다.

한도를 아끼는 방법

1. 긴 대화는 먼저 /compact를 실행합니다. 공식 설명은 대화를 요약해 공간을 확보한다는 것입니다. 대화가 이미 길다면 먼저 압축한 뒤 이어서 진행합니다. 유휴 자동 압축을 켜고 끄는 방법은 《Claude Code Idle Compaction이란》에서 설명합니다.
2. 오래 방치한 긴 세션은 바로 새로 시작합니다. 수십만 token짜리 이전 대화를 그대로 재개하지 말고, /clear로 새 세션을 열어 요점을 인수인계 파일로 정리한 뒤 이어서 작업합니다. 방법은 《Claude Code 작업 도중 Codex에 넘기려면? handoff.md로 컨텍스트 인수인계》에서 설명합니다.
3. 일상 작업에는 Sonnet 5.5를 사용합니다. /model claude-sonnet-5-5로 전환하고, 어려운 문제에서만 Opus 5.5로 되돌립니다. 선택 기준은 《Claude Code에는 어떤 모델을 쓸까》와 《Claude Sonnet 5.5 vs Opus 5.5》에서 설명합니다.
4. 병렬 서브 Agent는 적게 띄웁니다. 서브 Agent마다 별도의 컨텍스트를 사용하므로, 여러 개를 동시에 열면 한도 소모도 누적됩니다.
5. Fast Mode에 주의합니다. 사용법과 제한 사항은 《Claude Opus 5.5 Fast Mode 사용법》에서 설명합니다.

도움말 센터 원문: 「Your usage is affected by several factors, including the length and complexity of your conversations, the features you use, which Claude model you're chatting with, and the effort level you've selected.」

한도가 부족하면 API Key로 전환

구독 한도를 모두 소진한 뒤 공식적으로 제시하는 선택지는 초기화를 기다리거나, usage credits를 활성화하거나, Console 계정으로 바꿔 API를 사용하는 것입니다. Claude Code를 AI Code With의 API Key에 연결할 수도 있습니다. 종량제로 과금되며, 구독의 5시간 윈도우와 주간 한도의 제한을 받지 않습니다.

도움말 센터 원문: 「Switch to a Claude Console account and purchase API usage credits for intensive coding sprints.」「Wait until your usage limits reset.」 출처: Use Claude Code with your Pro or Max plan

1단계: API Key 생성

API Key 생성 →

가격 보기 →

2단계: 전역 settings.json 작성

~/.claude/settings.json을 열고 env에 다음 값을 입력합니다(ANTHROPIC_BASE_URL에는 /v1을 붙이지 않습니다):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

Claude Code를 다시 열었을 때 제목 표시줄에 「API Usage Billing」이 표시되고 /status의 Auth token 항목이 ANTHROPIC_AUTH_TOKEN이면 Key로 연결된 것입니다. 각 필드 설명과 자주 묻는 질문은 《Claude Code에 서드파티 API를 연결하려면? Base URL, API Key, 모델 설정 가이드》에서 확인할 수 있습니다.

구독으로 되돌리려면 settings.json에서 이 두 줄을 삭제하고, 터미널에서 claude login을 실행해 Pro 또는 Max 계정으로 로그인합니다.

자주 묻는 질문

주간 한도는 언제 초기화되나요?

매주 정해진 시각에 초기화됩니다. 이 시각은 계정마다 배정되며, 사용을 시작한 때나 구독한 때와는 무관합니다. 공식 사이트의 Settings > Usage에서 다음 초기화 시각을 확인할 수 있습니다.

Claude의 5시간 제한은 언제부터 계산되나요?

공식 문서에는 5시간 윈도우가 「resets every five hours」라고 되어 있습니다. 윈도우를 모두 썼다면 초기화될 때까지 기다리면 됩니다. 그동안에는 Claude 웹과 Claude Code 모두 제한을 받는데, 둘이 한도를 공유하기 때문입니다.

구독과 API Key를 동시에 쓸 수 있나요?

같은 시점에 Claude Code는 한 가지 방식만 사용합니다. settings.json에 ANTHROPIC_AUTH_TOKEN과 주소가 설정되어 있으면 Key로 연결되고, 이를 삭제한 뒤 claude login으로 구독 계정에 로그인하면 구독으로 연결됩니다. 낮에는 구독을 쓰다가 구독 한도가 소진되면 Key로 전환할 수 있습니다.

같은 Key를 Codex에서도 쓸 수 있나요?

쓸 수 있습니다. ~/.codex/config.toml에 주소와 Key를 설정하면 됩니다. 설정 방법은 《Codex config.toml 설정 가이드》를 참고하십시오. Codex 자체의 한도 규칙은 《Codex 요금은 어떻게 부과되고, 한도는 왜 빨리 줄어드는가》에서 설명합니다.

출처

• Claude Help Center: How do usage and length limits work?
• Claude Help Center: What is the Max plan?
• Claude Help Center: Use Claude Code with your Pro or Max plan
• Claude Code Docs: Commands
• SemiAnalysis 원문 게시글
• Tech City Authority: Anthropic is reportedly A/B testing Claude Max usage limits
• @JkwuRmsl, @buildwithhassan, @pumpccc