[Hacker News 요약] macOS 메뉴 바에서 Claude Code 할당량 시각화 플러그인 출시
28
설명
Claude Code 사용자는 이제 macOS 메뉴 바에서 실시간으로 코드 생성 할당량 사용량을 추적할 수 있습니다.
SwiftBar 플러그인으로 개발된 이 도구는 5시간 및 주간 할당량 사용량을 시각적으로 표시합니다.
이를 통해 사용자는 할당량 초과를 방지하고 효율적인 사용 계획을 세울 수 있습니다.
### 배경 설명
Anthropic의 Claude Code는 개발자가 AI를 활용하여 코드를 작성하고 개선하도록 돕는 강력한 도구입니다. 그러나 많은 AI 기반 코드 생성 서비스와 마찬가지로 Claude Code 역시 사용량에 대한 할당량 제한이 존재합니다. 특히 5시간 창 내 사용량과 주간 총 사용량에 대한 제한은 사용자가 예상치 못한 비용 발생이나 서비스 중단을 경험하지 않도록 주의 깊게 관리해야 합니다. 기존에는 Claude Code 웹 인터페이스나 CLI를 통해 사용량을 확인해야 했기에, 실시간으로 현재 상태를 파악하기 어렵다는 불편함이 있었습니다. 이러한 배경 속에서 개발자들은 보다 직관적이고 편리한 사용량 모니터링 도구의 필요성을 느끼고 있었습니다.
### Claude Code 할당량 시각화 플러그인 소개
이 프로젝트는 macOS 사용자를 위한 SwiftBar 플러그인으로, Claude Code의 5시간 및 주간 할당량 사용량을 메뉴 바에 시각적으로 표시합니다. 각 계정별로 별도의 게이지 바가 제공되며, 사용량은 녹색(정상), 주황색(70% 이상), 빨간색(90% 이상)으로 구분됩니다. 5시간 창이 완전히 사용되면 남은 시간을 카운트다운하고, 주간 제한에 도달하면 주간 리셋까지 남은 시간을 표시합니다. 메뉴 바의 드롭다운 목록에서는 각 계정의 5시간 및 주간 창 사용량, 모델별 창 사용량, 추가 크레딧, 리셋 시간 등 상세 정보를 확인할 수 있습니다. 플러그인은 5분마다 자동으로 새로고침되며, 수동 새로고침 기능도 제공합니다.
### 설치 및 작동 방식
설치는 매우 간편합니다. Homebrew가 설치된 macOS 환경에서 제공되는 `install.sh` 스크립트를 실행하면 됩니다. 스크립트는 SwiftBar를 자동으로 설치하고 로그인 항목에 추가하여 재부팅 후에도 플러그인이 자동으로 실행되도록 설정합니다. 플러그인은 macOS Keychain에 저장된 Claude Code OAuth 토큰을 읽어와 사용량 엔드포인트에 접근합니다. 이 과정에서 토큰을 새로고침하거나 다시 쓰지 않으므로 보안상 안전하며, 비밀번호나 스크래핑, 제3자 서비스가 필요 없습니다. 만약 계정 토큰이 만료되면 ⚠ 표시가 나타나며, 해당 계정으로 Claude CLI를 한 번 실행하면 문제가 해결됩니다.
### 계정 관리 및 사용자 정의
기본적으로 플러그인은 `~/.claude` 또는 `~/.claude-*`와 같은 설정 디렉토리를 자동으로 감지하여 해당 계정의 사용량을 표시합니다. 계정 이름은 디렉토리 접미사를 사용하여 표시됩니다(예: `~/.claude-work`는 'W'로 표시). 여러 `CLAUDE_CONFIG_DIR`을 사용하는 경우, `~/.config/claude-quota/accounts` 파일에 `[레이블]` 형식으로 경로를 지정하여 계정을 고정하거나 이름을 변경할 수 있습니다. 특정 계정의 메뉴 바 게이지를 숨기고 싶다면 드롭다운 메뉴에서 'Hide from menu bar' 옵션을 선택하거나 `~/.config/claude-quota/hidden` 파일에 레이블을 추가하면 됩니다.
### 가치와 인사이트
이 SwiftBar 플러그인은 Claude Code 사용자에게 실질적인 가치를 제공합니다. 개발자는 더 이상 웹 인터페이스를 열거나 CLI 명령을 실행할 필요 없이, 메뉴 바에서 실시간으로 자신의 코드 생성 할당량 상태를 즉각적으로 파악할 수 있습니다. 이는 할당량 초과로 인한 예기치 못한 비용 발생이나 작업 중단을 방지하는 데 크게 기여하며, 특히 여러 Claude Code 계정을 사용하는 사용자에게는 각 계정의 사용량을 효율적으로 관리할 수 있는 강력한 도구가 됩니다. 또한, 사용량 임계값에 따른 색상 구분과 카운트다운 기능은 직관적인 이해를 돕고, 상세 정보 드롭다운은 심층적인 분석을 가능하게 합니다. 이는 개발 워크플로우의 생산성을 향상시키는 데 직접적인 영향을 미칩니다.
### 기술·메타
- 언어: Python, Shell
- 프레임워크/도구: SwiftBar, Homebrew, macOS Keychain
### 향후 전망
이 플러그인이 성공적으로 출시되고 사용자 기반이 확대된다면, 향후 몇 가지 방향으로 발전할 가능성이 있습니다. 첫째, Anthropic이 Claude Code의 사용량 추적 API를 변경하거나 개선할 경우, 플러그인 개발자는 이에 맞춰 업데이트를 제공해야 할 것입니다. 둘째, 다른 AI 코드 생성 서비스(예: GitHub Copilot, OpenAI Codex 등)의 할당량 관리 기능도 유사한 플러그인 형태로 확장될 수 있습니다. 셋째, 사용자 커뮤니티의 피드백을 바탕으로 더 많은 사용자 정의 옵션(예: 알림 설정, 특정 모델별 상세 추적 강화 등)이 추가될 수 있습니다. 현재는 Python과 Shell 스크립트 기반으로 개발되었으나, 향후 더 다양한 플랫폼이나 언어로 포팅될 가능성도 배제할 수 없습니다.
📝 원문 및 참고
- Source: Hacker News
- 토론(HN): [news.ycombinator.com](https://news.ycombinator.com/item?id=48473845)
- 원문: [링크 열기](https://github.com/grzegorz-raczek-unit8/claude-quota)
---
출처: Hacker News · [원문 링크](https://github.com/grzegorz-raczek-unit8/claude-quota)
신고 · 불법·유해·아동 안전(CSAE) 관련 콘텐츠
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.