本地 AI Agent Trace Viewer

# 看清编程 Agent 真正发出了什么。

claude-tap 捕获 AI 编程 Agent 的真实 API 流量，并生成本地 trace viewer。你可以查看 prompt、工具调用、token 用量、延迟、流式响应和请求 diff，不需要把私有 trace 上传到云端 dashboard。

打开 GitHub 阅读 Trace Viewer 指南

    uv tool install claude-tap
    claude-tap --tap-client codex
    claude-tap export --format html trace.jsonl

打开一次真实 agent 运行，检查每个请求，并对比上下文在多轮之间如何变化。
工具调用查看输入、输出、参数和相邻请求 diff。
Token 用量记录 prompt、completion、cache 和 latency 信息。
HTML 导出生成便于 review 和归档的可移植 trace 文件。
本地优先查看私有 trace 不需要托管 dashboard。

## 为编程 Agent trace 设计，而不是泛用日志。

Agent 运行受到 prompt、工具 schema、重试、流式 chunk 和模型请求格式影响。claude-tap 把这些内容保留下来，让调试从真实 trace 开始。

### 查看完整请求链路

检查 system prompt、对话历史、工具 schema、原始请求体和重建后的响应。

### 用证据调试行为

通过结构化 diff 看清相邻轮次之间是哪条消息、prompt、工具或参数发生了变化。

### 不用服务也能分享 trace

导出自包含 HTML viewer，团队成员可以本地打开用于 review、支持或复盘。

## 一套流程覆盖多种 Agent 客户端。

用同一个本地 trace viewer 查看 Claude Code traces、Codex traces、OpenAI Responses API traces、Gemini traces 和其他编程 Agent 会话。

Claude Code Codex CLI Codex App Gemini CLI Cursor CLI OpenCode Kimi CLI Pi Hermes Agent Qoder CLI Antigravity CLI CodeBuddy CLI
结构化请求 diff 展示上下文如何从一轮变化到下一轮。
亮色和暗色模式适合更长时间的调试和 review。

## 从一次运行到一份 review 证据。

先把 trace 留在本地检查；只有需要分享时，再导出静态 HTML artifact。

运行通过 claude-tap 启动你的 Agent。
捕获记录真实 API 流量和流式响应。
检查搜索轮次、工具、用量、延迟和 diff。
导出保存独立 HTML trace 供 review。

## 从本地 trace 开始。

当你需要理解一个 AI 编程 Agent 到底做了什么，再去调 prompt、比较工具或分享运行记录。

从 GitHub 安装