클로드 코드 사용량 확인 방법
클로드 코드 사용량은 /usage 명령으로 확인합니다(/cost 와 같은 명령). 세션 한도는 5시간마다 다시 채워지고 상태줄에도 띄울 수 있습니다.2026.10.14 확인
클로드 코드에서 지금까지 쓴 토큰과 요금제 한도를 확인하는 방법입니다. 기본 명령어, 상태줄 표시, 사용량 확인 플러그인 순서로 정리했습니다.
클로드 코드 사용량은 /usage 명령으로 확인합니다(/cost 와 같은 명령). 세션 한도는 5시간마다 다시 채워지고 상태줄에도 띄울 수 있습니다.2026.10.14 확인
클로드 코드에서 지금까지 쓴 토큰과 요금제 한도를 확인하는 방법입니다. 기본 명령어, 상태줄 표시, 사용량 확인 플러그인 순서로 정리했습니다.
세션 비용, 요금제 사용 한도, 활동 통계를 보여 줍니다. Pro·Max·Team·Enterprise 에서는 스킬·서브에이전트·플러그인·MCP 서버가 각각 한도의 몇 %를 썼는지도 나옵니다. /cost 와 /stats 는 /usage 의 다른 이름입니다. 구독 요금제에서는 화면의 달러 금액이 실제 청구와 무관합니다.
출처: code.claude.com
대화·파일·도구 정의 등이 맥락 창을 얼마나 차지하는지 보여 줍니다. 토큰을 줄이려면 여기서 큰 항목부터 봅니다.
출처: code.claude.com
/statusline 으로 상태줄을 만들거나 settings.json 의 statusLine 에 스크립트를 지정합니다. 스크립트가 받는 값 중 rate_limits.five_hour·seven_day 의 used_percentage·resets_at 으로 5시간·7일 한도 사용률과 초기화 시각을 띄울 수 있습니다(Pro·Max 구독자, 첫 응답 이후).
출처: code.claude.com
Pro·Max 의 사용 한도는 클로드 앱과 클로드 코드가 함께 씁니다. 세션 한도는 5시간마다 다시 채워지고 상태줄 문서에는 7일 단위 한도 창도 있습니다. 한도에 닿으면 기다리거나 상위 요금제로 바꾸거나 추가 사용량을 구매합니다.
초기화 시각 읽는 법: 상태줄 스크립트가 받는 resets_at 는 유닉스 초입니다. 공식 문서 예시 값 1738425600 은 UTC 로 2025년 2월 1일 16:00, 한국 시간으로 2월 2일 01:00 입니다. 같은 예시의 used_percentage 23.5 는 5시간 한도의 23.5% 를 썼다는 뜻입니다.
| 어디서 | 무엇을 | 방법 |
|---|---|---|
| 클로드 코드 안 | 세션 비용·요금제 한도·플러그인과 MCP 별 사용 비율 | /usage (/cost·/stats 와 같은 명령) |
| 상태줄 | 5시간·7일 한도 사용률과 초기화 시각 | /statusline 로 만들고 rate_limits 값을 표시 |
| 클로드 계정 설정 | 추가 사용량(usage credits) 켜기·지출 한도·알림 | 클로드 앱·웹의 Settings → Usage |
설치 없이 npx 한 줄로 로컬 기록에서 날짜별·세션별 토큰과 비용을 집계합니다.
npx ccusage@latest출처: github.com
Anthropic 공식 마켓플레이스 플러그인입니다. 세션의 토큰·캐시 효율·서브에이전트·가장 비싼 요청을 HTML 리포트로 보여 줍니다.
/plugin install session-report@claude-plugins-official출처: github.com
pip install claude-monitornpx -y ccstatusline@latest/plugin marketplace add Owloops/claude-powerline
/plugin install claude-powerline@claude-powerline/usage 입니다(/cost·/stats 는 같은 명령의 다른 이름). 세션 비용·요금제 한도·활동 통계를 보여 주고 유료 요금제에서는 플러그인·MCP 별 사용 비율도 나옵니다. 맥락 창 점유는 /context 로 봅니다.
공식 안내에 따르면 세션 한도는 5시간마다 다시 채워집니다. 7일 단위 한도 창도 있습니다. 정확한 초기화 시각은 상태줄 스크립트가 받는 resets_at 값으로 확인할 수 있습니다. 한도는 클로드 앱과 함께 씁니다.
로컬 기록을 집계하는 ccusage, 공식 마켓플레이스의 session-report, 실시간 모니터 Claude Code Usage Monitor, 상태줄 도구 ccstatusline·claude-powerline 이 있습니다. 모두 무료입니다.
있습니다. 공식 상태줄 문서에 5시간 한도와 별도로 7일 단위 한도(seven_day)가 있고 각각의 사용률과 초기화 시각(resets_at)을 상태줄에 띄울 수 있습니다.
한도가 다시 채워질 때까지 기다리거나 상위 요금제(Max)로 바꾸거나 추가 사용량을 구매합니다. 추가 사용량은 클로드 코드의 /usage-credits 명령으로 관리합니다. 토큰을 덜 쓰는 방법은 클로드 코드 토큰 절약 방법에 있습니다.
같은 명령입니다. 공식 문서에서 /cost 와 /stats 는 /usage 의 다른 이름으로 안내됩니다.