Claude Code 사용량(5시간·7일 한도) 보는 법

Claude의 5시간·주간 사용량을 얼마나 썼는지, 언제 리셋되는지 /usage, 상태 줄 스크립트, 맥 패널로 보는 방법이에요.

Claude 구독으로 Claude Code를 쓰면 5시간마다 리셋되는 한도와 7일마다 리셋되는 한도가 있어요. 일하는 도중에 한도에 걸리면 곤란하니, 두 가지를 한눈에 볼 수 있으면 좋아요.

방법 1: /usage 명령

Claude Code에서 /usage를 입력하면 얼마나 썼는지, 각 한도가 언제 리셋되는지 보여 줘요. 정확하지만 매번 직접 물어봐야 해요.

방법 2: 상태 줄

Claude Code는 입력 칸 아래에 상태 줄을 보여 줄 수 있어요. 내가 정한 명령을 실행하면서 정보를 JSON으로 넘겨 주는데, 여기에 rate_limits.five_hour.used_percentage와 rate_limits.seven_day.used_percentage가 들어 있어요. 아래를 ~/.claude/statusline.sh로 저장하고(jq를 써요) 실행 권한을 주세요.

#!/bin/bash
input=$(cat)
five=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
week=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')
echo "5h ${five}% · 7d ${week}%"

그다음 ~/.claude/settings.json에서 이 파일을 가리키게 해요.

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh"
  }
}

숫자는 Claude가 답할 때마다 바뀌고, 그 터미널 탭 안에서만 보여요.

방법 3: 터미널 옆 패널에서

Alien Desk는 메뉴에서 5시간·7일 사용량과 리셋 시각을 보여 주고, 패널 위쪽에 늘 띄워 둘 수도 있어요. 같은 상태 줄로 연결하되 쓰던 상태 줄은 그대로 두고, 언제든 끌 수 있어요. 이 기능은 무료예요.