使用 Claude Code 等 AI Coding Agent 时，每月的账单可能高达数百美元。但你是否清楚这些费用具体花在了哪里？每次 API 请求发送了多少 Token？System Prompt 中包含了什么内容？多轮对话的上下文是如何膨胀的？工具调用消耗了多少资源？
通常，Agent 工具本身不会详细告知这些细节。claude-tap 是一个开源项目，可以帮助你监控 AI Coding Agent 的每一次 API 请求。
通过该工具，用户可以了解 Agent 的内部工作机制，并追踪 Token 的具体消耗情况。
项目简介
claude-tap 是一个本地代理和 Trace 查看器。它作为一个中间人，拦截 AI Agent 的所有 API 流量，并记录每次请求的详细信息。
System Prompt、对话历史、工具定义、流式响应、Token 用量等信息均可查看。
该工具支持 9 个主流 AI Coding 客户端：Claude Code、Codex CLI、Gemini CLI、Kimi CLI、OpenCode、Pi、Hermes Agent、Cursor CLI、Qoder CLI，覆盖了市面上主要的 AI 编程 CLI。
核心功能
1. 看见真实上下文
查看发给 AI 的每一句话、AI 看到的 System Prompt、工具参数 Schema 以及流式响应的每一个 Chunk。这是原始的 API 请求和响应，而非 Agent Loop 处理后的信息。
2. 相邻请求 Diff 对比
在多轮对话中，可以直接对比两次请求之间的变化，查看哪些消息被添加或删除，System Prompt 何处被修改。支持字符级 Diff 高亮。
3. Token 用量分析
详细展示输入 Token、输出 Token、缓存命中及创建数量。按请求拆分统计，清晰展示费用去向。
4. 实时查看器
使用 --tap-live 参数可自动打开浏览器，实时查看 API 调用记录。
5. 离线归档
运行结束后自动生成自包含 HTML 文件，支持离线打开和分享，无需安装额外软件。
6. 数据全在本地
所有 Trace 数据存储在本地，无需注册账号或连接云端。认证 Header 在记录前会自动脱敏，保护 API Key 安全。
使用方法
安装命令：
uv tool install claude-tap或：
pip install claude-tap使用示例（观察 Claude Code 请求）：
claude-tap实时查看：
claude-tap --tap-live切换客户端：
claude-tap --tap-client codex
claude-tap --tap-client gemini -- -p "hello"仅启动代理：
claude-tap --tap-no-launch --tap-port 8080查看历史 Trace：
claude-tap dashboard工作原理
claude-tap 的核心原理分为两种模式：
1. 反向代理模式：适用于支持自定义 Base URL 的工具（如 Claude Code、Codex CLI）。将客户端请求地址指向本地代理，代理再转发至真实 API，对客户端透明。
2. 正向代理模式：适用于不支持改地址的客户端（如 Gemini CLI、OpenCode、Pi）。通过 HTTPS_PROXY 环境变量将流量导向本地，配合自签名 CA 证书完成 TLS 解密。
所有流量经过代理时，会被实时记录为 JSONL 格式的 Trace 文件。实时模式通过 SSE 推送记录至浏览器，退出时将 Trace 打包为自包含 HTML。
适用人群
- Claude Code 重度用户：追踪 Token 消耗，了解费用去向。
- Prompt 工程师：查看完整 System Prompt 和上下文传递链路。
- 团队管理者：审计 Agent 行为、进行成本分析。
- Agent 开发者：调试 API 调用、排查问题，相当于 AI Agent 领域的 Wireshark。