Codex와 Claude Code 사용량 제한을 확인하는 데스크톱 위젯을 만들었어요. 물고기가 귀여워요.
I built a desktop widget for Codex and Claude Code limits. It has little fish.
핵심 요약
사용량 제한을 시각화해주는 물고기 애니메이션 데스크톱 위젯 'TokenFish' 개발기입니다.
- TokenFish 위젯 — Codex와 Claude Code의 남은 사용량을 물고기 애니메이션으로 표시함
- 개발 환경 — C# 및 WinUI 3를 사용하여 제작된 윈도우용 베타 프로그램임
- 시각적 요소 — 물고기가 사용량에 따라 이동하며 사용자가 직관적으로 제한을 파악하게 함
- 사용자 피드백 — 여러 세션 추적 기능과 사용량 표시 방식에 대한 논의가 진행됨
ChatGPT랑 Codex 써서 TokenFish를 만들었다. 내 데스크탑 구석에 코딩 할당량(quota)이 얼마나 남았는지 바로 보고 싶었거든.
Codex랑 Claude Code의 남은 할당량하고 초기화 시간을 보여준다. 작은 위젯 안에 물고기가 애니메이션으로 움직이면서 사용량을 따라가는데, 클릭하면 더 자세한 화면이 뜬다. 위젯은 숨길 수도 있고 앱을 트레이로 보낼 수도 있음.
만드는 과정은 자잘한 수정의 연속이었다. 변경 사항 계획하고, 목업 보고, 구현하고, 제대로 작동하는지 확인하고. 앱 테두리에 하얀 선 생기는 거나, 설정 창이 엉뚱한 데서 열리는 거, 리디자인하고 나서 물고기 애니메이션 다시 살리는 것까지 진짜 별의별 잡다한 버그 다 잡느라 고생 좀 했다.
C# / WinUI 3로 짰다. Codex 데이터는 기존 로컬 Codex 런타임에서 가져오고, Claude Code는 상태 표시줄 브릿지를 쓴다. 할당량하고 토큰 사용량은 따로 분리해 뒀는데, 물고기가 먹는 알갱이는 그냥 시각적인 비유일 뿐이지 토큰 카운터는 아니다.
아직 윈도우 베타 버전 수준이다. 영상은 샘플 데이터 넣은 UI 목업이고.
피드백 하나만 구하자면, 물고기는 사용한 할당량에 맞춰 움직이고 숫자는 남은 할당량을 보여주거든. 이거 한눈에 딱 들어오냐? 아니면 다르게 바꾸는 게 나을까?
코드랑 설정 관련 정보: https://github.com/pixelsncodes/tokenfish
