Claude Code 사용량 한도에 걸렸나요? 대처법과 계속 작업하는 방법

Claude Code가 세션 한도나 주간 한도에 도달했다고 할 때의 선택지: 자동 계속, 모델 전환, 사용량 크레딧, API 결제, 다른 계정.

기준 버전
CLI
0.2.17
프리뷰 ref
a2c45c8

요약

Claude Code가 You've hit your session limit · resets 3:45pm이라고 하면 선택지는 다음과 같습니다.

  1. 기다렸다가 Claude Code가 알아서 이어 가게 하기. v2.1.234 이상에서 claude.ai 구독을 쓴다면, 열린 세션에서 기다렸다가 초기화 후 작업을 이어 갑니다.
  2. 모델 한도라면 모델 바꾸기. Opus나 Sonnet 한도는 그 계열에만 적용되므로 /model로 계속할 수 있습니다. 세션 한도나 주간 한도는 모든 모델에 적용됩니다.
  3. 사용량 크레딧 켜기. Pro와 Max는 표준 API 요금으로 한도를 넘어 계속 작업할 수 있습니다. /usage-credits를 실행하세요.
  4. 작업을 API 결제로 옮기기. Claude Console 계정은 토큰 단위로 청구하며 5시간 창이 없습니다.
  5. 요금제 업그레이드. Max 5x와 20x는 세션당 할당량을 늘려 줍니다.
  6. 내가 소유한 다른 계정에서 이어 가기. 또는 이미 비용을 내고 있는 다른 에이전트로 이어 갑니다.

무엇이 맞는지는 어떤 한도에 걸렸는지, 초기화까지 얼마나 남았는지, 돈을 낼지 기다릴지에 따라 다릅니다.

문제

한도는 대개 곤란한 순간에 옵니다. 리팩터링을 시작한 지 한 시간, 테스트가 절반쯤 통과한 시점이죠. 세션이 멈추고, 쌓아 온 맥락은 그대로 남아 있습니다. 다른 곳에서 다시 시작하면 모든 걸 다시 설명해야 하고, 기다리면 초기화까지 작업이 멈춰 있습니다.

첫 단계는 메시지를 잘 읽는 것입니다. 한도마다 해결 방법이 다르기 때문입니다.

1단계: 어떤 Claude Code 한도에 걸렸는지 확인하기

Anthropic 오류 레퍼런스 기준:

메시지의미다시 쓰는 방법
You've hit your session limit · resets …5시간 롤링 창, 모델 공통초기화, 사용량 크레딧, 업그레이드
You've hit your weekly limit · resets …주간 한도, 모델 공통주간 초기화, 사용량 크레딧, 업그레이드
You've hit your Opus limit 또는 Sonnet limit한 모델 계열의 한도/model로 그 계열이 아닌 모델로 전환
You've hit your monthly spend limit 및 유사 메시지사용량 크레딧이 지출 한도에 닿음한도를 올리거나 메시지에 나온 요금제 초기화를 기다림
Server is temporarily limiting requests서버 측 제한, 할당량과 무관잠시 후 다시 시도
Credit balance is too low잔액이 없는 API 결제Console 크레딧 충전

/usage를 실행하면 두 창과 초기화 시각을 볼 수 있습니다. 창이 동작하는 방식은 Claude Code 사용량은 언제 초기화되나요?에서 설명합니다.

2단계: 계속 작업할 방법 고르기

기다렸다가 Claude Code가 자동으로 이어 가게 하기

claude.ai 구독으로 로그인한 대화형 세션에서는 v2.1.234부터 자동 계속이 기본으로 켜져 있습니다. 다음이 보입니다.

Usage limit reached · limit resets 3:45pm
Continuing automatically at 3:45pm · esc to cancel

세션을 열어 두세요. 초기화 시각이 되면 Claude Code가 Claude에게 멈춘 곳에서 작업을 이어 가라고 합니다. 마지막 메시지를 다시 보내지는 않습니다. Anthropic 대화형 모드 페이지의 세부 사항:

  • 컴퓨터가 약 30분 넘게 절전 상태였고 그동안 한도가 초기화됐다면 Enter를 누르라고 합니다.
  • 대기는 연속 최대 두 번까지 스스로 다시 설정합니다. 그 뒤에는 Automatic continue stopped after repeated usage-limit hits로 멈춥니다.
  • 권한 요청은 평소처럼 나타나므로, 자리를 비운 사이 이어진 작업이 거기서 멈출 수 있습니다.
  • 끄려면 /config의 Continue automatically at usage limit을 쓰세요. 데스크톱 앱에는 세션 한도 카드에 별도의 Auto-continue when limits reset 체크박스가 있습니다.

비용이 들지 않는 선택지입니다. 초기화가 가깝거나 작업이 기다려도 될 때 적합합니다.

Opus나 Sonnet 한도라면 모델 바꾸기

/model

한도에 걸린 계열이 아닌 모델을 고르세요. 모델마다 프롬프트 캐시가 따로 있어서 다음 요청은 캐시 없이 대화 전체를 다시 읽습니다. 평소보다 무거운 턴이 되고, 세션 한도나 주간 한도에는 도움이 되지 않습니다.

사용량 크레딧 켜기

Pro와 Max에서는 사용량 크레딧으로 표준 API 요금을 내고 한도를 넘어 계속 작업할 수 있습니다. 구독으로 로그인한 뒤 /usage-credits를 실행하세요. claude.ai의 Settings → Usage가 열리고, 거기서 크레딧을 켜고 월 지출 한도를 정합니다. Team과 Enterprise에서는 관리자에게 추가를 요청합니다.

Anthropic 도움말 센터에 따르면 크레딧으로 넘어가면 5-hour limit resets [time] - continuing with usage credits가 표시됩니다.

필요해지기 전에 지출 한도를 정해 두세요. API 요금으로는 긴 에이전트 실행이 금방 비용을 씁니다.

종량제 API 결제로 옮기기

Claude Console 계정은 토큰 단위로 청구하며 5시간이나 주간 창이 없습니다. Anthropic 도움말은 집중적인 코딩 작업을 위한 선택지로 이것을 소개합니다. 전환은 로그인 변경이므로 현재 대화의 결제가 함께 넘어가지는 않습니다. 먼저 Console에서 워크스페이스 지출 한도를 정하세요.

요금제 업그레이드

거의 매일 5시간 창에 닿는다면 오래가는 해결책은 더 큰 요금제입니다. Max 5x는 세션당 Pro의 5배, Max 20x는 20배를 씁니다. Anthropic에 따르면 새 요금제의 한도는 바로 적용됩니다.

내가 소유한 다른 계정이나 다른 에이전트에서 이어 가기

개인 Pro 요금제와 업무 좌석처럼 구독을 여러 개 가진 사람도 있습니다. Claude와 Codex가 포함된 ChatGPT 요금제를 둘 다 쓰는 사람도 있습니다. 어느 경우든 이미 비용을 낸 곳에서 작업을 이어 갈 수 있습니다. 각 제공자의 약관은 지키세요. Anthropic의 Consumer Terms에 따르면 계정 자격 증명을 다른 사람과 공유하거나 계정을 다른 사람이 쓰게 해서는 안 됩니다.

이걸 손으로 하면 새 세션을 만들고 작업을 다시 설명해야 합니다. 다음 섹션은 처음부터 다시 하지 않는 방법을 다룹니다.

내 계정들 사이에서 같은 세션 이어 가기

내 계정 중 하나가 한도에 닿아도 세션이 계속되고, 그걸 휴대폰에서 지켜보고 싶다면, Happier는 휴대폰, 데스크톱, 웹에서 Claude Code, Codex 등 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다.

계정 풀은 내가 소유한 계정을 묶습니다

풀은 개인 구독과 업무 구독처럼 내가 소유한 계정(둘 다 내 이름으로 로그인하고 내 컴퓨터에서 쓰는 계정)을 묶습니다. 하나가 사용량 한도에 닿으면 Happier가 세션을 다른 계정으로 바꿔 이어 갈 수 있습니다.

풀의 동작:

  • 풀을 만들기 전에는 아무것도 전환되지 않습니다. 풀 생성은 Settings → Connected services에서 직접 하는 단계입니다.
  • 새 Claude나 Codex 풀은 Automatic fallback이 켜진 상태로 시작합니다. 직접 전환하고 싶다면 풀 옵션에서 Automatic fallback을 끄세요.
  • 풀 안에서 전환해도 Claude Code나 Codex가 재시작되지 않습니다. 새 로그인이 실행 중인 세션에 적용됩니다.
  • Selection strategy의 기본값은 Least limited first입니다. Priority order와 Manual switching도 있습니다.
  • 예방적 전환. Soft switch threshold의 기본값은 남은 양 15%이며, 다른 멤버의 할당량 정보가 더 최신일 때 전환합니다. 0으로 두면 하드 한도에 닿았을 때만 전환합니다.
  • 전환 횟수 제한. 기본적으로 자동 전환은 턴당 1회, 세션 시간당 3회까지입니다.
  • Recovery mode의 기본값은 가능하면 전환하고, 아니면 초기화를 기다리는 것입니다. 다른 모드로는 초기화까지 기다리기, 전환 후 재개, 끄기가 있습니다.

세션 안의 실시간 대체는 Claude와 Codex용입니다. Gemini, OpenCode, Pi도 풀을 가질 수 있지만, 해당 컨트롤에는 이 서비스를 실행 중 계정 대체에 쓸 수 없다고 표시됩니다.

사용량 한도 배너

제공자가 세션에 대기를 요청하면 세션에 초기화 시각과 함께 Usage limit reached가 표시되고, Resume when limit resets, Stop waiting, Check limit now, 풀이라면 Switch account now 같은 동작이 나옵니다. Happier는 재개할 때 원래 요청을 다시 보내는 게 아니라 이어 가기 프롬프트를 보냅니다.

Continue with another Agent

가진 다른 구독이 다른 에이전트용이라면, Continue with another Agent로 같은 세션과 대화 기록을 유지한 채 세션을 실행하는 에이전트를 그 자리에서 바꿀 수 있습니다. 현재 에이전트가 유휴 상태일 때 쓸 수 있고, 인계는 분량이 제한된 텍스트 요약이라 이전 턴의 이미지는 넘어가지 않습니다. 자세한 과정은 작업 도중 Claude Code에서 Codex로 맥락을 잃지 않고 전환하는 방법에서 다룹니다.

하지 못하는 일

풀은 한도를 올리거나, 할당량을 늘리거나, 초기화 창을 줄여 주지 않습니다. 계정이 하나뿐이면 전환할 대상이 없습니다. 세션을 실행하는 컴퓨터가 꺼져 있으면 아무것도 계속되지 않습니다.

Connected services와 할당량 미터는 Happier 0.2.17에서 실험적 기능이며 기본적으로 꺼져 있습니다. Settings → Features에서 Connected services를 켜고, 미터가 필요하면 Connected services quotas도 켜세요. 설정은 휴대폰에서 Happier 사용하는 방법에 있습니다. Happier는 GitHub에 있고, 여기서 다운로드할 수 있으며, Discord도 있습니다.

다음을 대비하기

  • 미터를 보세요. rate_limits 필드를 쓰는 상태 표시줄은 5시간과 주간 비율을 항상 보여 줍니다. Claude Code 사용량 확인하는 방법을 참고하세요.
  • 작업 사이에 비우세요. /clear는 비용이 들지 않습니다. 긴 세션에서는 요청마다 기록을 다시 보냅니다.
  • 작업에 맞는 모델을 고르세요. Anthropic 비용 페이지는 대부분의 코딩에는 Sonnet, 복잡한 추론에는 Opus를 권합니다.
  • 간단한 작업은 effort를 낮추세요. 사고 토큰은 출력으로 집계됩니다. /effort로 낮출 수 있습니다.
  • CLAUDE.md는 짧게. 워크플로 지시는 사용할 때만 로드되는 스킬로 옮기세요.
  • 무엇이 많이 쓰는지 확인하세요. /usage 내역은 스킬, 서브에이전트, 플러그인, MCP 서버를 비율과 함께 보여 줍니다.

문제 해결

자동 계속이 시작되지 않음

Claude Code v2.1.234 이상, 대화형 세션, claude.ai 구독이 필요합니다. API 결제에서는 시작되지 않습니다. /config에서 Continue automatically at usage limit이 켜져 있는지 확인하세요.

모델을 바꿔도 소용없음

모든 모델에 적용되는 세션 한도나 주간 한도에 걸린 것입니다. 모델 전환은 Opus나 Sonnet 한도에만 도움이 됩니다.

사용량 크레딧을 켰는데도 작업이 멈춤

메시지를 확인하세요. 지출 한도 메시지라면 크레딧이 내가 정한 월 한도에 닿았거나, 자동 충전이 꺼진 상태에서 잔액이 바닥난 것입니다.

자주 묻는 질문

Claude Code 사용량 한도는 얼마나 지속되나요?

세션 한도는 5시간 롤링 창으로 동작합니다. 주간 한도는 계정마다 정해진 시각에 초기화됩니다. 정확한 초기화 시각은 메시지에 나옵니다.

Claude Code 사용량 한도를 우회할 수 있나요?

요금제 한도를 없애는 방법은 없습니다. 기다리거나, 사용량 크레딧이나 API 결제로 추가 비용을 내거나, 업그레이드하거나, 가진 다른 계정이나 에이전트로 이어 갈 수 있습니다.

한도에 걸리면 세션이 사라지나요?

아니요. 대화는 열린 세션에 남아 있습니다. 닫았더라도 초기화 후 claude --resume으로 다시 불러올 수 있습니다.

사용량 크레딧이 요금제보다 비싼가요?

표준 API 요금으로 청구됩니다. 한 달치 크레딧 지출과 한 단계 위 요금제 가격을 비교해 어느 쪽이 더 저렴한지 확인하세요.

관련 가이드

claudeusage-limitsquotaaccountsconnected-services
마지막 업데이트: 2026-10-26