夜雨聆风
目录
一、你是不是也有这种困惑
二、claude-tap 是干什么的
三、它大概怎么工作的
四、打开报告页，你能看到什么
五、支持哪些工具
六、三分钟上手
一、你是不是也有这种困惑
用 Claude Code、Cursor、Codex 这类 AI 编程助手写代码时，界面里往往只有「它在想」「它在调工具」「它回了一段话」。真正发到模型那边的那一大包内容——系统提示词、历史对话、工具定义、每次多带了什么上下文——通常是看不见的。
于是就会出现一些很常见的疑问：
为什么这次回答变笨了？是不是上下文被塞满了？
它到底调了哪些工具？参数长什么样？
Token 花在哪了？缓存有没有生效？
换了个模型或网关，请求体到底变了没有？
靠猜很累，靠日志又往往不全。claude-tap 想解决的就是这件事：在你本机把 AI 编程工具的 API 流量拦下来、记下来，再用一个好看的页面帮你逐条看清楚。
二、claude-tap 是干什么的
一句话：本地代理 + 抓包记录 + 可视化报告。
你不用改客户端源码，也不用把数据上传到别人的服务器。正常运行你的 CLI（比如 claude、codex、cursor），只是前面加一层 claude-tap 启动。它会：
在中间起一个本地代理；
把客户端的请求原样转发到真实 API；
把每一对「请求—响应」写进本地的
trace_*.jsonl；退出时生成一份单文件 HTML 报告，用浏览器就能打开，还能开实时模式边跑边看。
三、它大概怎么工作的
流程并不复杂，可以理解成「加了个透明中转站」：
几个让人放心的设计：
流式响应几乎不拖慢：SSE、WebSocket 都是边收边转，代理只做记录，不人为卡流。
敏感信息会脱敏：
Authorization、x-api-key等常见鉴权头在写入 trace 前会打码，降低密钥泄露风险。数据留在本机：没有必须注册的云端面板，适合内网、合规要求高的场景。
四、打开报告页，你能看到什么
跑完一轮任务，会拿到一份自包含的 HTML（不依赖外网 CDN）。界面支持中英文，深色模式也照顾到了长时间盯屏的情况。
比较实用的几块：
| 能力 | 你能用来干什么 |
|---|---|
| 按模型分组浏览请求 | 快速找到 Opus / Sonnet 等不同模型的调用 |
| 系统提示词与消息对比 | 看相邻两次请求里，上下文到底多了还是少了 |
| Token 用量拆分 | 分清 input、output、cache 读/写各占多少 |
| 工具（Tool） inspector | 展开看工具名、描述、参数 schema |
| 全文搜索 | 在提示词、工具、回复里搜关键词 |
| 一键复制 curl / 请求体 | 方便复现或发给同事排查 |
五、支持哪些工具
一套工作流，覆盖市面上主流的 AI 编程 CLI，是 claude-tap 的另一个卖点：
包括但不限于：
Claude Code（也支持 VS Code 扩展里配置 wrapper）
Codex CLI、Gemini CLI、Kimi CLI
Cursor CLI、OpenCode、Pi、Hermes Agent
以及 Qoder、Antigravity、CodeBuddy 等
六、三分钟上手
环境要求：Python 3.11+，以及你要分析的那个 CLI 本身已装好。
# 安装（任选一种）uv tool install claude-tap# 或pip install claude-tap
最常用的 Claude Code 场景，直接：
claude-tap想 trace 别的客户端，指定 --tap-client 即可，例如：
# Codexclaude-tap --tap-client codex# Cursor CLIclaude-tap --tap-client cursor ---p--trust--model auto "hello"
项目地址：https://github.com/liaohch3/claude-tap
2026年，锋哥又开始收Python+AI大模型学员了！目前活动，送AI编程+Java编程 VIP
最近锋哥录制了一些AI编程视频教程
高清视频+源码+领取。
扫描下方公众号【小锋学AI 】回复：888，
可获取下载链接
👇👇👇
👆长按上方二维码 2 秒 回复「888」即可获取
