Claude Code 할당량 소모 프로젝트 확인 방법

제가 Claude Code 5시간 또는 주간 한도에 도달했을 때, 어떤 프로젝트가 이 한도를 사용했는지 알고 싶습니다. /usage 명령어는 이를 알려주지 않습니다. 그 명령어는 계정 전체의 백분율과 ">150k context"나 "4+ parallel sessions" 같은 몇 가지 태그만 보여줄 뿐입니다. 프로젝트별로 세부 내역이 나뉘어 있지 않아, 이 백분율들을 다른 것과 비교해 볼 수가 없습니다.

Claude Code는 이미 모든 로컬 세션 기록 파일(~/.claude/projects/*/*.jsonl)에 메시지당 토큰 사용량을 작성하고 있습니다. 그래서 저는 그 파일을 읽어서 프로젝트별, 스킬별로 사용량을 나누어 보여주는 플러그인, quota-audit를 만들었습니다. 또한 할당량 제한(rate limit)에 도달한 정확한 시간과 어떤 저장소(repo)가 차단되었는지도 보여줍니다. 모든 것은 사용자 기기에 남아있습니다. 이 파일들만 읽을 뿐, 어딘가로 아무것도 전송하지 않습니다.

보고서의 구성

몇 가지 계산된 발견 사항으로 시작합니다. 그 다음으로는 창(window)별(5시간, 24시간, 7일) 개요 행이 하나씩 나오고, 가장 긴 기간에 대한 상세 내역이 나옵니다. 간략화한 예시는 다음과 같습니다:

KEY FINDINGS (7d window)
  • 예상 비용 $147.31, 그 중 65%가 my-app ($95.20)에서 발생
  • 가장 많이 사용된 스킬은 ai-work로 54%
...

스킬은 세션이 시작될 때 어떤 명령어로 시작했는지에 따라 할당되는 것이 아니라, 메시지별로 할당되기 때문에 명시된 스킬과 일반적인 상호작용 사용 간의 분할 비율이 유지됩니다. 150k context를 초과한 세션들은 가장 비용이 많이 드는 것부터 이름으로 나열되는데, 이것이 보통 가장 큰 변수이기 때문입니다. 할당량 제한에 도달한 기록은 저장소별, 시간대별로 그룹화되어 있습니다.

또한 브라우저 탭이나 스크립트를 열어두고 몇 분 간격으로 무언가를 호출하는 것과 같은 폴링 루프(polling loops)에 대한 확인 기능도 있습니다. 이러한 루프는 실제 할당량을 소모하지 않으면서 세션 카운트만 부풀립니다. 모든 창의 상세 내역과 개별 기록을 보려면 render.py에 --full 옵션을 전달하세요.

사용해 보기

현재 버전은 v1.3.0입니다. 상호작용 Claude Code 세션 내부에서는:

/plugin marketplace add rosehsu47/claude-code-quota-audit
/plugin install quota-audit@rosehsu47

또는 비상호작용 방식으로:

claude plugin marketplace add rosehsu47/claude-code-quota-audit
claude plugin install quota-audit@rosehsu47

설치 요약에 Run /reload-plugins to activate라고 되어 있다면, 해당 명령을 실행하세요. 그 후에 “누가 내 할당량을 먹고 있는지” 또는 “어떤 저장소가 내 5시간 제한을 소진하고 있는지”와 같은 질문을 하거나 /quota-audit를 직접 호출할 수 있습니다. 보고서는 사용자의 로케일 설정에 따라 영어 또는 번체 중국어로 나옵니다. 특정 언어를 강제하려면 QUOTA_AUDIT_LANG=en 또는 QUOTA_AUDIT_LANG=zh로 설정하세요.

할 수 없는 것들

달러($) 금액은 플러그인에 포함된 가격 스냅샷을 기반으로 한 추정치입니다. 이것이 청구서가 아닙니다. 저는 절대적인 총액보다는 프로젝트 간의 비율을 더 신뢰할 것이며, 전체 합계는 라이브 claude -p "/usage"와 비교해 볼 것입니다. 프로젝트별 서브 에이전트 비용은 제공되지 않습니다. /usage와 마찬가지로, 이 플러그인은 실행되는 기기만 보고 다른 장치나 claude.ai는 볼 수 없습니다.

코드는 github.com/rosehsu47/claude-code-quota-audit에 있으며, 다른 사람들이 자신의 할당량이 어디로 쓰이는지 어떻게 알아내는지 듣고 싶습니다.