liaohch3/claude-tap

这是什么？

核心功能

• 01捕获受支持的编程代理命令行工具的流式 API 请求与响应。
• 02按请求展示系统提示词、工具定义、工具调用与 token 用量。
• 03对比相邻请求，高亮变化的消息、提示词或参数。
• 04可将每次会话导出为独立 HTML 查看器或精简追踪包。
• 05记录前脱敏常见认证头，所有追踪数据保存在本机。

适用场景

• 排查编程代理在多轮对话之间行为变化的原因。
• 审计代理发送给模型的工具定义与系统提示词。
• 对比不同代理会话的 token 用量与上下文增长。
• 归档或分享代理运行的可复现追踪，便于审查。

快速上手

1. 1

   使用 uv 安装 claude-tap（推荐）

   uv tool install claude-tap
2. 2

   通过 claude-tap 运行 Claude Code

   claude-tap
3. 3

   或改为追踪 Codex CLI

   claude-tap --tap-client codex

使用前须知

• !需要 Python 3.11+，以及您要追踪的智能体客户端（需单独安装）。
• !部分客户端（如 AWS 原生 Bedrock）需要额外配置，例如使用正向代理模式。

标签

常见问题

claude-tap 是什么？

本地代理与追踪查看器，捕获 Claude Code、Codex CLI 等 AI 编程代理的 API 流量，便于查看提示词、工具调用与 token 用量。 claude-tap 通过本地代理启动 AI 编程代理的命令行工具，记录真实的 API 请求流量；对于无法代理的客户端，则监听其本地会话记录。每条追踪会展示系统提示词、对话历史、工具定义、工具调用、流式响应、token 用量，以及相邻请求之间的差异。

claude-tap 可以免费使用吗？用的什么许可证？

claude-tap 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

claude-tap 还在维护吗？

活跃维护中。claude-tap 最近一次提交是在 2026年10月19日。

claude-tap 适合用来做什么？

排查编程代理在多轮对话之间行为变化的原因。 审计代理发送给模型的工具定义与系统提示词。 对比不同代理会话的 token 用量与上下文增长。 归档或分享代理运行的可复现追踪，便于审查。

claude-tap 怎么安装和运行？

使用 uv 安装 claude-tap（推荐）: uv tool install claude-tap 通过 claude-tap 运行 Claude Code: claude-tap 或改为追踪 Codex CLI: claude-tap --tap-client codex

在哪里获取 claude-tap？

源代码和安装说明在 GitHub 上：https://github.com/liaohch3/claude-tap