Claude Code 사용량 제한: 무엇이 계산되는지, 언제 초기화되는지, 그리고 초과하는 것을 막는 방법

Pro 또는 Max 구독으로 Claude Code를 사용하는 경우, 작업 도중에 한도에 도달했다는 메시지를 본 적이 있을 것입니다. 이 제한은 이해하기 어렵지는 않지만, 공유되고, 서로 다른 주기로 초기화되며, chat보다 더 빠르게 소모되기 때문에 파악하기 쉽지 않습니다.

요약

구독으로 Claude Code에 로그인하면 claude.ai와 동일한 한도를 사용합니다:

• 첫 메시지로 시작하는 5시간 동안의 이동(rolling) 세션,
• 모든 모델이 공유하는 주간 한도,
• 일부 플랜에서는 특정 모델에 대한 별도의 주간 상한선.

채팅과 코딩은 하나의 풀을 공유합니다. 터미널에서 긴 리팩토링 작업은 claude.ai에서 차단될 수 있으며, 긴 채팅은 코딩 세션을 짧게 만들 수 있습니다.

만약 Claude Console의 API 키를 사용하여 Claude Code를 사용하는 경우, 이 모든 것이 적용되지 않습니다. API 사용량 제한에 따라 토큰당 비용을 지불합니다.

Claude Code가 채팅보다 한도를 더 빨리 사용하는 이유

1. 에이전트 루프(Agentic loops). 파일을 읽고, 명령을 실행하고, 코드를 편집하는 동안 하나의 요청이 여러 모델 호출로 바뀔 수 있습니다.
2. 큰 컨텍스트(Large context). 각 호출은 지금까지의 대화와 읽은 모든 파일을 담고 있으므로, 긴 세션일수록 단계당 비용이 더 많이 듭니다.
3. 더 강력한 모델(Stronger models). 가장 유능한 모델은 가벼운 모델보다 메시지당 사용 한도를 더 많이 소모합니다.

지속적으로 사용하는 방법

지속적으로 사용하는 방법

• 관련 없는 작업 사이에는 **/clear**를 사용하고, 긴 대화의 컨텍스트를 줄이려면 **/compact**를 사용하여 각 호출에서 더 적은 컨텍스트가 전달되도록 합니다.
• /model을 사용해 작업에 맞는 모델을 매칭시키고, 가장 강력한 모델은 어려운 부분에 남겨둡니다.
• 초기화 계획을 세웁니다. 세션 창이 거의 다 쓰여서 40분 후에 초기화된다면, 그 전에 대규모 리팩토링을 시작하지 말고, 초기화된 후에 시작합니다.
• 숫자를 항상 눈에 보이게 유지하세요. /usage는 세션 및 주간 사용량을 초기화 시간과 함께 보여주지만, 기록이 없고 사용량이 바닥나기 전에 경고를 해주지 않기 때문에 작업 도중에 잊어버리기 쉽습니다.

도움이 되는 도구들

• /usage (내장): 세션 및 주간 백분율을 빠르게 확인할 수 있습니다.
• ccusage (오픈 소스): Claude Code의 로컬 로그를 읽어 토큰과 일일, 세션별 또는 5시간 블록당 예상 비용을 보고합니다.