피드로 돌아가기
Dev.toDevOps
원문 읽기
Token Budget 소모 속도를 시각화한 Custom Status Line 설계
🐢 and 🐇 in My Claude Code Status Line
AI 요약
Context
Claude Code의 기본 JSON 상태 정보는 단순 퍼센트 수치만 제공하여 현재 시점의 소모 속도 판단이 어려움. 시간 경과에 따른 이상적인 소모율과 실제 사용량을 비교할 수 있는 직관적인 모니터링 체계 필요.
Technical Solution
- JSON Blob 데이터를 파싱하여 실시간 Token 사용량과 Reset 시점 데이터를 추출하는 Bash 스크립트 구현
- 5시간 윈도우(18,000초) 기준의 경과 시간을 계산하여 이상적 소모 지점(Ideal Position)을 산출하는 로직 설계
- 실제 소모량(Actual Position)과 이상적 지점을 1차원 바(Bar) 형태의 좌표로 매핑하여 🐢와 🐇 아이콘으로 시각화
- 실제 소모량이 이상적 지점을 초과할 경우 Warning(⚠️) 마커를 출력하는 조건부 렌더링 적용
- ~/.claude/settings.json 설정을 통한 외부 커맨드 실행 방식으로 Status Line 렌더링 파이프라인 구성
실천 포인트
1. API Rate Limit 모니터링 시 단순 잔여량보다 시간 대비 소모 속도(Burn Rate) 지표 도입 검토
2. CLI 도구의 상태 표시줄 설계 시 JSON 기반의 커스텀 커맨드 확장 가능 여부 확인
3. 사용자 경험 개선을 위해 추상적 수치를 직관적 메타포(아이콘, 바 차트)로 치환하는 UI 전략 적용