claude-tap macOS 菜单栏应用实战一键监控 Claude Code 与 Codex 流量完全指南【免费下载链接】claude-tapIntercept 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.项目地址: https://gitcode.com/gh_mirrors/cl/claude-tapclaude-tap是一款本地 AI 编码 Agent 流量监控与追踪查看器。它的macOS 菜单栏应用Claude Tap.app让你无需打开终端即可一键启动监控Claude Code 和 Codex CLI 的全部 API 流量系统提示词、对话历史、工具调用、流式响应与 Token 消耗全部记录在本地随时回放、对比与导出。本文面向新手带你从零构建这个菜单栏应用并用开始监控 / 停止监控两个按钮完成对 Claude Code 与 Codex 的完整流量抓取。一、为什么需要 macOS 菜单栏监控应用平时用命令行跑claude-tap每次都要敲命令、看终端输出。而菜单栏应用把这一切收敛成一个常驻小图标 ️紧凑状态板菜单栏下拉即可看到当前监控状态、Trace 会话统计Start Monitor / Stop Monitor一键开启或结束监控自动完成代理启动与配置写入Dashboard 快捷入口点击直达完整仪表盘查看历史会话自动还原配置停止监控时逐字节恢复~/.claude/settings.json和~/.codex/config.toml整体工作原理代理拦截 → 本地记录 → 查看器回放如下图所示架构实现可查看 claude_tap/proxy.py、claude_tap/trace.py菜单栏应用逻辑在 claude_tap/macos_app.py。二、安装步骤两步构建 Claude Tap.app1. 安装 claude-tap需要Python 3.11以及你想追踪的客户端Claude Code / Codex CLI# 推荐 uv tool install claude-tap # 或使用 pip pip install claude-tap2. 一键构建 macOS 菜单栏应用claude-tap build-macos-app open dist/Claude Tap.app构建完成后在 Finder 中双击dist/Claude Tap.app菜单栏顶部就会出现 claude-tap 的时钟图标。应用打包逻辑见 claude_tap/macos_bundle.py。小贴士如果希望构建出的 App 不依赖构建者的 Python 环境比如分享给同事使用自包含模式claude-tap build-macos-app --self-contained该模式会生成 Apple Silicon 的 PyInstaller 捆绑包放入Contents/Resources。ad-hoc 签名的构建在首次打开时可能需要在 macOS 安全设置中移除隔离属性或手动批准。三、核心实战Start Monitor 一键开始监控点击菜单栏图标会弹出紧凑的状态面板核心就是两个按钮 Start Monitor开始监控点击后应用会弹出一个确认提示确认后自动完成 4 件事为Claude Code和Codex CLI分别启动本地反向代理将临时 base-URL 写入~/.claude/settings.json将临时配置写入~/.codex/config.toml之后新打开的 Claude Code / Codex 会话流量全部被捕获⚠️ 注意已打开的会话不会生效请重新启动客户端再开始对话。几个智能路由细节详见 README.mdCodex 自定义 Provider 会走所选 Provider 的base_urlClaude Bedrock 自定义网关会被路由但原生 AWS Bedrock 端点保持不动——因为反向模式的 URL 改写会破坏 SigV4 签名本机 CA 证书会在需要时自动信任到当前用户的登录钥匙串不需要sudo证书相关实现见 claude_tap/certs.py Stop Monitor停止监控点击停止后代理进程结束两个配置文件逐字节还原你的 Claude Code 和 Codex 完全回到监控前的状态不留任何痕迹。监控运行时的仪表盘会话列表含 Claude Code 与 Codex 两个 Agent 的会话记录、Token 统计效果如下四、查看监控结果Trace 查看器亮点点击菜单里的 Dashboard 入口或运行claude-tap dashboard即可进入完整仪表盘。点开任意会话你会得到一个零外部依赖的自包含 HTML 查看器请求全览系统提示词、消息历史、工具 Schema 逐条展开结构化 Diff对比相邻两次请求精确看到哪条 prompt / 消息 / 工具参数变了Token 用量分解input / output / cache 读写一目了然深色模式长时间审阅不费眼全文搜索跨消息、工具、提示词、响应检索五、应急操作应用被强杀怎么办极端情况下比如你直接kill -9了应用进程配置可能没来得及还原。此时运行一条命令即可兜底claude-tap monitor-restore它会恢复 Claude/Codex 配置并清理应用记录的监控进程。六、常见问题 FAQQ1菜单栏应用会影响 API 费用或行为吗不会。claude-tap 只做本地透明转发与记录响应按 chunk 低开销透传常见鉴权头在记录前会被自动脱敏Trace 全程保存在本机无需任何云端服务。Q2监控时终端里的 Claude Code 会报错吗不会。客户端无感知代理对 SSE / WebSocket 流式响应按块转发正常对话即可。Q3支持的其他客户端能在菜单栏应用里监控吗菜单栏应用目前内置一键监控Claude Code 与 Codex CLI两条链路其他 15 客户端Gemini CLI、Cursor CLI、Kimi、OpenCode、Pi、Hermes 等可通过命令行方式使用完整对照见 docs/support-matrix.md。Q4如何把某次会话发给同事 Reviewclaude-tap export session-id -o trace.html导出的 HTML 完全自包含直接发文件即可。写在最后 用claude-tap build-macos-app构建出的菜单栏应用把给 Claude Code 和 Codex 抓流量这件复杂的事压缩成了构建一次 两个按钮操作命令 / 动作耗时安装uv tool install claude-tap~1 分钟构建 Appclaude-tap build-macos-app~1 分钟开始监控菜单栏点击 Start Monitor1 秒停止还原菜单栏点击 Stop Monitor1 秒从此你可以随时回答这些问题Agent 这一轮到底带上了多少上下文缓存命中率如何两次请求之间 prompt 究竟改了什么——答案都在本地 Trace 里随时可查、可导出、可分享。【免费下载链接】claude-tapIntercept 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.项目地址: https://gitcode.com/gh_mirrors/cl/claude-tap创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考