cc-menubar 공개: Claude Code 비용을 메뉴바에서 바로 확인하기

Claude Code로 하루 종일 작업하다 보면 "지금까지 얼마 썼지?"가 문득 궁금해집니다. 그때마다 터미널을 열고 ccusage를 치는 게 은근히 번거롭죠. 방금 오픈소스로 공개한 cc-menubar는 그 한 줄을 대신 눌러주는 도구예요. Claude Code(와 Codex) 사용량과 비용을 macOS 메뉴바에 늘 띄워두면, 화면 오른쪽 위만 힐끗 보면 됩니다.

메뉴바

이 글에서는 cc-menubar가 정확히 무엇을 보여주는지, 어떻게 만들어졌는지, 어떻게 설치하는지를 정리했습니다. Claude Code 비용이 신경 쓰이는 분이라면 5분만 투자해 보세요.

cc-menubar란 무엇인가요?

cc-menubar는 Claude Code와 Codex의 사용량·비용을 터미널 없이 macOS 메뉴바에서 확인하는 네이티브 Swift 앱입니다. 오늘·이번 주·이번 달·누적 지출을 USD와 원화로 상시 표시하고, 데이터는 ccusage에서 가져옵니다. MIT 라이선스로 공개돼 있습니다.

핵심은 "이미 잘 만들어진 계산기(ccusage)를 눈에 잘 보이는 자리에 붙여둔다"는 발상입니다. cc-menubar가 사용량을 직접 계산하지는 않습니다. ccusage가 계산한 값을 받아서 메뉴바에 예쁘게 얹어주는 역할이죠.

그래서 오해하면 안 되는 지점이 하나 있어요. cc-menubar는 비용을 자동으로 줄여주는 도구가 아닙니다. 지출을 "보이게" 만들어 스스로 판단하도록 돕는 가시화 도구입니다. 얼마 쓰는지 눈에 보이면 씀씀이를 조절하기 훨씬 쉬워지니까요.

무겁지 않게, 단일 바이너리 하나로

요즘 메뉴바 앱은 Electron으로 만드는 경우가 많습니다. 편하긴 한데 메모리를 꽤 잡아먹죠. cc-menubar는 다른 길을 택했습니다.

단일 Swift 바이너리 하나, 크기는 약 800KB입니다.
Electron도, 상시 도는 무거운 런타임도 없습니다.
앱을 쓰기 위해 별도로 npm install을 돌릴 필요도 없습니다.

데이터를 가져올 때도 조용합니다. cc-menubar는 npx ccusage --json --offline을 호출하는데, --offline 옵션이라 네트워크 통신이 0입니다. 사용량 데이터는 이미 로컬에 쌓여 있으니 밖으로 나갈 이유가 없죠. 이메일이나 토큰, 개인정보를 어디로도 전송하지 않습니다. 전부 로컬에서 끝납니다.

메뉴바에서 무엇이 보이나요?

메뉴바 한 줄에 담기는 정보가 생각보다 많습니다. 좁은 공간을 로테이션으로 활용해요.

오늘 / 주 / 월 / 누적 지출 (USD + KRW 병기)
총 토큰 수
병렬로 돌고 있는 세션 수
그 순간 비용이 가장 큰 모델

여기에 초록색 펄스닷과 지출 스파크라인이 함께 떠서, 지금 뭔가 활발히 돌아가고 있는지 한눈에 감이 옵니다.

메뉴바를 클릭하면 드롭다운이 열리고, 더 자세한 그림이 나옵니다.

대시보드

최근 14일 지출 차트
일별 추이
모델별 비용 (Claude와 Codex를 나란히 비교)

Claude Code 사용량 추적을 하다 보면 "이번 주에 유독 많이 나왔는데 왜지?" 싶을 때가 있는데, 일별 추이와 모델별 비용을 보면 원인을 짚기 쉽습니다.

teamclaude 계정 헬스까지 한 화면에

여러 계정을 로테이션하며 쓰는 분들을 위한 기능도 있습니다. cc-menubar는 teamclaude의 계정 헬스를 드롭다운에 보여줍니다.

teamclaude 로테이션

14개 계정 로테이션의 상태를 각 계정별로 확인할 수 있어요.

계정별 사용률
쿼터 경고
리셋 시각

여기서 teamclaude는 별도로 공개된 오픈소스이며, cc-menubar의 선택적 의존성입니다. teamclaude를 쓰지 않는다면 이 부분은 없이도 사용량·비용 확인은 그대로 됩니다.

편의 기능도 몇 가지 넣었습니다. 드롭다운에서 원클릭으로 Claude OAuth 계정을 추가하거나 프록시를 재시작할 수 있어요. 자주 하는 동작을 손이 덜 가게 만들었습니다.

설치 방법

macOS 13 이상, Apple Silicon 전용입니다. 빌드에는 Xcode Command Line Tools(swiftc)가, 실행에는 Node/npx가 필요합니다.

기본 설치는 세 단계예요.

git clone https://github.com/sangrokjung/cc-menubar
cd cc-menubar
bash build.sh
bash install.sh

install.sh는 LaunchAgent를 등록해서 로그인 시 자동으로 시작하고, 꺼지면 자동으로 다시 살아나게 해줍니다. 한 번 설치하면 신경 쓸 일이 거의 없죠.

그냥 한 번만 띄워보고 싶다면 설치 없이 이렇게 실행해도 됩니다.

./.build/cc-menubar &

한 가지 미리 알아둘 점이 있어요. cc-menubar는 코드 서명이 없습니다. 그래서 처음 실행할 때 macOS Gatekeeper가 확인을 요청할 수 있습니다. 이건 서명되지 않은 앱을 처음 열 때 나오는 일반적인 절차이니, 시스템 설정에서 실행을 허용해 주면 됩니다.

어떤 분에게 맞을까요?

정리하면 이런 상황에 잘 맞습니다.

Claude Code나 Codex를 매일 쓰면서 비용이 궁금한데 매번 터미널 명령을 치기 귀찮은 분
이미 ccusage를 쓰고 있는데 ccusage 메뉴바 형태로 늘 띄워두고 싶은 분
여러 계정을 로테이션하며 쿼터·리셋 시각을 관리해야 하는 분
Electron 없이 가볍게 도는 네이티브 앱을 선호하는 분

반대로 cc-menubar가 비용을 알아서 줄여주길 기대한다면 방향이 다릅니다. 이 도구는 판단의 재료를 눈앞에 놓아줄 뿐, 절감은 사용자의 몫이에요. 다만 "보이면 관리된다"는 말처럼, 지출이 상시 보이는 것만으로도 습관은 꽤 달라집니다.

마무리

cc-menubar는 거창한 도구가 아닙니다. ccusage가 계산한 사용량과 비용을 메뉴바라는 가장 잘 보이는 자리에 얹어, 매번 터미널을 여는 마찰을 없앤 작은 앱이에요. 800KB 바이너리 하나, 네트워크 0, 전부 로컬. 그게 전부입니다.

MIT 라이선스로 공개돼 있으니 소스를 직접 뜯어보거나 기여하셔도 좋습니다. Claude Code로 일하는 시간이 길수록, 그 비용이 눈에 보이는 값이 커집니다. 오늘 한 번 설치해 두고, 내일부터는 힐끗 보는 것만으로 관리해 보세요.

마지막으로, 이 앱은 훌륭한 오픈소스 위에 서 있습니다. 사용량 계산의 핵심인 ccusage(by ryoppippi)와 계정 로테이션의 teamclaude(by jung-wan-kim)에 감사드립니다.

자주 묻는 질문 (FAQ)

Q: cc-menubar가 제 사용량 데이터를 외부로 보내나요?

아니요. cc-menubar는 npx ccusage --json --offline으로 데이터를 가져오며, --offline 옵션이라 네트워크 통신을 하지 않습니다. 이메일·토큰·개인정보를 어디로도 전송하지 않고 전부 로컬에서 처리합니다.

Q: ccusage 없이도 cc-menubar만 쓸 수 있나요?

cc-menubar는 사용량과 비용 데이터를 ccusage에서 받아옵니다. 즉 ccusage가 데이터 출처예요. cc-menubar가 직접 계산하는 것이 아니라 ccusage의 결과를 메뉴바에 표시하는 구조입니다.

Q: 어떤 환경에서 동작하나요?

macOS 13 이상, Apple Silicon 전용입니다. 빌드에는 Xcode Command Line Tools(swiftc), 실행에는 Node/npx가 필요합니다. 코드 서명이 없어 첫 실행 시 macOS Gatekeeper 확인이 필요할 수 있습니다.

Q: teamclaude는 꼭 설치해야 하나요?

아니요. teamclaude는 계정 로테이션 헬스를 보여주기 위한 선택적 의존성입니다. teamclaude를 쓰지 않아도 사용량·비용 확인 기능은 그대로 동작합니다.

Q: cc-menubar가 Claude Code 비용을 자동으로 줄여주나요?

아니요. cc-menubar는 비용을 가시화하는 도구이지 자동으로 절감하는 도구가 아닙니다. 지출을 상시 보이게 만들어 사용자가 스스로 판단하도록 돕습니다.

cc-menubar 공개: Claude Code 비용을 메뉴바에서 바로 확인하기