AIコーディングのトークン使用量と費用を、ツール・モデル・プロジェクト・タスク別に分析するローカルCLI/デスクトップアプリ。
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
Claude Code または Codex がインストールされた macOS または Linux を使用していることを確認します
- 2
README に記載されている公式のインストールスクリプトを実行します
- 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 の数値は毎日更新されます。
関連プロジェクト
Claude Code、Codex、OpenCodeなどのAIコーディングエージェントのトークン使用量、セッションごとのコスト、サブスクリプションのクォータ期間を追跡するローカルダッシュボード。
AIトークンのコストや無駄が生じる場所、支出を抑える方法に関するツール、論文、ベンチマーク、ベンダーページを集めた厳選リスト。
Claude Codeやその他のCLIコーディングエージェントに生産性向上機能を追加する、CLIツール、スキル、フック、プラグインのコレクションです。
46以上のAIコーディングツールのトークン使用量、コスト、上限、セッションを追跡するデスクトップウィジェット。複数デバイス間の同期にも対応。
12種類のハーネスに対応し、AIコーディングエージェントやアシスタントの動作を可視化して、危険なツール呼び出しを実行前にブロックします。