본문으로 건너뛰기
claudemods

Claude Code 사용량 모드: 컨텍스트, 플랜 사용량, 비용

Claude Code 사용량 모드는 컨텍스트 창 사용률, 5시간 및 7일 플랜 사용량, 세션 비용, 도구 호출 수를 보여 주어 한도와 컴팩션에 놀라지 않게 합니다.

Claude Code에서 실행 중인 Cache Clock추천

Cache Clock

Claude Code 상태 표시줄 아래에 프롬프트 캐시의 남은 시간, 적중률, 식은 뒤 다시 캐시할 토큰 수를 보여 줍니다.

  • 상태 표시줄
  • 파일 읽기
  • 파일 쓰기
  • 명령어 실행
  • 명령어/도구 추가

v2.1.296에서 테스트됨

Claude Code에서 실행 중인 컨텍스트 미터추천

컨텍스트 미터

컨텍스트 창 사용률, 5시간·7일 요금제 사용량, 세션 비용을 상태 표시줄에 보여 주고 한도에 가까워지면 경고합니다.

  • 상태 표시줄
  • 토스트
  • UI 변경

v2.1.310에서 테스트됨

Claude Code에서 실행 중인 도구 호출 카운터추천

도구 호출 카운터

Claude의 도구 호출을 턴별·세션별로 세어 스피너 옆에 표시하고, 상세 내역을 보는 /tally 명령을 추가합니다.

  • 스피너
  • 대화 기록
  • 상태 표시줄
  • 도구 호출 가로채기
  • UI 변경
  • 명령어/도구 추가

v2.1.310에서 테스트됨

Claude Code에서 실행 중인 Compact Adviser추천

Compact Adviser

작업 단위가 끝난 시점을 판단해 Claude Code에서 /compact를 실행하기 좋은 때를 힌트로 알려 줍니다.

  • 상태 표시줄
  • 패널
  • 토스트
  • 파일 읽기
  • 파일 쓰기
  • 네트워크
  • 프롬프트 읽기
  • UI 변경
  • 명령어/도구 추가
  • 데이터 저장

v2.1.291에서 테스트됨

Claude Code에서 실행 중인 Context Bar추천

Context Bar

Claude Code 컨텍스트 창을 프롬프트 위 누적 막대 하나로 보여 줍니다. 카테고리마다 색이 다르고 토큰 수도 표시됩니다.

  • 프롬프트 위
  • UI 변경
  • 명령어/도구 추가
  • 데이터 저장

v2.1.291에서 테스트됨

Claude Code에서 실행 중인 Context Inspector추천

Context Inspector

Claude Code 컨텍스트 창을 무엇이 채우는지, 재읽기와 중복이 얼마나 되는지, 압축이 무엇을 남겼는지 보여 줍니다.

  • 상태 표시줄
  • 패널
  • 토스트
  • 파일 쓰기
  • 도구 호출 가로채기
  • 프롬프트 읽기
  • UI 변경
  • 명령어/도구 추가

v2.1.303에서 테스트됨

Claude Code에서 실행 중인 ctx-handoff추천

ctx-handoff

프롬프트 캐시를 유지하고, 가르친 내용을 프로젝트 노트로 만들며, 컨텍스트가 가득 차면 인계합니다.

  • 프롬프트 위
  • 상태 표시줄
  • 토스트
  • 파일 읽기
  • 파일 쓰기
  • 모델 호출 (사용량 소모)
  • 도구 호출 가로채기
  • 프롬프트 읽기
  • UI 변경
  • 명령어/도구 추가
  • 데이터 저장

v2.1.303에서 테스트됨

Claude Code에서 실행 중인 Project Sentinel추천

Project Sentinel

긴 Claude Code 실행을 위한 상태 띠, 컨텍스트 핸드오프, 프롬프트 캐시 추적, 권한 규칙을 제공합니다.

  • 프롬프트 위
  • 패널
  • 스피너
  • 상태 표시줄
  • 토스트
  • 파일 읽기
  • 명령어 실행
  • 모델 호출 (사용량 소모)
  • 도구 호출 가로채기
  • 프롬프트 읽기
  • UI 변경
  • 명령어/도구 추가
  • 데이터 저장

v2.1.296에서 테스트됨

Claude Code에서 실행 중인 Token Weather추천

Token Weather

Claude Code 컨텍스트 창 사용량을 날씨 예보처럼 프롬프트 위에 보여 주고, 최근 턴의 추이와 프롬프트 캐시 카운트다운을 함께 표시합니다.

  • 프롬프트 위
  • 파일 읽기
  • 명령어 실행
  • UI 변경
  • 데이터 저장

v2.1.307에서 테스트됨

Claude Code에서 실행 중인 Usage Meter추천

Usage Meter

플랜의 5시간·7일 사용량을 Claude Code 프롬프트 위 작은 막대로 보여 주고, 초기화 카운트다운과 세션 비용도 표시합니다.

  • 프롬프트 위
  • 토스트
  • UI 변경

v2.1.291에서 테스트됨

Claude Code에서 실행 중인 Use Haiku추천

Use Haiku

Claude Code 프롬프트 앞에 _ 를 붙이면 그 한 턴만 Haiku로 실행되고, 입력 중과 실행 중, 답변 아래에 표시됩니다.

  • 스피너
  • 대화 기록
  • 상태 표시줄
  • 프롬프트 읽기
  • UI 변경

v2.1.303에서 테스트됨

Claude Code 사용량 모드는 세션을 제한하는 숫자들을 계속 보이게 합니다. 컨텍스트 창이 얼마나 찼는지, 5시간 및 7일 플랜 기간을 얼마나 사용했는지, 지금까지 세션 비용이 얼마인지, Claude가 도구를 몇 번 호출했는지 등입니다. 작업 도중에 컴팩션이나 속도 제한에 부딪히는 대신 미리 다가오는 것을 볼 수 있습니다.

Claude Code 사용량 모드는 숫자를 어디에서 가져오나요?

주된 출처는 $.session.usage()입니다. 이 함수는 startedAt, context(토큰 수, 창 크기, 백분율), rateLimits(플랜 기간마다 percentUsed를 담은 항목 하나), cost를 반환합니다. 세부 내역 없이 호출하면 요청을 보내지 않으므로, 모드는 매 턴이 끝날 때마다 무료로 읽을 수 있습니다. 모드는 보통 turn.complete, session.compact, 그리고 느린 $.clock.every 타이머에서 새로 고친 뒤 결과를 $.ui.status로 씁니다.

session.measure는 각 턴이 끝난 뒤와 플랜 사용량이 바뀔 때마다 발생하므로, 임계값에 반응하는 모드에 적합합니다. 도구 호출 집계 같은 활동 카운터는 tool.call 이벤트를 세고 합계를 $.state에 보관합니다. 사용량 객체는 모드 레퍼런스에 설명되어 있습니다.

설치하기 전에 무엇을 확인해야 하나요?

사용량 표시에는 필요한 것이 거의 없어야 합니다. UI 변경만 표시되는 것이 일반적입니다. 사용량 모드에 네트워크가 표시된다면 사용자의 수치를 어딘가로 보내고 있다는 뜻이므로 어디로 보내는지 확인하십시오. 사용량 모드에 모델 호출이 표시된다면 위험 신호입니다. 추적한다고 내세우는 바로 그 사용량을 소모하게 되기 때문입니다.

데이터가 없을 때 어떻게 처리하는지도 확인하십시오. 첫 응답 전에는 아직 컨텍스트 수치가 없고, API 키를 사용하면 플랜 기간이 없습니다. 신중하게 만든 모드는 오해를 부르는 0을 보여 주는 대신 해당 부분을 생략합니다. 경고 토스트가 임계값마다 한 번만 뜨는지, 아니면 새로 고칠 때마다 뜨는지도 확인하십시오.

숫자를 보고 어떻게 대응해야 하나요?

컨텍스트가 약 80퍼센트를 넘으면 무엇을 남길지 짧게 메모를 붙여 /compact를 실행하거나, /clear로 비운 뒤 요약을 가지고 새로 시작합니다. 5시간 기간의 사용량이 높다면 긴 작업을 나중으로 미루거나 더 작은 모델로 옮깁니다. 사용량 모드는 한도를 바꾸지 않습니다. 대신 선택할 수 있을 만큼 일찍 경고해 줍니다.

자주 묻는 질문

사용량을 읽는 데 토큰이 드나요?
모드가 세부 내역 없이 $.session.usage()를 호출한다면 들지 않습니다. 이 호출은 Claude Code가 이미 추적하고 있는 수치를 반환합니다. 세부 내역을 요청하면 토큰 계산 요청이 전송됩니다.
사용량 모드에 5시간 또는 7일 수치가 왜 표시되지 않나요?
플랜 사용량 기간은 구독에만 존재합니다. API 키를 사용하면 표시할 속도 제한 기간이 없으므로, 잘 만든 모드는 0을 출력하는 대신 해당 항목을 생략합니다.
비용 수치는 /cost와 같은가요?
/cost가 합산하는 것과 같은 세션 사용량 데이터에서 나오며 단위는 미국 달러입니다. 세션에 대한 추정치이며 실제 청구 금액이 아닙니다.