What is Ccusage?
ccusage は、Claude Code のトークン消費量に不可欠な透明性をもたらすために設計された、強力なコマンドラインインターフェース(CLI)ツールです。ccusage は、Claude Code によって生成されるローカルの JSONL 使用状況ファイルを分析することで、無制限プランのユーザーが抱える共通の課題を解決します。それは、実際の使用量を定量化し、コスト要因を特定し、サブスクリプションから得られる真の価値を評価することです。このツールは、AIインタラクションを管理・最適化するための詳細で実用的なレポートを提供します。
主な機能
私たちは、きめ細かな詳細情報と実用的な洞察を提供することに注力し、トークンの使用量と費用の完全な可視性を確保します。
📊 包括的なレポートスイート
単なる日ごとの合計値を超えて、複数の側面から集計された使用状況にアクセスできます。日次、週次、月次、およびセッションレポートにより、長期的な傾向を追跡し、どの会話や期間が最も消費量を増加させたかを即座に特定できます。このきめ細かなビューは、過去の使用状況分析に不可欠です。
⏰ 5時間ブロックとライブモニタリング
Claude のバックエンドシステムで使用される特定の5時間ごとの請求期間内での消費量を追跡します。この独自のBlocks Reportは、リアルタイムでのアクティブな監視、コスト予測、および燃焼率の計算を提供し、早期警告を発し、基盤となるプラットフォームの仕組みに合わせた使用状況の管理に役立ちます。
💰 詳細なコストとモデルの追跡
ccusage は、現在のトークン使用量とモデルごとの料金体系に基づいて、USD での推定コストを提供します。異なる Claude モデル(Opus、Sonnet など)間での使用状況を自動的に追跡し、Model Breakdown ビューを提供します。さらに、標準トークンと Cache Read/Creation Tokens を正確に区別し、実際の運用コストをより正確に把握できるようにします。
🔒 100%ローカルでプライベートな分析
お客様のプライバシーは最優先事項です。ccusage は完全に Offline Mode で動作し、Claude Code の JSONL ファイルを読み取ることで、すべての分析をお客様のローカルマシン上で実行します。データが転送されたり、コンピューターから出ることは一切なく、お客様の使用パターンに関する完全なセキュリティとデータ主権を確保します。
🚀 超小規模なフットプリントと即時アクセス
多くの複雑な CLI ツールとは異なり、ccusage は驚くほど小さなバンドルサイズで設計されています。この効率性への注力により、完全なインストールなしでツールを直接実行できることが多く(例:bunx ccusageを使用)、最小限のセットアップオーバーヘッドで重要な使用状況データに即座にアクセスできます。
ユースケース
ccusage は、生の利用状況データを戦略的な洞察へと変換し、ユーザーがAIワークフローについて情報に基づいた意思決定を行えるようにします。
1. 無制限プランにおける投資収益率(ROI)の評価
Max plan をご利用の場合、月次およびセッションレポートを使用して、従量課金制プランであった場合の利用コストを算出できます。この比較は、現在のサブスクリプションモデルが十分な価値を提供しているかどうかを判断するための、具体的で定量化可能な指標を提供し、プランの正当性を証明したり、調整したりするのに役立ちます。
2. コスト集約的なワークフローの特定
Session Reports を活用して、最も多くのトークンを消費する特定のプロジェクトや会話スレッドを特定します。これを Model Tracking および Breakdown 機能と組み合わせることで、高コストのセッションがプレミアムモデル(Opus など)に過度に依存しているかどうかを判断し、特定のタスクでより低コストのモデルが同様の結果を達成できるかどうかを評価できます。
3. 使用状況データをカスタムダッシュボードに統合
JSON Output 機能により、すべての集計分析を構造化されたプログラム形式でエクスポートできます。開発者やパワーユーザーは、このデータを社内監視システム、カスタム分析ダッシュボード、またはスプレッドシートツールに直接パイプして、より深い傾向分析や、より広範なプロジェクト管理システムとの統合を図ることができます。
独自の利点
ccusage は、きめ細かな詳細情報とデータに対するユーザーの制御に焦点を当てることで、独特の価値を提供します。
プラットフォームロジックに合わせたきめ細かなレポート
私たちは単にカレンダーベースの要約を提供するだけではありません。5-Hour Block Reports を提供します。このレベルの詳細は、Claude の基盤となる請求期間と一致するため極めて重要であり、標準的なカレンダーレポートでは見過ごされる、機能的な使用状況の理解を提供します。
開発者エコシステムへの組み込みサポート
統合された Model Context Protocol (MCP) Server により、ccusage は他の開発ツールやシステムとスムーズに連携できます。この機能により、ccusage は単なるビューアとしてだけでなく、より大きなツールチェーンのアクティブなコンポーネントとして位置付けられ、より深い自動化と統合を可能にします。
柔軟な設定とタイムゾーン制御
ccusage は、検証とオートコンプリートのための IDE サポートを備えた JSON Configuration Files や、柔軟な Timezone and Locale Support など、広範な設定オプションを提供します。これにより、お客様の特定の運用環境と地理的場所に応じて、レポートが正確にグループ化、表示、フォーマットされることを保証します。
結論
ccusage は、Claude Code の消費量を管理するために必要な明瞭さと制御を提供します。不透明な使用状況データを詳細で実用的なレポートに変えることで、ワークフローを最適化し、コストを正確に追跡し、AI投資の価値を最大化する自信を得ることができます。
今すぐ ccusage がお客様の使用状況を管理するのにどのように役立つかを探ってみましょう。ツールとドキュメントは GitHub でご覧いただけます。
More information on Ccusage
Ccusage 代替ソフト
もっと見る 代替ソフト-

-

-

Desktop Commander MCP は、Claude Desktop アプリから直接ターミナルコマンドの実行とファイル編集を可能にするオープンソースツールです。Claude と共に、あなたのAIワークフローをさらに効率化しましょう。
-

macOS上でClaude Codeの自動化を簡素化するrunCLAUDErun。AIタスクをスケジュールし、ローカルデータのプライバシーを確保。そして、朝目覚める頃には、すべての作業が完了しています。
-

Claude Contextは、AIコーディングエージェントにフルコードベースコンテキストを提供し、その能力を最大限に引き出します。これにより、正確でコスト効率に優れたコードの生成、トークンコストの削減、そして開発の加速が実現します。
