首页 技术教程 正文阅读

你的 AI Agent 每次请求都在干嘛?这个开源项目帮你扒个底

emer 2026-06-03
2 0

每天用 Claude Code 写代码,一个月下来账单好几百刀。

但你真的知道这些钱都花在哪了吗?每次请求到底发了多少 token?system prompt 里藏了什么内容?

多轮对话的上下文是怎么一步步膨胀的?工具调用又消耗了多少?这些问题的答案,Agent 工具自己不会告诉你。

最近逛 GitHub 发现一个叫 claude-tap 的项目,帮你偷看 AI Coding Agent 的每一次 API 请求。
你的 AI Agent 每次请求都在干嘛?这个开源项目帮你扒个底 - 第 1 张图
用它能了解 Agent 内部工作机制,也能看看你的 Token 都花在哪里了。

【项目简介】
claude-tap 是一个本地代理和 Trace 查看器。

说得直白一点,它像一个套在你 AI Agent 外面的中间人,拦截所有 API 流量,然后把每一次请求的细节都记录下来。
你的 AI Agent 每次请求都在干嘛?这个开源项目帮你扒个底 - 第 2 张图
system prompt、对话历史、工具定义、流式响应、token 用量,全部可查。

重点是:一行命令就能启动,完全不改你现有的使用习惯。

而且它不挑食。目前支持 9 个主流 AI Coding 客户端:

Claude Code、Codex CLI、Gemini CLI、Kimi CLI、OpenCode、Pi、Hermes Agent、Cursor CLI、Qoder CLI。
你的 AI Agent 每次请求都在干嘛?这个开源项目帮你扒个底 - 第 3 张图
市面上叫得上名字的 AI 编程 CLI 基本都覆盖了。

你的 AI Agent 每次请求都在干嘛?这个开源项目帮你扒个底 - 第 4 张图

【用法】
看见真实上下文你发给 AI 的每一句话,AI 看到的 system prompt,工具的参数 schema,流式响应的每一个 chunk:

全部都能查看。是原始的 API 请求和响应,不是 Agent Loop 的那个信息哦。
你的 AI Agent 每次请求都在干嘛?这个开源项目帮你扒个底 - 第 5 张图
相邻请求 Diff 对比这个功能很实用。

多轮对话的时候,你可以直接对比两次请求之间到底变了什么,哪些消息被加进去了,哪些被删掉了,system prompt 哪里改了。

字符级的 diff 高亮,一目了然。

你的 AI Agent 每次请求都在干嘛?这个开源项目帮你扒个底 - 第 6 张图
Token 用量分析输入多少 token,输出多少 token,缓存命中多少,缓存创建多少。按请求拆开给你看,每一笔账都算得清清楚楚。

月底看账单的时候你就知道钱到底花在哪了。实时查看器加一个 --tap-live 参数,会自动打开浏览器。

Agent 一边跑,你在浏览器里一边看,实时的。每个 API 调用进来,页面就刷新一条记录。离线归档每次运行结束,自动生成一个自包含的 HTML 文件。这个文件可以离线打开,可以发给同事,丢到团队群里让大家一起 review。

不需要装任何东西。数据全在本地所有 trace 数据都存在你本机。不需要注册账号,不需要连云端 dashboard。

认证 header 在记录之前会自动脱敏,不会把你的 API Key 泄露出去。

怎么用呢??

安装就一行命令:uv tool install claude-tap

用 pip 也行:pip install claude-tap

装完直接用。比如你想观察 Claude Code 的 API 请求:claude-tap就这么简单。后面该干嘛干嘛,用完退出的时候会自动生成一个 HTML 查看器。想边跑边看?

加个参数就行:
claude-tap --tap-live

切换到其他客户端也是一行命令的事:
Gemini CLIclaude-tap --tap-client gemini -- -p "hello" Cursor CLIclaude-tap --tap-client cursor -- -p --trust --model auto "hello"

不启动客户端,只开代理也行:
claude-tap --tap-no-launch --tap-port 8080

想看历史 trace:
claude-tap dashboard

上手成本基本为零。装了就能用,用了就能看。

原理很简单
你的 AI Agent 每次请求都在干嘛?这个开源项目帮你扒个底 - 第 7 张图
claude-tap 的核心思路就两条路:
对于支持自定义 base URL 的工具,比如 Claude Code、Codex CLI,它用反向代理模式:把客户端的请求地址指向本地代理,代理再转发到真实 API。对客户端来说完全透明。

对于不支持改地址的客户端,比如 Gemini CLI、OpenCode、Pi,它用正向代理模式:通过 HTTPS_PROXY 环境变量把流量导到本地,配合自签名的 CA 证书完成 TLS 解密。

装好证书之后也是透明的。所有流量经过代理的时候,会被实时记录成 JSONL 格式的 trace 文件。实时模式则通过 SSE 把记录推送到浏览器。退出的时候把 trace 打包成自包含 HTML。

就这么简单。没有花里胡哨的东西,就是把流量拦下来、记下来、展示出来。

开源地址:立即下载

emer

emer

每天发现网络新鲜事

67664 文章
13 分类
10182.9k+ 访问

搜索

Zoomed Image