liaohch3/claude-tap

Intercept 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.

解决的问题

claude-tap 提供了一种检查 AI 编程代理内部工作机制的方法。它解决了“黑盒”问题，即用户无法看到由 Claude Code、Codex 或 Gemini CLI 等基于 CLI 的代理发送给 LLM 的确切系统提示词、工具调用和对话历史。

工作原理

它作为一个本地代理和追踪查看器。通过通过 claude-tap 运行 AI 代理 CLI，该工具会拦截代理与 LLM 提供商之间的 API 流量。它可以运行在反向代理模式（将代理的 base URL 重定向到 localhost）或正向代理模式（注入 HTTPS_PROXY 和本地 CA 证书）。捕获的流量随后会在实时浏览器查看器中展示，或者导出为可移植的 HTML 文件用于审查。

适用对象

  • 开发者：使用 AI 编程代理并希望调试代理行为的开发者。
  • 提示词工程师：需要确切查看系统提示词和工具模式是如何构建的工程师。
  • 研究人员：从各种代理 CLI 存档版本化系统提示词快照的研究人员。

亮点

  • 广泛的客户端支持：支持包括 Claude Code、Codex、Gemini CLI、Grok Build、Kimi、Cursor CLI 等在内的多种代理。
  • 深度检查：捕获系统提示词、工具定义、工具调用、流式响应和 Token 使用情况。
  • 请求差异对比：允许用户比较相邻的请求，以精确找出轮次之间提示词或上下文的具体变化。
  • 注重隐私：追踪数据存储在用户的本地机器上，并且在记录之前会脱敏常见的身份验证标头。
  • 可移植的产物：会话可以导出为自包含的 HTML 文件，以便于共享或存档。