🤖 AI

클로드(Claude) 토큰 사용량 확인하는 방법 총정리

리하RIHA 2026. 5. 31. 18:48

 

 

클로드를 매일 쓰다 보면 한 번쯤 궁금해지는 게 있다. “내가 지금 토큰을 얼마나 쓰고 있지?”, “이러다 사용 제한에 걸려서 하던거 마무리 안되는거 아니야?” 특히 Claude Code로 작업하다 보면 5시간 안에 토큰이 훅훅 줄어드는 게 체감됩니다.

 

사용 환경에 따라 확인 방법이 다르기 때문에, API 사용자, Claude Code 사용자, claude.ai 웹/앱 사용자 세 가지로 나눠서 정리했습니다.


1. API 사용자

Anthropic API로 직접 호출하거나 “종량제(pay-as-you-go)”로 사용하는 경우, Claude Console의 Usage 페이지가 가장 정확합니다.

👉 바로가기 : https://console.anthropic.com/settings/usage

 

Console 왼쪽 내비게이션 메뉴의 Usage 페이지에서 모델별, API 키별 사용량을 상세하게 볼 수 있습니다.

Claude Console Usage

 

주요기능

상세 분석 : 모델, 날짜/시간, API키 단위로 사용량 확인 ( 막대 차트를 클릭하면 시,분 단위까지 들어갈 수 있습니다. )

필터링 : 특정 모델, 월별, API 키 선택 가능

토큰 통계 : 선택한 조건의 입력/출력 토큰 총합 표시

Rate Limit 확인 : 제한에 걸려 차단된 요청과 분당 토큰 (ITPM/OTPM) 대비 사용량 시각화

CSV 내보내기 : 데이터를 다운로드해 자체 분석/리포트에 활용


2. Claude Code 사용자

Claude Code를 Pro/Max 구독으로 쓴다면 콘솔의 비용 데이터는 의미가 없습니다. (구독제는 토큰당 과금이 되지 않는다.) 대신 내장 슬래시 커맨드 두 개를 기억하자. 의외로 모르는 사람이 많은데, 가장 빠르고 정확합니다.

 

/usage

현재 플랜의 한도와 Rate Limit 상태를 보여줍니다. 지금 한도를 얼마나 썼는지를 빠르게 확인할 수 있습니다.

 

/stats

세션 수, 토큰 총량, 모델별 분석, 히트맵, 연속 사용 기록(streak)까지 보여주는 대시보드가 열립니다.

 

참고로 Claude Code는 플랜과 무관하게 토근 수, 모델, 세션, 프로젝트 정보를 로컬에 상세히 기록합니다. 그래서 다양한 서드파티가 존재하며, 이 로그를 읽어서 동작을 합니다.

 

세션/한도 구조 알아두기

  • 세션은 첫 메시지를 보내는 순간 시작되며, 5시간동안 지속됩니다.
  • 5시간 한도 외에 주간 한도가 별도로 존재합니다. 두 한도는 독립적으로 리셋되므로 5시간 한도가 남아 있더라도 주간 한도를 먼저 소진할 수 있습니다.
  • 효율을 위해서는 작업별로 세션을 분리해서 시작하는게 좋습니다.

 

3. claude.ai 웹/데스크톱 앱 사용자

Pro, Max, Team, Enterprise 플랜을 쓴다면 설정 > 사용량(Settings > Usage)에서 진행률 막대를 직접 확인할 수 있습니다. 별도 도구 없이 공식적으로 제공되는 가장 간편한 방법입니다. 저도 한동안 이 방법을 통해 확인했습니다.

 

👉 바로가기 : https://claude.ai/settings/usage

 

페이지 상단의 플랜 사용량 한도 섹션과 주간 한도 섹션에서 세 가지 한도에 대한 진행률을 보여 줍니다.

  • 현재 세션 : 현재 세션에서 얼마나 소비 했는지.
  • 모든 모델 : 현재 주간 세션에서 모든 모델 사용량을 얼마나 소비 했는지.
  • Sonnet만 : 현재 주간 세션에서 Sonnet 모델 사용량을 얼마나 소비 했는지.

여기서 알아둘 점 하나! claude.ai, Claude Code, Claude Desktop의 사용량은 모두 같은 한도 풀(pool)을 고유 합니다. 즉 데스크톱 앱에서 쓴 것도, Claude Code에서 쓴 것도 한 곳에 합산됩니다.

 

 

만약 한도를 넘겨도 계속 작업하고 싶다면, 같은 페이지에서 사용 크레딧 섹션에서 활성화 할 수 있습니다. 활성화 후 한도를 넘기면 이후 사용분은 표준 API 요금으로 과금 됩니다. (플랜 구독료와는 별도 청구)

claude.ai 설정 > 사용량

 


정리

사용 환경 확인 방법 정확도
API / 종량제 Claude Console > Usage 공식 / 정확
Claude Code /usage, /stats 슬래시 커맨드 공식 / 정확
claude.ai 웹, 데스크톱 앱 설정 > 사용량 공식 / 정확

 

반응형