claude-tap

产品简介

claude-tap 是面向 AI 编码智能体的本地代理与链路追踪查看器。让 Claude Code、Codex、Gemini 等客户端的请求先经过它，就能在本机看到真实的 API 流量与智能体上下文：系统提示词、对话历史、工具 Schema、工具调用、流式响应重建、Token 用量与相邻请求的差异，全部可视化。产品由 GitHub 仓库与 PyPI 包分发，作者另提供产品页面，定位是“本地优先的 AI 智能体链路查看器”，不需要托管看板。

核心功能

• 完整请求流检查：系统提示、历史消息、工具定义与调用结果、原始请求体与重建后的流式响应；
• 相邻请求结构化 diff：一眼看出哪条提示词、哪条消息、哪个参数在两轮之间发生了变化；
• Token 用量与延迟：提示词、补全、缓存与延迟元数据逐轮可见，便于定位上下文膨胀；
• 一键导出：每次运行写成本地 trace，可导出为自包含 HTML 查看器，离线打开、归档或发给同事；
• 本地优先：认证头等敏感字段在记录前自动脱敏，trace 全程留在本机；
• 客户端覆盖广：Claude Code、Codex CLI、Codex App、Gemini CLI、Grok Build CLI、DeepSeek Harness、Kimi CLI、MiMo Code、OpenCode、OpenClaw、Pi、Hermes Agent、Cursor CLI、Qoder CLI、Antigravity CLI、CodeBuddy CLI 等。

特色优势

专为智能体链路而不是通用日志设计，提示词、工具 Schema、重试与流式分片这些关键结构被完整保留，调试可以直接从真实 trace 出发；一条命令即可接管现有客户端，参数透传给被代理的 CLI，接入成本极低；跨客户端统一工作流，换工具不用换调试方法；不依赖云端服务，私有代码与提示词不会外泄。

应用场景

• 排查智能体为什么给出意外行为，回看它当时真正收到的上下文；
• 调优提示词前后对比请求差异，验证改动是否生效；
• 定位工具调用失败、Token 暴涨与缓存未命中的原因；
• 把一次运行导出成 HTML，作为复盘材料或工单证据交给同事。

适用人群

开发与调试 AI 编码智能体的工程师；从事提示词工程与智能体评测的研究者；需要向同事复现智能体行为的一线开发者；在多个智能体客户端之间切换、想用同一套方法观测流量的重度用户。

出品方

GitHub 开源项目 liaohch3/claude-tap，PyPI 包名 claude-tap，采用 MIT 许可，README 显示已有 9 位贡献者参与维护；产品页面由作者个人站点提供，另配有 agent 链路查看器的使用指南文档。

更新动态

项目保持活跃迭代，近期重点是扩充可接入的客户端清单（已覆盖 15 类智能体客户端）并补充中英文档与指南；README 持续更新接入方式，社区衍生工具如 Phistory 已基于其“只捕获提示词”的导出能力做提示词快照归档。

官网链接

https://liaohch3.com/claude-tap/