클로드코드 사용량조회하는 3가지 방법

클로드코드 사용량 조회를 가장 정확하게 확인하는 방법을 정리했습니다. /cost, Claude Console, OpenTelemetry 기준으로 플랜별 차이와 오류 복구까지 한 번에 확인하세요.

클로드코드 사용량조회는 콘솔과 관리자 페이지 그리고 터미널 명령어를 통해 간단하게 확인할 수 있습니다. 클로드코드 사용 시 소모되는 토큰량과 비용을 파악하는 것은 상당히 중요한데요.

참고로 한 가지 방법만으로는 정확하지 않습니다.
가장 안정적인 방법은 다음 3가지를 목적에 따라 나눠 쓰는 것입니다.

• 지금 세션에서 즉시 확인: /cost
• 월/일 단위 리포트 확인: Claude Console Usage/Cost
• 팀 단위 자동 수집/대시보드: OpenTelemetry + statusline

이 글은 2026년 2월 22일 기준 공식 문서와 실제 사용자 사례를 함께 검증해 작성했습니다.

30초 요약

• 클로드코드 사용량 확인이 급하면 터미널에서 /cost가 가장 빠릅니다.
• 월별 추이, 모델별 지출, CSV 내보내기는 Claude Console이 표준입니다.
• 팀 운영 환경이라면 OTel 메트릭(claude_code.cost.usage, claude_code.token.usage)을 붙여야 재발 방지가 됩니다.
• 사용량 제한(얼마나 자주 쓰는가)과 길이 제한(한 대화가 얼마나 길어지는가)은 다른 개념입니다.

어떤 환경에 있는지 체크하기

기본 : 클로드 설정에서 상세 사용량 확인하기

가장 기본이 되는 방법은 클로드 웹사이트에 접속하여 사용량 페이지를 살펴보는 것입니다.

왼쪽 사이드바 메뉴에서 사용량 항목을 클릭합니다.

그러면 현재 플랜사용량 현황을 볼 수 있습니다. 저희는 맥스요금제를 사용하고 있는데 생각보다 넉넉한 편입니다. 전모델 사용량, Sonnet만 했을때 사용량, 현재 세션에서 얼마나 사용했는지 볼 수 있습니다. Current session의 경우 4-5시간 주기로 업데이트가 되는데 이 시간동안 사용이 가능한 한도라고 생각하시면 됩니다.

요약: 클로드 설정-사용량에서 플랜사용량 한도를 볼 수 있습니다.

방법1 : 터미널에서 즉시확인 /usage , /cost

클로드코드 사용량 조회를 가장 빠르게 하는 방법입니다.
터미널에서 Claude Code 세션 중 /usage 를 입력하면 구독플랜 기준으로 사용량을 확인할 수 있습니다.

아래는 구독플랜 기준 사용량을 터미널에서 조회한 사진입니다. 제가 직접 명령을 해보았습니다.

/cost를 입력하면 API토큰 사용통계용으로 현재 세션의 토큰/비용 통계를 바로 볼 수 있습니다.

언제 유용한가

• 코딩 중 “지금 얼마나 썼는지” 즉시 확인할 때
• 프롬프트/컨텍스트 전략 변경 전후를 비교할 때
• 세션 단위 비용 급증을 빠르게 감지할 때

함께 알아두면 좋은 절약 명령

• /compact: 컨텍스트를 줄여 토큰 사용량 최적화
• /clear: 작업 단위가 끝났을 때 컨텍스트 리셋
• 자동 compact 설정: 컨텍스트가 커질 때 자동 요약

주의

공식 문서에서는 /cost 관련 안내에서 Max/Pro 구독 맥락과 API 과금 맥락을 분리해 설명합니다.
즉, 구독 체감 한도와 API 세션 비용은 같은 지표로 보면 안 됩니다.

방법2 : Claude Console에서 공식 리포트 확인

조직의 관리자나 팀 플랜 사용자는 더 심층적인 분석을 제공하는 전용 메뉴를 이용할 수 있습니다. 

API 콘솔 사용자라면 왼쪽 패널에서 Analytics를 선택하여 클로드코드 전용 통계를 확인하게 됩니다.

실무에서 가장 중요한 표준 화면은 Console Usage/Cost입니다.
여기서 클로드코드 사용량 확인, 클로드코드 토큰 확인, 월별 추이 분석까지 가능합니다.

Console에서 보는 항목

• Workspace 단위 사용량
• 모델별 사용량/비용
• 기간(월/일)별 추이
• API Key 필터
• CSV 내보내기

권한 조건

공식 지원 문서 기준으로 Usage/Cost 보고는 Developer, Billing, Admin 역할 중심으로 제공됩니다.
권한이 맞지 않으면 화면이 안 보이거나 일부 항목이 비활성화될 수 있습니다.

중요포인트

현재 Console에서는 개별 사용자별 사용량/비용 분석이 불가하다고 명시되어 있습니다.
팀원별 관리가 필요하면 키 전략, 워크스페이스 분리, 로그 수집 체계를 함께 설계해야 합니다.

방법3 : 운영 자동화: statusline + OpenTelemetry

“매번 수동 확인” 단계에서 끝내면 다시 비용 사고가 납니다.
운영 단계에서는 자동 계측으로 넘어가야 합니다.

statusline

statusline 입력 JSON에서 cost.total_cost_usd와 context window 정보를 읽어
터미널 상단/하단에 실시간 상태를 보여줄 수 있습니다.

OpenTelemetry

Claude Code는 OTel 메트릭/이벤트를 지원합니다.
실무에서 자주 쓰는 키는 아래 2개입니다.

• claude_code.cost.usage
• claude_code.token.usage

이 두 메트릭을 시계열로 쌓으면 “언제, 어떤 작업에서 급증했는지”를 회고할 수 있습니다.

자주 헷갈리는 개념: 사용량 제한 vs 길이 제한

공식 지원 문서에서도 이 둘을 분리합니다.

• 사용량 제한: 일정 시간 동안 얼마나 많이 사용할 수 있는지
• 길이 제한: 한 대화에서 컨텍스트 윈도우를 얼마나 쓰는지

또한 여러 제품 표면(claude.ai, Claude Code, Claude Desktop) 사용량이 같은 제한 집계에 포함될 수 있다는 점을 함께 안내하고 있습니다.

클로드코드 서비스가 실행 중인 상태에서 아래의 단계를 수행하여 실시간 정보를 얻을 수 있습니다.

– 터미널 프롬프트에서 /cost 입력하기

– 현재 세션에서 발생한 입력 및 출력 토큰 확인하기

– 누적된 예상 비용 수치 검토하기

– 세션별 리소스 소모량 비교하기

요약: 관리자 전용 분석 페이지나 터미널의 /cost 명령어를 통해 목적에 맞는 방식으로 사용량 조회가 가능합니다.

마무리하며

지금까지 클로드코드 사용량조회를 위한 방법에 대해 알아보았습니다. 오늘 안내해 드린 방법들을 상황에 맞게 툴을 사용하시기 바랍니다.

다음에도 도움이 되는 내용으로 찾아오겠습니다. 끝까지 읽어주셔서 고맙습니다.

함께 보면 좋은 글

출처

• Claude Code 비용 관리 문서
• Claude Code 모니터링(OTel)
• Claude Code statusline
• Claude 콘솔 비용/사용량 보고
• 사용량 및 길이 제한 이해하기
• Workspace 생성/관리

자주 묻는 질문