Cmd. /usage
세션 비용·플랜 사용량 한도·활동 통계를 한 화면에서 확인하고, skill·subagent·plugin·MCP 서버별로 무엇이 한도를 소모하는지 breakdown으로 진단하는 명령. /cost·/stats는 alias.
핵심 요약
/usage는 세션 비용, 플랜 사용량 한도, 활동 통계를 한 화면에서 보여 줍니다./cost·/stats는 별도 명령이 아니라 alias이며,/stats는 Stats 탭으로 바로 엽니다.- v2.1.149부터 skill·subagent·plugin·per-MCP-server 단위 per-category breakdown으로 한도 소모 요인을 진단할 수 있습니다.
- Session 블록의 달러 금액은 로컬 추정치라 실제 청구액과 다르며, 구독자는 비용보다 플랜 막대·활동 통계가 의미 있습니다.
- 한도 도달 후 작업을 이어가려면
/usage가 아니라/usage-credits로 credits를 설정합니다.
명령어 원본 선언
/usage공식 설명 요약
/usage는 세션 비용(session cost), 플랜 사용량 한도(plan usage limits), 활동 통계(activity stats)를 한 화면에서 보여 주는 명령입니다.
Pro, Max, Team, Enterprise 플랜에서는 무엇이 한도를 소모하는지 skill, subagent, plugin, MCP 서버별로 나눈 breakdown까지 함께 표시합니다.
/cost와 /stats는 별도 명령이 아니라 /usage의 alias입니다. /cost는 /usage를 열고, /stats는 /usage를 Stats 탭에서 엽니다.
화면 최상단의 Session 블록은 현재 세션의 토큰 사용 통계를 보여 줍니다. 표시되는 달러 금액은 토큰 수를 로컬에서 추정해 계산한 값이라 실제 청구액과 다릅니다. 이 Session 블록은 API 사용자를 위한 정보입니다. Max·Pro 구독자는 사용량이 구독에 포함되므로 세션 비용 수치가 청구 관점에서는 의미가 없습니다. 구독자는 같은 화면에서 플랜 사용량 막대, 활동 통계, 사용량 breakdown을 봅니다.
최소 지원 버전
v2.1.118부터:/cost와/stats가/usage로 통합되었습니다. 두 명령은 해당 탭을 여는 타이핑 shortcut으로 남았습니다. (2026-04-23)v2.1.121: 큰 transcript history가 있는 머신에서/usage가 최대 약 2GB 메모리를 누수하던 문제가 수정되었습니다. (2026-04-28)v2.1.144: "extra usage"가 CLI 문구 전반에서 "usage credits"로 변경되었고,/extra-usage가/usage-credits로 바뀌었습니다(이전 이름도 계속 동작). (2026-05-19)v2.1.149:/usage가 한도를 소모하는 요인을 skill, subagent, plugin, per-MCP-server 단위로 나눈 per-category breakdown을 표시하기 시작했습니다. (2026-05-22)v2.1.152:/usagebreakdown이 큰 세션 파일까지 포함하며, streaming read로 스캔해 메모리 사용량을 일정하게 유지합니다. (2026-05-27)
사용법
/usaged또는w키로 최근 24시간(d)과 최근 7일(w) 집계를 전환합니다.- breakdown 수치는 근삿값이며 이 머신의 로컬 세션 기록에서 계산됩니다. 다른 기기나 claude.ai의 사용량은 포함되지 않습니다.
좋은 사용 예
- 월간 사용량 한도 사전 점검
- 모델 정책 조정 전 기준 확인
- skill·subagent·plugin·MCP 서버 중 무엇이 한도를 많이 쓰는지 진단
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/usage | 통합 화면 | 세션 비용·플랜 한도·활동 통계 확인 |
/cost | /usage의 alias | 비용 확인용 빠른 진입 |
/stats | /usage의 alias (Stats 탭으로 열림) | 통계 탭으로 바로 진입 |
/usage-credits | 사용량 한도 도달 시 credits 설정 (구 /extra-usage) | 제한 도달 후 작업 지속 |
/context | 컨텍스트 창 사용량 시각화 | 현재 토큰 점유 구조 점검 |
활용 사례
- 분기별 플랜 최적화
- 스프린트별 리소스 예산 관리
- 한도 소모 요인 분석 후 비용이 큰 MCP 서버나 subagent 정리
주의사항
- Session 블록의 달러 금액은 로컬 추정치입니다. 정확한 청구 정보는 Claude Console의 Usage 페이지에서 확인하세요.
- breakdown 수치는 근삿값이며 현재 머신의 세션 기록만 반영하므로 다른 기기/claude.ai 사용량은 빠집니다.
/usage같은 일부 명령은 상태 확인을 위해 백그라운드 요청을 발생시켜 소량의 토큰(세션당 보통 $0.04 미만)을 사용합니다./cost와/stats는 독립 명령이 아니라/usage의 alias입니다. 별도 기능을 기대하지 마세요.- 사용량 한도에 도달했을 때 작업을 이어 가려면
/usage가 아니라/usage-credits(구/extra-usage)로 credits를 설정합니다.
출처
- Commands: https://code.claude.com/docs/en/commands
- Manage costs effectively (
/usage가이드): https://code.claude.com/docs/en/costs - Changelog: https://code.claude.com/docs/en/changelog