tigerless-labs/cost-xray

解決的問題

大多數 AI 編碼代理使用工具僅讀取本地日誌，忽略了在模型呼叫前組裝的「不可見」請求時上下文——例如系統提示、工具模式和 MCP 塊。cost-xray 提供對實際 API 流量的可見性，清楚展示傳送給模型的內容，以及請求中每個具體部分的成本。

工作原理

它作為本地捕獲中繼，使用 mitmproxy 運行。攔截編碼代理（如 Claude Code 或 Codex）與模型 API 之間的 HTTP/HTTPS 流量。

• 捕獲：對 Claude Code 使用反向代理，對 Codex 使用具作用域的本地 CA 的正向代理。
• 隱私：所有資料均本地儲存於 ~/.cost-xray/，在寫入磁碟前 API 金鑰和敏感資訊已被脫敏。
• 分析：透過獨立的材料化器對捕獲的原始位元組進行分詞和定價，確保不會對即時中繼造成延遲。
• 去重：為節省空間，僅儲存唯一的塊（訊息、模式），並使用每輪的增量（delta）表示重複的會話歷史。

適用對象

希望優化 API 成本、識別上下文視窗中「無用負擔」（如未使用的 MCP 伺服器）並精確理解上下文視窗佔用構成的 AI 編碼代理使用者。

主要亮點

• 細粒度成本歸因：追蹤到單個工具呼叫和特定來源的成本，而非僅限於會話總成本。
• 上下文視窗可見性：清楚展示上下文視窗中實際佔用空間的內容，包括系統提示和工具模式。
• 浪費檢測：標記那些被配置為注入每個請求但從未實際使用的 MCP 伺服器和工具。
• 分詞準確性：使用經過校準的 Claude 私有分詞器估算器，確保總帳單金額精確無誤。
• 自愈式捕獲：封裝器確保若代理中斷，代理可自動重啟代理或直接運行，持續工作。
• TUI 電腦板：提供即時終端使用者介面，可從代理到專案、會話，再到具體 API 呼叫逐層深入分析。