liaohch3/claude-tap

解决的问题

claude-tap 是一个本地代理和追踪查看器，旨在使 AI 编码代理的内部运作透明化。它允许开发者检查实际发送到和来自 LLM 的 API 流量和上下文，这些内容通常被代理的 CLI 或应用程序界面所隐藏。

工作原理

该工具作为 AI 代理（客户端）与 LLM 服务提供商 API 之间的代理。它可以在两种主要模式下运行：

• 反向代理模式：将代理的 API 基础 URL 重定向到本地代理，捕获流量后再转发到目标 API。
• 正向代理模式：向子进程注入 HTTPS_PROXY 和本地 CA 证书，捕获代理与任何提供商通信的流量。

捕获的数据以本地追踪会话的形式存储，可通过实时浏览器查看器查看，或导出为自包含的 HTML 文件用于归档和共享。

适用人群

使用 AI 编码代理（如 Claude Code、Codex、Gemini CLI、Cursor 等）并希望调试代理行为、分析系统提示或审计令牌使用量和工具调用的开发者和 AI 研究人员。

主要亮点

• 深度上下文检查：可查看系统提示、对话历史、工具模式、工具调用以及重构的流式响应。
• 详细调试：可比较相邻请求，精确识别各轮次中提示或参数的变化。
• 广泛客户端支持：支持多种代理，包括 Claude Code、Codex、Gemini、Grok、Kimi、Cursor 等。
• 本地优先隐私保护：追踪数据保留在本地机器上，敏感的认证头在记录前会被屏蔽。
• 可移植的成果物：可将追踪会话导出为独立的 HTML 查看器，用于审查或共享。