Claude/Codex 사용량 확인이 귀찮아서 직접 만든 macOS 위젯
I built a tiny macOS widget because I was tired of checking Claude/Codex limits
핵심 요약
Claude와 Codex의 사용량 제한을 실시간으로 확인하기 위해 직접 개발한 macOS 위젯 소개.
- 사용량 모니터링 — Claude와 Codex의 사용 제한을 실시간으로 추적함
- 로컬 위젯 구현 — 별도의 서버 없이 로컬 데이터만 사용하여 개인정보를 보호함
- 기능 확장성 — 사용 패턴 학습과 상태 알림 등 다양한 편의 기능을 포함함
- 오픈소스 계획 — 현재는 개인용이지만 추후 깃허브에 공개할 예정임
사용량이나 속도 제한 화면을 계속 열어서 한계치에 다다랐는지 확인하는 게 너무 짜증 나서, 간단한 로컬 macOS 위젯을 만들었습니다.
데스크탑이나 메뉴 바에 띄워두고 Claude와 Codex를 나란히 볼 수 있어요:
- 5시간 및 주간 사용량 미터
- 초기화 카운트다운
- 현재 사용 속도에 기반한 “언제쯤 제한에 걸릴지” 예측
- 컴팩트/확장 모드
- 사용 패턴을 학습하는 로컬 세션 일지
- 항상 위에 표시 토글
- 제한이 임박했을 때만 알려주는 조용한 모드
전부 로컬에서 작동합니다. 백엔드도 없고, 계정 정보를 긁어가는 서비스도 없습니다. 도구들이 이미 노출하고 있는 로컬 사용량/속도 제한 데이터를 읽어서 제 컴퓨터에 기록을 저장할 뿐입니다.
작업 흐름을 끊어가며 수동으로 제한을 확인하는 게 너무 멍청하게 느껴져서 만들었습니다.
더 많은 기능을 추가할 생각입니다: 지연 시간 추적, 세션 효율성, 더 나은 사용량 예측, 추세에 기반한 “오늘 사용량이 빨리 소진될 것 같다”는 힌트, 그리고 Claude/Codex/OpenAI/Anthropic에 문제가 생겼을 때 알려주는 상태 감시 기능까지요.
작은 사이드 프로젝트지만, 솔직히 벌써 유용하게 쓰고 있습니다.


