상태 표시줄에서
Claude Code 프롬프트 아래에서 컨텍스트가 얼마나 찼는지, 세션이 쓴 토큰과 비용, 그리고 두 한도와 초기화까지 남은 시간을 보여 줍니다. Claude Code가 실행되는 곳이면 어디서나 동작합니다.
Claude Usage버전 1.0.0
Claude 사용 한도, 늘 눈앞에
프롬프트 아래의 상태 표시줄과 데스크톱의 유리 질감 위젯이 5시간·주간 한도, 초기화 시점, 세션별 비용을 보여 줍니다.
Windows 10/11 · macOS 13 이상 · zip 하나에 설치 프로그램 두 개
- 무료
- 로컬에서 동작
- GitLab 소스 코드
지켜보는 두 가지 방법
데스크톱에서
작은 플로팅 카드가 두 한도를 초록·주황·빨강으로 보여 주고, 현재 구간이 얼마나 지났는지도 표시합니다. 이 속도로는 초기화 전에 한도가 바닥날 것 같으면 언제인지 알려 줍니다.
- 여유 있음
- 한도 근접
- 거의 소진
작지만 쓸모 있는 것들
원하는 곳에 두세요
어디로든 끌어다 놓고, 다른 창 위에 고정하거나 트레이·메뉴 막대로 숨길 수 있습니다.
Claude Code와 함께 실행
첫 세션과 함께 시작되며, 원하면 로그인할 때 시작하도록 설정할 수 있습니다.
트레이 속 링
트레이·메뉴 막대 아이콘이 5시간 사용량에 따라 차오르고 색이 바뀝니다.
내 언어로
12개 언어를 지원하며, 시스템 언어를 따르거나 메뉴에서 고를 수 있습니다.
필요하면 조용하게
애니메이션은 메뉴에서 끌 수 있습니다.
기록은 스스로 보관
Claude Code는 오래된 세션 로그를 일정 기간 뒤 삭제합니다. 위젯은 첫 실행부터 자체 장부를 남기므로 기록이 사라지지 않습니다.
지출과 모델
통계 보기를 열면 전체 그림이 보입니다. 세션을 API 가격으로 계산한 일·주·월별 비용과 모델별 비중을 확인할 수 있습니다.
스크린샷: 데모 데이터를 사용한 Windows 위젯. macOS 위젯도 같은 기능을 제공합니다. 설치 중에 사용자의 Mac에서 빌드되므로 여기에는 스크린샷이 없습니다.
세션 하나하나 빠짐없이
Claude Code 세션마다 한 줄씩: 제목, 프로젝트, 시간, 토큰, 비용을 최신순으로 보여 줍니다. 비용이 큰 세션은 한눈에 들어옵니다.
1분이면 설치 끝
zip 하나에 설치 프로그램이 둘 다 들어 있습니다. 사용 중인 시스템용을 실행하세요.
Windows 10 및 11내 시스템
- zip을 내려받아 압축을 풀고 claude-usage 폴더를 엽니다.
- install.cmd를 더블클릭하거나 PowerShell에서 다음을 실행합니다.
powershell -ExecutionPolicy Bypass -File install.ps1 - Claude Code를 다시 시작하세요. 프롬프트 아래에 상태 표시줄이 나타나고 첫 세션과 함께 위젯이 열립니다. 한도는 첫 응답 이후에 채워집니다.
macOS 13 이상내 시스템
- 처음 한 번: Xcode Command Line Tools를 설치합니다. 위젯은 설치 중에 사용자의 Mac에서 빌드됩니다.
xcode-select --install - 내려받은 파일의 압축을 풀고, claude-usage 폴더에서 터미널로 다음을 실행합니다.
bash install.sh - Claude Code를 다시 시작하세요. 프롬프트 아래에 상태 표시줄이 나타나고 첫 세션과 함께 위젯이 열립니다. 한도는 첫 응답 이후에 채워집니다.
필요한 것만
상태 표시줄만 필요하세요? 위젯 없이 설치할 수 있습니다. 이미 설치했다면 위젯 메뉴에서 상태 표시줄을 끄거나, 위젯이 Claude Code와 함께 시작되지 않게 할 수 있으며 나머지는 계속 동작합니다.
Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -NoWidgetmacOS
bash install.sh --no-widget위젯을 직접 열려면 시작 메뉴(Windows) 또는 응용 프로그램(macOS)에서 Claude Usage를 찾으세요. 숨겨져 있다면 트레이 또는 메뉴 막대 아이콘을 클릭하세요.
업데이트 또는 제거
업데이트
위젯은 하루에 한 번 이 사이트에 새 버전이 있는지 물어봅니다. 있으면 새로 고침 버튼에 점이 나타나고 메뉴에 업데이트 항목이 생깁니다. 요청에는 버전과 시스템만 담기며, 메뉴에서 끌 수 있습니다.
- 이 페이지에서 새 zip을 내려받습니다.
- 설치 프로그램을 다시 실행하세요. 기록과 설정은 그대로 유지됩니다.
제거
mod, 위젯, 바로 가기를 제거합니다.
Windows
powershell -ExecutionPolicy Bypass -File install.ps1 -UninstallmacOS
bash install.sh --uninstall기록을 남기려면 -KeepHistory(Windows) 또는 --keep-history(macOS)를 붙이세요.
모든 것이 로컬
한도는 상태 표시줄이 사용자의 컴퓨터에 기록하는 파일에서, 지출 기록은 Claude Code의 세션 로그에서 읽어 옵니다. 업로드되는 것은 없고 계정이나 로그인도 없습니다. 위젯이 보내는 것은 업데이트 확인뿐입니다.
필요한 것
- Windows 10 또는 11, 또는 macOS 13 이상
- mod를 지원하는 Claude Code(2.1.296에서 테스트). mod API는 얼리 액세스 단계라 릴리스 사이에 바뀔 수 있습니다.
- Pro 또는 Max 구독: 한도는 계정에서 가져옵니다.
- 지출 기록에는 Node.js가 필요합니다. 없어도 한도는 표시됩니다.
- macOS에서는 Xcode Command Line Tools가 필요합니다. 위젯이 설치 중에 사용자의 Mac에서 빌드되기 때문입니다.
숫자 읽는 법
- 한도는 Claude가 응답할 때마다 알려 주는 백분율이므로, 어느 세션에서든 Claude Code를 사용할 때 갱신됩니다.
- 비용은 같은 토큰을 API 가격으로 계산했을 때의 금액입니다. 구독은 이렇게 청구되지 않으며, 구독으로 얼마나 뽑아 쓰는지를 보여 줍니다.
- 기록은 Claude Code의 로컬 세션 로그에서 읽습니다. 위젯은 첫 실행부터 자체 장부를 쌓으며, 그 이전 기간은 추정치로 연하게 표시됩니다.
바닥나기 전에 먼저 알아보세요.
무료, 오픈 소스, 조용함: 보기 전까지는 구석에 가만히 있습니다.
Windows 10/11 · macOS 13 이상 · zip 하나에 설치 프로그램 두 개