무료만 보기
10월 실측AI 7개에 같은 프롬프트 3개를 넣고 채점한 결과 보기AI 7개 채점 결과 보기

클로드 코드 사용량 확인 방법

클로드 코드 사용량은 /usage 명령으로 확인합니다(/cost 와 같은 명령). 세션 한도는 5시간마다 다시 채워지고 상태줄에도 띄울 수 있습니다.2026.10.14 확인

클로드 코드에서 지금까지 쓴 토큰과 요금제 한도를 확인하는 방법입니다. 기본 명령어, 상태줄 표시, 사용량 확인 플러그인 순서로 정리했습니다.

클로드 코드 사용량 확인 명령어

  1. 1/usage — 사용량·한도 한 번에

    세션 비용, 요금제 사용 한도, 활동 통계를 보여 줍니다. Pro·Max·Team·Enterprise 에서는 스킬·서브에이전트·플러그인·MCP 서버가 각각 한도의 몇 %를 썼는지도 나옵니다. /cost 와 /stats 는 /usage 의 다른 이름입니다. 구독 요금제에서는 화면의 달러 금액이 실제 청구와 무관합니다.

    출처: code.claude.com

  2. 2/context — 맥락 창을 무엇이 채우는지

    대화·파일·도구 정의 등이 맥락 창을 얼마나 차지하는지 보여 줍니다. 토큰을 줄이려면 여기서 큰 항목부터 봅니다.

    출처: code.claude.com

  3. 3상태줄에 5시간·주간 한도 표시

    /statusline 으로 상태줄을 만들거나 settings.json 의 statusLine 에 스크립트를 지정합니다. 스크립트가 받는 값 중 rate_limits.five_hour·seven_day 의 used_percentage·resets_at 으로 5시간·7일 한도 사용률과 초기화 시각을 띄울 수 있습니다(Pro·Max 구독자, 첫 응답 이후).

    출처: code.claude.com

  4. 4한도는 5시간마다 초기화, 앱과 공유

    Pro·Max 의 사용 한도는 클로드 앱과 클로드 코드가 함께 씁니다. 세션 한도는 5시간마다 다시 채워지고 상태줄 문서에는 7일 단위 한도 창도 있습니다. 한도에 닿으면 기다리거나 상위 요금제로 바꾸거나 추가 사용량을 구매합니다.

    출처: support.claude.com

클로드 코드 사용량 보는 곳 3가지

초기화 시각 읽는 법: 상태줄 스크립트가 받는 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

클로드 코드 사용량 확인 플러그인 추천

  1. 1ccusage

    설치 없이 npx 한 줄로 로컬 기록에서 날짜별·세션별 토큰과 비용을 집계합니다.

    하는 일
    로컬 기록으로 날짜별·세션별 토큰과 비용을 집계하는 CLI
    무료
    가능 무료
    라이선스
    MIT · 최근 업데이트 2026.10.08
    설치
    npx ccusage@latest

    출처: github.com

  2. 2session-report (Anthropic 공식)

    Anthropic 공식 마켓플레이스 플러그인입니다. 세션의 토큰·캐시 효율·서브에이전트·가장 비싼 요청을 HTML 리포트로 보여 줍니다.

    하는 일
    최근 7일(24시간·30일·전체로 바꿀 수 있음) 기록을 프로젝트·서브에이전트·스킬별로 나눠, 토큰을 가장 많이 쓴 곳을 전체 대비 비율로 짚어 줍니다
    무료
    가능 무료(Anthropic 공식 마켓플레이스)
    설치
    /plugin install session-report@claude-plugins-official

    출처: github.com

클로드 코드 사용량 모니터링 도구

  • Claude Code Usage Monitor

    실시간 사용량 모니터, 한도 도달 예측·경고무료 가능 무료
    pip install claude-monitor

클로드 코드 사용량 상태줄 표시 도구

  • ccstatusline

    모양을 꾸밀 수 있는 상태줄(파워라인·테마)무료 가능 무료
    npx -y ccstatusline@latest
  • claude-powerline

    상태줄에 이번 세션·오늘·이번 달 사용량을 비용이나 토큰으로 띄우고, 하루·월 예산 대비 비율과 남은 컨텍스트도 함께 보여 줍니다무료 가능 무료
    /plugin marketplace add Owloops/claude-powerline
    /plugin install claude-powerline@claude-powerline
기준과 출처
  • 설정·명령어 설명은 클로드 코드 공식 문서(code.claude.com)와 고객센터(support.claude.com)를 2026.10.14에 확인한 내용입니다.
  • 설치 명령·라이선스·최근 업데이트는 각 GitHub 저장소 README 와 커밋 기록 기준입니다. 저장소가 내세우는 절감률·스타 수는 검증할 수 없어 싣지 않았습니다.
  • 제휴 관계는 없고, 추천에 제휴 여부를 반영하지 않습니다.

함께 보기

자주 묻는 질문

클로드 코드 사용량은 어떤 명령어로 확인하나요?

/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 와 /usage 는 무엇이 다른가요?

같은 명령입니다. 공식 문서에서 /cost 와 /stats 는 /usage 의 다른 이름으로 안내됩니다.