Claude Code usage tracking by LangWatch

LangWatch：Claude Codeの利用状況とトークンコストを最適化する究極のプラットフォーム

AI開発が加速する現代において、Claude CodeをはじめとするAIコーディングエージェントの利用は日常的なものとなりました。しかし、**「どの程度のトークンを消費しているのか？」「実際のコストはいくらか？」「ワークフローのどこにボトルネックがあるのか？」**といった疑問を解消することは、効率的な開発に不可欠です。

LangWatchは、これらの課題を解決するために設計された、チームでAIをプロダクション環境へ届けるためのLLMエンジニアリングプラットフォームです。Claude CodeのネイティブなOpenTelemetryエクスポート機能を活用し、すべてのセッション、モデルのターン、ツール呼び出しを詳細に追跡（トレース）します。

---

LangWatchとは？

LangWatchは、Claude Code、Codex、OpenCode、Copilot、Cursor、Piといった最先端のAIエージェントの利用状況をキャプチャし、その完全なトレース履歴を保存・分析するためのプラットフォームです。開発フローを改善し、トークン消費量を正確に把握することで、個人の開発者からエンタープライズチームまで、AI活用の透明性を高めることができます。

LangWatchを使用すれば、ローカルログのクリーンアップで失われてしまう情報も、OpenTelemetryを通じてクラウド上で安全に管理され、複数のマシンを跨いで利用状況を追跡することが可能です。

---

LangWatchの主な機能 (Features)

LangWatchは、単なるコスト追跡ツールではありません。AIエンジニアリングを最適化するための包括的な機能を備えています。

1. トークンアカウンティングとコスト分析

LangWatchは、APIレスポンスから直接取得した正確なコスト数値を表示します。

• 理論的なコストと請求コストの比較: 個別プランやチームプラン（サブスクリプション）を利用している場合でも、APIのリスト価格に基づいた「本来かかるはずのコスト」を算出します。
• トークンクラス別の詳細: 入力、出力、そして後述するキャッシュトークンを正確に分類して集計します。

2. キャッシュヒットの高度な追跡

AIエージェントとの長いセッションにおいて、キャッシュの活用はコストとパフォーマンスの鍵となります。

• 5分・1時間のTTL別管理: キャッシュの読み取り（Read）と書き込み（Write）を個別のトークンクラスとして追跡します。
• 精緻な計算: キャッシュ読み取りを単なる入力としてカウントせず、個別のレートで価格設定を行うため、正確なコスト把握が可能です。

3. ツール、スキル、MCPの完全な可視化

AIエージェントが行うすべての動作をスパンとして記録します。

• 実行履歴の追跡: すべてのBashコマンド、ファイル編集、スキル呼び出し、MCP（Model Context Protocol）コールを記録。
• 詳細なインプット/アウトプット: 各動作の所要時間（Duration）とともに、具体的な入出力内容をフルデバッグ可能です。

4. セッションインサイトと分析

自身のトレース履歴に対してClaudeを実行し、以下のようなインサイトを得ることができます。

• 摩擦パターンの特定: セッションがうまくいかなかった原因や、最も役立った質問の分析。
• 分析グラフの作成: 並列セッション数、セッションごとのコスト、アイドル時間などの任意のメトリクスをチャート化して可視化します。

5. セキュリティとプライバシー（秘密情報の保護）

企業での利用において最も重要なのがセキュリティです。

• 自動レッドアクション: APIシークレットキーやPII（個人を特定できる情報）は自動的に検知・秘匿処理され、LangWatch側に保存されることはありません。
• エンタープライズ対応: セルフホスト設定や、より厳格なエンタープライズポリシーの適用も可能です。

---

LangWatchの使い方 (How to Use)

LangWatchの導入は非常にシンプルです。既存のワークフローを止めることなく、数秒でセットアップが完了します。

セットアップ手順

ターミナルで以下のコマンドを実行するだけです：

$ npx langwatch claude

このコマンドを実行することで、Claude CodeのネイティブなOpenTelemetryエクスポートがLangWatchに向けて設定されます。これ以降、すべてのセッションは自動的にトレースとしてLangWatchに送信され、モデルのターン、ツール呼び出し、トークン消費などがリアルタイムで記録されるようになります。

---

ユースケース (Use Case)

チーム全体のコスト管理

複数のメンバーがClaude CodeやCursorを使用している場合、チーム全体のトークン消費量を一元管理できます。「Bundled」表示機能を活用すれば、サブスクリプションプラン内での利用がAPI換算でどれほどの価値を生んでいるかを定量化できます。

複雑なバグのデバッグ

AIエージェントが複雑なコード変更を行った際、どのステップでエラーが発生したのか、MCPツールがどのような出力を返したのかを過去に遡って調査できます。スパンツリー表示により、繰り返された試行や長時間の処理を視覚的に理解できます。

AI自身の自己改善

LangWatchのMCPサーバーを利用することで、Claude Code自身が過去のトレースを確認できるようになります。AIが「先週の実行結果」を確認し、どこでトークンが無駄になったかを分析して、自身のワークフローを編集・改善することが可能です。

---

よくある質問 (FAQ)

Q: Claude Code以外のツールでも使えますか？

A: はい。Codex、OpenCode、Copilot、Cursor、Piなど、同じOTLPエンドポイントを通じてエクスポートを行うエージェントであれば、すべて同じようにトークン、コスト、トレースの管理が可能です。

Q: 「Bundled」コストラベルとは何ですか？

A: Claude Pro、Max、Teamなどのサブスクリプションプランを利用している場合、トークンごとの請求は発生しません。LangWatchではこれらのセッションを「Bundled」とマークし、APIリスト価格に基づいた「理論上の総コスト」を算出します。これにより、APIを利用した場合のコストパフォーマンスを把握できます。

Q: キャッシュされたトークンはカウントされますか？

A: はい。キャッシュの読み取り（Read）と書き込み（Write）は、すべてのスパンで個別のトークンクラスとしてカウントされ、それぞれのレートで価格計算されます。長時間のセッションではキャッシュ読み取りが大部分を占めるため、これらを正確に区別することは非常に重要です。

Q: 秘密キーを誤ってセッションに貼り付けてしまった場合は？

A: APIシークレットや個人情報（PII）は自動的に検知・秘匿（レッドアクション）されるため、LangWatchのトレースに残ることはありません。安心して開発を続けることができます。

---

LangWatchは個人利用であれば無料で開始できます。 今すぐ npx langwatch claude を実行して、あなたのAI開発を次のレベルへ引き上げましょう。