# Claude Code /usage 읽는 법: 주간 한도와 리셋 후 차단 확인

> Claude Code /usage에서 계정 한도, 세션 비용, 로컬 통계를 구분하는 방법. /cost와의 관계, usage monitor의 추정값, /limit-reset 이후에도 사용하지 못하는 이유를 확인합니다.

- Source: https://www.aifreeapi.com/ko/posts/claude-code-usage-monitor
- Language: ko
- Published: 2026-09-08
- Updated: 2026-09-12
- Publisher: AI Free API (https://www.aifreeapi.com)

Claude Code에서 남은 사용량을 확인하려면 대화 입력창에 `/usage`를 입력합니다. 여기서 **작업을 계속할 수 있는지 판단할 때 볼 것은 계정의 한도 막대와 각 리셋 시각**입니다. Session에 표시되는 달러 금액이나 모니터의 예상 잔여 토큰을 같은 값으로 읽으면, 비용이 0인데도 사용이 막히는 상황을 설명하기 어렵습니다.

2026년 9월 8일 공식 문서 기준으로 `/cost`는 `/usage`의 별칭입니다. 예전 안내에 나오는 “비용은 /cost, 한도는 /usage”라는 구분을 현재 모든 버전에 그대로 적용하면 안 됩니다. 아래에서는 화면을 확인하는 순서와, 리셋 뒤에도 `out of usage`가 표시될 때 대조할 항목을 다룹니다.

## /usage를 열고, 숫자보다 먼저 항목 이름을 보세요

Claude Code가 실행 중인 **대화 입력창 맨 앞**에 다음 명령을 입력합니다. 일반 셸에서 실행하는 명령이 아닙니다.

```text
/usage
```

현재 명령 목록에서 `/usage`는 세션 비용, 요금제 사용 한도, 활동 통계를 보여 줍니다. `/cost`는 이 명령의 별칭이며 `/stats`는 같은 기능의 Stats 탭으로 들어갑니다. 실제 명령 제공 여부는 플랫폼·요금제·환경에 따라 달라집니다. 화면이 예전 글과 다르면 먼저 사용 중인 클라이언트 버전과 `/` 메뉴를 확인하세요. [공식 명령 목록](https://code.claude.com/docs/en/commands)

한도 화면은 웹의 **Settings → Usage**와도 대조할 수 있습니다. 공식 지원 문서는 해당 구독에서 현재 세션의 5시간 사용량과 주간 사용량, 각각의 리셋 시각을 확인하도록 안내합니다. 표시되는 모델별 항목은 계정에 따라 다를 수 있으므로 화면의 이름을 그대로 읽어야 합니다. [사용 한도 확인 안내](https://support.claude.com/en/articles/9797557-usage-limit-best-practices)

| 확인한 값 | 이 값으로 알 수 있는 것 | 혼동하기 쉬운 것 |
| --- | --- | --- |
| 5시간 사용 한도 | 현재 5시간 동안 쓴 비율과 리셋 시각 | 지금 열어 둔 대화 하나의 비용 |
| 주간 전체 한도 | 한 주간 적용되는 전체 사용 제한 | 5시간 한도가 리셋되면 함께 사라지는 제한 |
| 모델 계열별 한도 | 표시된 모델 계열에 적용되는 제한 | 모든 모델을 합친 주간 한도 |
| Session의 달러 금액 | 현재 세션의 토큰 비용 추정치 | 구독에 추가로 청구될 금액 또는 남은 사용량 |
| 기기 내 사용 내역 | 이 기기에서 사용량이 발생한 작업 | 다른 기기와 웹까지 포함한 계정 전체 기록 |

표에서 비용과 기기 내 내역의 의미는 [공식 비용 문서](https://code.claude.com/docs/en/costs), 기간별·모델별 한도의 구분은 [공식 한도 오류 설명](https://code.claude.com/docs/en/errors#youve-hit-your-session-limit)을 기준으로 합니다. **백분율 옆의 기간과 대상이 다르면 서로 더하지 마세요.** 5시간 40%와 주간 70%를 합쳐 “110% 사용”이라고 계산할 수는 없습니다.

## 비용이 0이라고 사용 제한이 풀린 것은 아닙니다

Session 금액은 로컬 토큰 비용 추정치입니다. Pro·Max 구독의 추가 청구서가 아닙니다. v2.1.211 이상에서 `/clear`로 새 세션을 시작하면 세션 비용 합계는 0부터 시작하지만, 구독 사용 한도가 충전되지는 않습니다.

로컬 사용 내역에서 `d`와 `w`는 각각 최근 24시간과 7일을 뜻합니다. 계정 한도의 리셋 기간을 선택하는 키가 아닙니다. 이 내역에는 다른 기기나 claude.ai에서의 활동이 포함되지 않습니다. 따라서 “노트북 내역은 적은데 계정 막대는 높다”는 사실만으로 오류라고 판단할 수 없습니다. [비용과 사용 내역 설명](https://code.claude.com/docs/en/costs)

Usage credits의 월간 지출 행도 별도로 읽어야 합니다. 월 지출 상한이 없는 Pro·Max 계정의 `Unlimited` 표시는 무료 무제한 사용을 뜻하지 않으며, 5시간·주간 한도가 없어졌다는 뜻도 아닙니다. [Usage credits 지출 표시](https://code.claude.com/docs/en/costs#check-your-usage-credits-spend)

## 리셋 시각이 지났다면 주간 막대와 조회 상태를 함께 확인하세요

구독 요청에는 세션 한도와 주간 한도가 동시에 적용됩니다. 모델 계열별 한도가 표시된다면 그 조건도 봐야 합니다. 한 종류의 제한이 풀렸다는 사실만으로 모든 요청이 재개되는 것은 아닙니다. [한도 오류의 적용 범위](https://code.claude.com/docs/en/errors#youve-hit-your-session-limit)

다음은 **이해를 위한 가상 예시이며 실제 계정 측정값이 아닙니다.**

| 확인 시점 | 5시간 한도 | 주간 전체 한도 | 읽어야 할 의미 |
| --- | --- | --- | --- |
| 화요일 14:50 | 100%, 15:00 리셋 | 100%, 금요일 09:00 리셋 | 두 기간 모두 사용 제한에 도달 |
| 화요일 15:05에 새로 조회 | 리셋되어 여유 있음 | 여전히 100% | 5시간 한도는 초기화됐지만 주간 제한은 유지 |

이 경우 계속 막히는 이유를 찾으려면 금요일로 표시된 **주간 전체 한도**를 봐야 합니다. 반대로 특정 모델 계열만 한도에 도달했다면, 다른 적용 한도가 남아 있는 조건에서 다른 모델 사용이 가능할 수 있습니다. 전체 주간 한도를 다 썼는데 모델만 바꾸면 해결된다고 기대해서는 안 됩니다.

조회가 최신인지도 확인하세요. `/usage`에 `Showing last-known usage`가 나타나면 한도 조회에 실패해 최근에 받아 둔 막대를 보여 주는 상태일 수 있습니다. 공식 문서상 최대 60분 이내의 이전 값을 사용하며 `r`로 다시 조회할 수 있습니다. 최근 캐시도 없으면 조회 오류가 표시됩니다. 이런 화면만 보고 “방금 리셋됐는데 서버가 반영하지 않았다”고 결론 내리기는 이릅니다. [사용량 조회 실패 시 동작](https://code.claude.com/docs/en/costs#when-the-usage-request-fails)

![5시간 한도와 주간 전체 한도의 리셋 시점을 따로 보여 주는 설명용 도식](https://www.aifreeapi.com/posts/ko/claude-code-usage-monitor/img/reset-windows.webp)

## Usage monitor는 숫자의 출처부터 확인하세요

Claude Code usage monitor라는 이름으로 소개되는 도구가 모두 같은 데이터를 읽는 것은 아닙니다. 먼저 해당 도구가 **공식 계정 한도 값을 받은 것인지, 기기 내 기록으로 추정한 것인지** 구분하세요.

예를 들어 [Claude-Code-Usage-Monitor 원본 README](https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor)는 공식 statusline에서 받은 최신 데이터와 `local_estimate`, `experimental`, `unknown` 상태를 구분합니다. 이미 이 도구가 설치되어 있다면 README의 다음 명령으로 1회 JSON 출력을 확인할 수 있습니다. 이 글에서 도구를 설치하거나 실행해 검증한 것은 아닙니다.

```bash
claude-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 데이터 설명](https://code.claude.com/docs/en/statusline)

![사용량 모니터에 들어오는 공식 계정 데이터와 기기 내 추정 기록을 구분한 개념도](https://www.aifreeapi.com/posts/ko/claude-code-usage-monitor/img/monitor-sources.webp)

## /limit-reset을 사용했는데도 막힌다면

`/limit-reset`은 공식적으로 모든 계정에 제공되는 초기화 명령이라고 안내할 수 없습니다. 2026년 9월 8일 확인한 공식 Commands 목록에는 없고, 확인 가능한 것은 [Reddit 사용자의 원래 보고](https://www.reddit.com/r/ClaudeCode/comments/1w5r1hv/this_is_new_limitreset_resets_your_session_limit/)입니다. 작성자는 세션 리셋 성공, 다음 사용 가능 시점, 주간 한도 유지 안내를 받았다고 했습니다. 댓글에는 사용할 수 없거나 효과가 없었다는 보고도 있습니다.

따라서 지원 요금제, 최소 버전, 모든 사용자의 주 1회 이용 권리를 확정해서는 안 됩니다. 계정에서 실제로 실행되어 성공 문구가 나왔더라도 **그 문구가 지칭한 세션 한도와 주간 한도를 따로 확인**하세요. 위 가상 예시처럼 주간 사용 제한에 걸려 있다면 세션 리셋만으로는 재개할 수 없습니다. 명령이 보이지 않는 경우에는 해당 기능을 전제로 기다리거나 반복 입력할 이유가 없습니다.

## 계속 out of usage라면 이 순서로 기록하세요

1. **오류 원문을 확인합니다.** 세션 한도인지, 주간 한도인지, 특정 모델 제한인지 기록합니다. `429`, 서버의 일시적 요청 제한, 크레딧 부족이나 지출 상한 오류는 별도로 구분해야 합니다. [오류별 공식 설명](https://code.claude.com/docs/en/errors)
2. **/usage를 새로 조회합니다.** 이전 사용량 표시가 있으면 `r`로 재시도하고, 웹 Settings → Usage의 같은 항목과 비교합니다. 사용률·기간 이름·리셋 시각을 한 묶음으로 적어 두세요.
3. **모니터와 계정 화면의 기준을 맞춥니다.** 모니터 값이 추정치인지, 마지막 갱신이 언제인지, 시간대가 같은지 확인합니다. 단순한 토큰 수나 문맥 사용률로 주간 막대를 대체하지 않습니다.
4. **같은 계정과 인증 경로인지 확인합니다.** 특히 `ANTHROPIC_API_KEY`가 적용되면 구독 대신 별도의 API 인증·결제 경로를 사용할 수 있습니다. 키 값 자체를 공유할 필요는 없습니다. [Pro·Max의 Claude Code 인증 안내](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-or-max-plan)

지원팀에 문의할 때는 클라이언트 버전, 오류가 난 시각과 시간대, 오류 원문, 각 한도의 이름·리셋 시각, 최신 조회 여부를 함께 전달하면 “무엇을 리셋했는데 어느 제한이 남았는지” 설명할 수 있습니다. 사용량 화면을 제대로 읽은 뒤 정책 변화의 배경이 필요하다면 [Claude Code 사용 한도 문제 정리](/ko/posts/claude-code-usage-limit-issues)를 이어서 확인하세요.