Claude 사용량 사이드바
Claude Code 와 Codex 의 남은 한도를 화면 가장자리에 얇게 붙여 둡니다. 마우스를 갖다 대면 자세히 펼쳐집니다.
표시하는 것
- CH — Claude 5시간 세션 한도
- CW — Claude 주간 한도 (전체 모델)
- CF — Claude 주간 한도 (모델 전용, 계정에 따라 뒷 글자가 바뀝니다)
- GH · GW — Codex 의 5시간대 · 주간대 한도 (Codex CLI 설치 필요)
Claude Code 나 Codex 를 켜면 저절로 나타나고, 다 끄면 사라집니다. 크레딧 잔액은 펼친 패널에 글로 나옵니다. 85% 를 넘긴 항목은 빨갛게 깜빡입니다.
설치
방법 1 — 내려받아 실행
위 버튼으로 받은 zip 을 풀고 실행합니다. 설치 과정은 없습니다.
- zip 을 풀고
ClaudeSidebar.exe를 실행합니다. - 파란 경고창이 뜨면 추가 정보 → 실행. 코드 서명 인증서가 없어서 뜨는 것입니다.
- “You must install or update .NET” 창이 뜨면 .NET 8 데스크톱 런타임이 없는 것입니다.
그 창의 링크 대신 아래 명령이 확실합니다 — 반드시 Desktop 런타임이어야 합니다.
winget install Microsoft.DotNet.DesktopRuntime.8
Node 가 있다면 내려받기 없이 한 줄로도 됩니다.
npx github:new-moon87/claude-usage-sidebar install방법 2 — Claude 에 붙여넣기
아래를 복사해 Claude Code 에 그대로 붙여넣으면 런타임 확인부터 실행까지 알아서 합니다.
Claude 사용량 사이드바를 이 PC에 설치해줘.
1. https://claude-usage-sidebar.vercel.app/version.json 을 받아 downloadUrl 과 sha256 을 확인한다.
2. `dotnet --list-runtimes` 로 Microsoft.WindowsDesktop.App 8.x 가 있는지 확인하고,
없으면 `winget install Microsoft.DotNet.DesktopRuntime.8` 로 설치한다.
3. downloadUrl 의 zip 을 받아 sha256 을 대조한다. 값이 다르면 중단하고 알려준다.
4. ClaudeSidebar 프로세스가 실행 중이면 종료한다.
5. zip 을 %LOCALAPPDATA%\ClaudeSidebar\ 에 풀고 ClaudeSidebar.exe 를 실행한다.
6. 프로세스가 떠 있는지 확인하고 설치 결과를 알려준다.
설치 뒤에는 시작할 때 스스로 새 버전으로 갱신하므로 다시 설치할 필요는 없다.필요한 것
- Windows 10 이상 (64비트)
- .NET 8 데스크톱 런타임 (방법 2 는 없으면 알아서 설치합니다)
- Claude Code — 데스크톱 앱 권장. 자동 표시/숨김이 이 앱 실행을 보고 판단합니다.
- Claude Code 에 한 번 로그인. 이력이 없으면 패널의 “Claude 로그인 필요” 를 눌러 터미널을 열 수 있습니다.
한 번 설치하면 그 뒤로는 새 버전이 나올 때 시작하면서 스스로 갱신합니다. 이 페이지를 다시 찾아올 필요가 없습니다.