Claude Code에서 남은 사용량을 확인하려면 대화 입력창에 /usage를 입력합니다. 여기서 작업을 계속할 수 있는지 판단할 때 볼 것은 계정의 한도 막대와 각 리셋 시각입니다. Session에 표시되는 달러 금액이나 모니터의 예상 잔여 토큰을 같은 값으로 읽으면, 비용이 0인데도 사용이 막히는 상황을 설명하기 어렵습니다.
2026년 9월 8일 공식 문서 기준으로 /cost는 /usage의 별칭입니다. 예전 안내에 나오는 “비용은 /cost, 한도는 /usage”라는 구분을 현재 모든 버전에 그대로 적용하면 안 됩니다. 아래에서는 화면을 확인하는 순서와, 리셋 뒤에도 out of usage가 표시될 때 대조할 항목을 다룹니다.
/usage를 열고, 숫자보다 먼저 항목 이름을 보세요
Claude Code가 실행 중인 대화 입력창 맨 앞에 다음 명령을 입력합니다. 일반 셸에서 실행하는 명령이 아닙니다.
text/usage
현재 명령 목록에서 /usage는 세션 비용, 요금제 사용 한도, 활동 통계를 보여 줍니다. /cost는 이 명령의 별칭이며 /stats는 같은 기능의 Stats 탭으로 들어갑니다. 실제 명령 제공 여부는 플랫폼·요금제·환경에 따라 달라집니다. 화면이 예전 글과 다르면 먼저 사용 중인 클라이언트 버전과 / 메뉴를 확인하세요. 공식 명령 목록
한도 화면은 웹의 Settings → Usage와도 대조할 수 있습니다. 공식 지원 문서는 해당 구독에서 현재 세션의 5시간 사용량과 주간 사용량, 각각의 리셋 시각을 확인하도록 안내합니다. 표시되는 모델별 항목은 계정에 따라 다를 수 있으므로 화면의 이름을 그대로 읽어야 합니다. 사용 한도 확인 안내
| 확인한 값 | 이 값으로 알 수 있는 것 | 혼동하기 쉬운 것 |
|---|---|---|
| 5시간 사용 한도 | 현재 짧은 사용 기간의 소진 정도와 리셋 시각 | 지금 열어 둔 대화 하나의 비용 |
| 주간 전체 한도 | 한 주간 적용되는 전체 사용 제한 | 5시간 한도가 리셋되면 함께 사라지는 제한 |
| 모델 계열별 한도 | 표시된 모델 계열에 적용되는 제한 | 모든 모델을 합친 주간 한도 |
| Session의 달러 금액 | 현재 세션의 토큰 비용 추정치 | 구독에 추가로 청구될 금액 또는 남은 사용량 |
| 기기 내 사용 내역 | 이 기기에서 사용량이 발생한 작업 | 다른 기기와 웹까지 포함한 계정 전체 기록 |
표에서 비용과 기기 내 내역의 의미는 공식 비용 문서, 기간별·모델별 한도의 구분은 공식 한도 오류 설명을 기준으로 합니다. 백분율 옆의 기간과 대상이 다르면 서로 더하지 마세요. 5시간 40%와 주간 70%를 합쳐 “110% 사용”이라고 계산할 수는 없습니다.
비용이 0이라고 사용 제한이 풀린 것은 아닙니다
Session 금액은 로컬 토큰 비용 추정치입니다. Pro·Max 구독의 추가 청구서가 아닙니다. v2.1.211 이상에서 /clear로 새 세션을 시작하면 세션 비용 합계는 0부터 시작하지만, 구독 사용 한도가 충전되지는 않습니다.
로컬 사용 내역에서 d와 w는 각각 최근 24시간과 7일을 뜻합니다. 계정 한도의 리셋 기간을 선택하는 키가 아닙니다. 이 내역에는 다른 기기나 claude.ai에서의 활동이 포함되지 않습니다. 따라서 “노트북 내역은 적은데 계정 막대는 높다”는 사실만으로 오류라고 판단할 수 없습니다. 비용과 사용 내역 설명
Usage credits의 월간 지출 행도 별도로 읽어야 합니다. 월 지출 상한이 없는 Pro·Max 계정의 Unlimited 표시는 무료 무제한 사용을 뜻하지 않으며, 5시간·주간 한도가 없어졌다는 뜻도 아닙니다. Usage credits 지출 표시
리셋 시각이 지났다면 주간 막대와 조회 상태를 함께 확인하세요
구독 요청에는 세션 한도와 주간 한도가 동시에 적용됩니다. 모델 계열별 한도가 표시된다면 그 조건도 봐야 합니다. 한 종류의 제한이 풀렸다는 사실만으로 모든 요청이 재개되는 것은 아닙니다. 한도 오류의 적용 범위
다음은 이해를 위한 가상 예시이며 실제 계정 측정값이 아닙니다.
| 확인 시점 | 5시간 한도 | 주간 전체 한도 | 읽어야 할 의미 |
|---|---|---|---|
| 화요일 14:50 | 100%, 15:00 리셋 | 100%, 금요일 09:00 리셋 | 두 기간 모두 사용 제한에 도달 |
| 화요일 15:05에 새로 조회 | 리셋되어 여유 있음 | 여전히 100% | 짧은 기간은 풀렸지만 주간 제한은 유지 |
이 경우 계속 막히는 이유를 찾으려면 금요일로 표시된 주간 전체 한도를 봐야 합니다. 반대로 특정 모델 계열만 한도에 도달했다면, 다른 적용 한도가 남아 있는 조건에서 다른 모델 사용이 가능할 수 있습니다. 전체 주간 한도를 다 썼는데 모델만 바꾸면 해결된다고 기대해서는 안 됩니다.
조회가 최신인지도 확인하세요. /usage에 Showing last-known usage가 나타나면 한도 조회에 실패해 최근에 받아 둔 막대를 보여 주는 상태일 수 있습니다. 공식 문서상 최대 60분 이내의 이전 값을 사용하며 r로 다시 조회할 수 있습니다. 최근 캐시도 없으면 조회 오류가 표시됩니다. 이런 화면만 보고 “방금 리셋됐는데 서버가 반영하지 않았다”고 결론 내리기는 이릅니다. 사용량 조회 실패 시 동작
Usage monitor는 숫자의 출처부터 확인하세요
Claude Code usage monitor라는 이름으로 소개되는 도구가 모두 같은 데이터를 읽는 것은 아닙니다. 먼저 해당 도구가 공식 계정 한도 값을 받은 것인지, 기기 내 기록으로 추정한 것인지 구분하세요.
예를 들어 Claude-Code-Usage-Monitor 원본 README는 공식 statusline에서 받은 최신 데이터와 local_estimate, experimental, unknown 상태를 구분합니다. 이미 이 도구가 설치되어 있다면 README의 다음 명령으로 1회 JSON 출력을 확인할 수 있습니다. 이 글에서 도구를 설치하거나 실행해 검증한 것은 아닙니다.
bashclaude-monitor --once --output json
출력에서는 사용률만 떼어 보지 말고 출처·추정 여부와 갱신 시점을 함께 확인하세요. 추정 모드의 잔여량은 실제 구독 한도를 보증하지 않습니다. 모니터의 리셋 시간 설정을 바꾸어도 계정의 리셋 일정이 바뀌지는 않습니다. 이 도구를 사용하지 않아도 같은 원칙으로 플러그인이나 상태 표시줄을 읽을 수 있습니다.
직접 상태 표시줄을 구성한다면 공식 필드의 의미가 도움이 됩니다.
| statusline 필드 | 읽는 방법 |
|---|---|
rate_limits.five_hour.used_percentage | 5시간 한도의 사용률 |
rate_limits.seven_day.used_percentage | 7일 한도의 사용률 |
각 기간의 resets_at | 해당 기간의 리셋 시각. Unix 초 단위이므로 표시할 때 시간대 확인 |
context_window.used_percentage | 대화의 문맥 창 사용률. 구독의 주간 사용률과 별개 |
이 한도 데이터는 지원되는 계정·환경에서 제공되며, API 응답을 받은 뒤에 나타날 수 있습니다. 두 기간 중 하나만 없을 수도 있고, 만료된 기간 데이터는 제거됩니다. 필드가 없으면 “0% 사용”이 아니라 “현재 값이 없음”으로 처리해야 합니다. 공식 statusline 데이터 설명
/limit-reset을 사용했는데도 막힌다면
/limit-reset은 공식적으로 모든 계정에 제공되는 초기화 명령이라고 안내할 수 없습니다. 2026년 9월 8일 확인한 공식 Commands 목록에는 없고, 확인 가능한 것은 Reddit 사용자의 원래 보고입니다. 작성자는 세션 리셋 성공, 다음 사용 가능 시점, 주간 한도 유지 안내를 받았다고 했습니다. 댓글에는 사용할 수 없거나 효과가 없었다는 보고도 있습니다.
따라서 지원 요금제, 최소 버전, 모든 사용자의 주 1회 이용 권리를 확정해서는 안 됩니다. 계정에서 실제로 실행되어 성공 문구가 나왔더라도 그 문구가 지칭한 세션 한도와 주간 한도를 따로 확인하세요. 위 가상 예시처럼 주간 사용 제한에 걸려 있다면 세션 리셋만으로는 재개할 수 없습니다. 명령이 보이지 않는 경우에는 해당 기능을 전제로 기다리거나 반복 입력할 이유가 없습니다.
계속 out of usage라면 이 순서로 기록하세요
- 오류 원문을 확인합니다. 세션 한도인지, 주간 한도인지, 특정 모델 제한인지 기록합니다.
429, 서버의 일시적 요청 제한, 크레딧 부족이나 지출 상한 오류는 별도로 구분해야 합니다. 오류별 공식 설명 - /usage를 새로 조회합니다. 이전 사용량 표시가 있으면
r로 재시도하고, 웹 Settings → Usage의 같은 항목과 비교합니다. 사용률·기간 이름·리셋 시각을 한 묶음으로 적어 두세요. - 모니터와 계정 화면의 기준을 맞춥니다. 모니터 값이 추정치인지, 마지막 갱신이 언제인지, 시간대가 같은지 확인합니다. 단순한 토큰 수나 문맥 사용률로 주간 막대를 대체하지 않습니다.
- 같은 계정과 인증 경로인지 확인합니다. 특히
ANTHROPIC_API_KEY가 적용되면 구독 대신 별도의 API 인증·결제 경로를 사용할 수 있습니다. 키 값 자체를 공유할 필요는 없습니다. Pro·Max의 Claude Code 인증 안내
지원팀에 문의할 때는 클라이언트 버전, 오류가 난 시각과 시간대, 오류 원문, 각 한도의 이름·리셋 시각, 최신 조회 여부를 함께 전달하면 “무엇을 리셋했는데 어느 제한이 남았는지” 설명할 수 있습니다. 사용량 화면을 제대로 읽은 뒤 정책 변화의 배경이 필요하다면 Claude Code 사용 한도 문제 정리를 이어서 확인하세요.
