tigerless-labs/cost-xray

何を解決するか

ほとんどのAIコーディングエージェントの使用ツールはローカルログしか読み取らないため、モデルが呼び出される前に組み立てられる「目に見えない」リクエスト時のコンテキスト（システムプロンプト、ツールスキーマ、MCPブロックなど）を逃してしまう。cost-xrayは実際のAPIトラフィックへの可視性を提供し、モデルに送信されている内容と、リクエストの各特定部分のコストがどれだけかを正確に把握できる。

動作方法

mitmproxy を使用してローカルキャプチャホップとして動作する。コーディングエージェント（Claude Code や Codex など）とモデルAPI間のHTTP/HTTPSトラフィックをインターセプトする。プロキシは機密情報を（APIキーなど）マスキングし、リクエスト/レスポンスの生データをローカルディスクに保存する。別途実行される「マテリアライザー」がオフラインでデータをトークン化・価格計算するため、リクエストのホットパスに影響せず、エージェントのパフォーマンスに追加の遅延を加えない。

対象ユーザー

macOS や Linux 上でAIコーディングエージェント（特に Claude Code と Codex）を使用し、API利用コストを細かく追跡し、コンテキストウィンドウの使用状況を最適化したい開発者。

特徴

• 細分化されたコスト追跡: セッション全体の合計ではなく、個々のツール呼び出しとその出力単位までコストを追跡。
• コンテキストウィンドウ分析: コンテキストウィンドウを実際に占めているものが何であるか（例：システムプロンプト、MCPサーバー）を明確に表示し、プレフィックス内の「無駄なデータ」を特定可能。
• 未使用MCPの発見: 各リクエストに常に挿入されるが、実際に使われない設定されたMCPサーバーやツールを検出。
• 自己修復キャプチャ: コマンドラッパーを使用し、プロキシが停止した場合やキャプチャに失敗した場合に自動で再起動、またはエージェントを直接ルーティングするため、エージェントの機能を維持。
• ローカルかつプライベート: すべてのデータは ~/.cost-xray/ にローカルに保存され、テレメトリは一切送信せず、保存前に機密フィールドはマスキングされる。