요약

Claude Code 안에서 /usage를 실행하세요. Pro, Max, Team, Enterprise 요금제라면 5시간 세션 한도와 주간 한도의 막대가 초기화 시각과 함께 표시되고, 무엇에 썼는지 내역도 나옵니다. API 결제라면 세션의 토큰 수와 예상 비용이 표시됩니다.

같은 요금제 한도는 다른 두 곳에서도 볼 수 있습니다.

• claude.ai → Settings → Usage, 채팅 사용량도 포함합니다.
• 사용자 지정 상태 표시줄, 모든 세션 아래쪽에 5h: 42% 7d: 18%처럼 표시할 수 있습니다.

문제

Claude Code는 기본적으로 작업 중에 남은 할당량을 보여 주지 않습니다. 첫 신호는 85% 경고나 한도 메시지 자체인 경우가 많고, 그때쯤이면 긴 작업이 절반쯤 진행된 상태입니다.

비슷해 보이는 숫자도 여러 개입니다. 달러로 표시된 세션 비용, 스피너 옆의 토큰 수, 5시간 창 대비 비율, 주간 대비 비율. 각각 측정하는 것이 다르고, 구독에서 의미 있는 건 그중 일부뿐입니다.

방법 1: /usage로 Claude Code 사용량 확인하기

/usage

보이는 내용은 로그인 방식에 따라 다릅니다. Anthropic 비용 페이지 기준:

구독 (Pro, Max, Team, Enterprise):

• 세션 창과 주간 창의 요금제 사용량 막대와 각각의 초기화 시각.
• 스킬, 서브에이전트, 플러그인, 개별 MCP 서버별로 나눈 최근 사용량 내역(비율).
• 최근 사용량의 10% 이상을 차지하는 항목에 대한 추천, 한 줄에 하나. 25% Trim ~/code/api/CLAUDE.md · 49k tokens per request 같은 줄은 그 항목이 사용량의 얼마에 해당하는지를 말할 뿐, 변경으로 얼마를 아낄 수 있는지가 아닙니다.
• 최근 실행된 무거운 /loop나 예약 작업을 보여 주는 루프.
• 사용량 크레딧이 켜져 있다면 사용량 크레딧 줄.

d나 w를 눌러 내역을 최근 24시간과 최근 7일 사이에서 바꿀 수 있습니다. 내역은 이 머신의 세션 기록으로 계산하므로 다른 컴퓨터나 claude.ai의 사용량은 들어 있지 않습니다. 요금제 막대는 Anthropic에서 가져오므로 모든 사용량을 포함합니다.

하단에 f to fix 2 of 3 같은 힌트가 보이면 f를 눌러 Claude Code가 처리할 수 있는 추천을 실행하게 할 수 있습니다. Claude Code v2.1.305 이상이 필요합니다.

API 결제:

Session 블록에 총비용, API 시간과 실제 시간, 코드 변경, 모델별 토큰이 표시됩니다. 달러 금액은 Claude Code가 정가로 로컬에서 계산한 것입니다. 실제 청구액은 Claude Console의 Usage 페이지를 보세요. 이 합계는 /clear로 새 세션을 시작하면 초기화됩니다.

/usage가 속도 제한이라고 할 때

rate limited until 3:14am 같은 메시지는 그 시각까지 Claude Code가 요금제 한도를 다시 가져올 수 없다는 뜻입니다. 사용량 한도가 아닙니다. 요청이 실패하면 /usage는 이 머신에서 지난 한 시간 안에 마지막으로 불러온 막대를 Showing last-known usage 안내와 함께 보여 줍니다. 표시된 시각이 지난 뒤 r을 눌러 새 데이터를 가져오세요.

방법 2: 상태 표시줄에 Claude Code 한도 표시하기

항상 보이는 숫자를 원한다면 사용자 지정 상태 표시줄에 rate_limits 필드를 추가하세요. Claude Code는 스크립트에 stdin으로 JSON을 넘깁니다. Pro와 Max 구독자에게는 첫 API 응답 이후 다음이 포함됩니다.

• rate_limits.five_hour.used_percentage와 rate_limits.five_hour.resets_at
• rate_limits.seven_day.used_percentage와 rate_limits.seven_day.resets_at

used_percentage는 0부터 100까지입니다. resets_at은 Unix epoch 초입니다.

Anthropic 예제를 바탕으로 한 최소 스크립트:

#!/bin/bash
input=$(cat)

MODEL=$(echo "$input" | jq -r '.model.display_name')
FIVE_H=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
WEEK=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')

LIMITS=""
[ -n "$FIVE_H" ] && LIMITS="5h: $(printf '%.0f' "$FIVE_H")%"
[ -n "$WEEK" ] && LIMITS="${LIMITS:+$LIMITS }7d: $(printf '%.0f' "$WEEK")%"

echo "[$MODEL] $LIMITS"

~/.claude/statusline.sh로 저장하고 chmod +x로 실행 가능하게 만든 뒤, ~/.claude/settings.json의 statusLine이 이 파일을 가리키게 하세요.

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

jq 호출의 // empty는 API 결제일 때나 첫 응답 전처럼 필드가 없을 때 스크립트가 아무것도 출력하지 않게 해 줍니다.

방법 3: claude.ai에서 사용량 확인하기

claude.ai에서 Settings → Usage를 엽니다. 채팅을 포함한 계정 전체의 현재 세션과 주간 한도가 표시됩니다. 휴대폰에서 보거나, 채팅 세션이 얼마나 썼는지 보고 싶을 때 여기를 보세요.

방법 4: Console에서 API 지출 확인하기

종량제라면 Claude Console의 Usage 페이지가 공식 기록입니다. Console 계정으로 Claude Code를 처음 인증하면 "Claude Code"라는 워크스페이스가 만들어져, 그 지출이 다른 API 사용과 따로 관리됩니다.

숫자의 의미

스피너 숫자(예: (10m 27s · ↓ 5.5k tokens))는 출력만 셉니다. 프롬프트와 대화 기록으로는 늘지 않으므로, 한 턴이 창을 얼마나 썼는지는 거의 알려 주지 않습니다.

여러 에이전트와 컴퓨터의 사용량 확인하기

/usage는 한 머신에서 본 Claude 계정 하나만 다룹니다. Codex나 Gemini도 쓰거나 Claude 계정이 여러 개라면 각각 확인하는 곳이 따로 있습니다.

휴대폰에서 계정별 잔량을 보고 싶다면, Happier는 휴대폰, 데스크톱, 웹에서 Claude Code, Codex 등 에이전트를 크로스 디바이스로 실행하고 오케스트레이션하는 오픈 소스 앱입니다.

미터가 동작하는 방식:

• 미터가 있는 서비스는 세 가지입니다: Claude 구독, Codex 구독(openai-codex), Gemini. API 키 서비스와 Happier가 실행하는 다른 에이전트에는 할당량 미터가 없습니다.
• 게이지는 남은 양을 보여 줍니다. 30% left · resets in 2h 10m은 그 창의 30%를 아직 쓸 수 있다는 뜻입니다.
• 오래된 데이터에는 표시가 붙습니다. 계정마다 마지막 업데이트 시각이 표시되고, 오래된 데이터는 stale로 표시되며, Refresh quota now가 있습니다.
• 미터는 연결된 계정과 함께 있습니다. Settings → Connected services에 있고, 세션에서는 계정 옆에 표시됩니다.

Connected services와 Connected services quotas는 Happier 0.2.17에서 둘 다 실험적 기능이며 기본적으로 꺼져 있습니다. Settings → Features에서 둘 다 켜세요. 설정은 휴대폰에서 Happier 사용하는 방법에 있습니다. Happier는 GitHub에 있고, 여기서 다운로드할 수 있으며, Discord도 있습니다.

문제 해결

Pro 요금제인데 /usage에 달러 비용이 표시됨

그 Session 블록은 API 사용자용입니다. Anthropic 안내에 따르면 세션 비용 수치는 Pro와 Max 청구와 관계가 없습니다. 요금제 막대를 기대했는데 비용만 보인다면 ANTHROPIC_API_KEY가 설정되어 있는지 확인하세요. 설정되어 있다면 Claude Code는 요금제가 아니라 키에 청구하고 있습니다.

상태 표시줄에 한도가 아무것도 안 보임

rate_limits 객체는 claude.ai Pro와 Max 구독자에게만, 그리고 첫 API 응답 이후에만 나타납니다. 메시지를 하나 보낸 뒤 다시 확인하세요.

내역이 claude.ai와 맞지 않음

내역은 이 머신의 세션 기록을 씁니다. 요금제 막대와 claude.ai는 모든 기기와 채팅을 포함합니다.

자주 묻는 질문

Claude Code 사용량이 얼마나 남았는지 어떻게 확인하나요?

/usage를 실행하고 세션 막대와 주간 막대를 보세요. 사용한 비율과 초기화 시각이 나옵니다.

/status로도 사용량이 보이나요?

Anthropic 도움말은 남은 할당량을 확인하는 데 /status를 언급합니다. 현재 버전에서 문서가 요금제 막대와 내역을 보여 주는 명령으로 설명하는 건 /usage입니다.

프로젝트별 Claude Code 사용량을 볼 수 있나요?

직접은 안 됩니다. 내역은 사용량을 스킬, 서브에이전트, 플러그인, MCP 서버로 나눕니다. 팀에서 사용자별 수치를 보려면 Anthropic은 분석 기능과 OpenTelemetry 내보내기를 안내합니다.

긴 세션은 왜 이렇게 많이 쓰나요?

Claude Code는 요청마다 대화 전체를 보냅니다. 하루 종일 이어진 세션 후반에는 한 줄짜리 질문도 기록 분량만큼 비용을 냅니다. 관련 없는 작업 사이에 /clear를 실행하면 기록을 짧게 유지할 수 있습니다.

관련 가이드

• Claude Code 사용량은 언제 초기화되나요? 5시간 창과 주간 한도 정리
• Claude Code 사용량 한도에 걸렸나요? 대처법과 계속 작업하는 방법
• Claude Code는 무료인가요? 2026년 요금과 결제 방법 총정리
• Codex 구독을 여러 컴퓨터에서 쓰는 방법