[Claude code] 클로드 코드 사용량 모니터링 claude-monitor

이전 글에서는 cluade를 설치 및 기본적인 사용 방법에 대해 알아봤다:

https://codingsmu.tistory.com/185

[Claude code] 설치 및 사용법 Vscode, Terminal

 

본 글에서는 claude code 사용량을 편하게 모니터링 할 수 있는 claude-monitor에 대해 소개하고자한다.

 

 

claude 토큰 사용량을 모니터링 하고 싶다면, claude-monitor 강추

claude 공식 web에서도 사용량을 트래킹할 수 있지만 꽤나 번거롭다. claude-monitor를 이용한다면, 터미널에서 실시간 사용량을 확인할 수 있다. (gpu/cpu 사용량 모니터링 도구인 htop과 비슷한 느낌이다)

 

먼저  claude-monitor를 사용하기 위해서는 패키지 설치부터 해야한다. pip로 설치 후 claude-monitor를 입력하면, 실시간 claude code토큰 사용량, 비용 등을 모니터링 할 수 있다.

 

pip install claude-monitor
claude-monitor

 

 

만약 Pro플랜이고, 시간을 한국 타임으로 보고 싶다면 아래 커맨드를 입력하면 된다

claude-monitor --plan pro --timezone Asia/Seoul

claude-monitor 화면 UI

 

 

 

각 상태창이 의미하는 바는 아래와 같다:

항목	설명
💰 Cost Usage	비용 사용량으로 현재까지 사용한 금액과 설정된 예산 한도에 해당 (Time Reset후 초기화 됨)  (이미지상에서는 총 $18.00 중 $0.14(0.8%)를 사용했음을 보여줌)
📊 Token Usage	토큰 사용량으로 현재 기간 내에 사용된 토큰 수에 해당 (Time Reset후 초기화 됨)  100%가 넘어도 동작은 하나, 속도가 굉장히 느려짐 (300~400% 까지 사용하면 time reset 전까지 사용 제한이 걸림) (19,000 토큰 중 2,818개(14.8%)를 소비한 상태임)
📨 Messages Usage	메시지 횟수로 Claude와 주고받은 메시지 수에 해당
⏱️ Time to Reset	초기화까지 남은 시간으로 사용량 제한(위의 지표)이 리셋되기까지 남은 시간임. (Pro-Plan의 경우 4h 1m~5h 리밋임)
🤖 Model Distribution	모델 분포로 사용 중인 Claude 모델의 종류와 비중을 나타냄 (/model을 입력하면 호출 모델을 변경할 수 있다. 기본은 Sonnet)
🔥 Burn Rate	소모 속도로 분당 토큰 소모량(tokens/min)입니다. 현재 분당 47.0개의 토큰을 쓰고 있으며, 옆의 달팽이(🐌) 아이콘은 소모 속도가 매우 낮음을 의미
💲 Cost Rate	비용 발생 속도로 분당 발생하는 비용($/min)임. 현재 분당 약 $0.0027의 비용이 발생
🔮 Predictions	예측값으로 현재의 소모 속도를 유지할 경우, **Tokens will run out(토큰 소진 시간)**은 오전 5시 6분으로 예상되며, **Limit resets at(한도 리셋 시간)**은 오후 6시 정각임을 알려줍니다.

 

 

이 외에 추가 옵션과 자세한 내용이 궁금하다면 다음 github를 참고:

https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor

GitHub - Maciek-roboblog/Claude-Code-Usage-Monitor: Real-time Claude Code usage monitor with predictions and warnings