Claude Code 사용량 한도, 왜 막히고 언제 풀리나

💡 요약 / TL;DR - Claude Code 사용량 한도 실측 핵심 요약 (BLUF)

• 삼중 한도 구조: Claude Code는 5시간 세션 롤링 한도, 7일 주간 모델 한도, 그리고 초과분을 결제하는 사용량 크레딧의 삼중 제어판으로 작동합니다.
• 단일 사용량 풀 공유: claude.ai 웹 챗, Desktop App, Claude Code CLI가 동일한 사용 한도 풀을 공유하여 한 플랫폼의 사용량이 다른 쪽을 실시간 간섭합니다.
• 롤링 리셋 메커니즘: 자정 일괄 리셋이 아니라 각각 세션을 시작하거나 사용량이 고갈된 시점부터 돌아가는 롤링 시계 구조입니다.

Claude Code가 사용량 초과 메시지로 동작을 중단하는 원인은 세 가지 독립적 한도 제한 계층(5시간 롤링 세션 한도, 7일 주간 전체 및 Opus 전용 한도, 초과분 종량제 사용량 크레딧)의 충돌에 기인합니다. 아울러 웹 채팅, 데스크톱 앱, CLI 도구(Claude Code)가 단일 사용량 풀을 완전히 공유하므로 작업량 예측 시 이종 플랫폼 간의 간섭을 상시 감안해야 합니다. 본 Claude Code 사용량 분석 가이드는 Anthropic 공식 명세를 토대로 삼중 한도의 작동 메커니즘을 규명합니다.

왜 이 가이드가 꼭 필요할까요?

Claude Code가 왜 막혔는지 검색하면, 세 한도를 뭉뚱그린 가이드가 나옵니다. 전부 “주간 한도"라 부르거나, 주간 한도가 언제 도입됐는지 시점을 틀리게 적습니다. 그래서 엉뚱한 리셋을 기다리게 됩니다. 세 층을 나눠 보면 구조는 깔끔하고, 각 층은 자기 시계로 리셋됩니다. Claude Code 과금이 다른 AI 코딩 도구와 어떻게 다른지는 AI 코딩 도구 과금 정리에서 다뤘습니다. 이 글은 한도 자체에 집중합니다.

3대 사용량 한도는 각각 어떻게 동작하나요?

Claude Code 사용량은 세 층이 서로 쌓이는 삼중 제한 구조로 관리됩니다.

1. 5시간 세션 한도. 무거운 코딩 세션에서 가장 자주 부딪히는 층입니다. 플랜 포함 사용량에 도달하면 포함 사용량 한도는 5시간마다 리셋됩니다. 고정 시각이 아니라 세션을 시작한 시점부터 굴러가는 롤링 방식입니다.

2. 7일 주간 한도. Pro·Max 구독자에게 도입된, 5시간 한도에 더해지는 더 긴 예비분입니다. Anthropic은 7일마다 리셋되는 주간 한도 두 종류를 도입했습니다. 하나는 전체 사용량 한도, 하나는 가장 고성능인 Opus 모델 전용 한도입니다. 그래서 5시간 창이 계속 갱신돼도, 사용량이 많으면 주간 한도가 먼저 바닥날 수 있습니다.

3. 사용량 크레딧(초과 사용). 플랜 포함분을 넘겨도 크레딧으로 작업을 이어갈 수 있습니다. 크레딧은 Pro·Max·Team·좌석제 Enterprise에서 쓸 수 있고, Claude 대화와 Claude Code 양쪽에 적용됩니다. 알아둘 디테일이 하나 있습니다. 크레딧을 꺼도 5시간 리셋 타이밍은 바뀌지 않습니다. 그 창은 자기 일정대로 리셋됩니다.

아래 스크린샷이 앞의 두 층을 사용량 패널에서 실제로 보여줍니다. 5시간 세션 막대와 7일 주간 막대, 각각 자기 리셋 카운트다운이 붙어 있습니다. 크레딧 층은 포함분을 넘겨야 나타납니다.

현재 내가 막힌 한도는 무엇인지 어떻게 알 수 있나요?

막힘 메시지는 똑같아 보여도 대기 시간은 다릅니다. 5시간 창에 막혔다면 몇 시간이면 풀립니다. 주간 한도를 다 썼다면 5시간을 기다려도 소용없습니다. 7일 창이 넘어갈 때까지 기다려야 하고, 그건 며칠 뒤일 수 있습니다.

구분하려면 사용량 패널을 보면 됩니다. Claude Code 터미널에서 /usage 슬래시 명령을 쓰거나, 브라우저에서 사용량 설정 페이지를 열면 남은 사용량과 주간 한도 상태를 볼 수 있습니다. 꽉 찬 막대가 지금 막고 있는 한도입니다. Opus 전용 주간 한도는 흔한 함정입니다. 다른 모델은 여유가 있는데 Opus만 막힐 수 있습니다.

웹 챗과 API, CLI가 하나의 한도를 공유하나요?

claude.ai 채팅이 Claude Code 한도를 깎아먹을까요. 그렇습니다. 이게 개발자들이 가장 자주 헷갈리는 지점입니다. Claude Code는 채팅 사용량과 따로 계산되지 않습니다. claude.ai, Claude Code, Claude Desktop이 하나의 사용량 풀을 공유하고, 전부 같은 한도로 합산됩니다.

오전에 길게 한 채팅 대화가, 오후에 Claude Code에 쓸 예산을 줄여놓습니다. 코딩 마감 때문에 사용량을 아끼는 중이라면, 그 가벼운 claude.ai 세션은 공짜가 아닙니다. 같은 한도를 쓰는 셈입니다.

사용량 리셋은 정확히 언제 일어날까요?

시간 기반 두 한도는 리셋 방식이 다르고, 둘 다 매일 고정된 시각이 아닙니다.

5시간 창은 롤링 방식입니다. 처음 쓴 시점부터 세서 5시간 뒤에 리셋됩니다. 그래서 시작 시각에 따라 리셋 시각이 매번 달라집니다. 주간 한도는 7일 창이고, 특정 모델에서 한 번 바닥나면 그 7일이 다 차야 풀립니다. 5시간 대기로는 건드려지지 않습니다.

둘 다 자정 같은 고정 시각이 아니라 롤링이라, 정확한 리셋 시점을 아는 유일한 방법은 외워둔 시각이 아니라 사용량 패널의 카운트다운입니다.

2026년 5월 중순, 계정 카운터가 일괄 리셋되고 주간 한도에 한시 프로모가 붙었다는 제3자 보도가 있었습니다. 작성 시점 Anthropic 공식 문서에는 반영돼 있지 않아 미확인으로 둡니다. 현재 값은 본인 사용량 패널을 기준으로 삼는 게 맞습니다.

한도 고갈 시 즉시 대처하는 실용적 조치 3가지는?

노력 순으로 세 가지입니다. 한도에 도달하면 리셋을 기다리거나, 플랜을 업그레이드하거나, 사용량 크레딧을 구매할 수 있습니다.

그 너머의 더 오래가는 해법은 작업당 소비를 줄이는 것입니다. Anthropic 자체 가이드도 재사용에 무게를 둡니다. 여러 번 참조할 자료는 프로젝트에 올리고, 첫 메시지에 코딩 환경 맥락을 충분히 담으라는 것입니다. 같은 내용을 재사용할수록 캐싱 이득이 커지기 때문입니다. Claude Code라면 반복 작업을 스킬로 만들어두면 매번 다시 보내는 맥락이 줄어듭니다.

플랜·한도 정리표

값과 적용 범위는 2026년 5월 Anthropic 문서 기준이며 바뀔 수 있습니다. 본인 계정은 사용량 설정 페이지가 최종 기준입니다.

자주 묻는 질문

Q. 한도에 막혔는데 5시간이 지나도 안 풀립니다. 왜 그럴까요?

5시간 창이 아니라 주간 한도일 가능성이 높습니다. 특정 모델의 주간 한도를 다 쓰면 5시간을 기다려도 복구되지 않고, 7일 창이 리셋될 때까지 기다려야 합니다.

Q. claude.ai 채팅이 Claude Code 한도를 쓰나요?

그렇습니다. claude.ai, Claude Code, Claude Desktop 사용량이 전부 같은 한도로 합산됩니다.

Q. 매일 고정된 리셋 시각이 있나요?

없습니다. 5시간 창은 쓰기 시작한 시점부터 굴러서 리셋 시각이 달라집니다. 외운 시각 대신 사용량 패널 카운트다운을 보면 됩니다.

Q. 사용량 크레딧이 뭔가요?

플랜 포함 사용량을 넘겨도 작업을 이어가는 방법입니다. Pro·Max·Team·좌석제 Enterprise에서 쓸 수 있고 Claude 대화와 Claude Code 양쪽에 적용됩니다.

Q. 남은 양은 어떻게 확인하나요?

Claude Code에서 /usage 슬래시 명령을 쓰거나 브라우저에서 사용량 설정 페이지를 열면 됩니다.

Q. Opus만 막히고 다른 모델은 되는 경우가 있나요?

있습니다. 주간 한도에 Opus 전용 한도가 따로 있어서, 다른 모델은 여유가 있어도 Opus만 바닥날 수 있습니다.

출처

• Anthropic — How usage and length limits work: https://support.claude.com/en/articles/11647753-how-do-usage-and-length-limits-work
• Anthropic — Manage usage credits for paid plans: https://support.claude.com/en/articles/12429409-manage-extra-usage-for-paid-claude-plans
• Anthropic — Usage limit best practices: https://support.claude.com/en/articles/9797557-usage-limit-best-practices

업데이트 기록

• 2026-05-21 — 초기 게시. 한도 구조(5시간 세션, 7일 주간 전체+Opus, 사용량 크레딧)는 Anthropic support 문서 기준. 주간 한도는 2025년 8월 28일 Pro·Max에 적용. 2026년 5월 중순의 일괄 리셋·프로모 보도는 공식 문서 확인 전까지 미확인으로 표기.

메모: 한도·플랜 세부는 바뀝니다. 현재 값은 본인 Anthropic 사용량 설정 페이지에서 확인하시기 바랍니다.

Last verified: May 2026