fallbackModel도 Max 플랜 주간 한도를 피할 수 없다

Claude Code는 중단된 작업을 더 쉽게 복구하게 해주지만, Max 구독 한도는 여전히 구독 한도입니다. fallbackModel은 추가 할당량이 아니라 작업 연속성을 위한 배관으로 봐야 합니다.

현재 Claude Code 주간 한도

fallbackModel은 기본 모델이 과부하 상태이거나 사용할 수 없거나, 지원되는 서버 측 조건에서 실패할 때 Claude Code가 계속 진행하도록 돕습니다. 하지만 공유 Claude Max 주간 한도를 우회하지는 않습니다. TechCrunch에 따르면 Anthropic은 2025년 7월 28일 Pro 및 Max 사용자를 위한 새로운 주간 한도를 발표했고, 이는 2025년 8월 28일부터 적용되었으며, 영향을 받은 구독자는 5% 미만이라고 밝혔습니다 .

빠른 답변: fallbackModel은 모델 과부하를 우회해 다른 경로로 보낼 수 있지만, Claude Max의 공유 주간 사용량 풀을 늘릴 수는 없습니다. Anthropic의 주간 한도 도입은 2025년 7월 28일 발표되었고, 영향을 받는 구독자는 5% 미만으로 보도되었습니다 .

중요한 차이는 할당량의 종류입니다. Anthropic의 Claude Code 오류 문서는 과부하 및 가용성 실패를 세션, 주간, 모델별 사용 한도와 구분합니다. 용량 오류는 재시도하거나 다른 모델로 라우팅할 수 있지만, 주간 한도 메시지가 뜨면 표시된 초기화 시간까지 구독 요청이 차단됩니다 . 그래서 fallback은 안정성에는 유용하지만, 이용 권한을 확장하는 수단은 아닙니다.

"Claude Pro 또는 Max 구독으로 Claude Code를 사용할 수 있습니다." — Anthropic Support (source: Anthropic Support)

Max는 5x 및 20x 티어로 판매되며 각각 월 $100 및 월 $200부터 시작합니다. 사용량은 Claude 웹, 데스크톱, 모바일, Claude Code 전반에서 공유되며, 화면별로 따로 분리되지 않습니다 . 실제로는 긴 Claude Code 세션 하나가 나중에 웹 앱에서 쓰려고 예상했던 동일한 구독 허용량을 소모할 수 있습니다.

fallbackModel을 믿기 전에 확인할 것

fallbackModel은 실제로 어떤 제한이 걸렸는지 확인한 뒤에야 유용합니다. Claude Max에서 계속 이어가기 위한 범용 스위치가 아닙니다. Claude Code는 세션 한도, 주간 한도, 모델별 한도, 과부하, 요청 크기, 전송, 인증, 결제 실패를 구분하며, 공식 오류 안내에서 이 범주들은 서로 다르게 동작합니다 .

모델을 바꾸기 전에 /usage부터 확인하세요. Anthropic은 Pro 및 Max에서 Claude Code 사용량이 Claude 웹, 데스크톱, 모바일과 동일한 허용량에서 차감된다고 설명합니다. 그래서 브라우저에서 많이 사용한 세션이 있으면 터미널 작업에 남은 분량이 줄어들 수 있습니다 . Max 플랜은 5x 및 20x 티어로 판매되며, 공개 가격은 각각 $100/month 및 $200/month부터 시작합니다 .

• 오류가 공유 세션 한도 또는 주간 한도라면, 모델을 바꿔도 구독 접근이 다시 열리지 않습니다. Claude는 표시된 초기화 시간까지 또는 결제 경로가 바뀔 때까지 추가 구독 요청을 차단합니다 .
• 오류가 모델별 소진이라면, 다른 eligible 모델은 여전히 실행될 수 있습니다. 이는 공유 Max 풀보다 좁은 범위의 한도이기 때문입니다 .
• 오류가 용량 관련 529 같은 과부하라면, 재시도나 fallback이 도움이 될 수 있습니다. 이 실패는 사용자 할당량 소모로 계산되지 않기 때문입니다 .

fallback은 탈출구가 아니라 제한된 체인으로 설정하세요. Claude Code는 설정의 fallbackModel과 명령줄의 --fallback-model을 지원하며, 중복 제거와 문서화된 설정 우선순위에 따른 해석 이후 최대 3개의 fallback 모델을 둘 수 있습니다 . 변경 기록에는 v2.1.166이 fallbackModel을 추가하고 --fallback-model이 대화형 세션에 적용되도록 만든 릴리스로 기록되어 있습니다 .

fallbackModel은 주간 한도가 아니라 과부하에 대응하는 단계입니다

fallbackModel은 선택한 모델이 과부하 상태이거나, 사용할 수 없거나, 그 밖에 서버 측 조건에 해당하는 실패가 발생했을 때 Claude Code가 복구하는 경로입니다. 공유 Max 주간 한도를 모두 쓴 뒤 계속 쓰기 위한 방법은 아닙니다. 이 기능은 설정에서 구성하거나 --fallback-model로 전달할 수 있으며, Claude Code는 문서화된 설정 우선순위에 따라 fallback 체인을 해석합니다 .

1. fallback 체인을 명확히 설정하세요. Claude Code 설정에 fallbackModel을 넣거나, 인터랙티브 세션을 시작할 때 --fallback-model을 전달하세요. Anthropic의 설정 문서는 fallback 모델 선택을 Claude Code의 모델 설정 일부로 설명하며, 변경 로그에는 v2.1.166이 fallbackModel을 추가하고 인터랙티브 세션에서 --fallback-model이 동작하게 만든 릴리스로 기록되어 있습니다 . 체인은 짧고 의도적으로 유지하세요. Claude Code는 중복 제거 후 최대 3개의 fallback 모델을 지원합니다 .
2. 올바른 실패 상황으로 테스트하세요. 유효한 fallback 테스트는 과부하나 일시적 사용 불가처럼 모델 측 문제여야 합니다. Max 주간 한도 메시지, 결제 실패, 인증 오류, 요청 크기 실패, 전송 실패를 테스트 사례로 삼지 마세요. Anthropic의 오류 문서는 서버 용량 오류와 사용 한도 및 계정 상태 오류를 구분하므로, 일부 실패만 모델 fallback 대상이 됩니다 .
3. 529는 한도 메시지와 다르게 보세요. 529 과부하 응답은 용량 관련 문제이며 quota에 계산되지 않으므로, 나중에 다시 시도하거나 사용 가능한 다른 모델로 이동하는 것이 합리적일 수 있습니다 . “You’ve hit your weekly limit” 같은 메시지는 다릅니다. 표시된 reset 시간까지 구독 허용량을 모두 썼다는 뜻이며, 모델을 바꿔도 공유 Max 풀은 다시 채워지지 않습니다 .
4. 허용량이 남아 있을 때만 /model opusplan을 사용하세요. 문제가 계정 한도 소진이 아니라 비용 조정이라면, /model opusplan으로 계획에는 Opus를 예약하고 구현에는 Sonnet을 사용할 수 있습니다. 공유 플랜 용량이 아직 남아 있고, 더 무거운 모델을 모든 편집이 아니라 아키텍처, 디버깅 전략, 리뷰에 쓰고 싶을 때 유용합니다 .

실무 규칙은 단순합니다. 모델 사용 가능성 문제에 대비해 fallback을 설정하고, 한도 메시지는 문자 그대로 읽으세요. Claude Code가 과부하를 보고하면 fallback이 세션을 계속 생산적으로 유지하는 데 도움이 될 수 있습니다. Claude가 Max 주간 한도를 보고하면 가능한 경로는 사용 가능한 경우 usage credits, 상위 플랜, API 결제, 또는 reset 대기입니다 .

긴 작업에서 subagent와 resume hook 활용하기

Subagent와 resume hook은 긴 Claude Code 작업이 context 압박, 승인, 재시작, 작업 분산을 견디는 데 도움이 되지만, Max 주간 한도를 우회하지는 않습니다. Anthropic의 sub-agent documentation에 따르면 subagent는 자체 context window, 도구, 모델, permission mode, effort setting, hook, 선택적 background execution을 가진 별도의 Claude instance입니다.

효과적인 패턴은 책임 단위로 작업을 나누는 것입니다. 검색 subagent는 큰 repository를 조사하고, 리뷰 subagent는 patch를 감사하며, test-repair subagent는 실패에 집중할 수 있고, parent session은 압축된 요약을 받습니다. 이렇게 하면 main conversation의 context를 보존하고, compaction이나 interruption 이후 긴 작업을 재개하기 쉬워집니다. 다만 여전히 선택된 모델의 사용량을 소비하므로, subagent fanout을 무료 병렬 용량처럼 다루면 한도에 더 빨리 도달할 수 있습니다.

Anthropic은 Claude Code 문서에서 "Subagents run in separate context windows,"라고 말합니다 (source: Anthropic).

모델 라우팅이 중요한 이유는 subagent가 작업의 비용 구조를 조용히 바꿀 수 있기 때문입니다. Anthropic은 해석 순서를 CLAUDE_CODE_SUBAGENT_MODEL, invocation parameter, subagent frontmatter, parent model 순서로 문서화합니다. 즉 팀은 더 저렴한 기본값을 전역으로 설정한 뒤, 더 깊은 reasoning에 비용을 쓸 가치가 있는 특정 research 또는 planning agent만 override할 수 있습니다.

Hook은 긴 작업을 다루는 또 다른 축입니다. SessionStart는 startup, resume, clear, compact에서 실행될 수 있고, CLAUDE_ENV_FILE은 lifecycle event 전반에 걸쳐 environment variable을 유지할 수 있습니다. Non-interactive mode에서는 PreToolUse가 defer 결정을 반환해 Claude Code가 pending tool call을 보존한 채 종료되게 할 수 있습니다. 이후 외부 승인 상태가 바뀌면 claude -p --resume <session-id>로 해당 call을 다시 실행할 수 있습니다.

주의할 점은 accounting입니다. Subagent, hook, resume, background work는 작업을 더 견고하게 만들지만, 그 자체로 더 저렴하게 만들지는 않습니다. Anthropic의 Claude Code 한도 문서는 usage limit을 overload 및 model availability error와 구분하며, usage limit은 reset, credits, plan changes, API billing이 적용될 때까지 workflow를 여전히 멈춥니다. ccusage 같은 community tool은 local token pattern을 살펴보는 데 도움이 될 수 있지만, Anthropic의 server-side accounting이 최종 기준입니다.

Max 플랜 주간 한도를 다 쓴 뒤에는

공유 Max 플랜의 주간 한도를 모두 소진한 뒤에는 fallbackModel, 서브에이전트, 재개 훅으로 Claude Code를 구독 용량 안에서 계속 실행할 수 없습니다. 합법적인 방법은 표시된 초기화 시간까지 기다리거나, 가능한 경우 사용량 크레딧을 활성화하거나, 더 높은 Max 티어로 옮기거나, 무거운 작업을 Claude Console/API 종량제 결제로 실행하는 것입니다 .

Anthropic은 Max가 Claude Code, 웹, 데스크톱, 모바일 사용을 포함한 Claude 전반에서 공유된다고 설명합니다. Max 플랜은 5x와 20x 티어로 판매되며, 표시된 시작 가격은 월 $100 및 월 $200입니다 . 이 점이 중요한 이유는 fallback 체인이 기본 모델이 과부하 상태이거나, 사용할 수 없거나, 지원되는 모델 fallback 조건에 해당하는 방식으로 실패할 때만 도움이 되기 때문입니다. 계정에 남은 공유 사용량이 없을 때는 도움이 되지 않습니다 .

• 모델을 바꾸거나 설정을 수정하기 전에 /usage로 현재 한도 상태를 확인하세요 .
• 조사, 테스트 수정, 리뷰 작업을 분리하는 데 서브에이전트를 사용하되, 서브에이전트는 자체 컨텍스트와 모델 설정을 가진 별도의 Claude 인스턴스이므로 그 토큰도 사용량에 포함된다고 보아야 합니다 .
• 로컬 대시보드는 과금의 진실이 아니라 진단 도구로 다루세요. ccusage 관련 커뮤니티 보고에서는 서브에이전트 사이드체인과 도구 결과 구조가 로컬 집계에 영향을 줄 수 있다고 언급하지만, Anthropic의 서버 측 한도 상태가 최종 기준입니다 .

실제로 해볼 실험은 “한도 우회”가 아닙니다. 아키텍처와 계획에는 Opus를 유지하고, 기계적인 수정이나 리뷰 패스는 적절한 경우 Sonnet으로 보내며, 승인 지속성, 재시작 복구, 무인 워크플로 제어를 위해 훅을 추가하세요. Claude Code는 긴 작업을 더 쉽게 재개하게 해줄 수는 있지만, 이미 소진된 Max 주간 풀을 더 많은 구독 용량으로 바꿔주지는 못합니다.

자주 묻는 질문

fallbackModel로 Claude Code 주간 한도를 우회할 수 있나요?

아니요. fallbackModel은 모델 과부하나 조건에 맞는 서버 측 장애가 있을 때 Claude Code 세션을 다른 모델로 우회시킬 수 있지만, 공유 Claude Max 주간 한도를 우회하지는 않습니다. Anthropic의 Claude Code 오류 문서는 과부하 조건과 사용량 한도 오류를 구분하며, 사용량 한도 지원 페이지는 표시된 초기화 시간 이후 또는 자격이 되는 결제 변경 이후에 접근이 재개된다고 설명합니다.

Claude Code 서브에이전트에는 별도 Max 플랜 사용량이 있나요?

아니요. Claude Code 서브에이전트는 별도 컨텍스트, 도구, 모델 설정, 권한 모드, 훅, 선택적 백그라운드 실행으로 동작할 수 있지만, 그 작업도 여전히 사용자의 계정 사용량을 소비합니다. Anthropic의 서브에이전트 문서는 서브에이전트를 작업 분리를 위한 별도 Claude 인스턴스로 설명할 뿐, 별도 구독 풀로 설명하지 않습니다.

Claude Code에서 모델 전환은 언제 도움이 되나요?

모델 전환은 Opus 허용량 소진, 모델 과부하, 조건에 맞는 서버 장애처럼 문제가 특정 모델에 한정될 때 도움이 될 수 있습니다. 공유 세션이나 주간 Max 풀이 소진된 뒤에는 도움이 되지 않습니다. 모델 구성 문서는 fallback 모델 동작을 설명하고, Anthropic의 오류 문서는 사용량 한도 오류가 임시 용량 오류와 다르다고 설명합니다.

재개 훅은 실제로 어디에 쓰나요?

재개 훅은 Claude Code 재시작이나 비대화형 워크플로 전반에서 라이프사이클 상태, 승인, 대기 중인 도구 호출을 보존하는 데 유용합니다. 추가 구독 용량을 얻는 장치는 아닙니다. Anthropic의 훅 문서는 SessionStart, PreToolUse, Stop, SubagentStop 같은 이벤트와 나중에 재개할 수 있는 지연된 도구 승인 흐름을 설명합니다.

Max를 많이 쓰는 사용자는 다음에 무엇을 시도해야 하나요?

Claude Code를 많이 쓰는 사용자는 /usage를 확인하고, 아키텍처와 계획에는 Opus를 유지하며, 일상적인 구현이나 리뷰 작업은 더 저렴한 모델로 보내고, 서브에이전트 fanout을 줄이며, 지속적인 자동화에는 Claude Console 또는 API 종량제 결제를 고려해야 합니다. Max는 Max 5x와 Max 20x 같은 더 높은 사용량 티어로 제공되지만 , 이러한 티어도 여전히 Anthropic의 공유 사용량 한도 시스템 안에서 동작합니다.

이 글이 도움이 되셨다면, 새 글이 올라올 때마다 이메일로 받아보세요.

구독하기