Claude Code 사용량 제한 총정리: 5시간 윈도우, 주간 한도와 사용량을 늘리는 9가지 방법

핵심 요약: Claude Code의 사용량 제한은 두 가지 계층으로 적용됩니다. 5시간마다 초기화되는 세션 제한과 일주일에 한 번 초기화되는 주간 제한입니다. 두 제한 모두 Claude 웹 앱 및 Claude Desktop과 공유됩니다. 사용할 수 있는 양은 모델, 컨텍스트 크기, 도구 사용 여부에 따라 달라지므로 Anthropic은 메시지 수를 명시하지 않습니다.

많은 사용자가 바로 이 사용량 공유 방식을 간과하곤 합니다. 아침 식사 중에 방대한 리서치 대화로 소진해 버린 사용량이, 오후 3시에 에이전트를 실행할 때 절실히 필요한 사용량과 같은 풀에서 차감되는 셈입니다.

Claude Code 사용량 제한에는 무엇이 포함될까

Anthropic 고객센터에서는 이를 명확히 밝히고 있습니다. 유료 요금제에는 5시간마다 초기화되는 세션 제한과 일주일에 한 번 초기화되는 주간 제한이 적용됩니다. Max 요금제의 경우 여기에 Fable 모델에 대한 별도의 주간 제한이 추가됩니다. 이 할당량은 세 가지 환경(Claude 웹 앱, Claude Desktop, 그리고 터미널 및 IDE의 Claude Code)에서 공유되어 차감됩니다. 도구별로 별도의 사용량이 할당되어 보호되는 것은 아닙니다.

가격 정보는 Anthropic 요금 안내 페이지를 기준으로 하며, Anthropic의 정책에 따라 변경될 수 있습니다.

실제로 작동하는 5시간 세션 윈도우의 구조

세션 제한은 윈도우가 열린 시점으로부터 5시간 후에 초기화됩니다. Anthropic은 시작 기준이나 토큰 수치를 공식적으로 공개하지 않으므로, 타이밍을 계산해 우회하려 하기보다는 롤링 버짓(유동적 할당량)으로 여기는 것이 좋습니다.

버그처럼 보이지만 실제로는 의도된 동작이 하나 있습니다. 응답 도중 한도에 도달하면 Claude Code가 현재 진행 중인 단계를 마무리하고 Usage limit reached · wrapping up이라는 메시지를 출력할 수 있습니다. Anthropic의 Pro 및 Max 안내에 따르면 이 마무리 작업은 주간 제한에 산정되며 새로운 메시지에는 적용되지 않습니다. Pro 요금제에서는 주간 주기당 한 번 적용되고, Max 요금제에서는 5시간 제한에 도달할 때마다 적용됩니다. 또한 Anthropic은 이 기능이 점진적으로 배포되는 중이라 일부 계정에는 아직 적용되지 않았을 수 있다고 명시하고 있습니다. 이는 유예 기간이 아니라 이미 실행 중인 턴을 배려해 완료해 주는 기능입니다.

주간 제한이 업무에 더 치명적인 이유

주간 제한은 하루 업무를 완전히 중단시킬 수 있는 한도입니다. 5시간 윈도우는 하루에 4~5번 다시 채워지지만, 주간 제한은 그렇지 않습니다. Anthropic은 "일주일에 한 번 초기화되는 주간 제한" 외에는 구체적인 초기화 기준을 공개하지 않으므로, 임의로 추측한 초기화 시점에 맞춰 대규모 리팩터링 계획을 세우지 마세요. 작업을 시작하기 전에 먼저 /usage를 확인하시기 바랍니다.

어느 한도에 도달하든 선택할 수 있는 방법은 세 가지입니다.

1. 초기화될 때까지 기다린다.
2. 요청이 중단되지 않고 종량제로 전환되도록 사용량 크레딧을 활성화한다.
3. 이미 구독 중인 다른 에이전트로 작업을 전환한다.

메시지 수가 명시되지 않는 이유

Anthropic이 "윈도우당 200개 메시지"와 같은 수치를 공개하지 않는 이유는 그런 고정된 수치가 현실과 맞지 않기 때문입니다. 사용량은 토큰에 비례하며, 토큰은 선택한 모델(Opus는 턴당 Sonnet보다 더 많은 비용이 듭니다), 컨텍스트 크기(메시지를 보낼 때마다 지금까지의 대화가 다시 전송됩니다), 도구(Anthropic은 커넥터를 "토큰 소모가 큰 요소"로 규정합니다), 그리고 사고 강도(effort level)(생각 토큰은 출력으로 청구되며 기본 예산만으로도 요청당 수만 개에 달할 수 있습니다)에 따라 크게 달라집니다.

이 목록은 곧 사용량을 아끼기 위한 전략 목록이기도 합니다.

Claude Code 사용량을 최대한 효율적으로 활용하는 9가지 방법

1. /usage 명령을 실행하고 제안에 따르기

Pro, Max, Team, Enterprise 요금제에서는 /usage를 실행하면 최근 사용량을 스킬, 서브에이전트, 플러그인, 개별 MCP 서버별로 분류하여 보여주고, 각각이 차지하는 비중과 함께 권장 사항을 제시해 줍니다.

25%  Trim ~/code/api/CLAUDE.md · 49k tokens per request
40%  Switch from max to high effort · /effort high
30%  Compact before you step away · run /compact

d 또는 w를 눌러 24시간과 7일 간의 통계를 전환할 수 있습니다. 하단에 f to fix 2 of 3과 같은 표시가 나타나면 f를 눌러 Claude Code가 자체적으로 처리할 수 있는 항목들을 바로 적용할 수 있습니다. 표시되는 수치는 로컬 세션 기록을 기반으로 하므로 다른 노트북에서 사용한 내역은 포함되지 않습니다. 막연히 짐작하기보다는 여기서부터 확인하는 것이 좋습니다.

2. 서로 무관한 작업 사이에는 컨텍스트 초기화(/clear)하기

남아 있는 이전 컨텍스트는 한 번만 소모되는 것이 아니라 이후 전송되는 모든 메시지마다 토큰을 낭비하게 만듭니다. 버그 수정에서 새로운 기능 개발로 전환할 때 이전 대화 내용은 계속 재전송되는 불필요한 부담이 됩니다.

/rename auth-token-refresh-bug   # label it so you can find it later
/clear                           # start fresh
/resume                          # come back to it later

/clear를 실행하기 전에 /rename을 해두는 것은 많은 이들이 무심코 지나쳤다가 나중에 후회하는 단계입니다.

3. 압축(/compact) 시 유지할 정보 지정하기

자동 압축 기능은 컨텍스트 한도에 가까워지면 대화 기록을 요약하는데, 별다른 지침이 없으면 무엇이 중요한지 자체적으로 추측합니다. /compact Focus on code samples and API usage처럼 집중할 내용을 직접 지정하거나, 프로젝트의 CLAUDE.md에 영구적으로 설정해 두세요.

# Compact instructions

When you are using compact, please focus on test output and code changes

4. 작업에 알맞은 모델 매칭하기

Sonnet은 대부분의 코딩 작업을 충분히 처리하면서도 Opus보다 비용이 적게 듭니다. Opus는 아키텍처 설계와 같은 복잡한 판단에 아껴두고, 필요할 때 /model로 전환하세요. 이때 주의해야 할 두 가지 세부 사항이 있습니다. Opus로 전환하면 세션 모델을 상속받는 서브에이전트에도 적용된다는 점, 그리고 서브에이전트별로 더 저렴한 모델을 고정할 수 있다는 점입니다.

---
name: test-runner
model: haiku
---

어떤 역할에 어떤 모델을 배치해야 하는지는 Sharkly의 모델 라우팅 가이드를 참고하시고, 모델 다운그레이드가 오히려 역효과를 내는 경우는 저렴한 모델이 비용을 더 소모하는 순간을 확인해 보세요.

5. 사고 강도(effort level) 낮추기

확장된 사고(Extended thinking)는 난도 높은 기획 및 설계에 유용하기 때문에 기본적으로 활성화되어 있습니다. 하지만 일상적인 코드 수정 작업에서는 불필요하게 토큰을 낭비하는 원인이 됩니다. /effort 명령어로 강도를 낮추거나 /config에서 사고 기능을 비활성화하세요. Opus 5.5, Sonnet 5.5, Haiku 5.5 또는 Fable 모델에서는 이를 끌 수 없습니다. 고정 예산을 지원하는 모델의 경우 MAX_THINKING_TOKENS=8000으로 한도를 설정할 수 있으며, 적응형 추론 모델은 0이 아닌 예산 설정을 무시합니다.

6. MCP 서버 오버헤드 줄이기

도구 정의는 기본적으로 지연 로딩되므로, 도구가 실제로 실행되기 전까지는 이름과 서버 안내문만 컨텍스트에 포함됩니다. 하지만 이 역시 완전히 공짜는 아닙니다. /context를 사용해 무엇이 공간을 차지하고 있는지 확인하고, /mcp로 당장 사용하지 않는 서버를 비활성화하세요. CLI 도구가 있다면 CLI를 우선 활용하는 것이 좋습니다. gh, aws, gcloud 등은 도구별 정의 목록을 컨텍스트에 전혀 추가하지 않습니다.

7. CLAUDE.md 지침을 스킬로 분리하기

CLAUDE.md는 세션이 시작될 때 로드되어, 해당 내용과 전혀 무관한 메시지를 포함해 모든 메시지의 컨텍스트에 상주합니다. PR 체크리스트나 마이그레이션 런북이 포함된 300줄짜리 파일은 매 요청마다 큰 토큰 부담을 줍니다. 스킬(Skills)은 필요할 때만 온디맨드로 로드되므로, 특화된 절차는 스킬로 분리하고 CLAUDE.md는 200줄 미만으로 유지하세요.

8. Claude가 읽기 전에 장황한 출력 필터링하기

PreToolUse 훅을 사용하면 데이터가 컨텍스트에 전달되기 전에 전처리할 수 있습니다. Claude가 10,000줄짜리 로그를 전부 읽는 대신, 훅이 ERROR 항목만 grep하여 일치하는 내용만 반환함으로써 토큰 비용을 수만 개에서 수백 개 수준으로 줄여줍니다. 서브에이전트 역시 테스트 실행이나 문서 조회 시 동일한 역할을 수행합니다. 방대한 노이즈는 서브에이전트의 컨텍스트에만 머물고 메인 세션에는 요약된 결과만 반환됩니다.

9. 먼저 계획을 세우고 구체적으로 프롬프트 작성하기

"이 코드베이스 개선해 줘" 같은 모호한 요청은 광범위한 파일 스캔을 유발합니다. 반면 "auth.ts 파일의 로그인 함수에 입력값 유효성 검사 추가해 줘"와 같은 요청은 몇 개의 파일만 읽으면 됩니다. 규모가 큰 작업의 경우 Shift+Tab을 눌러 플랜 모드로 전환하세요. 검토 후 거절하는 계획은 잘못 구현된 코드를 되돌리는 것보다 훨씬 적은 비용이 듭니다.

작업 규모를 확장할 때 주의할 점이 하나 있습니다. Anthropic의 비용 관련 문서에 따르면, 팀원이 플랜 모드로 실행될 때 에이전트 팀은 표준 세션보다 약 7배 더 많은 토큰을 사용합니다. 각 에이전트가 자체 컨텍스트 윈도우를 유지하기 때문입니다. 단일 구독 내에서 병렬 작업을 진행하는 것은 주간 한도에 가장 빠르게 도달하는 지름길입니다.

피해야 할 행동

한도를 피하기 위한 다중 계정 생성, 로그인 정보 공유, 자격 증명 교체 등은 모두 Anthropic의 이용 약관을 위반하는 행위이며, 계정이 정지되면 초기화를 기다리는 것보다 훨씬 큰 손실이 발생합니다. 정당한 해결책은 상위 요금제로 업그레이드하거나 사용량 크레딧을 활용하는 것, 또는 콘솔 API 크레딧을 이용하는 것입니다.

더 상위 요금제로의 업그레이드가 정답이 아닌 경우

주목해 볼 만한 패턴이 있습니다. 목요일에 주간 한도에 도달했다고 가정해 보겠습니다. 팀에서 이미 결제 중인 Codex 구독도 있고, Gemini CLI 키도 있으며, 대기 중인 노트북도 한 대 있습니다. 하지만 이 중 어떤 것도 도움이 되지 않습니다. 작업이 단일 구독에 연결된 하나의 터미널에 묶여 있기 때문입니다. 이는 할당량 부족의 문제가 아니라 라우팅의 문제입니다.

Sharkly는 여러 코딩 에이전트 상위에 위치하는 오케스트레이션 레이어입니다. 컴퓨터를 연결하면 로컬 서비스가 설치된 에이전트 도구를 감지하여 각각을 런타임(Runtime)으로 등록합니다. 사용자는 원하는 런타임에서 실행되는 에이전트에 작업(Task)을 할당하기만 하면 됩니다. 이제 Claude Code, Codex, Gemini CLI, OpenCode는 고립된 사일로가 아니라 상황에 맞게 선택할 수 있는 실행 대상이 됩니다.

명확히 짚고 넘어가야 할 두 가지 경계가 있습니다.

• Sharkly는 사용자의 Claude 한도를 늘려주지 않습니다. 모델 사용량은 해당 도구에 설정된 구독 및 API 키에서 그대로 차감됩니다. Sharkly는 토큰을 직접 판매하지 않으며, 이는 기능상의 한계가 아니라 의도된 설계 방식(BYOK)입니다.
• Sharkly는 Claude Code를 대체하는 도구가 아닙니다. 팀에서 이미 사용 중인 도구들 주위에 공유 작업(Task), 컴퓨터(Computer), 컨텍스트, 리뷰 레이어를 더해주는 역할을 합니다.

어떤 런타임이 작업을 가져가든 업무 분담 원칙은 동일합니다. 에이전트는 조사, 실행, 테스트 및 보고를 담당하고, 사용자는 방향을 설정하고 실행 권한을 부여하며 결과를 승인합니다. 사용량 윈도우가 소진되었다고 해서 사용자의 판단권이 넘어가는 것이 아니라, 실행 주체만 전환될 뿐입니다.

달라지는 것은 작업이 이동할 수 있는 경로입니다. Claude 세션 윈도우가 소진되더라도 작업이 먹통이 된 터미널 안에서 오후 4시까지 멈춰 서 있지 않습니다. 다른 런타임의 에이전트로 작업을 재할당하면, 하나의 코드베이스에서 Claude Code와 Codex를 함께 운영하는 방법 가이드에서 다룬 것처럼 실행 과정, 차단 요소, 결과가 동일한 작업 타임라인으로 계속 기록됩니다.

솔직하게 판단해 보자면 두 가지 경우가 있습니다. 단일 리포지토리에서 에이전트 하나만 사용하고 있다면 앞서 소개한 9가지 팁만으로 충분합니다. 반면 여러 구독에 걸쳐 여러 에이전트를 이미 운용하고 있다면, 세션 윈도우를 일일이 손으로 계산하는 방식은 한계에 부딪힐 수밖에 없으며 수많은 터미널을 관리하는 비용을 치르게 됩니다. 또한 에이전트가 늘어날수록 검토할 내용도 많아지므로, 실행 단계의 병목이 해결되고 나면 사람의 검토가 새로운 병목으로 떠오르게 됩니다.

직접 환경에서 확인해 보려면 컴퓨터 하나를 연결하고 에이전트를 하나 생성한 뒤 간단한 작업을 할당해 보세요.

자주 묻는 질문 (FAQ)

Claude Code는 Claude 앱과 사용량 제한을 공유하나요? 네, 공유됩니다. Claude 웹 앱, Claude Desktop, Claude Code의 사용량은 모두 동일한 세션 제한 및 주간 제한 풀에서 차감됩니다. IDE 내 사용량 역시 마찬가지로 포함됩니다.

5시간 동안 메시지를 몇 개나 보낼 수 있나요? Anthropic은 고정된 숫자를 제시하지 않습니다. 사용하는 모델, 대화 길이, 활성화된 도구, 사고 강도에 따라 달라집니다. 어림짐작하기보다는 /usage를 확인하세요.

“Usage limit reached · wrapping up”은 무슨 뜻인가요? 5시간 한도에 도달했을 때 Claude Code가 이미 진행 중이던 단계를 마무리하고 있다는 의미입니다. 이 마무리 작업은 주간 제한에 포함되며 새로운 메시지 전송에는 적용되지 않습니다. Pro 요금제에서는 주간 주기당 1회, Max 요금제에서는 한도에 도달할 때마다 적용됩니다.

주간 제한은 언제 초기화되나요? Anthropic은 "일주일에 한 번 초기화되는 주간 제한" 외에는 명확한 초기화 기준을 공개하지 않으며, 고객센터에서는 이 주기를 주간 사용 기간(weekly usage period)으로 칭합니다. 명확히 설명된 것은 5시간마다 초기화되는 세션 제한뿐입니다. 무거운 작업을 시작하기 전에는 반드시 /usage를 확인하세요.

한도에 도달한 후에도 작업을 계속할 수 있나요? 네, 사용량 크레딧을 활성화하면 요청이 종량제로 전환되어 계속 작업할 수 있습니다. 콘솔 API 크레딧을 구매해 사용하는 것도 가능합니다. 단, Max 요금제에 포함된 월간 API 크레딧은 Claude Code에서 사용할 수 없습니다.

다른 에이전트 플랫폼을 사용하면 Claude 할당량이 늘어나나요? 아닙니다. Claude Code를 구동하는 모든 도구는 사용자의 구독 계정 기반으로 작동합니다. 관리 플랫폼은 라우팅 방식을 바꾸어 초기화를 기다리는 대신 다른 에이전트로 작업을 이동할 수 있게 해 줄 뿐입니다.

/compact