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/，无遥测数据，敏感字段在存储前已擦除。