Claude Code Usage Monitor
공식 한도를 근거로 사용량을 추적하는 터미널 모니터
uv tool install claude-monitor클로드 코드 사용량을 실시간으로 보여 주고 앞으로의 소진을 예측합니다. 4.0 부터는 공식 한도 값을 상태줄에서 직접 받아 오고, 그 값이 오래되었거나 만료되면 지역 추정치로 내려가되 그 사실을 표시로 남깁니다. 나오는 숫자마다 공식인지 지역 추정인지 실험값인지 표가 붙습니다. 클로드가 30일 뒤 지우는 기록을 따로 남기는 지역 저장소를 선택으로 켤 수 있고 프로젝트와 모델, 날짜 단위 보고서를 CSV 나 JSON 으로 뽑습니다. 기계가 읽는 출력과 상태 파일을 제공해 다른 도구가 그 위에 얹힙니다. 기본 요금제는 최근 8일 사용 패턴을 분석해 개인화된 한도를 계산합니다.
판단
이럴 때 씁니다
- 한도에 언제 닿을지 미리 알아야 할 때
- 30일 뒤 사라지는 사용 기록을 남겨 두고 싶을 때
- 사용량 숫자를 다른 도구가 읽게 하고 싶을 때
이럴 땐 쓰지 마세요
- 요금 청구서를 대신하지 않습니다
- 지역 추정치는 공식 값과 다를 수 있습니다
- 여러 계정을 섞으면 창 계산이 어긋납니다
차별점
- 숫자마다 공식과 지역 추정, 실험값을 구분하는 표가 붙습니다.
- 기계가 읽는 출력과 상태 파일이 같은 규격을 씁니다.
- 최근 8일 사용 패턴으로 개인화된 한도를 계산합니다.
- 지역 기록 저장소가 30일 정리 이후에도 이력을 남깁니다.
워크플로
- 01도구를 설치합니다.
- 02상태줄 연동으로 공식 한도를 받아 옵니다.
- 03실시간 화면에서 소진 속도를 봅니다.
- 04기록 저장소를 켜서 이력을 남깁니다.
- 05필요하면 상태 파일로 뽑아 다른 도구에 넘깁니다.
주요 명령
| 명령 | 설명 |
|---|---|
uv tool install claude-monitor | 격리된 환경에 설치합니다. |
claude-monitor --statusline | 공식 한도 값을 받아 옵니다. |
claude-monitor --once --output json | 한 번만 찍어 기계가 읽는 형태로 뽑습니다. |
함정
설치 전에 확인하세요
- 공식 값이 오래되면 지역 추정치로 내려갑니다. 화면의 출처 표시를 확인해야 합니다.
- 여러 계정 디렉터리를 함께 훑으면 5시간 창이 섞일 수 있습니다. 경로를 나눠 지정해야 합니다.
- 기록 저장소는 선택 기능입니다. 켜지 않으면 30일 뒤 원본과 함께 사라집니다.
- 외부 도구는 상태 파일이나 단발 출력을 쓰라고 문서가 못 박습니다. 화면을 긁어 쓰면 깨집니다.
비교
사용량 도구는 대개 지역 로그만 계산해 실제 한도와 어긋납니다. 이쪽은 공식 값을 받아 오고 못 받으면 그 사실을 표시로 남기는 쪽이라 숫자를 믿을 근거가 생깁니다. 대신 요금 청구서를 대신하지는 않습니다.
최근 변경
모델 분포 화면이 모든 모델 계열을 표시하도록 바뀌었습니다. 예전에는 두 계열만 그려서 나머지가 사라지고 비율까지 틀어졌습니다.