Claude Token Tray

Claude의 5시간 사용 한도를 Windows 작업표시줄에 링 게이지로 상주시킵니다. 추정치가 아니라 /usage와 같은 실제 수치입니다.

50% 미만 초록, 50% 이상 노랑, 80% 이상 빨강. 1분마다 갱신되고, 아이콘을 클릭하면 5시간·7일 한도와 리셋까지 남은 시간이 풍선으로 뜹니다.

다운로드

두 파일(TrayGauge.exe, usage.js)은 같은 폴더에 두어야 합니다. exe가 옆에 있는 usage.js를 실행합니다.

준비물

1. Windows 10/11
2. Node.js 18 이상
3. 로그인된 Claude Code — 인증 토큰(~/.claude/.credentials.json)을 읽어 사용량을 조회합니다

설치

1. 두 파일을 원하는 폴더(예: C:\Tools\token-tray)에 저장합니다.
2. TrayGauge.exe를 실행합니다. 서명되지 않은 실행 파일이라 SmartScreen 경고가 뜨면 추가 정보 → 실행을 누르세요.
3. 부팅 시 자동 실행하려면 Win+R → shell:startup → 그 폴더에 exe 바로가기를 넣습니다.
4. 작업표시줄에 항상 표시하려면 숨김 아이콘(∧)에서 아이콘을 시계 옆으로 드래그합니다. 드래그가 먹지 않는 빌드에서는 아래 명령을 PowerShell에 붙여넣으세요.

Get-ChildItem 'HKCU:\Control Panel\NotifyIconSettings' | ForEach-Object {
  if ((Get-ItemProperty $_.PSPath).ExecutablePath -like '*TrayGauge*') {
    Set-ItemProperty $_.PSPath -Name IsPromoted -Value 1 -Type DWord
  }
}

직접 빌드하기

.NET Framework가 포함된 컴파일러만 있으면 됩니다. 별도 설치 없이 Windows에 기본 탑재되어 있습니다.

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe ^
  -target:winexe -out:TrayGauge.exe ^
  -reference:System.Windows.Forms.dll,System.Drawing.dll TrayGauge.cs

개인정보

인증 토큰은 로컬 파일에서 읽어 Anthropic의 사용량 API를 호출하는 데에만 쓰입니다. 다른 서버로 나가는 통신은 없고, 토큰을 저장하거나 기록하지 않습니다. 전체 동작은 usage.js 25줄과 TrayGauge.cs에서 그대로 확인할 수 있습니다.