Tare: Claude Code 토큰 사용량 및 할당량 제한 진단하기

Tare는 Claude Code에서 토큰 소비가 급증하고 할당량이 소진되는 원인을 식별하기 위해 설계된 로컬 우선(local-first) 진단 도구입니다. 사용자의 기기에 이미 저장된 세션 로그를 분석함으로써, Tare는 개발자가 평이한 영어로 사용 이력을 조회하여 정확히 어떤 파일, 도구 또는 자동화된 프로세스가 할당량을 소진시키고 있는지 확인할 수 있게 해줍니다.

토큰 감사 및 제한 진단

Tare는 단순한 토큰 수치를 넘어 사용량 급증의 근본 원인을 식별하기 위해 원시 세션 로그를 실행 가능한 통찰로 변환합니다. 이 도구는 다음과 같은 구체적인 운영 질문에 대한 답을 제공합니다:

할당량 소진: 사용자가 5시간 이동 창(rolling window) 제한에 걸렸는지 또는 주간 한도에 도달했는지 식별합니다.
토큰 귀속: 어떤 프로젝트, 모델 또는 특정 파일이 가장 많은 토큰을 소비하고 있는지 결정합니다.
uma 백그라운드 프로세스나 자동화된 스크립트가 비용을 부풀리는 병렬 세션을 생성하고 있는지 식별합니다.
최적화: /clear를 사용하여 컨텍스트를 초기화하는 것과 같은 전략을 구현하기 전후의 사용 패턴을 비교합니다.

고급 사용량 분석

단순한 토큰 계산 방식과 달리, Tare는 보고의 정확성을 보장하기 위해 여러 논리 계층을 구현합니다:

중복 제거: Claude Code의 로그 형식은 API 응답을 여러 번 반복하는 경우가 많습니다. Tare는 총합이 부풀려지는 것을 방지하기 위해 이를 중복 제거합니다(일부 사례에서는 최대 86%까지 차이가 날 수 있습니다).
문맥적 비용 산정: Tare는 파일 읽기 비용을 세션 내의 모든 후속 메시지에 귀속시킵니다. 이는 긴 세션 초기에 읽은 대용량 파일이 컨텍스트 창을 계속 점유한다는 점을 인식하기 때문입니다.
이동 창 추적: 이 도구는 5시간 이동 창을 추적하여 사용자가 차단되는 순간 할당량이 얼마나 찼는지 정확히 알려줍니다.
자동화 탐지: Tare는 수백 개의 짧은 병렬 세션의 특징을 인식합니다. 이는 일반적으로 인간의 상호작용보다는 스크립트를 나타냅니다.

개인정보 보호 및 기술적 요구 사항

Tare는 기본적으로 개인정보를 보호하도록 설계되었습니다. 모든 분석은 사용자의 기기에서 로컬로 수행되며, 스크립트는 네트워크 연결을 수행하지 않습니다. 공유 가능한 요약을 생성할 때, 도구는 프롬프트, 파일 경로 및 계정 식별자를 삭제(redact)하여 총합, 날짜 및 도구 이름만 제공합니다.

기술적 요구 사항:

OS: macOS 또는 Linux.
Runtime: Python 3.9+.
Compatibility: 현재 Claude Code 로그만 지원합니다.

설치 및 인터페이스

사용자는 다음 명령어를 사용하여 Tare를 Claude Code 스킬로 설치할 수 있습니다:

npx skills add kelviq/tare -g -y --copy --agent claude-code

설치 후, 사용자는 Claude Code 내에서 평이한 영어로 질의하거나 특정 슬래시 명령어를 통해 Tare와 상호작용할 수 있습니다:

커뮤니티 인사이트 및 대안

커뮤니티 논의에서는 토큰 제한의 "블랙박스" 특성에 대한 반복적인 어려움이 강조됩니다. 일부 사용자는 놀람을 방지하기 위해 실시간으로 사용량을 추적하기 위해 자신만의 커스텀 커스텀 상태 라인을 구현했습니다.

"I just used Claude to Claude를 사용하여 플러그인을 작성했는데, CLI의 하단이 다음과 같이 표시되도록 변경했습니다: ( ) Usage: {34%} (resets in 2h 47m) Context: 56%... That way if my usage starts shooting up, if my 사용량이 급증하기 시작하면, 그것을 알아차리기가 매우 쉽습니다."

다른 사용자들은 급격한 할당량 소진은 종종 여러 서브에이전트를 파산하는 개방형 요청이나 대용량 컨텍스트 캐시의 만료로 인해 발생하며, 이는 반복적인 고비용 읽기를 유발한다고 언급했습니다.