Claudetop: Claudeコードセッションのリアルタイムコスト監視

Claudetop: Claude Codeセッションのリアルタイムコスト監視

Claudetopは、Claude Code用の監視ツールで、コーディングセッション中のリアルタイムコスト追跡、キャッシュ効率メトリクス、モデル比較を表示します。このツールは、開発者がモデル推定では10ドルと表示されていたのに実際の請求額は65ドルで、圧縮によりトークン使用量の80%が隠されていたという不一致に気づいた後に作成されました。

インストール方法

3つのインストール方法があります：

• クローンしてインストール: git clone https://github.com/liorwn/claudetop.git その後 cd claudetop && ./install.sh
• ワンライナー: curl -fsSL https://raw.githubusercontent.com/liorwn/claudetop/main/install.sh | bash
• Claude Codeプラグインとして: claude plugin marketplace add liorwn/claudetop その後 claude plugin install claudetop

プラグインインストールでは、SessionEndフックとスラッシュコマンドが自動的に提供されます: /claudetop:stats, /claudetop:dashboard, /claudetop:branch, /claudetop:export, /claudetop:pricing。

表示情報

セッション中、Claudetopは以下を表示します：

• 現在のプロジェクトの場所と深さ
• アクティブなモデルとセッション時間
• 現在のコスト、時間あたりの消費率、予測月間コスト
• キャッシュ効率の割合と1行あたりのコスト
• 他のモデル（Opus、Sonnet、Haiku）との比較コスト
• トークン内訳: fresh、cwrite、creadカテゴリを含む入力/出力の割合

主な機能

リアルタイムコスト追跡: 実際のセッションコスト（緑）、時間あたりの消費率、履歴から外挿した月間予測を表示します。Anthropicが価格を変更すると、pricing.jsonから価格が自動的に更新されます。

モデルコスト比較: セッションがOpus、Sonnet、Haikuでどれだけのコストになるかを、実際のキャッシュヒット率を考慮したキャッシュ対応価格で表示します。現在のモデルは太字で表示され、即座に比較できます。

キャッシュ効率監視: キャッシュヒット率は効率を示します：緑（≥60%）は入力トークンの大部分が再利用されていることを意味し、赤（<30%）は何かが完全な再読み込みを強制していることを示します。

スマートアラート

アラートは注意が必要な場合にのみ表示されます：

• $5 MARK / $10 / $25: コストの節目を超えました - 価値の直感的な確認
• OVER BUDGET: 日次予算を超過しました - 終了するかモデルを切り替えてください
• CONSIDER FRESH SESSION: 2時間以上 + 60%以上のコンテキスト - 収穫逓減
• LOW CACHE: 5分後に20%未満のキャッシュ - コンテキストがリセットされ、トークンが再読み込みされています
• BURN RATE: 15ドル/時間以上の速度 - 暴走したサブエージェントまたはタイトなループ
• SPINNING?: 1ドル以上消費、コード出力ゼロ - 調査ループに陥っています
• TRY /fast: Opusで0.05ドル/行以上 - タスクに最大モデルは必要ありません
• COMPACT SOON: コンテキストウィンドウが80%以上埋まっています - 自動圧縮が間近です

セッション履歴と分析

すべてのセッションは自動的に記録されます。様々な引数でclaudetop-statsを使用します：

• claudetop-stats - 今日の概要
• claudetop-stats week - 今週
• claudetop-stats month - 今月
• claudetop-stats all - 全期間
• claudetop-stats tag auth - タグでフィルタリング

このツールは、Claude Codeを使用する開発者で、AI支出パターンを可視化し、モデル使用とキャッシュ効率を最適化したい人向けです。