claude-tap：本地捕获 AI 编程智能体 API 流量的工具

工具用途

claude-tap 是面向 AI 编程智能体的本地代理与追踪查看器。它要么让命令行客户端经本地代理运行，要么监听本地应用的会话转录，从而查看真实的 API 流量与智能体上下文，包括系统提示、对话历史、工具定义、工具调用、流式响应、token 用量，以及相邻请求之间的差异。

使用方式与支持范围

根据上游说明，使用前需要 Python 3.11+ 以及待追踪的客户端。基本方式是运行 claude-tap 启动所选客户端，-- 之后的参数会透传给该客户端；用 --tap-client 指定客户端，如 codex、gemini、kimi、opencode 等。

README 列出可配合多种客户端使用，包括 Claude Code、Codex CLI、Gemini CLI、OpenCode、Kimi CLI、Pi、Cursor CLI 等；不同客户端采用的代理模式不同，例如 OpenCode、Pi、Qoder 默认走正向代理，Cursor 则仅读取会话转录、不拦截其 API 请求。

可查看的内容

• 提示、消息、工具定义、工具调用及其结果
• 重建后的流式响应与 token 用量
• 相邻请求的结构化差异，用于定位哪一处提示、消息、工具或参数发生变化

数据保存与限制

每次运行会在本地写入一个追踪会话，并可导出为自包含的 HTML 查看器，便于审阅或归档。无需托管仪表板，常见认证头在记录前会被脱敏。

需注意：上游文件内容在 Grok Build CLI 一节处被截断，该部分及后续说明不完整；文中出现的模型名、参数示例属于具体客户端的用法示例，不代表工具本身的固定配置。