Claude Code 사용량 확인하는 법 — /usage부터 메뉴바 상시 표시까지

한창 코딩하다 "한도에 도달했습니다"를 만나면 흐름이 끊깁니다. Claude Code 사용량을 미리 챙기는 방법을 가벼운 것부터 차례로 정리했습니다.

방법 1 — /usage 명령

가장 기본입니다. Claude Code 입력창에 그대로 입력하면 됩니다.

/usage

5시간 세션·주간 전체·모델별 한도의 현재 사용률과 리셋 시각을 한 화면에 보여 줍니다. 단점은 생각날 때마다 직접 쳐야 한다는 것입니다. 작업에 몰입하면 잊기 쉽습니다.

방법 2 — 상태줄(statusline)에 띄우기

/statusline으로 터미널 아래 상태줄을 꾸미면 현재 모델·컨텍스트 사용량 등을 항상 볼 수 있습니다. 터미널 안에서는 유용하지만 터미널을 벗어나면 보이지 않는다는 한계가 있습니다. 브라우저에서 문서를 보거나 다른 앱에서 일하다가 한도를 넘기는 경우가 많습니다.

방법 3 — ccusage로 토큰·비용 통계 보기

오픈소스 CLI인 ccusage는 Claude Code가 로컬에 남기는 로그를 분석해 일별·프로젝트별 토큰 사용량과 추정 비용을 보여 줍니다.

npx ccusage@latest

"이번 달 어디에 얼마나 썼지?"를 돌아보는 사후 분석에 좋습니다. 다만 로컬 로그 기반이라 지금 남은 한도 퍼센트(서버 기준)와는 다른 정보입니다.

방법 4 — 메뉴바에서 늘 보기

확인 명령을 치는 대신 맥 메뉴바에 퍼센트가 항상 떠 있게 하는 방식입니다. 어떤 앱을 쓰고 있든 시선만 올리면 남은 한도가 보입니다.

Claude Code를 쓰면 따로 설정할 것이 없습니다

Burndown은 Claude Code의 로그인 정보를 찾아, 키체인 허용 한 번이면 메뉴바에 사용량을 띄웁니다. 지금 속도면 언제 막히는지 예측하고, 정해 둔 비율을 넘으면 알림을 보냅니다. Claude Code 세션이 허용을 기다리거나 끝났을 때도 알려 줍니다(선택 기능).

Mac App Store에서 받기

자주 묻는 질문

Claude Code 사용량과 웹 Claude 사용량은 따로인가요?

같은 계정이면 함께 집계됩니다. Claude Code에서 쓴 만큼 웹에서 쓸 수 있는 양도 줄어듭니다. 한도 구조 자체가 궁금하다면 Claude 사용량 한도 총정리를 먼저 읽어 보세요.

API 키로 쓰는 경우에도 한도가 있나요?

API 키(종량제)로 연결하면 구독 한도 대신 크레딧 잔액·요율 제한을 따릅니다. 이 글의 한도 이야기는 Pro·Max 같은 구독 플랜으로 로그인해 쓰는 경우입니다.

Burndown은 데이터를 어디로 보내나요?

사용량은 이 맥과 Anthropic 서버 사이에서만 오갑니다. 외부 서버로는 아무것도 보내지 않고, 로그인 정보는 맥 키체인에만 저장합니다. 자세한 내용은 개인정보처리방침에 있습니다.