【要約】Claude Code / Codex CLIの残り使用量を常時表示するWindowsウィジェットを作った [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
開発者が、Claude CodeやCodex CLIの利用枠を意識できず、作業が中断される問題に直面している。具体的には以下のペインポイントが存在する。
- ・5時間枠や週間枠の利用率を、作業中に把握しにくい。
- ・利用上限に達した際、作業が突如として停止してしまう。
- ・現在の使用量を確認するために、都度ダッシュボードを開く手間が発生する。
// Approach
開発者は、作業の継続性を確保するために、Pythonを用いた軽量な常時表示ウィジェットを開発した。以下の手法を用いて実装されている。
- ・Python標準ライブラリの
tkinterのみを使用し、依存関係を最小限に抑えた。 - ・Claude側は非公開の
GET /api/oauth/usageから情報を取得する。 - ・Codex側は
codex app-serverのJSON-RPC APIを利用する。 - ・右クリックメニューにより、ポーリング間隔や背景色の設定を可能にした。
// Result
このウィジェットにより、開発者はダッシュボードを確認する手間なく、利用状況を把握できるようになった。得られた成果は以下の通りである。
- ・画面右下に「Claude 5h:67% 7d:30% / Codex:95%」のように常時表示される。
- ・背景色のカスタマイズが可能で、設定は次回起動時も保持される。
- ・API取得に失敗しても、アプリがクラッシュせずに「N/A」と表示される堅牢性を備える。
Senior Engineer Insight
> 開発者のコンテキストスイッチを最小化する、優れたDX（開発体験）向上ツールである。しかし、非公開APIへの依存は、仕様変更により即座に機能停止するリスクを伴う。また、トークンの自動リフレッシュ機能がないため、運用には手動の再認証が必要となる。個人利用には非常に有用だが、組織的な導入にはAPIの安定性とセキュリティの観点から慎重な評価が必要である。