내 Claude Code 사용량이 얼마나 남았지? 맥 메뉴바에서 실시간으로 보는 오픈소스 도구

Claude Code 사용량이 얼마나 남았지? 맥 메뉴바에서 실시간으로 보는 오픈소스 도구" style="width:100%;border-radius:12px;margin-bottom:24px;">

"지금 한도 얼마나 썼더라?"가 사라지는 도구

Claude Code로 코딩하다 보면 흐름 타고 신나게 작업하는데, 문득 이런 생각 드는 순간 있잖아요. "어… 나 지금 사용량 얼마나 쓴 거지? 곧 한도 차는 거 아냐?" 그렇다고 작업 멈추고 매번 어딘가 들어가서 확인하기는 귀찮고요. 이 답답함을 깔끔하게 풀어주는 작은 오픈소스 도구가 나왔어요. 바로 claude-quota라는 macOS 메뉴바 앱이에요.

이게 뭐냐면, 맥 화면 맨 위 메뉴바(시계랑 와이파이 아이콘 있는 그 줄)에 Claude Code 사용량 게이지를 작게 띄워주는 도구예요. 브라우저 열 필요도, 명령어 칠 필요도 없이 그냥 눈만 슬쩍 올리면 지금 내가 한도를 얼마나 썼는지 한눈에 보이는 거죠. 자동차 계기판에 연료 게이지 있는 것처럼, 코딩하다가 위로 시선만 올리면 '연료'가 얼마나 남았는지 바로 확인되는 셈이에요.

어떻게 동작하나

핵심 아이디어는 단순하면서도 똑똑해요. 메뉴바라는, 항상 떠 있지만 거슬리지 않는 공간을 활용한다는 점이에요. 게이지(gauge)는 말 그대로 막대나 원형으로 비율을 보여주는 시각 요소인데, 숫자로 "87%" 이렇게 보는 것보다 막대가 점점 차오르는 걸 보는 게 직관적으로 훨씬 빨리 와닿거든요. 사람 뇌가 숫자보다 '얼마나 찼나'라는 면적·길이를 더 빠르게 인식하니까요.

이런 메뉴바 유틸리티들은 보통 백그라운드에서 주기적으로 사용량 데이터를 읽어와서 아이콘을 갱신하는 방식으로 돌아가요. 무겁게 상주하는 프로그램이 아니라, 가볍게 띄워두고 잊고 지내다가 필요할 때만 눈에 들어오는 구조죠. 그리고 GitHub에 공개된 오픈소스라는 점도 좋아요. 코드가 다 공개돼 있으니 내 사용량 데이터를 어디로 보내는 건 아닌지 직접 확인할 수 있고, 마음에 안 드는 부분은 직접 고쳐서 쓸 수도 있어요. 사용량 같은 민감한 정보를 다루는 도구일수록 이렇게 내부가 투명한 게 안심되죠.

업계 맥락에서 보면

사실 '메뉴바에 작은 정보를 띄우는' 유틸리티 문화는 맥 생태계에서 꽤 오래된 전통이에요. CPU 온도, 네트워크 속도, 배터리 상태, 환율, 심지어 주식 시세까지 메뉴바에 올려두는 앱들이 예전부터 사랑받아 왔거든요. claude-quota는 그 익숙한 패턴을 'AI 코딩 도구 사용량'이라는 새로운 영역에 적용한 거예요.

흥미로운 건, AI 코딩 도구가 일상이 되면서 이런 'AI 사용량을 관리하고 시각화하는' 주변 도구들이 하나의 작은 생태계를 이루기 시작했다는 점이에요. 터미널에서 토큰 소비를 추적하는 CLI 도구나, 비용을 대시보드로 보여주는 서비스들도 속속 등장하고 있죠. 한도가 정해진 구독형 AI 도구를 효율적으로 쓰려는 수요가 이런 도구들을 만들어내고 있는 거예요.

한국 개발자에게 주는 시사점

맥으로 Claude Code 쓰는 분이라면 이건 그냥 깔아두면 손해 볼 게 없는 종류의 도구예요. 작업 흐름을 끊지 않으면서 사용량을 관리할 수 있으니, 특히 한도가 빡빡하게 느껴지던 분들한테 체감이 클 거예요. "중요한 작업 시작하기 전에 한도부터 확인"하는 습관을 게이지 하나로 자연스럽게 만들 수 있거든요.

그리고 더 큰 배움은 따로 있어요. 이 프로젝트는 "작지만 진짜 가려운 곳을 긁어주는 도구"가 어떻게 만들어지는지를 보여주는 좋은 사례예요. 거창한 기능 없이, '메뉴바 + 사용량 API + 게이지' 조합만으로 사람들이 반기는 물건이 됐잖아요. 사이드 프로젝트를 고민 중이라면, 본인이 매일 쓰는 도구에서 느끼는 작은 불편함을 메뉴바 앱이나 CLI로 풀어보는 것부터 시작하면 좋아요. 이런 도구는 코드 양도 적고, 오픈소스로 공개하면서 다른 사람의 기여도 받아볼 수 있어 학습용으로도 제격이고요.