클로드 코드 한도: 플랜별 사용량과 한도·오류 메시지 17가지의 뜻

플랜별 Claude Code 사용 한도는 얼마인가요?

모든 구독에서 Claude Code의 사용 한도는 계정 전체 예산의 한 조각이며, 5시간 세션과 주 단위로 계량되고, Anthropic은 각 플랜을 Pro의 배수로만 정합니다. 어느 플랜 페이지에도 프롬프트나 토큰 수는 나와 있지 않습니다. Anthropic의 요금 FAQ는 "there's no fixed message count"라고 하므로, 가이드들이 아직 싣는 Pro의 5시간당 약 45개 프롬프트는 Anthropic의 숫자가 아니라 외부 추정치입니다. 아래 표의 모든 칸은 Anthropic의 요금 페이지, 플랜 도움말 문서, API 속도 한도 참고 문서에서 가져온 것이며 2026년 10월 18일에 확인했습니다.

가격을 배수로 나누면 사다리가 평평해집니다. 월 결제 기준으로 Pro, Max 5x, Team Standard 시트, Team Premium 시트는 모두 Pro 크기 세션 하나당 $20입니다. 이를 절반인 $10으로 낮추는 단계는 Max 20x뿐입니다. Team 한도도 사람마다 따로입니다. Anthropic의 Team 플랜 페이지는 "Usage limits on Team plans are per-member, rather than applied to the team as a whole."이라고 밝힙니다.

두 행에는 창이 아예 없습니다. 사용량 기반 Enterprise는 API 요금으로 소비량만큼 청구하고, Console API 키는 Anthropic의 Claude Code 도움말에 따르면 "No hard stop; the account is charged for what it uses"입니다. 다만 키에도 천장은 있고 종류가 다를 뿐입니다. 등급의 분당 한도를 넘는 요청은 429를 받고, 등급의 월 상한(Start $500, Build $1,000, Scale $200,000)을 다 쓴 조직은 다음 달 1일 00:00 UTC까지 중지됩니다. Fable이 또 하나의 예외입니다. Pro에서는 사용 크레딧으로만 돌아가고, Max에서는 자체 주간 막대를 갖습니다.

한도에 걸리면 Claude Code는 뭐라고 하나요?

Claude Code는 메시지의 첫 단어로 바닥난 계량기를 알려 주므로, 다른 무엇보다 그 부분부터 읽으세요. "Session"과 "weekly"는 플랜의 창을 뜻합니다. 모델 이름은 한 모델군의 한도를 뜻합니다. "Spend limit"은 사용 크레딧 상한이고 "429"는 API 키를 뜻합니다. 한도 메시지는 모두 Anthropic의 Claude Code 오류 레퍼런스, 대화형 모드 문서, Pro 및 Max 도움말 페이지에서 2026년 10월 18일에 모았습니다. 표시된 시각은 Anthropic의 예시이며 실제와는 다를 수 있습니다.

처음 두 행은 모델을 바꿔도 해결되지 않습니다. Anthropic의 비용 문서는 세션 또는 주간 한도가 "shared across all models, so the developer can't restore access by switching models with /model."이라고 합니다. Opus와 Sonnet 행은 반대입니다. 그 모델군 밖의 모델로 바꾸면 바로 작업을 이어갈 수 있습니다. 마지막 두 행은 사용 한도가 전혀 아닙니다. 529는 "doesn't count against your quota"이며, Claude 자체가 흔들리는 중이라면 Claude 장애 확인에서 볼 수 있습니다.

Claude Code 사용 한도는 언제 초기화되나요?

Claude Code의 세션 한도는 5시간마다 롤링 창으로 초기화되고, 주간 한도는 Anthropic이 계정마다 정해 둔 매주 고정된 시각에 초기화됩니다. 어느 쪽도 자정에 초기화되지 않습니다. 초기화 시각은 한도 메시지에 나오고 /usage에도 나옵니다.

버전 2.1.234부터 Claude Code는 사용자를 기다려 줄 수 있습니다. claude.ai 한도가 작업을 실행 도중에 멈추면 열린 세션을 붙들고 "Continuing automatically at 3:45pm · esc to cancel"을 표시합니다. 초기화 시각이 되면 마지막 메시지를 다시 보내지 않아도 멈춘 지점부터 작업을 이어가도록 Claude에게 요청합니다. 대기는 연속으로 최대 두 번까지만 다시 걸립니다. 그다음에는 "Automatic continue stopped after repeated usage-limit hits"와 함께 멈춥니다. 세 경우에는 자동 대기를 건너뜁니다.

• 24시간 넘게 남은 주간 초기화. Claude Code가 대신 /rate-limit-options를 열고, 사용자가 직접 "Wait here, then continue automatically"를 고릅니다.
• 다른 모델군을 쓰는 중에 닿은 Opus 또는 Sonnet 한도. 다음 턴은 그 한도에 걸리지 않을 수도 있으니 기다릴 이유가 없습니다.
• API 키, 클라우드 제공업체, 사용량 기반 청구. Anthropic은 그쪽 사용량이 "is metered per request, so there is no reset to wait for."라고 합니다.

일찍 채우는 방법이 하나 있습니다. Anthropic은 가끔 무료 한도 초기화를 나눠 주는데, 2026년 9월 22일 Opus 5.5 출시 때 구독자에게 "which you can now save and use whenever you choose."라며 하나를 줬습니다. 터미널에서는 쓸 수 없습니다. Anthropic 도움말에 "The "Reset for free" button isn't currently available on Claude Mobile or in Claude Code in your terminal or IDE."라고 나와 있습니다. 웹의 설정 > 사용량이나 Claude Desktop에서 쓰면 예산이 공유되므로 Claude Code도 한도를 가득 돌려받습니다. 지출 상한이 걸린 API 조직에는 그런 버튼이 없습니다. 달력상의 월이 바뀌는 00:00 UTC까지 기다려야 합니다.

/usage와 /status로 Claude Code 사용량을 확인하려면?

/usage를 실행하면 플랜의 세션 및 주간 막대와 초기화 시각이 나오고, /status를 실행하면 Claude Code가 실제로 어떤 계정과 자격 증명을 쓰는지 나옵니다. "왜 막혔지"라는 의문의 대부분은 이 두 명령으로 풀립니다. /cost와 /stats는 /usage의 별칭입니다.

Pro, Max, Team, Enterprise에서 /usage는 무엇이 허용량을 썼는지도 보여 줍니다. 스킬, 서브에이전트, 플러그인, 각 MCP 서버가 전체에서 차지한 비율과, 긴 컨텍스트나 캐시 미스처럼 10% 이상을 쓴 동작에 대한 표시입니다. d나 w를 눌러 최근 24시간과 최근 7일을 전환합니다. 이 전환은 조심해서 읽으세요. Anthropic은 이 수치가 "computed from local session history on this machine, so usage from other devices or claude.ai is not included."라고 밝힙니다. 플랜 막대가 계정 전체 수치이고, 세부 내역은 이 노트북 한 대의 것일 뿐입니다.

/status는 이해가 안 되는 벽을 확인하는 수단입니다. API 키 행이 보이면 Claude Code는 플랜이 아니라 그 키로 청구되고 있는 것입니다. Anthropic의 Pro 및 Max 도움말 페이지는 ANTHROPIC_API_KEY가 설정되어 있으면 "Claude Code will use this API key for authentication instead of your Claude subscription."이라고 경고합니다. Max 구독자가 429나 "Credit balance is too low"를 받는 이유가 이것입니다. 변수를 해제하고 다시 실행한 뒤 /login을 하세요. 하루 종일 계량기를 보고 싶다면 사용자 지정 상태 줄이 rate_limits.five_hour.used_percentage와 rate_limits.seven_day.used_percentage를 읽을 수 있습니다. Anthropic은 이 필드가 Pro 및 Max 구독자나 지출 한도를 설정하는 회사 게이트웨이 뒤에서만 나타난다고 합니다.

2025년 이후 Claude Code 사용 한도는 어떻게 바뀌었나요?

Anthropic은 Claude Code의 5시간 한도를 주간 한도보다 빠르게 올려 왔습니다. 2026년 5월 6일에 5시간 한도를 두 배로 올렸고 9월 22일에 다시 올렸지만, 주간 한도는 9월 말 기준 4월 수준보다 25% 높은 데 그쳤습니다. 아래 모든 행은 Anthropic의 공지나 도움말 페이지에서 2026년 10월 18일에 확인한 것이며, 첫 행만 TechCrunch가 보도한 Anthropic의 이메일입니다.

두 배율을 나란히 놓으면 세션 기준으로는 주간 한도가 더 빡빡해졌습니다. 5시간 창 하나가 4월보다 적어도 두 배를 담고 한 주는 1.25배를 담는다면, 이제 한 주에는 그때보다 가득 채운 세션이 최대 62.5%만 들어갑니다. 매 세션을 가득 채우는 개발자는 이제 4월보다 적은 세션만에 주간 벽에 닿습니다. 이는 Anthropic의 수치를 바탕으로 한 우리 계산이지 Anthropic이 밝힌 숫자가 아니며, 9월 22일 상향을 반영하면 실제 비율은 더 낮습니다.

Opus 주간 상한은 과거의 일입니다. Anthropic의 Opus 4.5 글은 "we've removed Opus-specific caps"라고 했고, 플랜 페이지들은 이제 "across all models"에 적용되는 주간 한도 하나를 설명합니다. 그래도 Claude Code에는 "You've hit your Opus limit" 메시지가 남아 있고 Anthropic 문서도 그 해결책으로 /model을 그대로 둡니다. 이제 자체 계량기를 가진 모델은 Fable이며, 요금 페이지에 따르면 Max에서는 "50% of weekly limits"까지 쓸 수 있습니다.

Claude Code는 왜 한도에 이렇게 빨리 닿나요?

Claude Code는 요청할 때마다 대화 전체를 보내고, 도구 호출마다 결과를 실은 요청이 하나씩 더 붙습니다. Anthropic의 비용 문서는 그 결과를 한 줄로 말합니다. "a one-line question in a session that has been open all day still draws usage for the whole conversation." 허용량을 가장 빨리 깎는 습관은 다섯 가지입니다.

• 긴 세션. 컨텍스트는 턴마다 커지므로 백 번째 프롬프트는 첫 번째보다 훨씬 비쌉니다. 관련 없는 작업 사이의 /clear는 "costs nothing"이지만, /compact는 그 자체로 큰 요청입니다.
• 캐시 수명을 넘기는 휴식. 프롬프트 캐시는 구독에서는 1시간 유지되고 사용 크레딧으로 넘어가면 5분으로 줄어듭니다. 긴 휴식 뒤 첫 메시지는 모든 것을 다시 처리합니다.
• 기본값이 Opus. Anthropic은 Sonnet이 "handles most coding tasks well and costs less than Opus"라고 하며, Opus로 바꾸면 사용자의 모델을 물려받는 서브에이전트도 함께 바뀝니다.
• 서브에이전트, 에이전트 팀, 루프. 각각이 자체 요청을 만듭니다. 에이전트 팀은 팀원이 플랜 모드로 돌 때 "approximately 7x more tokens than standard sessions"를 쓰고, /loop 작업은 사용자가 자리를 비운 동안에도 간격마다 실행됩니다.
• 계정의 나머지 전부. claude.ai 채팅, Claude Desktop, claude -p로 돌린 스크립트, Agent SDK가 모두 같은 한도를 씁니다.

값싼 해결책 두 가지로 대부분 해결됩니다. CLAUDE.md는 세션 시작 때마다 로드되므로 200줄 안팎으로 유지하고, 긴 워크플로 지침은 쓸 때만 로드되는 스킬로 옮기세요. 그다음 /mcp를 실행해 쓰지 않는 서버를 끄세요. 최근 사용량의 10% 이상을 쓴 동작을 /usage 세부 내역이 표시해 주므로, 어느 쪽이 문제인지 알려 줄 것입니다.

Claude Code 한도에 닿았을 때 계속 작업하려면?

가장 빠른 길은 메시지에 따라 다릅니다. 모델군 한도는 /model로 몇 초 만에 풀립니다. 세션이나 주간 한도에는 선택지가 네 개 있고, 이 순서대로 비용이 커집니다.

1. 기다리기. 세션을 열어 두면 Claude Code가 초기화 뒤에 알아서 작업을 이어가며, 주간 초기화라면 /rate-limit-options에서 "Wait here, then continue automatically"를 고르세요.
2. 사용 크레딧 켜기. /usage-credits를 실행하세요. Pro와 Max에서는 설정 > 사용량이 열리는데, 크레딧은 선불이며 "billed at standard API rates"입니다. 사용량 번들은 이를 낮춰 줍니다. $50어치 사용량이 $45, $250어치가 $200, $1,000어치가 $700이며 월 $2,000까지입니다. Team과 Enterprise에서 결제 권한이 없는 구성원은 대신 관리자에게 요청을 보냅니다.
3. Console API 키로 전환. 5시간 창 없이 토큰 단위로 내며, Opus 5.5는 백만 토큰당 입력 $4와 출력 $20, Sonnet 5.5는 $2와 $10입니다. Max에 딸린 월 API 크레딧은 "can't be used in Claude Code or the Claude apps."입니다.
4. 업그레이드. /upgrade를 실행하세요. Pro 크기 세션당 가격을 $10으로 낮추는 단계는 Max 20x뿐입니다.

3번과 4번 중에서 고르기 전에 API 수치를 확인하세요. Anthropic은 기업 배포 전체에서 Claude Code가 개발자 1인당 활성일 하루 평균 약 $13, 개발자당 월 $150에서 $250 정도이며, 사용자의 90%는 활성일 하루 $30 미만이라고 밝힙니다. 이 범위는 Max 20x의 가격 $200 양쪽에 걸쳐 있고, API에는 주간 한도가 없습니다. 매주 주간 벽에 닿는다면 해결책은 API나 Max 20x입니다. 한 달에 한 번 닿는다면 크레딧이 더 쌉니다. Claude Max는 그만한 가치가 있을까가 플랜별 계산을 전부 다룹니다. Google의 에이전트로 옮길 생각이라면 코딩용 Claude vs Gemini가 Claude Code와 Antigravity를 작업당 비용과 시간으로 비교합니다.

이 페이지를 게시한 Whizi에서는 Claude Code가 실행되지 않습니다. Anthropic은 Claude 플랜, Console API 키, Amazon Bedrock, Google Cloud, Microsoft Foundry를 결제 수단으로 꼽습니다. Whizi가 할 수 있는 것은 한도가 다시 차는 동안 채팅에서 코딩 질문에 답하는 일입니다. Whizi Pro는 월 $29.99에 2,500 크레딧이고, Claude Sonnet은 메시지당 10크레딧, Claude Opus는 20크레딧이므로 5시간 창 없이 한 달에 Sonnet 250개 또는 Opus 125개 메시지를 보낼 수 있습니다(Whizi에서 Claude 쓰기). 불리한 점도 있습니다. 크레딧은 UTC 기준 월이 바뀔 때만 다시 차고, 모든 플랜은 시간당 60개 메시지에서 멈춥니다.