ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

claude-tap追踪查看器完全指南:结构Diff、工具检查器、全文搜索等10大核心功能详解

claude-tap追踪查看器完全指南:结构Diff、工具检查器、全文搜索等10大核心功能详解 claude-tap追踪查看器完全指南结构Diff、工具检查器、全文搜索等10大核心功能详解【免费下载链接】claude-tapIntercept and inspect Coding Agent API traffic from Claude Code, Codex CLI, Gemini CLI, Cursor CLI, OpenCode, Kimi/Kimi Code, Pi, and Hermes in a local trace viewer.项目地址: https://gitcode.com/gh_mirrors/cl/claude-tapclaude-tap 是一个本地代理 AI 编程 Agent 追踪查看器工具可以拦截并检查 Claude Code、Codex CLI、Gemini CLI、Cursor CLI、OpenCode、Kimi、Pi、Hermes 等编码 Agent 的真实 API 流量系统提示词、对话历史、工具调用、流式响应、Token 用量以及相邻请求之间的结构 Diff。所有数据都留在本机无需上传任何私有数据到云端。claude-tap 是什么一分钟上手claude-tap的工作原理很简单它在本地启动一个透明代理把你要追踪的 CLI 通过它启动代理一边把请求转发给真正的 API一边把完整的请求/响应链路记录成本地 trace最后生成一个自包含的 HTML 查看器。# 推荐安装方式 uv tool install claude-tap # 或 pip install claude-tap # 通过 claude-tap 启动 Claude Code默认带实时浏览器查看器 claude-tap # 追踪 Codex CLI claude-tap --tap-client codex # 追踪 Gemini CLI claude-tap --tap-client gemini -- -p hello运行结束后claude-tap dashboard可以随时打开本地面板回看历史会话导出的 HTML 文件则是零外部依赖、可随手分享的静态产物。核心功能 1结构 Diff精准定位哪一行变了多轮对话中 Agent 行为突然变化结构 Diff 会逐字段对比相邻请求新增/删除的消息、系统提示词变更、参数改动并用字符级行内高亮标出差异位置未变化的部分自动折叠一眼锁定根因。比如 Agent 在第 67 轮开始行为异常Diff 可以直接显示系统提示词中x-anthropic-billing-header字段的变更甚至精确到字符级别实现代码位于 claude_tap/viewer_assets/diff.jsDiff 算法与匹配逻辑的测试见 tests/test_diff_matching.py。核心功能 2工具检查器看清 Agent 的能力清单工具检查器Tool Inspector以可展开卡片的形式展示每个工具的名称、描述和参数 Schema同时展示工具调用输入与执行结果。你能快速验证Agent 是否收到了预期的工具定义它调用工具时参数是否正确多轮之间工具 Schema 是否被悄悄修改核心功能 3全文搜索跨消息、工具与提示词内置全文搜索可跨消息、工具定义、系统提示词和模型响应进行检索适合快速定位这段上下文到底出现在第几轮。配合路径筛选与模型分组排查效率大幅提升。搜索与筛选逻辑位于 claude_tap/viewer_assets/filters_search.js。核心功能 4路径筛选只看目标端点侧边栏可按 API 端点如/v1/messages、/v1/responses过滤请求列表在多协议混合的会话中快速聚焦目标流量减少无关请求的干扰。核心功能 5模型分组多模型会话一目了然侧边栏按模型对请求分组并支持 Claude 系列优先排序。当一次会话混合了 opus/sonnet/haiku 或多个客户端时分组视图让你立刻看清每个模型各处理了哪些轮次。核心功能 6Token 用量明细成本与缓存尽收眼底每个请求的详情顶部都展示 Token 用量拆分输入 / 输出 / 缓存读取 / 缓存创建顶部工具栏还会汇总整个会话的总 Token、输入输出占比与总耗时。排查Token 为什么越滚越大时可以直观区分增长来自对话历史、工具结果还是重复上下文。核心功能 7深色模式长时间 Review 不刺眼支持浅色 / 深色主题切换并自动跟随系统偏好。长时间调试会话或夜间 review 时深色模式明显更护眼。核心功能 8键盘导航不碰鼠标也能翻 trace按j/k或方向键即可在请求间上下移动配合全文搜索纯键盘就能完成一轮完整的排查。核心功能 9一键复制Request JSON 与 cURL 随取随用每条请求都支持一键复制完整 Request JSON 或等价的 cURL 命令方便复现请求、转发给同事或手动向 API 重放验证行为。核心功能 108 语言国际化与 iFrame 嵌入查看器内置英文、简体中文、日本語、한국어、Français、العربية、Deutsch、Русский 共 8 种界面语言右上角一键切换。导出的 HTML 还支持 iFrame 嵌入参数如embed1、hideHeader1、densitycompact、themelight|dark可以低打扰地嵌入到你的内部文档或周报中。进阶导出与分享# 回看历史会话 claude-tap dashboard # 导出自包含 HTML 查看器 claude-tap export .traces/2026-02-28/trace_141557.jsonl -o trace.html # 导出紧凑 trace 包之后再渲染 claude-tap export session-id -o trace.ctap.json claude-tap export trace.ctap.json -o trace.html导出文件适合给 PR 附调试证据、与同事共享一次运行、归档模型行为回归对比。所有常见认证 Header 在记录前会自动脱敏trace 数据始终留在本机。延伸阅读资料说明README.md完整安装说明与全部客户端示例docs/guides/agent-trace-viewer.md官方 Agent Trace 查看指南docs/support-matrix.md各客户端环境变量、代理模式与支持矩阵claude_tap/viewer.pyHTML 查看器生成源码claude_tap/export.py导出逻辑源码claude_tap/viewer_assets/查看器前端资源渲染、Diff、搜索等 上手建议先用claude-tap跑一次真实任务 → 用结构 Diff对比相邻轮次 → 用工具检查器核对工具调用 → 用Token 明细定位成本增长点。这四个功能组合起来就是排查 Agent 问题的黄金路径。【免费下载链接】claude-tapIntercept and inspect Coding Agent API traffic from Claude Code, Codex CLI, Gemini CLI, Cursor CLI, OpenCode, Kimi/Kimi Code, Pi, and Hermes in a local trace viewer.项目地址: https://gitcode.com/gh_mirrors/cl/claude-tap创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表