최근 AI 모델을 활용하는 개발자와 사용자들 사이에서 여러 계정을 번갈아 사용하는 경우가 늘고 있습니다. 하지만 각 계정의 사용 한도를 일일이 확인하는 과정은 번거롭고 시간을 소모하는 일입니다. 이러한 불편함을 해소하기 위해 macOS 바탕화면 위젯 'AI Usage'가 등장했습니다. 이 위젯은 클로드(Claude) 코드와 코덱스(Codex) 같은 AI 서비스의 사용량을 직관적인 활동 링 형태로 보여주어, 사용자가 남은 한도를 한눈에 파악할 수 있도록 돕습니다.
'AI Usage' 위젯은 계정당 5시간 및 주간 한도를 활동 링과 게이지로 시각화합니다. 클로드의 경우 5시간, 주간, 주간 페이블(Fable) 한도를, 코덱스는 5시간 및 7일 한도를 각각 표시합니다. 또한, '~/.claude-' 및 '~/.codex-' 설정 디렉토리를 자동으로 탐지하여 여러 계정을 손쉽게 관리할 수 있으며, 안티그래비티(Antigravity, agy) CLI 계정(제미니, 클로드/GPT 풀)도 지원합니다. 사용량이 임계치(기본 90%)를 초과하면 링 색상이 변경되고 알림이 제공되어, 한도 소진 전에 미리 대비할 수 있습니다. 상세 창에서는 한도별 퍼센트, 남은 시간, 정확한 리셋 일시 등 더 구체적인 정보를 확인할 수 있습니다.
이 위젯은 로컬에서 직접 AI 서비스의 비공개 API 엔드포인트(api.anthropic.com/api/oauth/usage, chatgpt.com/backend-api/wham/usage)를 호출하여 사용량 정보를 가져옵니다. 결과는 앱 그룹(App Group)의 스냅샷 파일에 저장되며, 샌드박스 위젯은 이 파일만 읽습니다. 중요한 점은 사용자 토큰이 스냅샷 파일에 기록되지 않고 맥(Mac) 외부로 전송되지 않아 보안성이 높다는 것입니다. 클로드의 경우 앱에서 한 번 로그인하면 자체 OAuth 세션을 유지하므로 기존 자격 증명에 영향을 주지 않습니다. 이 앱은 스위프트(Swift)와 위젯킷(WidgetKit)으로 개발된 오픈소스이며, macOS 14 이상에서 동작합니다.
'AI Usage'는 여러 AI 모델을 사용하는 개발자들에게 생산성 향상과 효율적인 자원 관리를 가능하게 합니다. 더 이상 터미널을 열어 복잡한 명령어를 입력하거나 각 서비스 웹사이트를 방문할 필요 없이, 바탕화면에서 실시간으로 사용량을 모니터링할 수 있게 된 것입니다. 이는 AI 개발 및 활용 워크플로우를 간소화하고, 비용 관리에도 도움을 줄 수 있습니다. 유사한 기능을 제공하는 '토큰 슬레이어(Token Slayer)'나 'JJStatus' 같은 다른 위젯들과 함께, AI 사용량 관리 도구의 중요성이 점차 커지고 있음을 보여줍니다.