Claude Code 사용량 확인하려고 브라우저 탭 띄워두는 게 귀찮아서, 화면 가장자리에 두는 작은 모니터 앱을 만들었습니다 (Windows, 오픈 소스)

내 한도가 얼마나 남았는지 확인하려고 맨날 브라우저 탭 몇 개씩 띄워놓고 계속 왔다 갔다 하는 게 너무 귀찮더라고. 그래서 그냥 슥 보기만 해도 되는 사용량 모니터링 툴을 만들었어. 화면은 최대한 안 잡아먹으면서도 깔끔해 보이게 디자인하려고 애 좀 썼지.

결과물이 바로 OrbMet이야. 화면 구석에 붙어 있는 작은 검은색 바인데, 도구마다 링이 하나씩 달려 있어. 한도를 쓸수록 링이 차오르고, 진짜 신경 써야 할 때가 되면 노란색이나 빨간색으로 변해. 마우스를 올리면 모든 한도(5시간, 주간, 모델별)랑 초기화 시간, 그리고 남은 시간까지 싹 다 보여줘.

• Windows 10/11 지원, 무료 오픈 소스(MIT), 계정 필요 없음, 데이터 전송 일절 없음

• Claude Code는 자체 상태 표시줄을 통해 연결(클릭 한 번이면 끝, 기존 상태 표시줄은 그대로 유지되고 연결 해제하면 원래대로 복구됨)

• Codex는 codex app-server로 연결, 별도 설정 필요 없음

• 75/80/90/95% 알림 설정 가능, 접기 모드, 멀티 모니터 지원, 터미널 포커스 절대 안 뺏음

아직 코드 서명이 안 되어 있어서 처음 실행할 때 SmartScreen 경고가 뜰 거야. 왜 그런지, 다운로드한 파일 SHA-256 확인하는 법은 README에 적어놨어.

https://github.com/29ardayildiz/OrbMet

Claude Code의 도움을 엄청 많이 받아서 만들었어. 부족한 점이나 버그 있으면 알려줘.

Claude Code로 만든 과정

설계랑 전체적인 방향은 내가 잡았고, 실제 코드(C#, .NET 10, WPF)랑 테스트는 Claude Code가 거의 다 짰어. 나한테 잘 먹혔던 방법들은 이거야:

• 설계 문서랑 프로젝트 문서를 리포지토리에 넣어두고 Claude Code가 세션 시작할 때마다 읽게 했어. 덕분에 색상이나 데이터 없을 때 처리 방식, 바가 어디에 붙을지 같은 걸 매번 다시 논쟁할 필요가 없었지.

• 코드를 읽어서 추측하는 게 아니라 직접 측정해서 검증하게 시켰어. 바를 화면 밖에서 렌더링해 보거나, 실제 마우스 드래그 테스트를 하거나, 파서 짜기 전에 실제 제공자 응답을 먼저 읽어보는 식으로 말이야.

• 잘게 쪼개서 작업하기: 기능 하나 구현하고, 빌드하고, 테스트 돌리고, 디버그용으로 직접 써보고, 커밋하고. 벌써 테스트만 350개 정도 쌓였네.

만들면서 배운 점

• Claude Code는 상태 표시줄에만 사용 제한을 알려주더라고. 그래서 OrbMet은 상태 표시줄 도우미로 연결해서 기존 상태 표시줄은 그대로 살려두고, 연결 끊으면 원래대로 복구되게 만들었어.