Cmd. /usage
세션 비용·플랜 사용량 한도·활동 통계를 한 화면에서 확인하고, skill·subagent·plugin·MCP 서버별로 무엇이 한도를 소모하는지 breakdown으로 진단하는 명령. /cost·/stats는 alias.
핵심 요약
- session cost·plan limit·activity 표시
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
session cost·plan limit·activity 표시
/usage사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | /cost, /stats |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/usaged또는w키로 최근 24시간(d)과 최근 7일(w) 집계를 전환합니다.- breakdown 수치는 근삿값이며 이 머신의 로컬 세션 기록에서 계산됩니다. 다른 기기나 claude.ai의 사용량은 포함되지 않습니다.
- 반복 자동화를 운영한다면 Loops 탭에서 실행당 토큰이 갑자기 커진 작업을 먼저 찾습니다.
선택 시점
- 월간 사용량 한도 사전 점검
- 모델 정책 조정 전 기준 확인
- skill·subagent·plugin·MCP 서버 중 무엇이 한도를 많이 쓰는지 진단
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/usage | 통합 화면 | 세션 비용·플랜 한도·활동 통계 확인 |
/cost | /usage의 alias | 비용 확인용 빠른 진입 |
/stats | /usage의 alias (Stats 탭으로 열림) | 통계 탭으로 바로 진입 |
/usage-credits | 사용량 한도 도달 시 credits 설정 (구 /extra-usage) | 제한 도달 후 작업 지속 |
/context | 컨텍스트 창 사용량 시각화 | 현재 토큰 점유 구조 점검 |
실행 결과와 유지 범위
사용량·비용·활동 정보를 조회합니다. 이 화면을 여는 것만으로 결제나 추가 사용을 승인하지 않습니다.
/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을 봅니다.
주의사항
- Session 블록의 달러 금액은 로컬 추정치입니다. 정확한 청구 정보는 Claude Console의 Usage 페이지에서 확인하세요.
- breakdown 수치는 근삿값이며 현재 머신의 세션 기록만 반영하므로 다른 기기/claude.ai 사용량은 빠집니다.
/usage같은 일부 명령은 상태 확인을 위해 백그라운드 요청을 발생시켜 소량의 토큰(세션당 보통 $0.04 미만)을 사용합니다./cost와/stats는 독립 명령이 아니라/usage의 alias입니다. 별도 기능을 기대하지 마세요.- 사용량 한도에 도달했을 때 작업을 이어 가려면
/usage가 아니라/usage-credits(구/extra-usage)로 credits를 설정합니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록