Rate Limit 가시화를 통한 토큰 소모 속도 최적화 도구 구현

Context

Claude Code의 Token 사용량 제한 정책 변화로 인해 5시간 단위 제한보다 7일 단위 Weekly Cap의 제약 사항이 더 빈번하게 발생함. 단순 사용량 확인만으로는 현재 소모 속도가 적정 수준인지 판단하기 어려운 모니터링 한계 존재.

Technical Solution

• Bash 및 jq를 활용한 JSON 기반 Rate Limit 데이터 파싱 구조 설계
• 실제 사용량(Actual)과 시간 경과에 따른 이상적 사용량(Ideal)을 대조하는 Tortoise-and-Hare 알고리즘 적용
• 7일(604,800s)과 5시간(18,000s) 윈도우에 대해 서로 다른 가중치(W7=20, W5=10)를 부여한 가변 길이 Progress Bar 구현
• (Total_Window - Remaining_Time) * Width / Total_Window 수식을 통한 실시간 Ideal 지점 계산 로직 포함
• 사용량이 Ideal 지점을 초과할 경우 ⚠️ 경고 표시 및 🐇 아이콘의 바깥쪽 배치를 통한 시각적 Alert 체계 구축
• Timezone 설정을 통한 사용자 로컬 시간 기준의 Reset 시점 동기화 처리