/usage는 이번 세션의 토큰 사용량과 비용 추정치, 구독 플랜의 사용 한도 현황을 한 화면에 보여 줍니다. 한도가 얼마나 남았는지, 무엇이 많이 쓰이는지 확인하려고 씁니다.
직접 써보니
이 사이트를 개편하는 작업 중에 /usage를 두 번 열어 사용량을 확인했습니다. 긴 세션에서는 한도 상태를 중간중간 확인해 두는 것이 도움이 됩니다.
어떻게 동작하나
/usage 화면 위쪽에는 Session 블록이 있습니다. 현재 세션의 토큰 사용량 통계와 비용이 나옵니다. 비용은 Claude Code가 토큰 수를 바탕으로 로컬에서 정가 기준으로 계산한 추정치입니다. 공식 문서도 정확한 청구는 Claude Console의 Usage 페이지에서 보라고 안내합니다.
Pro, Max 구독자는 사용량이 구독에 포함되어 있어 Session의 비용 수치가 청구 기준이 아닙니다. 대신 플랜 사용량 막대, 활동 통계, 사용량 내역을 같은 화면에서 봅니다. 플랜 사용량 내역에는 스킬, 서브에이전트, 플러그인, MCP 서버별 비율과 줄일 수 있는 항목에 대한 권장 사항이 나옵니다.
/cost와 /stats는 이 명령의 별칭입니다. /stats는 Stats 탭으로 엽니다. /usage는 Claude가 응답하는 동안에도 끼어들지 않고 바로 실행되는 명령 중 하나입니다.
화면 읽는 법
- Session 블록: 총 비용, API 시간, 모델별 입력·출력·캐시 토큰. /clear를 하면 새 세션이라 0부터 다시 시작합니다(v2.1.211 이상).
- 프롬프트 캐시 줄: 캐시에서 읽힌 비중, 캐시 미스, 캐시가 아직 살아 있는지 표시됩니다(v2.1.251 이상).
- 플랜 사용량 막대와 내역: d 키와 w 키로 최근 24시간과 7일을 전환합니다.
- 권장 사항: 각 줄 앞의 퍼센트는 그 줄이 내 사용량 중 얼마에 해당하는지이고, 절약되는 양이 아닙니다. 여러 줄에 겹쳐 100%를 넘길 수 있습니다.
- f 키: 하단에 "f to fix"가 보이면 적용 가능한 권장 사항을 Claude Code가 처리합니다(v2.1.305 이상). run /compact처럼 명령이 적힌 줄은 직접 실행해야 합니다.
- 수치는 이 기기의 로컬 세션 기록에서 계산한 근사값이어서 다른 기기나 claude.ai 사용량은 포함되지 않습니다.
세션이 길어질수록 사용량이 느는 이유
비용 문서는 이유를 이렇게 설명합니다. Claude Code는 요청마다 전체 대화를 보냅니다. 프롬프트 캐시 덕에 그 기록은 캐시 단가로 읽히지만, 하루 종일 열려 있는 세션에서 한 줄을 물어도 전체 대화만큼 사용량이 잡힙니다. 휴식 후 첫 메시지는 캐시 수명이 지나 있으면 컨텍스트 전체를 다시 처리합니다. 서브에이전트, 예약 작업, 에이전트 팀도 각자 요청을 보냅니다. /compact 자체도 큰 컨텍스트를 읽는 큰 요청입니다.
줄이는 방법은 무관한 작업 사이에 /clear, 필요하면 /compact에 지시문 붙이기, 작업에 맞는 모델 선택, CLAUDE.md 200줄 이내 유지, 쓰지 않는 MCP 서버 끄기입니다.
rate limited until 같은 문구가 /usage에 보이면 플랜 한도를 다시 가져올 수 없다는 뜻이지, 작업이 막혔다는 뜻이 아닙니다. 시각 이후 r 키로 다시 불러옵니다.
실제 예시
오후 내내 같은 세션에서 작업했더니 한도가 예상보다 빨리 줄어드는 것 같을 때
/usage
플랜 사용량 막대와 내역에서 어떤 스킬, 서브에이전트, MCP 서버가 큰 비중인지 보입니다. "컨텍스트 정리" 계열 권장 사항이 있으면 /clear나 /compact로 컨텍스트를 줄이는 것이 우선입니다.
긴 작업을 하나 끝내고 다른 작업으로 넘어가기 전에 현재 세션의 비용을 확인하고 싶을 때
/cost
/usage와 같은 화면이 열려 Session 블록에서 세션 총 비용과 모델별 토큰을 볼 수 있습니다. 이후 /clear를 하면 이 합계는 새 세션에서 0부터 시작합니다.
API 키로 쓰는데 Session 비용이 청구서와 달라 보일 때
/usage 의 Total cost 와 Claude Console Usage 페이지 비교
/usage의 비용은 로컬 추정치입니다. 정확한 청구는 Console의 Usage 페이지 기준이므로 그쪽을 확인하세요.
흔한 실수와 쓰지 말아야 할 때
- 구독 플랜에서 Session 비용을 실제 청구액으로 읽는 것. 구독자에게는 청구 기준이 아닙니다.
- /usage 수치를 모든 기기의 합계로 믿는 것. 이 기기의 로컬 기록 기준이라 다른 기기와 claude.ai는 빠집니다.
- 권장 사항의 퍼센트를 절감량으로 읽는 것. 해당하는 사용량의 비중일 뿐입니다.
- /clear 후에도 이전 세션 합계가 이어진다고 생각하는 것. v2.1.211부터는 새 세션 합계가 0부터 시작합니다.
- 한도에 걸리자 모델만 바꾸는 것. 세션·주간 한도는 모델 공통이라 모델을 바꿔도 풀리지 않습니다.
자주 묻는 질문
/cost와 /usage는 다른가요?
/cost와 /stats는 /usage의 별칭입니다. /stats는 Stats 탭으로 엽니다.
/usage의 비용은 정확한가요?
로컬에서 토큰 수와 정가로 계산한 추정치입니다. 관리자가 조직 요율을 설정한 경우 그 요율이 반영됩니다. 정확한 청구는 Claude Console의 Usage 페이지 기준입니다.
사용 한도가 초과되면 어떻게 하나요?
표시되는 초기화 시각까지 기다리거나, 사용 크레딧이 켜져 있다면 /usage-credits로 관리할 수 있습니다. 한도 종류에 따라 안내가 다르니 화면의 메시지를 먼저 확인하세요.
2026-10-30 공식 문서와 대조함. 출처: Claude Code 문서: Manage costs effectively, Claude Code 문서: Commands. 작성 원칙