v1.3.0

변경 사항

메뉴바 2줄 표시

아이콘을 제거하고, 5시간/주간 사용량을 동시에 표시합니다.

10%[5h]
28%[Wk]

• 정수 퍼센트 + 짧은 레이블로 컴팩트하게 표시
• 커스텀 NSView 레이아웃으로 수직 중앙 정렬

이전 버전 포함

• v1.2.0: 커스텀 앱 아이콘 (게이지 + CC 모노그램)
• v1.1.0: 에러 메시지 세분화 (로그인/토큰/네트워크/파싱별 안내)

설치

curl -sL https://raw.githubusercontent.com/NewTurn2017/ccusage/main/install.sh | bash

v1.2.0

변경 사항

커스텀 앱 아이콘 추가

Spotlight/Finder 검색 시 기본 아이콘 대신 CCUsage 전용 아이콘이 표시됩니다.

• 다크 네이비 배경 + 초록→주황→빨강 게이지 아크
• 중앙 CC 모노그램
• macOS 전체 사이즈 지원 (16px ~ 1024px @2x)

에러 메시지 세분화 (v1.1.0)

• 로그인 필요 / 토큰 만료 / 네트워크 오류 / 파싱 실패별 한국어 안내

설치

curl -sL https://raw.githubusercontent.com/NewTurn2017/ccusage/main/install.sh | bash

v1.1.0

변경 사항

에러 메시지 세분화

기존 "Unable to fetch usage data" 대신 원인별 구체적인 안내 메시지를 표시합니다.

상황	메시지
로그인 필요	Claude Code에 로그인하세요 (claude login)
토큰 만료	인증 만료 — claude login으로 재로그인하세요
네트워크 오류	API 연결 실패 — 네트워크를 확인하세요
응답 파싱 실패	API 응답을 처리할 수 없습니다

설치

curl -sL https://raw.githubusercontent.com/NewTurn2017/ccusage/main/install.sh | bash

v1.0.0

CCUsage v1.0.0

Claude Code 사용량을 macOS 메뉴바에서 실시간 모니터링하는 미니멀 앱

기능

• 5시간 / 주간 사용량 퍼센트 표시
• 색상 구분 (🟢 정상 → 🟠 70%+ → 🔴 90%+)
• 리셋 시간 표시 (24h 이내: 1h 32m / 초과: Feb 13 AM 10:00)
• 30초 자동 갱신
• Universal Binary (Apple Silicon + Intel)

설치

터미널 한 줄:

curl -sL https://raw.githubusercontent.com/NewTurn2017/ccusage/main/install.sh | bash

수동 설치:

1. 아래 CCUsage.zip 다운로드
2. 압축 풀고 /Applications로 이동
3. 우클릭 → 열기 (최초 1회)

조건

• macOS 14 (Sonoma)+
• Claude Code CLI 로그인 상태