Claude Code가 작업을 멈추며 띄운 문구에 따라 해결법이 달라집니다. You've hit your session limit이나 You've hit your weekly limit은 Pro·Max·Team 구독의 사용량 한도라서 모델을 바꿔도 풀리지 않고, 표시된 리셋 시각까지 기다리거나 추가 사용량을 켜야 합니다. You've hit your Opus limit처럼 모델 이름이 들어간 문구라면 /model로 다른 모델 계열을 고르면 바로 이어서 작업할 수 있습니다. API Error: Request rejected (429)는 구독이 아니라 API 키나 클라우드 계정의 속도 제한이고, 529는 사용자 한도가 아니라 서버 용량 문제입니다.
2026년 10월 8일 기준 Anthropic은 구독 한도를 메시지 수나 사용 시간으로 공개하지 않습니다. "Pro는 5시간에 메시지 몇 개" 같은 숫자는 공식 값이 아니므로, 남은 양은 Claude Code의 /usage나 claude.ai의 설정 > 사용량에서 직접 보는 것이 가장 정확합니다.
Claude Code 한도 오류 문구별 의미와 바로 할 일
아래 문구는 Claude Code 오류 문서에 실린 영어 원문입니다. 리셋 시각 부분은 계정마다 다르게 표시되고, 한국어 화면에서는 번역된 문장으로 보일 수 있습니다.
| 화면 문구(영어 원문) | 뜻 | 바로 할 일 |
|---|---|---|
You've hit your session limit · resets 3:45pm | 5시간 세션 한도 소진, 모든 모델 공통 | 리셋까지 대기(자동 재개 가능), 한도 리셋, 추가 사용량 |
You've hit your weekly limit · resets Mon 12:00am | 주간 한도 소진, 모든 모델 공통 | 위와 같음. 모델 변경으로는 풀리지 않음 |
You've hit your Opus limit / You've hit your Sonnet limit | 해당 모델 계열의 한도만 소진 | /model로 다른 계열 선택 |
You've hit your monthly spend limit · raise it at claude.ai/settings/usage | 추가 사용량이 직접 정한 월 지출 한도에 도달 | 설정 > 사용량에서 한도 상향 또는 /usage-credits |
You've hit your org's monthly spend limit 등 | Team·Enterprise 조직·개인 지출 한도 | 관리자에게 상향 요청 |
Credit balance is too low | 크레딧 잔액 부족 | /usage-credits로 충전 |
API Error: Request rejected (429) | API 키, Amazon Bedrock, Google Cloud 프로젝트의 속도 제한 | /status로 인증 수단 확인, 동시 실행 줄이기, 티어 확인 |
API Error: Repeated 529 Overloaded errors | 서버 용량 부족, 내 한도와 무관 | 잠시 후 재시도, 다른 모델로 변경 |
Server is temporarily limiting requests (not your usage limit) | 짧은 서버 측 조절, 내 한도와 무관 | 잠시 대기(v2.1.199부터 자동 재시도) |
판단 기준은 두 가지입니다. 문구에 "session", "weekly"가 있으면 구독 한도이고, "429"가 있으면 API 속도 제한입니다. 529는 모든 사용자에게 걸리는 용량 문제라서 사용량에 포함되지 않으며, 원인과 대처는 Claude 529 overloaded_error란? 2026년 기준 의미와 해결 방법에 따로 정리되어 있습니다.
Claude Code 속도 제한은 두 가지: 구독 사용량 한도와 API 속도 제한
어느 쪽 제한을 받는지는 Claude Code에 어떻게 로그인했는지로 정해집니다. /status를 실행했을 때 Login method 줄에 Claude Max account처럼 구독이 보이면 구독 사용량 한도를, API key 줄이 보이면 Claude Console 조직의 API 속도 제한을 받습니다(fast 모드 문서의 확인 방법).
구독 사용량 한도: 5시간 세션, 주간, 모델별 한도
Pro, Max, Team, 좌석제 Enterprise에는 세 겹의 한도가 있습니다(Claude 지원 센터: 사용량 및 길이 제한).
- 5시간 세션 한도: 5시간마다 리셋됩니다.
- 주간 한도: 모든 모델에 걸쳐 적용되며, 구독 시작일과 관계없이 계정마다 정해진 요일·시각에 리셋됩니다. 다음 리셋 시각은 설정 > 사용량에 나옵니다.
- 모델별 한도: Opus나 Sonnet처럼 특정 모델 계열에만 걸리는 한도입니다.
claude.ai 채팅, Claude Code(터미널과 VS Code·JetBrains 확장), Claude Desktop은 모두 같은 한도를 나눠 씁니다. 오전에 채팅을 많이 했다면 오후 Claude Code에 남는 양이 그만큼 줄어듭니다.
플랜 간 차이는 Pro를 기준으로 한 세션당 사용량 배수로만 공개되어 있습니다(Max 플랜 안내, Team 플랜 안내).
| 플랜 | 월 요금(미국, 세전) | 세션당 사용량(Pro = 1) |
|---|---|---|
| Pro | $20 | 1 |
| Max 5x | $100 | 5배 |
| Max 20x | $200 | 20배 |
| Team Standard 좌석 | $25(연간 결제 시 $20) | 1.25배 |
| Team Premium 좌석 | $125(연간 결제 시 $100) | 6.25배 |
이 배수는 세션 한도에 대한 것이고, 주간 한도가 플랜별로 몇 배인지는 공개되어 있지 않습니다. Anthropic은 주간·월간 상한이나 모델·기능별 사용 제한을 따로 둘 수 있다고 밝히고 있습니다. Fable 모델은 Max에서 주간 한도의 최대 50%까지 쓸 수 있고, Pro에서는 처음부터 추가 사용량으로 과금됩니다. Claude Code는 무료 플랜에 포함되지 않으며, 무료로 써 볼 수 있는 조건은 Claude Code 무료 체험이 아직 있나? 2026년 기준 조건과 다음 선택지에서 다룹니다.
API 속도 제한: 분당 요청·토큰 수
Claude Console의 API 키, ANTHROPIC_API_KEY 환경 변수, Amazon Bedrock이나 Google Cloud로 Claude Code를 쓰면 구독 한도 대신 API 속도 제한이 적용됩니다. 조직의 사용 티어에 따라 모델 계열별로 분당 요청 수(RPM), 분당 입력 토큰(ITPM), 분당 출력 토큰(OTPM)이 정해지고, 넘으면 HTTP 429가 돌아옵니다. 티어별 숫자는 아래 "API 키로 쓸 때의 429" 절에 있습니다.
남은 사용량 확인: Claude Code /usage와 설정 > 사용량
가장 빠른 확인 방법은 Claude Code에서 /usage를 실행하는 것입니다(/cost, /stats도 같은 명령). 구독자에게는 다음이 보입니다(Claude Code 비용 관리 문서).
- 세션·주간 사용량 막대와 각 리셋 시각
- 사용량이 어디서 나왔는지: 스킬, 서브에이전트, 플러그인, MCP 서버별 비율
- 긴 컨텍스트나 캐시 미스처럼 최근 사용량의 10% 이상을 차지한 동작 경고
- 많이 쓴
/loop·예약 작업 목록 d/w키로 최근 24시간과 7일 전환
이 분석은 현재 컴퓨터의 로컬 세션 기록으로 계산되므로 다른 기기나 claude.ai 채팅 사용량은 빠집니다. 전체 사용량과 주간 리셋 시각은 claude.ai의 설정 > 사용량에서 보는 것이 정확하고, Claude Desktop에서는 모델 선택기 옆 사용량 링으로 남은 양을 계속 볼 수 있습니다. /usage 맨 위의 달러 금액은 API 사용자용 추정치라서 Pro·Max 요금과는 관계가 없습니다.
사용량 조회 자체가 일시적으로 막히면 /usage는 최근 60분 안에 불러온 값을 Showing last-known usage 표시와 함께 보여 줍니다. r 키로 다시 불러올 수 있습니다.
세션 한도를 90% 가까이 썼을 때 할 일
세션 막대가 90% 근처라면 남은 10%를 어디에 쓸지 먼저 정하는 것이 좋습니다.
/usage에서 세션 리셋 시각을 봅니다. 곧 리셋된다면 큰 작업은 그 뒤로 미룹니다.- 하던 작업과 관계없는 다음 작업은
/clear로 새로 시작합니다. 긴 대화는 매 요청마다 전체가 다시 전송되기 때문입니다. - 반복 작업은
/model에서 Sonnet이나 Haiku로 바꿉니다. 같은 턴이라도 Opus가 Sonnet보다 여러 배 많이 쓰고, Sonnet은 Haiku보다 많이 씁니다. - 서브에이전트나 에이전트 팀을 새로 띄우는 일은 리셋 뒤로 미룹니다.
- 끊기면 안 되는 작업이라면 미리 추가 사용량을 켜고 월 지출 한도를 정해 둡니다.
한도에 걸린 뒤 계속 작업하는 방법: /rate-limit-options
구독 한도 때문에 요청이 막히면 /rate-limit-options가 선택지를 보여 줍니다. 리셋 뒤 자동으로 이어 가기, 추가 사용량 켜기, 플랜 업그레이드입니다(Claude Code 명령어 문서). 여기에 웹·Desktop에서 쓰는 한도 리셋과 모델 변경을 더하면 공식적인 방법은 다섯 가지입니다.

리셋 시각까지 기다렸다가 자동으로 이어 가기
Claude Code v2.1.234 이상에서는 중단된 작업을 리셋 뒤 자동으로 이어서 실행하도록 기다리게 할 수 있습니다. 어떤 경우에 자동으로 대기를 시작하는지는 대화형 모드 문서에 있고, 조직 관리자는 autoContinueAtUsageLimit 설정으로 이 동작을 정할 수 있습니다. 세션 한도라면 오류 문구에 나온 시각까지, 주간 한도라면 계정에 정해진 주간 리셋 시각까지 기다리는 셈입니다.
한도 리셋(Reset for free)으로 바로 되돌리기
Anthropic은 대상 플랜에 가끔 한도 리셋을 지급합니다. 리셋 하나는 5시간 세션 한도나 주간 한도 가운데 표시된 쪽을 처음 상태로 되돌립니다(한도 리셋 안내).
- 웹이나 Claude Desktop의 설정 > 사용량에서 "Reset for free"를 누릅니다. Claude Code 터미널·IDE와 모바일 앱에서는 쓸 수 없습니다.
- 한 번 쓰면 되돌릴 수 없고, 주간 리셋은 원래 일정대로 따로 진행됩니다.
- 쓰지 않은 리셋은 표시된 날짜에 만료되고, 이미 청구된 추가 사용량은 환불되지 않습니다.
- 다운그레이드하거나 해지하면 쓰지 않은 리셋은 사라집니다.
2026년 9월 22일 Opus 5.5 출시 때 구독자에게 나중에 쓸 수 있는 리셋이 지급되었고(Opus 5.5 발표), 보고에 따르면 이 리셋은 2026년 10월 22일에 만료됩니다. 정확한 만료일은 설정 > 사용량에서 확인하고, 버튼이 보인다면 만료 전에 주간 한도가 막혔을 때 쓰는 편이 효과가 큽니다.
추가 사용량으로 한도를 넘어 계속하기
Pro와 Max는 추가 사용량(영어 화면의 usage credits)을 켜면 플랜 한도를 넘어서도 API 표준 요금으로 계속 쓸 수 있습니다(추가 사용량 안내).
- 켜는 곳: claude.ai 설정 > 사용량. Claude Code에서
/usage-credits를 실행하면 이 페이지가 열립니다(API 키 로그인에서는 쓸 수 없음). - 결제 방식: "Add funds"로 미리 충전하는 선불이며, 자동 충전과 월 지출 한도(또는 무제한)를 정할 수 있습니다. 하루 사용 한도는 $2,000입니다.
- 묶음 할인: $50어치를 $45, $250어치를 $200, $1,000어치를 $700에 살 수 있습니다.
- 모바일 앱으로 구독했다면 웹에서 켜야 합니다.
2026년 10월 8일 기준 Claude API 요금은 100만 토큰당 입력/출력 기준으로 다음과 같습니다.
| 모델 | 입력 | 출력 |
|---|---|---|
| Haiku 5.5 | $0.10부터 | $0.50부터 |
| Sonnet 5.5 | $2 | $10 |
| Opus 5.5 | $4 | $20 |
| Fable 5.1 | $10 | $50 |
비용에 영향을 주는 함정이 하나 있습니다. 구독 한도 안에서는 프롬프트 캐시가 1시간 유지되지만, 추가 사용량으로 넘어가면 기본 5분으로 짧아집니다. 추가 사용량으로 일할 때 쉬는 시간이 길면 다음 메시지에서 전체 컨텍스트를 다시 처리하게 되므로, 긴 휴식 뒤에는 /clear로 새로 시작하는 편이 쌉니다.
월간 지출 한도에 도달했는데 크레딧이 남아 있다면
잔액과 지출 한도는 별개입니다. 크레딧이 충전되어 있어도 직접 정한 월 지출 한도에 닿으면 You've hit your monthly spend limit 오류가 나고 요청이 멈춥니다. Pro·Max에서는 이때 Claude Code가 터미널을 떠나지 않고 지출 한도를 올리거나 없앨지 묻습니다(비용 관리 문서). 바로 올리면 이어서 작업할 수 있고, 지출을 묶어 두고 싶다면 그대로 두고 세션 리셋을 기다리면 됩니다. 브라우저에서는 claude.ai/settings/usage에서 같은 설정을 바꿀 수 있습니다.
Opus·Sonnet 한도라면 /model로 다른 모델 계열로
You've hit your Opus limit은 Opus 계열에만 걸린 한도이므로 /model로 Sonnet을 고르면 대화를 잃지 않고 계속할 수 있습니다. 반대로 세션·주간 한도는 모든 모델이 공유하므로 모델을 바꿔도 소용이 없습니다.
Claude Code v2.1.280부터 Pro를 포함한 모든 플랜에서 default 모델은 Opus 5.5입니다(모델 설정 문서). 모델을 직접 고른 적이 없다면 Opus로 쓰고 있을 가능성이 높고, 그만큼 한도가 빨리 줄어듭니다. 별칭은 opus(Opus 5.5), sonnet(Sonnet 5.5), haiku(Haiku 5.5)이고, opusplan은 계획은 Opus 5.5로, 실행은 Sonnet 5.5로 나눕니다. 모델별 비용과 성능 차이는 Opus 5.5 vs Fable 5.1: Claude API 모델을 비용과 성능으로 고르는 법에서 비교합니다.
자주 막히면 Max·Team으로 업그레이드
매주 한도에 걸린다면 업그레이드를 검토할 때입니다. 미국 월 요금 기준으로 Pro에서 Max 5x는 $80, Max 20x는 $180이 더 들고, 남은 결제 주기만큼 일할 계산됩니다. 업그레이드 직후 이미 쌓인 이번 주 사용량이 초기화되는지는 공개 문서에 나와 있지 않으므로, 지금 막힌 한도를 풀려고 업그레이드한다면 결과를 /usage로 바로 확인해야 합니다. Pro와 Max의 한도 차이와 주간 제한이 남는 이유는 클로드 Pro·Max 사용량 한도 비교: 업그레이드해도 주간 제한은 남습니다에 자세히 있습니다.
짧은 기간 집중해서 많이 써야 한다면 Claude Console 계정에서 API 크레딧을 사서 그 계정으로 로그인하는 방법도 Anthropic이 안내하는 선택지입니다. 이 경우 구독 한도 대신 아래의 API 속도 제한과 토큰당 요금이 적용됩니다.
2026년 9월 변경: 주간 한도 25% 상향 고정과 5시간 한도 상향
주간 한도는 프로모션이 끝나면서 한 번, Opus 5.5 출시와 함께 5시간 한도가 한 번 바뀌었습니다(주간 한도 프로모션 안내).
- 2026년 5월 13일~9월 13일: Claude Code 주간 한도가 50% 늘어났습니다. 5시간 한도와 채팅은 그대로였습니다.
- 2026년 9월 14일부터: Claude Code 주간 한도가 프로모션 이전보다 25% 높은 수준으로 고정되었습니다. 대상은 Pro, Max, Team, 좌석제 Enterprise이고, 무료 플랜과 사용량 기반 Enterprise는 빠집니다.
- 2026년 9월 22일: Opus 5.5 출시와 함께 같은 플랜들의 5시간 한도가 올라갔습니다. 얼마나 올랐는지는 공개되지 않았습니다.
프로모션 기간과 비교하면 주간 한도는 1.25 ÷ 1.5 ≈ 0.83, 즉 약 17% 줄었습니다. 프로모션 이전 기준으로는 25% 늘어난 상태입니다. 같은 작업량인데 9월 중순부터 주간 한도에 더 빨리 닿았다면 이 차이 때문일 수 있습니다.

API 키로 쓸 때의 429: Claude API 티어별 RPM·ITPM·OTPM
구독자인데 429가 뜬다면 ANTHROPIC_API_KEY부터 확인
Pro·Max 구독자가 API Error: Request rejected (429)를 본다면 가장 먼저 의심할 것은 환경 변수입니다. ANTHROPIC_API_KEY가 설정되어 있고 사용을 승인했다면 Claude Code는 구독 대신 그 키로 인증해서 API 요금과 API 속도 제한을 적용합니다(인증 문서). 낮은 티어의 키가 남아 있으면 구독자인데도 429가 납니다.
unset ANTHROPIC_API_KEY # 현재 셸에서 키 제거
claude # 다시 실행한 뒤 /status로 Login method 확인셸 설정 파일(~/.zshrc 등)에 키가 적혀 있다면 그 줄도 지워야 다음 터미널에서 다시 나타나지 않습니다. 429가 계속되면 CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY를 낮추거나 병렬 서브에이전트 수를 줄이는 것도 오류 문서가 권하는 방법입니다.
Claude API 티어별 속도 제한 표
2026년 10월 8일 기준 Claude API 속도 제한 문서의 표준 한도입니다. 조직 단위로 적용되며, 실제 내 조직의 티어와 한도는 Claude Console의 Rate limits 페이지에서 볼 수 있습니다.
| 모델 | Start (RPM / ITPM / OTPM) | Build | Scale |
|---|---|---|---|
| Opus 5.5 | 1,000 / 2,000,000 / 400,000 | 5,000 / 5,000,000 / 1,000,000 | 10,000 / 10,000,000 / 2,000,000 |
| Sonnet 5.5 | 1,000 / 2,000,000 / 400,000 | 5,000 / 5,000,000 / 1,000,000 | 10,000 / 10,000,000 / 2,000,000 |
| Haiku 5.5 | 1,000 / 2,000,000 / 400,000 | 5,000 / 5,000,000 / 1,000,000 | 10,000 / 10,000,000 / 2,000,000 |
| Fable 5.x | 1,000 / 500,000 / 100,000 | 2,000 / 1,500,000 / 300,000 | 4,000 / 4,000,000 / 800,000 |
| 월 지출 상한 | $500 | $1,000 | $200,000 |
표를 읽을 때 알아 둘 점입니다.
- 새 조직이나 사용 기록이 적은 조직은 이 표보다 낮은 Evaluation 티어에서 시작할 수 있고, 기록이 쌓이면 자동으로 올라갑니다.
- 한도는 모델별로 따로 적용되므로 Sonnet과 Haiku를 각자의 한도까지 동시에 쓸 수 있습니다.
- 대부분의 현재 모델에서 캐시에서 읽은 입력 토큰은 ITPM에 들어가지 않습니다. 문서의 예시대로 ITPM 2,000,000에 캐시 적중률 80%라면 분당 입력 토큰을 사실상 10,000,000개(캐시 미적용 200만 + 캐시 800만)까지 처리할 수 있습니다.
- 토큰 버킷 방식이라 용량은 정해진 시각에 한꺼번에 리셋되지 않고 계속 채워집니다. 60 RPM이 초당 1건으로 적용될 수도 있어서 짧게 몰아 보내면 분당 평균이 한도 안이어도 429가 날 수 있습니다.
- 사용량이 갑자기 크게 늘면 가속 제한(acceleration limits)으로 429가 날 수 있으므로 트래픽은 점진적으로 늘리는 것이 좋습니다.
429 대응 코드: retry-after가 없으면 월 지출 상한
같은 429라도 두 종류입니다. 속도 제한 429에는 몇 초 기다릴지 알려 주는 retry-after 헤더가 붙고, 티어의 월 지출 상한에 닿은 429(error.details.error_code가 enforced_spend_limit_reached)에는 이 헤더가 없습니다. 지출 상한 429는 SDK의 자동 재시도를 포함해 아무리 다시 보내도 다음 달 1일 00:00 UTC까지 실패하므로, 재시도 대신 티어 상향을 요청해야 합니다. Console에서 직접 정한 지출 한도에 닿으면 429가 아니라 HTTP 400(invalid_request_error)이 돌아옵니다.
아래 예시는 Python anthropic SDK로 두 경우를 나눠 처리합니다. ANTHROPIC_API_KEY가 설정된 환경에서 그대로 실행할 수 있습니다.
import random
import time
import anthropic
client = anthropic.Anthropic(max_retries=0) # 재시도를 직접 제어
def create_with_backoff(max_attempts=5, **kwargs):
for attempt in range(max_attempts):
try:
return client.messages.create(**kwargs)
except anthropic.RateLimitError as e:
retry_after = e.response.headers.get("retry-after")
if retry_after is None:
# 월 지출 상한(enforced_spend_limit_reached): 재시도해도 다음 달까지 실패
raise
wait = float(retry_after) + random.uniform(0, 1)
print(f"429 속도 제한: {wait:.1f}초 대기 ({attempt + 1}/{max_attempts})")
time.sleep(wait)
raise RuntimeError("재시도 횟수를 모두 사용했습니다")
message = create_with_backoff(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "이 함수의 버그를 찾아 주세요."}],
)
print(message.content[0].text)남은 한도는 성공한 응답의 헤더로 미리 볼 수 있습니다. anthropic-ratelimit-requests-remaining, anthropic-ratelimit-input-tokens-remaining, anthropic-ratelimit-output-tokens-remaining가 남은 요청·토큰 수를, -reset으로 끝나는 헤더가 다시 가득 차는 시각(RFC 3339)을 알려 줍니다. SDK에서는 client.messages.with_raw_response.create(...)로 호출하면 .headers로 읽을 수 있습니다.
Claude Code 속도를 높이는 /fast는 추가 사용량에서 따로 차감
응답 속도 자체가 문제라면 fast 모드가 있습니다. /fast로 켜면 같은 Opus 모델을 최대 2.5배 빠르게 실행하며, Opus 5.5, Opus 5, Opus 4.8에서만 됩니다(fast 모드 문서). 2026년 10월 8일 기준 연구 프리뷰 기능이라 가격과 제공 조건이 바뀔 수 있습니다.
- 요금: Opus 5.5 fast 모드는 100만 토큰당 입력 $8, 출력 $40으로 표준 Opus 5.5($4/$20)의 2배입니다.
- 구독 한도와의 관계: Pro·Max·Team·Enterprise에서는 추가 사용량으로만 쓸 수 있고 구독 한도에 포함되지 않습니다. 플랜 사용량이 남아 있어도 fast 모드 사용분은 바로 추가 사용량에서 빠집니다. 추가 사용량이 꺼져 있으면
/fast가 "Fast mode requires usage credits"라고 알립니다. - 켜는 시점: 대화 중간에 처음 켜면 그때까지의 전체 컨텍스트를 fast 모드의 캐시 미적용 입력 요금으로 한 번 처리합니다. 세션을 시작할 때 켜는 편이 쌉니다.
- fast 모드 전용 속도 제한: 표준 Opus와 별도 한도가 있고, 닿으면 표준 속도로 자동 전환되었다가 대기 시간이 끝나면 다시 켜집니다. 프롬프트 옆
↯아이콘이 회색이면 대기 중입니다.
사용량을 빨리 소모하는 원인과 줄이는 방법
같은 작업량인데 한도가 유독 빨리 찬다면 대개 아래 중 하나입니다(비용 관리 문서의 "Why usage climbs in a long session").
| 원인 | 왜 많이 쓰는가 | 줄이는 방법 |
|---|---|---|
| 긴 컨텍스트 | 매 요청마다 전체 대화와 도구 결과를 다시 보냄 | 관련 없는 작업 사이에 /clear(비용 없음) |
| 캐시 미스 | 캐시 유지 시간(구독 1시간, 추가 사용량·API 기본 5분)이 지난 뒤 첫 메시지가 전체를 재처리 | 긴 휴식 뒤에는 새 세션으로 시작 |
예약 작업·/loop | 쉬는 동안에도 정해진 간격마다 전체 컨텍스트 전송 | /usage의 Loops 항목에서 무거운 작업 정리 |
| 서브에이전트 | 메인 대화와 별개로 요청을 보냄 | 단순 작업용 서브에이전트에 model: haiku 지정 |
| 에이전트 팀 | 팀원이 계획 모드로 돌면 일반 세션의 약 7배 토큰 | 팀을 작게, 끝난 팀원은 종료 |
압축(/compact) | 요약하려고 큰 대화를 한 번 다 읽음 | 이어 갈 필요가 없으면 /compact 대신 /clear |
| Opus 기본값 | 턴당 사용량이 Sonnet의 여러 배 | 일상 작업은 Sonnet, 어려운 설계만 Opus |
그 밖에 /effort로 추론 수준을 낮추고, /mcp에서 쓰지 않는 MCP 서버를 끄고, CLAUDE.md를 200줄 안쪽으로 줄여 자주 쓰지 않는 지침을 스킬로 옮기는 것도 문서가 권하는 방법입니다. 어떤 원인이 큰지는 /usage의 경고 항목이 10% 이상을 차지한 동작을 짚어 주므로 거기서부터 손대면 됩니다.
다른 API 엔드포인트(ANTHROPIC_BASE_URL)는 구독 한도 해결책이 아닙니다
ANTHROPIC_BASE_URL로 Claude Code를 다른 업체의 엔드포인트에 연결하면 요청은 내 Claude 구독이 아니라 그 업체의 요금과 정책으로 처리됩니다. Anthropic 구독의 5시간·주간 한도가 늘거나 리셋되는 것이 아니라 구독을 쓰지 않는 것일 뿐이고, 원래 로그인으로 돌아오면 한도는 그대로 남아 있습니다. 계정 공유나 재판매도 구독 한도를 늘리는 공식 방법이 아닙니다.
Anthropic이 제공하는 방법은 위에서 다룬 다섯 가지(리셋 대기, 한도 리셋, 추가 사용량, 모델 계열 변경, 플랜 업그레이드)와 Claude Console API 키로 직접 과금받는 방법입니다.
자주 묻는 질문
클로드 코드 Pro 요금제의 사용량은 어느 정도인가요?
메시지 수나 시간으로 정해진 값은 공개되어 있지 않습니다. 공식적으로 알려진 것은 Pro가 기준(1)이고 Max 5x가 세션당 5배, Max 20x가 20배라는 배수뿐입니다. 같은 Pro라도 모델(Opus는 Sonnet보다 턴당 여러 배 사용), 대화 길이, 서브에이전트·MCP 사용 여부에 따라 버티는 시간이 크게 달라지므로, 본인의 /usage 7일 기록으로 판단하는 것이 가장 정확합니다.
Claude Code와 claude.ai 채팅은 사용량 한도를 공유하나요?
네. Pro·Max·Team에서 claude.ai 채팅, Claude Code(터미널과 IDE 확장), Claude Desktop은 같은 5시간 세션 한도와 주간 한도를 나눠 씁니다. 따로 나눠 배정하는 설정은 없으므로, Claude Code에 여유를 남기려면 채팅에서 긴 대화나 무거운 모델 사용을 줄여야 합니다. 다만 /usage의 분석 항목은 현재 컴퓨터의 Claude Code 기록만 보여 주므로, 채팅까지 합친 전체 사용량은 설정 > 사용량에서 봐야 합니다.
플랜을 업그레이드하면 지금 걸린 한도가 바로 풀리나요?
공개 문서에는 업그레이드 직후 이번 주 사용량이 초기화된다는 내용이 없습니다. 업그레이드하면 한도 자체가 커지므로 여유가 생길 수는 있지만, 지금 당장 이어서 써야 한다면 추가 사용량을 켜거나 한도 리셋을 쓰는 쪽이 확실합니다. 업그레이드 뒤에는 /usage로 막대가 어떻게 바뀌었는지 확인하세요.
Claude Code 한도를 공식적으로 늘리는 방법은 무엇인가요?
구독에서는 플랜 업그레이드(Max 5x, Max 20x, Team Premium 좌석)와 추가 사용량이 공식 방법입니다. 한도 리셋은 지급된 경우에만 쓸 수 있고, 모델 변경은 Opus·Sonnet 모델별 한도에만 효과가 있습니다. API로 쓴다면 Claude Console의 Rate limits 페이지에서 Request rate limit increase로 더 높은 한도나 월 지출 상한을 요청할 수 있습니다.
한국에서도 Claude Code 구독과 추가 사용량을 쓸 수 있나요?
네. 한국은 Anthropic 지원 국가 목록에 포함되어 있어 Pro·Max 구독, 추가 사용량, Claude API를 모두 쓸 수 있습니다. 위 요금은 미국 달러 기준이며, 현지 통화 표시와 세금 처리는 결제 화면에서 확인해야 합니다.



