Claude Code에서 사용량 한도에 걸렸다면 먼저 내 플랜과 제한 종류를 확인해야 한다. 개인 Pro·Max 플랜은 세션 기반 한도가 5시간마다 초기화되고, 주간 한도는 계정에 할당된 고정 요일과 시각에 매주 초기화된다. 하지만 모든 Claude Code 사용자가 같은 시간표를 적용받는 것은 아니다.
내 계정의 실제 다음 초기화 시간은 Claude의 설정 > 사용량에서 확인하는 것이 가장 정확하다. 터미널에서는 /usage로 플랜 사용량을 볼 수 있다. 인터넷에 적힌 특정 시각이나 “첫 메시지부터 정확히 168시간”이라는 계산을 내 계정의 답으로 대신하면 안 된다.
1분 안에 다음 초기화 시간 확인하기
- 한도 메시지의 문구를 그대로 읽는다. 5시간 세션 한도인지, 주간 한도인지, 특정 모델 한도인지 구분한다.
- Claude에서 설정 > 사용량을 연다. 개인 Pro·Max 플랜이라면 이 화면에 다음 초기화 시간이 표시된다.
- Claude Code에서
/usage를 실행한다. 플랜 한도와 활동 정보를 확인하되, 화면에 이전 스냅샷이라는 안내가 있으면 현재값으로 단정하지 않는다. - 로그인 경로를 확인한다. 개인 구독, 조직의 포함 사용량, API 키 종량제는 같은 초기화 규칙을 공유하지 않는다.
- 설정 화면의 제한 이름과 Claude Code의 한도 메시지가 같은 항목을 가리키는지 대조한다.
특정 계정의 시간대, 남은 용량, 카운트다운 최신성은 공개 문서만으로 알 수 없다. 인증된 설정 화면에 보이는 제한 이름과 시각이 내 계정에 적용되는 답이다.
어떤 한도에 걸렸는지 먼저 구분한다
| 보이는 상황 | 의미 | 확인할 곳 |
|---|---|---|
| 개인 Pro·Max에서 세션 한도 안내 | 5시간마다 초기화되는 세션 기반 사용량 한도일 수 있음 | 설정 > 사용량, /usage |
| 주간 한도 안내 | 개인 Pro·Max라면 계정에 할당된 고정 요일·시각에 초기화 | 설정 > 사용량 |
| 조직 계정의 포함 사용량 안내 | 좌석·조직 정책에 따라 개인 플랜과 다른 계약이 적용될 수 있음 | 한도 메시지, 조직 관리자, /usage |
| API 키로 사용 중 | 구독 포함량이 아니라 별도 종량제 사용 경로 | API 결제·사용량·rate limit 화면 |
| 대화가 너무 길거나 컨텍스트가 부족함 | 플랜 사용량 한도와 다른 대화 길이 문제 | 새 대화 또는 컨텍스트 관리 |
이 구분이 중요한 이유는 해결 방법이 서로 다르기 때문이다. 대화 컨텍스트를 비워도 구독 플랜의 사용량이 되돌아오지는 않는다. 반대로 API 키로 별도 과금 중이라면 “5시간 뒤 구독 한도 초기화”가 현재 요청의 처리 기준이 아닐 수 있다.
개인 Pro·Max: 5시간 한도와 주간 한도는 별개다
Anthropic의 현재 Pro 플랜 안내와 Max 플랜 안내는 두 종류의 제한을 구분한다.
- 세션 기반 사용량 한도: 5시간마다 초기화된다.
- 주간 한도: 계정에 할당된 고정 요일과 시각에 매주 초기화된다.
따라서 “5시간이 지났는데도 계속 제한된다”면 주간 한도나 다른 제한도 함께 적용되고 있는지 확인해야 한다. 현재 작업을 막는 것이 세션 한도뿐이라면 주간 초기화일 전이라도 5시간 한도가 풀린 뒤 다시 사용할 수 있다. 어느 제한이 실제로 발동했는지는 계정 화면의 이름과 시각으로 판별한다.
주간 한도를 첫 프롬프트 시점부터 168시간 뒤라고 계산하는 한국어 글도 보이지만, 현재 개인 Pro·Max 공식 설명은 계정에 할당된 고정 요일과 시각을 기준으로 한다. 내 날짜를 추측하지 말고 설정 > 사용량의 표시를 우선해야 한다.
Claude와 Claude Code를 함께 쓴다면 사용량도 따로 계산된다고 가정하면 안 된다. Pro·Max 구독에서는 Claude와 Claude Code가 포함 사용량 한도를 공유한다. 웹에서 Claude를 많이 사용한 뒤 Claude Code 한도에 빨리 도달한 것처럼 보이는 이유가 될 수 있다.
/usage가 보여 주는 값이 현재값인지 확인한다
Claude Code의 현재 비용·사용량 문서에서 /usage는 플랜 사용량 한도와 활동을 확인하는 명령이다. 터미널에서 다음처럼 실행한다.
text/usage
여기서 제한 종류, 남은 사용량, 다음 초기화 정보를 확인한다. 다만 사용량 조회 자체가 rate limit에 걸리면 /usage가 최근 60분 이내의 마지막 스냅샷을 보여 줄 수 있다. 이런 안내가 붙은 수치는 실시간 값이 아니다. 잠시 뒤 다시 조회하거나 설정 > 사용량과 대조한다.
로그인한 계정·플랜이 예상과 다르다면 /status에서 계정과 연결 상태를 먼저 확인하는 것도 도움이 된다. 그다음 /usage의 한도 정보가 어느 인증 경로에 속하는지 판단한다. 설치한 Claude Code 버전에 따라 명령명이나 표시가 달라질 수 있으므로, 명령이 없거나 설명이 다르면 현재 버전의 공식 명령 문서를 확인한다.
/clear는 사용량 한도 초기화 명령이 아니다
Claude Code의 /clear는 빈 컨텍스트에서 새 대화를 시작한다. /reset과 /new도 같은 용도의 별칭으로 안내된다. 이 동작으로 새 대화를 시작해도 계정의 Pro·Max 사용량 할당량이 즉시 복구됐다는 뜻은 아니다.
둘을 이렇게 구분하면 된다.
- 대화가 길어져 컨텍스트가 부족하다면
/clear로 새 대화를 시작할 수 있다. - 플랜 사용량 한도에 도달했다면 설정 > 사용량 또는
/usage에 표시된 초기화를 기다려야 한다.
새 대화를 시작하면 이후 요청의 컨텍스트 부담을 줄이는 데는 도움이 될 수 있다. 그러나 이를 “5시간 한도 리셋”이나 “주간 한도 리셋”으로 설명해서는 안 된다. 사용량 제한과 대화 길이 제한은 서로 다른 제약이다.
Enterprise와 API 키 사용자는 같은 시간표를 쓰지 않는다
Claude Code는 로그인 방식에 따라 계량 방식이 달라진다. Enterprise 좌석이 포함 사용량 풀을 쓰는 경우에는 한도 메시지에 롤링 윈도우가 표시될 수 있다. 반면 사용량 기반 조직 플랜이나 API 키 경로는 소비량에 따라 별도 과금될 수 있으며, 개인 Pro·Max의 구독 한도 초기화와 같은 계약이 아니다.
조직 계정이라면 다음을 확인한다.
- 내 좌석이 포함 사용량 방식인지 사용량 기반 방식인지
- 조직 관리자가 별도 정책이나 한도를 설정했는지
- Claude Code가 조직 좌석으로 로그인됐는지 API 키를 사용하는지
- 메시지에 표시된 윈도우와
/usage의 제한 이름이 무엇인지
API 종량제에는 구독의 5시간 하드 스톱이 없을 수 있지만, 그렇다고 제한이 전혀 없는 것은 아니다. API rate limit, 지출 한도, 예산, 클라우드 공급자 정책이 별도로 적용될 수 있다. “API로 전환하면 한도가 초기화된다”가 아니라 별도 과금 경로로 요청을 보내는 것이라고 이해해야 한다.
한도에 도달한 뒤 선택할 수 있는 방법
현재 공식 안내가 허용하는 선택지는 계정과 지역, 조직 정책에 따라 달라진다.
- 표시된 시각까지 기다린다.
- 제공되는 계정이라면 추가 사용량 크레딧을 활성화한다.
- 필요한 경우 플랜을 변경한다.
- 별도 과금을 이해한 뒤 API 사용 경로를 선택한다.
추가 크레딧이나 API를 쓰기 전에는 가격, 결제 주체, 조직 승인 여부를 확인해야 한다. 이 선택들은 기존 구독 한도를 수동으로 초기화하는 기능이 아니다.
자주 묻는 질문
Claude Code 사용량을 지금 바로 수동으로 초기화할 수 있나?
확인한 현재 공식 자료에서는 사용자가 포함 사용량을 즉시 초기화하는 지원 기능을 찾을 수 없다. 다만 이는 공개된 문서 범위의 결론이다. 지원팀 조치, 장애 보상, 실험 기능, 플랜별 예외나 향후 변경까지 존재하지 않는다고 단정할 수는 없다.
주간 초기화 날짜가 계속 달라 보이는 이유는 무엇인가?
먼저 같은 제한을 보고 있는지 확인한다. 5시간 세션 한도와 주간 한도, 모델별 표시, 조직 계정의 윈도우, 오래된 /usage 스냅샷은 서로 다른 시각을 보여 줄 수 있다. 개인 Pro·Max의 현재 공식 기준은 계정에 할당된 고정 요일과 시각이므로, 커뮤니티 계산보다 설정 > 사용량을 우선한다. 실제 화면이 공식 설명과 계속 다르면 시간대와 플랜을 적어 Anthropic 지원에 확인하는 것이 안전하다.
/clear를 자주 쓰면 한도를 덜 쓰나?
새 대화는 불필요하게 긴 컨텍스트를 계속 보내는 상황을 줄일 수 있지만, /clear 자체가 이미 사용한 플랜 할당량을 되돌리지는 않는다. 컨텍스트 관리 효과와 사용량 초기화를 같은 기능으로 설명하면 안 된다.
정확한 다음 초기화 시각만 빠르게 알고 싶다면?
개인 Pro·Max는 설정 > 사용량을 열고 제한 이름과 다음 초기화 시각을 확인한다. Claude Code에서는 /usage를 실행하고 마지막 스냅샷 안내가 없는지 본다. 조직 계정이나 API 키를 쓴다면 개인 플랜의 5시간·주간 규칙을 대입하지 말고, 현재 인증 경로와 조직 정책부터 확인한다.
Claude Code의 “사용량 초기화”는 하나의 타이머가 아니다. 한도 메시지에서 제한 종류를 식별하고, 인증된 계정의 설정 > 사용량과 최신 /usage에서 다음 시각을 대조하는 것이 가장 빠르고 정확한 해결 방법이다. /clear, 커뮤니티의 168시간 계산, 별도 API 과금 경로는 그 확인을 대신하지 않는다.
