richhickson/claudecodeusage

解決する課題

Claude Usageは、Claude Code CLIツールのユーザーが使用制限を管理し、セッションの状態を常に把握できるように設計されたmacOSメニューバーアプリです。使用クォータを手動で確認したり、AIエージェントのセッションでユーザーの入力や許可が必要な通知を見逃したりする問題を解消します。

仕組み

このアプリはmacOS KeychainからOAuth認証情報を読み取り、Anthropicの使用状況APIをクエリします。セッションのアラートを提供するために、Claude Codeのhooksシステムを利用し、セッションの状態（実行中、対応が必要、完了）をローカルのJSONファイルに書き込む小さなシェルスクリプトをインストールして監視します。

対象ユーザー

macOSでClaude Code CLIを使用しており、トークン制限をリアルタイムで視覚的に確認したい方、およびAIコーディングセッションで対応が必要な際に通知を受け取りたい開発者向けです。

主な特徴

• 使用状況の追跡: セッション、週間、モデルごとの制限を監視し、色分けされたステータスインジケーター（緑、黄、赤）と超過分を追跡します。
• セッションアラート: セッションで入力が必要な場合にmacOS通知とメニューバーのベルで知らせます。「クリックしてフォーカス」機能により、該当するターミナルタブへ直接ジャンプできます。
• Claudeのステータス: status.claude.comからの障害通知を統合しています。
• Claude Codeの設定: グローバルな CLAUDE.md ファイル用の組み込みエディタと、会話保持設定が含まれています。
• 軽量: ネイティブのSwiftで構築されており、リソース消費を最小限に抑えています。