Claude Usage Tracker

Claude Usage Trackerとは？

Claude Usage Trackerは、ローカル優先のツールで、複数のローカル開発ツールにわたるClaude AIの利用コストを自動検知・集計します。既知のデータディレクトリをスキャンし、JSONL/ログファイルを解析、モデル固有の料金でコストを計算し、インタラクティブなダッシュボードに結果を表示します。

主な目的はコスト追跡と可視化です。ソース、モデル、期間別の支出をクラウドにデータを送信せずに確認できます。すべてローカルマシンで動作し、ダッシュボードはChart.jsで駆動されます。

主な機能

• 9種類以上のClaude統合ツールを自動検知し、それらの利用データを統合して一元的なビューを提供。
• Anthropicモデルファミリー（Opus、Sonnet、Haiku）のモデル別百万トークン単価でコスト計算。入力/出力やキャッシュ読み書きを含む（該当する場合）。
• Chart.jsを使用したダークテーマのインタラクティブダッシュボード。ビジュアルチャートと内訳表示。
• 時間ベースのコスト追跡。日次、週次、月次、全期間のコストビュー。
• モデル・ソース分析。モデル別コスト内訳とフィルタリング（ソース、モデル、日付範囲、最小コスト）。
• ピークパターン可視化。ヒートマップと2つのビュー：Peak Hours（日×時間グリッド）とPeak Days（GitHub風カレンダー）。
• セッション詳細。展開可能なセッションログに色分けソースカード、セッション別コスト強調（例：最も高額セッション）、セッションディテールパネル。
• プロジェクトペース予測。現在の支出ペースに基づくmonthly projections。
• macOSアプリバンドルオプション。ダブルクリック起動のスタンドアロン.appをビルド。

Claude Usage Trackerの使い方

1. インストールと起動。最新リリース（推奨）またはソースからローカル実行。
2. スキャン実行でデータ収集とダッシュボード表示：macOSアプリは新鮮なデータを収集してインタラクティブダッシュボードを表示。ブラウザモードはローカルサーバーを起動し、dashboard.htmlをロード。
3. ダッシュボード確認。総コストを探索し、利用可能なチャート、ヒートマップ、フィルターでソース/モデル・期間別に内訳。

クイックスタートオプション（リポジトリから）：

• macOS (Apple Silicon/Intel): 最新リリースをダウンロード、アンパック、Claude Usage Dashboard.appをApplicationsに移動し、ダブルクリック起動。
• ソースからビルド: リポジトリをクローン、./build-app.shを実行し、ビルドされたアプリをダブルクリック。
• ブラウザモード（全OS）: node collect-usage.jsを実行、python3 -m http.server 8765でローカルサーバー起動、http://localhost:8765/dashboard.htmlを開く。

ユースケース

• 複数Claudeツールの支出集約：Cursor、Windsurf、Claude Desktop、Continue.devなどのローカル統合を複数使用する場合、これらのソースから利用データを1つのダッシュボードに統合。
• 最高支出タイミング特定：Peak Hours（日×時間ヒートマップ）とPeak Daysカレンダーで最も高額な利用セッションの時間・日を特定。
• 特定セッションや日の監査：日付のセッションログを展開し、セッション別コストを確認、トークン内訳と会話履歴をセッションディテールパネルで表示。
• 日次変化比較：Yesterday Deltaで今日の支出を昨日と一目で比較。
• 今月の見込み計画：Monthly Projectionsで現在の支出ペースに基づく月間コスト推定。

FAQ

• トラッカーは利用データをサーバーに送信しますか？ いいえ。プロジェクト説明に「No cloud」「No telemetry」とあり、すべてローカルマシンに留まります。

• どのツールをサポートしていますか？ リポジトリにOpenClaw/Clawdbot、Claude Code CLI、Claude Desktop（ローカルエージェントモード）、Cursor、Windsurf、Cline、Roo Code、Aider、Continue.devのClaude利用を記載。ツール検知は自動。

• どのようなデータ形式を読み込みますか？ 既知ディレクトリをスキャンしJSONL/ログファイルを解析。サポートツールセクションで各ツールのJSONLを指定。

• ツールがインストールされていないかデータがない場合？ ツール検知の動作：インストールなしやデータなしの場合、サイレントにスキップ。

• コスト計算方法は？ サポートモデルファミリー（Opus、Sonnet、Haiku）のAnthropic百万トークン単価で計算。提供された入力/出力、キャッシュ読み書きに基づく。

代替案

• ローカルログ解析 + スプレッドシート: Claudeの利用ログをエクスポートまたは収集し、スプレッドシートで手動計算。インタラクティブなダッシュボードより手作業が多いが、カスタムワークフローに適合可能。
• ベンダー提供の利用ダッシュボード（利用可能な場合）: 一部のプロバイダーが請求/利用レポート用の表示を提供。これらは通常単一の製品/アカウントに焦点を当て、多ツールの集計は行わない。
• 汎用開発者時間/コスト分析ツール: IDEアクティビティを解析したり利用イベントからコストを計算するツールは役立つが、Claude特有のトークン価格モデルや各ツールのストレージ形式の自動解析は行わない場合がある。
• その他のローカル優先監視ダッシュボード: ローカルログをブラウザで可視化する類似ツールは似たチャートを提供するが、トラッカーの自動検知やJSONL解析に頼らずデータ準備が必要な場合がある。