Claude コード使用状況を監視する3つのオープンソースツール

Vibe Codersにとって、AnthropicのClaude Codeのようなツールは、多くのエンジニアにとって不可欠なものとなっています。ボイラープレートコードの生成から複雑なアルゴリズムのデバッグまで、Claude Codeは生産性を大幅に向上させることができます。しかし、この強力なツールには監視が必要です。監視されていない使用は、予期せぬコスト、パフォーマンスのボトルネック、そしてこれらの強力なツールが開発ライフサイクルにどのような影響を与えているかについての不完全な理解につながる可能性があります。

効果的なモニタリングは、単に費用を追跡するだけではありません。それは価値を理解することです。あなたは自分のタスクに最も費用対効果の高いモデルを使用していますか？ワークフローに最適化できるパターンはありますか？AIアシスタンスは、チームにとって具体的な生産性向上にどのように貢献していますか？これらの質問に答えるにはデータが必要であり、そこでオープンソースのモニタリングツールが役立ちます。

Claude Codeは一定の使用情報を提供しますが、より深く、より実用的な洞察を提供するオープンソースツールの専用エコシステムが登場しています。これらのツールは、日々のトークン消費量を素早く確認したい個人開発者から、AIの使用状況に関する包括的な可観測性プラットフォームを構築しようとしているエンタープライズチームまで、幅広いニーズに対応します。

この記事では、Claude Codeの使用状況を監視するのに役立つ3つの異なるオープンソースツールについて詳しく掘り下げていきます。

ccusage: ローカルの使用データを素早くアドホックに分析するための、高速でシンプルなコマンドラインインターフェース（CLI）。
Claude-Code-Usage-Monitor: 現在のセッションを把握し、トークン制限に達するのを避けるのに役立つ、インタラクティブなリアルタイムターミナルダッシュボード。
claude-code-otel: チーム全体の使用状況、パフォーマンス、コストを包括的かつ長期的に監視するための、本格的なエンタープライズグレードの可観測性スタック。

それぞれのアーキテクチャ、機能、理想的なユースケースを探り、Claude Code開発ワークフローを習得するための適切なツールを選択できるようお手伝いします。

💡

美しいAPIドキュメントを生成する優れたAPIテストツールをお探しですか？

最大限の生産性で開発チームが協力して作業できる、統合されたオールインワンプラットフォームをお探しですか？

Apidogは、お客様のすべての要求に応え、Postmanをはるかに手頃な価格で置き換えます！

ボタン

`ccusage`

速度、シンプルさ、効率性を重視する開発者にとって、ccusageは完璧なツールです。GitHubユーザーryoppippiによって作成されたこのツールは、Claude Codeが生成するローカルのJSONLログファイルを分析することで、Claude Codeの使用状況とコストに関する明確で簡潔なレポートを提供する、軽量で信じられないほど高速なCLIツールです。

主な機能:

複数のレポートビュー: daily、monthly、session、blocksレポート（Claude Codeの5時間課金ウィンドウに対応）で、質問に合わせた洞察を得られます。
ライブモニタリング: ccusage blocks --liveコマンドを使用すると、アクティブなセッションの進行状況、トークンの「バーンレート」、および予測コストを示すリアルタイムダッシュボードを取得できます。
コストとモデル分析: このツールはトークンを数えるだけでなく、それらをUSDに換算し、使用した特定のモデル（Opus、Sonnet、Haikuなど）ごとにコストを内訳表示できます。
柔軟な出力: デフォルトの人間が読める形式のテーブルは美しくフォーマットされており、ターミナルの幅にも適応しますが、--jsonフラグを使用して任意のレポートをJSON形式でエクスポートすることもでき、他のスクリプトやツールへの統合が容易です。
ゼロ依存実行: npxを使用すると、永続的なインストールなしでccusageを即座に実行できるため、素早い一度限りのチェックに最適です。

仕組み:

ccusageはTypeScriptで書かれたNodeJSベースのツールです。その魅力はシンプルさにあります。ローカルのClaude Code設定ディレクトリ（例: ~/.config/claude/logs/バレエ）に保存されている.jsonlファイルを直接解析します。これらのイベントログを読み込み、プロンプトと応答のトークン数を集計し、各モデルの最新の料金情報を適用して、データをきれいで表形式で表示します。このローカルファーストのアプローチにより、非常に高速で、完全にオフラインで動作します（一度料金データをキャッシュしていれば）。

インストールと使用法:

ccusageの使い始めはこれ以上ないほど簡単です。インストール不要で直接実行するには、次のように使用します。

npx ccusage@latest

このコマンドは最新バージョンを取得し、日次レポートを表示します。より詳細なビューについては、レポートタイプを指定できます。

# 各月の使用状況の概要を表示
npx ccusage@latest monthly

# 会話セッションごとに使用状況をグループ化
npx ccusage@latest session --breakdown

# 現在の5時間課金ブロックをリアルタイムで監視
npx ccusage@latest blocks --live

誰のためのツールか？

ccusageは、個人開発者にとって理想的なツールです。次のような場合に最適です。

「昨日Claude Codeにいくら使ったか？」という質問に答える。
長時間のコーディングセッションの終わりにトークン使用量を確認する。
複雑なセットアップのオーバーヘッドなしに、シンプルでアドホックな分析を行う。
JSON出力経由で他のスクリプトに利用データをパイプする。

個人のClaude Code使用状況を素早く、手軽に把握したいなら、ccusageは素晴らしい出発点です。

`Claude-Code-Usage-Monitor`

ccusageが事後分析に優れているのに対し、Maciek-roboblogによるClaude-Code-Usage-Monitorは、コーディングセッション中のライブコンパニオンとして設計されています。このPythonベースのツールは、使用した量を示すだけでなく、これから使用する量を予測する永続的なリアルタイムターミナルダッシュボードを提供し、予期せずトークン制限に達するのを避けるのに役立ちます。

主な機能:

インタラクティブなリアルタイムダッシュボード: モニターは、現在の5時間セッションウィンドウ内のトークン使用量を（3秒ごとに）常に更新して表示します。
予測分析: その際立った機能は「バーンレート」計算です。最近の使用状況を分析し、セッションのトークンをいつ使い果たすかを予測するため、ペースを落とす機会を与えてくれます。
視覚的なプログレスバー: UIはリッチで直感的で、トークン消費量とセッションの残り時間の両方について色分けされたプログレスバーが表示されます。
プランとタイムゾーンに対応: 異なるClaude Codeプラン（Pro、Max5、Max20）用にモニターを設定し、正確なセッションリセット予測のためにローカルタイムゾーンを設定できます。過去の使用状況に基づいてプランを自動検出することも可能です。
警告システム: トークン制限に近づいているときに積極的に警告を発し、より積極的に使用状況を管理するのに役立ちます。

仕組み:

ccusageと同様に、このツールもローカルのClaude Codeログファイルを監視します。ただし、過去のデータを報告するだけでなく、現在の5時間セッションのライブ状態を維持します。Claude Codeのローリングウィンドウシステムを理解し、そのコンテキスト内でトークン使用量とバーンレートを計算します。Pythonで書かれており、richライブラリを使用して洗練されたインタラクティブなターミナルインターフェースを作成しています。

インストールと使用法:

Claude-Code-Usage-Monitorをインストールする推奨方法は、仮想環境を自動的に処理する最新のPythonパッケージインストーラーであるuvを使用することです。

# uvをインストール（持っていない場合）
curl -LsSf https://astral.sh/uv/install.sh | sh

# ツールをインストール
uv tool install claude-monitor

# モニターを実行
claude-monitor

実行すると、ターミナルウィンドウを占有し、ライブダッシュボードが表示されます。さまざまなフラグでカスタマイズできます。

# プランとタイムゾーンを指定
claude-monitor --plan max20 --timezone America/New_York

誰のためのツールか？

Claude-Code-Usage-Monitorは、作業中に常に情報を得たい開発者向けのツールです。次のような場合に最適です。

より厳格なトークン制限があり、慎重に管理する必要がある無料または「Pro」ティアのユーザー。
長時間の集中的なコーディングセッションに従事し、使用ペースを調整したい開発者。
制限に達したために思考の途中で中断されるという不快な経験を避けたい人。
静的なレポートよりもグラフィカルなダッシュボードを好む視覚学習者。

トークン予算の「守護天使」のように機能し、あなたの作業を見守り、軌道に乗せるツールが欲しいなら、これが最適です。

`claude-code-otel`

最初の2つのツールは個人開発者にとって素晴らしいものですが、チーム全体や組織全体でClaude Codeの使用状況を監視する必要がある場合はどうでしょうか？そこでColeMurrayによるclaude-code-otelが輝きます。これは単なるツールではなく、業界標準のオープンソースコンポーネントに基づいて構築された、完全なセルフホスト型可観測性ソリューションです。

主な機能:

完全な可観測性スタック: OpenTelemetry、Prometheus、Loki、Grafanaといった、本番環境のインフラ監視に使用される堅牢なツール群の事前設定済みセットアップを提供します。
包括的なダッシュボード: このプロジェクトには、コスト、ユーザーアクティビティ、ツールパフォーマンス、生産性指標（変更されたコード行数など）、APIレイテンシ、エラーなどの詳細な分析のための事前構築されたGrafanaダッシュボードが付属しています。
チーム全体の監視: 複数のユーザーからのデータを集約するように設計されており、傾向の把握、パワーユーザーの特定、チームまたはプロジェクトレベルでのコスト管理が可能です。
データ主権とセキュリティ: スタック全体を自分でホストするため、潜在的に機密性の高いユーザープロンプト（ログに記録することを選択した場合）を含むすべての使用データは、独自のインフラストラクチャ内に留まります。
標準ベース: OpenTelemetryを使用することで、テレメトリデータのためのベンダーニュートラルな標準に準拠しており、拡張性と将来性が保証されます。

仕組み:

このソリューションは根本的に異なるアプローチをとります。Claude CodeのOpenTelemetry（OTel）に対する組み込みサポートを活用します。いくつかの環境変数を設定することで、Claude Code CLIが詳細なメトリクスとログを出力するように構成できます。claude-code-otelは、このデータを受信および処理するためのバックエンド全体を起動するdocker-composeセットアップを提供します。

OpenTelemetry Collector: すべてのユーザーのClaude Codeインスタンスからテレメトリデータを受信します。
Prometheus: メトリクス（例: トークン数、コスト、レイテンシ）をスクレイピングして保存します。
Loki: イベントログ（例: ユーザープロンプト、ツール結果、APIエラー）を取り込んで保存します。
Grafana: PrometheusとLokiにクエリを実行し、強力でインタラクティブなダッシュボードでデータを視覚化します。

インストールと使用法:

claude-code-otelのセットアップは他のツールよりも複雑ですが、Dockerのおかげで非常に効率化されています。

リポジトリをクローン:

git clone https://github.com/ColeMurray/claude-code-otel.git
cd claude-code-otel

2. スタックを起動:

make up

3. 環境変数を設定して、ローカルのClaude Code環境が新しいスタックにデータを送信するように構成します。

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
# ... その他いくつか

4. ブラウザでhttp://localhost:3000にアクセスして、ダッシュボードにアクセスします。

誰のためのツールか？

claude-code-otelは、エンジニアリングチーム、プラットフォームチーム、およびマネジメントのための決定的なソリューションです。次のような場合に理想的です。

AI開発ツールのROIを測定したい組織。
Claude Codeの使用に関する共有予算を管理する必要があるチームリーダー。
AIツールのパフォーマンスと信頼性を監視する必要があるプラットフォームエンジニア。
開発チーム全体でAIがどのように使用されているかを理解するための、集中型で安全かつ強力な方法を必要とするあらゆる組織。

結論: あなたのレンズを選ぶ

Claude Codeの使用を習得する道のりは、可視性から始まります。私たちが探求した3つのツールは、この強力なAIアシスタントとのインタラクションを見るための異なるレンズを提供します。

過去の使用状況に関する一般的な質問にシンプル、強力、かつ迅速に答えるには、まずccusageから始めましょう。
受動的な分析から、コーディングセッション中のトークン予算の積極的かつリアルタイムな管理へと移行したい場合は、Claude-Code-Usage-Monitorに進みましょう。
個人の使用状況から、チーム全体の可観測性、コスト管理、パフォーマンス分析へと焦点を移す場合は、claude-code-otelを採用しましょう。

これらのオープンソースプロジェクトはそれぞれ、開発者コミュニティへの素晴らしい貢献であり、ユーザーがAIテクノロジーの受動的な消費者から、能動的で情報に通じた参加者へと移行することを可能にします。ニーズに合った適切なツールを選択することで、新たなレベルの制御と洞察を解き放ち、AIアシスト開発ワークフローから最大限の価値を引き出すことができます。

💡

ボタン