Repolode
tigerless-labs

tigerless-labs/cost-xray

Claude CodeとCodexのAPI通信をローカルプロキシでキャプチャし、リクエスト内の各要素にトークンコストを割り当てます。

スター
5,809
フォーク
376
未解決の Issue
35
最終コミット
一昨日

これは何?

cost-xrayは、AIコーディングエージェントがモデルAPIに実際に送信する内容と、それぞれの要素にかかるコストを可視化します。ログベースの利用状況ツールでは事後の合計しか確認できませんが、cost-xrayはローカルのキャプチャ用ホップとして動作するため、システムプロンプト、ツールスキーマ、MCPサーバーブロック、ツールの実行結果、キャッシュの読み書き、以前の思考ブロックなど、リクエスト時のコンテキストを確認できます。

キャプチャした通信をデコードし、個々のツール呼び出しに至るまで、各要素に割り当てます。各行ではコストを、新規入力、キャッシュ読み取り、キャッシュ書き込み、出力に分けて表示します。ライブTUIではエージェント、プロジェクト、セッションごとにセッションをグループ化できます。また、コンテキストウィンドウの使用率や、リクエストに注入されているものの一度も呼び出されていないMCPサーバーやツールも表示します。

キャプチャはmacOSまたはLinuxで実行でき、テレメトリーを送信せずに127.0.0.1へバインドします。認証情報や秘密情報に見えるフィールドは、~/.cost-xray/に書き込む前にマスキングされます。Claude CodeはベースURLの上書きでキャプチャし、Codexはcodexコマンドだけが信頼するスコープ限定のローカルCAを使ったフォワードプロキシでキャプチャします。

主な機能

  • 01APIキーやエージェント設定の変更なしに、ローカルプロキシ経由でClaude CodeとCodexのAPIリクエストを生のままキャプチャします。
  • 02各要素のコストを、新規入力、キャッシュ読み取り、キャッシュ書き込み、出力に分けて表示します。
  • 03個々のツール呼び出しやMCPサーバーに至るまでコストを割り当てます。
  • 04システムプロンプト、ツールスキーマ、MCPブロック、メッセージごとのコンテキストウィンドウ使用率を表示します。
  • 05すべてのリクエストに注入されているものの、一度も呼び出されていないMCPサーバーやツールを検出します。
  • 06データをローカルに保存する前に認証情報をマスキングします。

ユースケース

  • コーディングエージェントのセッションが予想外に高コストになっている原因を調べる。
  • 使われていないMCPサーバーや大きなツールスキーマによって、すべてのリクエストが肥大化していないか確認する。
  • プロンプトキャッシュが安定したプレフィックスに適用されているか確認し、予期しないキャッシュの書き換えを見つける。
  • コーディングエージェントがモデルAPIに送信するコンテキストをローカルで監査する。

クイックスタート

  1. 1

    Claude Code または Codex がインストールされた macOS または Linux を使用していることを確認します

  2. 2

    README に記載されている公式のインストールスクリプトを実行します

  3. 3

    新しいターミナルを開き、ライブ TUI を起動します

    cx

使う前に知っておきたいこと

  • macOS または Linux でのみ動作します。
  • Claude Code では、リクエスト内のソースごとのトークンの内訳は概算ですが、合計コストは正確です。
  • Codex のキャプチャでは、codex コマンドのみが信頼するローカル認証局を使用します。

収録されている特集

トピック

よくある質問

cost-xray とは?
Claude CodeとCodexのAPI通信をローカルプロキシでキャプチャし、リクエスト内の各要素にトークンコストを割り当てます。 cost-xrayは、AIコーディングエージェントがモデルAPIに実際に送信する内容と、それぞれの要素にかかるコストを可視化します。ログベースの利用状況ツールでは事後の合計しか確認できませんが、cost-xrayはローカルのキャプチャ用ホップとして動作するため、システムプロンプト、ツールスキーマ、MCPサーバーブロック、ツールの実行結果、キャッシュの読み書き、以前の思考ブロックなど、リクエスト時のコンテキストを確認できます。
cost-xray は無料で使えますか?ライセンスは?
cost-xray は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
cost-xray は今もメンテナンスされていますか?
活発にメンテナンス中。cost-xray の最終コミットは 2026年11月5日 です。
cost-xray は何に使えますか?
コーディングエージェントのセッションが予想外に高コストになっている原因を調べる。 使われていないMCPサーバーや大きなツールスキーマによって、すべてのリクエストが肥大化していないか確認する。 プロンプトキャッシュが安定したプレフィックスに適用されているか確認し、予期しないキャッシュの書き換えを見つける。 コーディングエージェントがモデルAPIに送信するコンテキストをローカルで監査する。
cost-xray のインストール方法は?
Claude Code または Codex がインストールされた macOS または Linux を使用していることを確認します README に記載されている公式のインストールスクリプトを実行します 新しいターミナルを開き、ライブ TUI を起動します: cx
cost-xray はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/tigerless-labs/cost-xray

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト