tigerless-labs/cost-xray

这是什么？

核心功能

• 01通过本地代理抓取 Claude Code 和 Codex 的原始 API 请求，无需 API 密钥，也无需修改 agent 配置。
• 02按来源拆分费用：新输入、缓存读取、缓存写入和输出。
• 03费用可细化到单次工具调用和 MCP 服务器。
• 04展示系统提示词、工具 schema、MCP 定义和消息各自占用的上下文窗口比例。
• 05标记每次请求都注入但从未被调用的 MCP 服务器和工具。
• 06数据写入本地前完成凭据脱敏。

适用场景

• 排查某次编程 agent 会话费用异常偏高的原因。
• 检查未使用的 MCP 服务器或过大的工具 schema 是否拖累每次请求。
• 确认提示词缓存是否命中稳定前缀，并发现异常的缓存重写。
• 在本地审计编程 agent 发送给模型 API 的全部上下文。

快速上手

1. 1

   确认你使用的是 macOS 或 Linux，并已安装 Claude Code 或 Codex

2. 2

   运行 README 中的官方安装脚本

3. 3

   打开新的终端并启动实时 TUI

   cx

使用前须知

• !仅支持 macOS 或 Linux。
• !对于 Claude Code，请求中各来源之间的 token 划分是近似的，但总成本是准确的。
• !Codex 捕获使用本地证书颁发机构，且仅被 codex 命令信任。

收录于专题

标签

常见问题

cost-xray 是什么？

本地代理工具，抓取 Claude Code 和 Codex 的原始 API 请求，并把 token 与费用归因到请求中的各个来源。 cost-xray 用于查看 AI 编程助手实际发送给模型 API 的内容，以及每一部分的费用。基于日志的用量工具只能看到事后的总量，而 cost-xray 作为本地抓包中间层运行，能够获取请求时才拼装好的上下文，包括系统提示词、工具 schema、MCP 服务器定义、工具返回结果、缓存读写以及历史思考块。

cost-xray 可以免费使用吗？用的什么许可证？

cost-xray 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

cost-xray 还在维护吗？

活跃维护中。cost-xray 最近一次提交是在 2026年11月5日。

cost-xray 适合用来做什么？

排查某次编程 agent 会话费用异常偏高的原因。 检查未使用的 MCP 服务器或过大的工具 schema 是否拖累每次请求。 确认提示词缓存是否命中稳定前缀，并发现异常的缓存重写。 在本地审计编程 agent 发送给模型 API 的全部上下文。

cost-xray 怎么安装和运行？

确认你使用的是 macOS 或 Linux，并已安装 Claude Code 或 Codex 运行 README 中的官方安装脚本 打开新的终端并启动实时 TUI: cx

在哪里获取 cost-xray？

源代码和安装说明在 GitHub 上：https://github.com/tigerless-labs/cost-xray