AI Coding 账单不透明？这个开源工具帮你查清每一笔 Token 消费

你的AI编程助手，到底在偷偷“烧”掉多少Token？

每天用 Claude Code 或类似工具写代码，一个月的API账单动辄几百甚至上千美元。但你是否真正了解，这些钱到底花在了哪里？

是每次请求的Token数量？是冗长的System Prompt？还是多轮对话中不断膨胀的上下文？或者是你从未留意的工具调用开销？

大多数AI Coding Agent（编程智能体）只会告诉你“任务已完成”，却不会为你晒出每一笔API调用的“账单”。最近，一个名为 claude-tap 的开源项目在GitHub上火了，它就像AI Agent界的“Wireshark”，能帮你拦截、记录并可视化每一次API请求的完整细节。

这不仅是开发者的调试利器，更是所有AI重度用户进行成本审计和效率分析的神器。本文将带你深度拆解这个工具，并告诉你如何使用它来洞悉Agent的“黑盒“。

01. 中间人代理：偷看AI的API请求

claude-tap 的核心原理并不复杂，但非常巧妙。它本质上是一个本地代理服务器和Trace查看器。

你可以把它想象成一个放在你的AI编程工具（如Claude Code）和Anthropic等API服务之间的“中间人”。所有从你的工具发出的API请求，都会先经过 claude-tap，它会把请求和响应的完整内容复制一份，记录到本地的JSONL文件中，然后再将请求转发给真正的API。

这个过程对用户和AI工具本身是完全透明的，你无需修改任何使用习惯。它就像一个高精度的“监控摄像头”，忠实记录下AI Agent的每一次思考和行动。

更难得的是，claude-tap 的兼容性极广。它目前支持9个主流AI Coding客户端：

• Claude Code
• Codex CLI
• Gemini CLI
• Kimi CLI
• OpenCode
• Pi
• Hermes Agent
• Cursor CLI
• Qoder CLI

无论你是Anthropic、OpenAI还是Google的忠实用户，这个工具几乎都能覆盖你的使用场景。

02. 功能详解：从Token到上下文的全方位审计

claude-tap 的价值远不止于记录。它提供了一系列强大且实用的功能，让你真正看清AI Agent的内部运作。

看见真实的上下文

这是最核心的功能。你发给AI的每一句话、AI看到的系统提示、工具的参数定义、流式响应的每一个数据块……所有这些原始的API请求和响应，都能被完整地呈现出来。

这让你能彻底理解Agent的“大脑”是如何处理你的指令的。例如，你可以看到System Prompt中是否包含了隐藏的规则，或者工具调用时传入了哪些具体的参数。

相邻请求Diff对比

在多轮对话中，上下文是如何一步步膨胀的？哪些历史消息被保留，哪些被裁剪？System Prompt是否在后续对话中被修改？

claude-tap 的Diff功能可以完美回答这些问题。它能以字符级的精度，高亮显示两次相邻API请求之间的所有差异。新增了什么，删除了什么，一目了然。

这对于调试Prompt和优化上下文窗口极其有用。

Token用量分析：钱都花在哪了？

这是每个付费用户最关心的功能。claude-tap 将每次请求的Token用量拆解得清清楚楚：

• 输入Token
• 输出Token
• 缓存命中Token
• 缓存创建Token

每个数字都对应着具体的请求，让你能精确地知道是哪个步骤、哪一轮对话最“烧钱”。月底看到账单时，你就能有理有据地进行优化。

实时查看器与离线归档

• 实时查看：只需加上 --tap-live 参数，你的浏览器就会自动打开一个实时仪表盘。Agent一边运行，API调用数据一边在页面上刷新，这种“现场直播”的体验非常直观。
• 离线归档：每次运行结束后，claude-tap 会自动生成一个自包含的HTML文件。这个文件可以离线打开，可以发给同事，甚至丢到团队群里让大家一起Review，无需安装任何额外软件。

数据全在本地，安全可控

所有Trace数据都存储在你自己的机器上。你不需要注册任何账号，也不需要将数据上传到云端Dashboard。最关键的是，API密钥在记录之前会自动脱敏，彻底杜绝了泄露风险。

03. 快速上手：一分钟启动你的AI审计工具

安装和使用的门槛几乎为零。

安装：
使用 uv 工具，一行命令即可：

uv tool install claude-tap

或者使用 pip：

pip install claude-tap

使用：
安装后，直接运行 claude-tap，它会自动启动并接管你的 Claude Code 客户端。

claude-tap

当你结束任务退出时，它会自动生成一个HTML查看器。

如果你想实时查看，只需加上 --tap-live 参数：

claude-tap --tap-live

切换其他客户端也非常简单，只需指定 --tap-client 参数：

# 监控 Codex CLI
claude-tap --tap-client codex

# 监控 Gemini CLI
claude-tap --tap-client gemini -- -p "hello"

# 监控 Cursor CLI
claude-tap --tap-client cursor -- -p --trust --model auto "hello"

如果你只想启动代理服务器，而不启动任何客户端：

claude-tap --tap-no-launch --tap-port 8080

如果你想查看历史Trace记录：

claude-tap dashboard

04. 原理揭秘：两种代理模式的无缝切换

claude-tap 的精妙之处在于其优雅的设计。它根据客户端是否支持自定义API地址，采用了两种代理模式。

1. 反向代理模式：对于支持自定义Base URL的工具（如Claude Code、Codex CLI），它会将客户端请求的地址指向本地代理。代理接收到请求后，再转发到真实的API。对客户端来说，它只是在跟一个本地地址通信，完全透明。
2. 正向代理模式：对于不支持修改地址的客户端（如Gemini CLI、OpenCode、Pi），它通过设置 HTTPS_PROXY 环境变量，将流量导向本地代理。配合自签名的CA证书完成TLS解密，同样可以实现透明拦截。

所有经过代理的流量，都会被实时记录成JSONL格式的Trace文件。实时模式下，通过SSE（Server-Sent Events）技术推送到浏览器。退出时，则将所有Trace打包成自包含的HTML文件。

05. 谁应该立即使用？

claude-tap 的目标用户非常清晰：

• 重度AI编程用户：尤其是每天使用Claude Code写代码的人，这是你控制成本、理解Agent行为的必备工具。
• Prompt工程师：想深入理解System Prompt和上下文传递链路，用它比手动翻日志高效一万倍。
• 团队技术负责人：需要审计团队AI Agent的使用情况、进行成本分析、了解Agent的实际行为，生成的HTML报告可以直接作为审查依据。
• AI Agent开发者：调试API调用、排查问题、优化Agent行为，claude-tap 就是你的AI Agent版Wireshark。

开源地址：https://github.com/liaohch3/claude-tap

写在最后

AI编程工具正在重塑我们的开发方式，但随之而来的成本、透明度和可控性问题也日益凸显。claude-tap 的出现，恰好填补了这一空白。它不是一个花哨的玩具，而是一个能帮你省下真金白银、提升开发效率的实用工具。

如果你也在使用AI Agent写代码，不妨花一分钟安装它，看看你的Agent到底在做什么，你的钱都花在了哪里。这或许是优化你AI工作流的开始。