惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

月光博客
月光博客
Apple Machine Learning Research
Apple Machine Learning Research
IT之家
IT之家
阮一峰的网络日志
阮一峰的网络日志
雷峰网
雷峰网
S
SegmentFault 最新的问题
量子位
有赞技术团队
有赞技术团队
V
V2EX
宝玉的分享
宝玉的分享
Hugging Face - Blog
Hugging Face - Blog
B
Blog
H
Hackread – Cybersecurity News, Data Breaches, AI and More
Jina AI
Jina AI
C
Check Point Blog
G
Google Developers Blog
博客园 - 叶小钗
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
博客园_首页
T
Tailwind CSS Blog
B
Blog RSS Feed
让小产品的独立变现更简单 - ezindie.com
让小产品的独立变现更简单 - ezindie.com
酷 壳 – CoolShell
酷 壳 – CoolShell
U
Unit 42

博客园 - 狂师

AI越来越强了,为什么测试人反而越来越累!(为打工人发声) AI 都会写代码了,还要不要学传统编程了? (强烈建议阅读) BrowserAct,给AI Agent配一个真实浏览器,从安装到实战 2026 性能测试工具大盘点:13 款主流压测工具,测试工程师必备! 最近火爆出圈的,FDE 到底是个什么岗位? 2026年AI编程工具大全,33个主流工具一次看懂 为什么都说要做自动化测试,落地却这么难!(附自动化测试的四种死法) AI 测试工具收藏了几十篇,一篇没看?我建了个学习圈子,专治这种... 别只会用 Postman 了,这 15 款接口测试工具你可能还不知道 2026年9月大模型最新排行榜,30款主流AI大模型,第一名有点意外... 公司从零开始推自动化测试,如何落地? AI 测试提效 | 别搞万能 Skill,推荐5 个 Agent Skill 串起 UI 自动化执行到报告生成全流程 为什么团队用了 AI 之后,测试质量反而下降了! 阿里开源:skill-up,一款Agent Skill 评测工具! 整理了一份 DeepSeek Harness 必备插件清单! 我的免费 AI 测试开发学习路线,开源了! UI自动化测试提效必备Skill!一套CI流水线编排 Skill 可以直接抄了... AI 测试丨一句指令生成测试报告,带失败截图、操作录屏、Trace、日志,这套 Skill 思路可以直接抄... AI 测试提效丨从失败排查到自动修复,分享我的Playwright+Skill UI自动化测试失败诊断提效方案! AI 测试 | 把 UI 自动化测试执行固化成五步流程,这套 AI Skill 思路可以直接抄 智谱GLM-5.3+ZCode Agent,真实项目第一手实测! 从 0 到 1,DeepSeek Harness 保姆级安装与使用教程! 一个测试负责人的崩溃:该做的都做了,线上还是炸了 Agent质量怎么评? 想做测试工具却不会写代码?怎么办? 用AI做自动化测试,哪些是真不行,哪些是你不会用? 推荐一款开源 Skill:让 AI Agent 给你做一份"能改"的 PPT,支持 上千套模板! AI 测试提效 | UI 自动化测不出样式 bug?分享 ui-visual-assert + Skill 视觉断言与多浏览器适配方案 公司不给你配 AI,你会自己掏钱吗? AI 测试提效 | 脚本能跑但总挂?分享我的 ui-testscript-enhancer + Skill UI 自动化健壮性增强方案
天天用 Claude Code/Codex,你知道它实际发给模型什么吗?被...
狂师 · 2026-08-11 · via 博客园 - 狂师

你可能每天都在用 Claude Code、Codex、Cursor。

但你有没有想过——它每次发给模型的,到底是个什么样的请求?

系统提示词长什么样?工具是怎么定义的?多轮对话上下文是怎么累积的?token 都花在哪了?不同模型之间,请求结构有啥差别?

一问三不知。

这就是现在 AI 编程助手的现状——好用是好用了,但它是个黑盒

你看不见它发给模型什么,就只能在结果上猜:这次回答不好,是 Prompt 没写好?是上下文太长?还是模型本身不行?没有数据,全是玄学。

最近我发现一个开源项目,把这个黑盒撬开了。

它叫 claude-tap

一句话介绍:本地代理 + 追踪查看器,专门用来拦截 AI 编程 CLI 的 API 流量。

MIT 开源,2.9k star,作者是一个叫 liaohch3 的兄弟。

它干的事情其实就两件:

  1. 在 AI CLI 和模型 API 之间,插一个本地代理
  2. 把每一次请求、每一次响应,都完整记下来,然后给你一个漂亮的查看器

听起来简单,但解决了一个真实痛点——终于能看见 AI 编程助手到底在干什么了。

一款工具,覆盖 16 种主流 CLI

这是我觉得最离谱的地方。

claude-tap 不只能拦截 Claude Code,它还能拦截:

  • Claude 系:Claude Code(含 AWS Bedrock、DeepSeek/GLM 网关)
  • OpenAI 系:Codex CLI、Codex App
  • Google 系:Gemini CLI
  • xAI:Grok Build CLI
  • 月之暗面:Kimi CLI、Kimi Code
  • 小米:MiMo Code
  • Cursor、Qoder、Antigravity、OpenCode、OpenClaw、Pi、Hermes Agent
  • 腾讯:CodeBuddy CLI

数一下,16 种

国外主流的、国内大厂的、新锐开源的,全覆盖。

image.png

装一个工具,所有 AI 编程 CLI 的请求都能看。这个覆盖度,目前我没见到第二个项目能做到。

最杀手的:结构化 diff 对比

光看请求还不够。claude-tap 真正让我眼前一亮的,是这个功能——结构化 diff

什么意思?

AI 编程助手是多轮对话——你发一句、它回一句、你再发一句。每次请求,上下文都在累积变化。

  • 第 1 次请求:系统提示词 + 你的问题
  • 第 2 次请求:系统提示词 + 第 1 轮对话 + 工具调用结果 + 你的新问题
  • 第 3 次请求:又多了第 2 轮的内容

但每两次请求之间,到底多了什么、改了什么、删了什么?

claude-tap 的 diff 视图会给你字符级的高亮对比

  • 系统提示词从 v1 变到 v2,改了哪几个字
  • 工具列表是新增了还是减少了
  • 对话历史是按什么顺序拼接的
  • 有没有偷偷插入什么隐藏指令

这对调试 Prompt 的人来说,是核武器。

以前调 Prompt 全靠感觉——"好像这次更差了,但不知道为啥"。现在能直接看到上下文变化,差在哪、改了什么,一目了然。

它的实现原理也很简单,核心思路就两条:

1、对于支持自定义 base URL 的工具,比如 Claude Code、Codex CLI,它用反向代理模式:把客户端的请求地址指向本地代理,代理再转发到真实 API。对客户端来说完全透明。

2、对于不支持改地址的客户端,比如 Gemini CLI、OpenCode、Pi,它用正向代理模式:通过 HTTPS_PROXY 环境变量把流量导到本地,配合自签名的 CA 证书完成 TLS 解密。装好证书之后也是透明的。

所有流量经过代理的时候,会被实时记录成 JSONL 格式的 trace 文件。

实时模式则通过 SSE 把记录推送到浏览器。退出的时候把 trace 打包成自包含 HTML。

就这么简单。没有花里胡哨的东西,就是把流量拦下来、记下来、展示出来。

其他几个我觉得很贴心的设计

第一,认证头自动脱敏。

API Key 这种敏感信息,存下来之前会自动打码。你可以放心地把追踪文件分享出去,不会泄露密钥。

第二,自包含 HTML 查看器。

导出的追踪文件是单文件 HTML,零外部依赖。发给同事、丢到 issue 里、嵌入网页都行——对方不用装任何东西,打开就能看。

第三,macOS 菜单栏 app。

可以一键构建一个 Claude Tap.app,住在状态栏里,点开就是控制面板。macOS 用户狂喜。

第四,实时模式。

默认开启。你边跟 AI 聊,浏览器里边实时刷新请求——不用等会话结束才看。

第五,token 用量分解。

输入 token、输出 token、缓存读、缓存创建——分得清清楚楚。优化成本的时候,这是最基础也最重要的数据。

第六,AWS Bedrock 智能适配。

Bedrock 有三种接入方式(Anthropic 网关、企业代理、原生 SigV4),claude-tap 能自动识别,分别用不同策略捕获。这种细节做得到位,说明作者真的在用。

怎么用?真的就一行命令

安装:

# Recommended
uv tool install claude-tap

# Or with pip
pip install claude-tap

启动(默认是 Claude Code):

claude-tap

就这样。它会自动起代理、起查看器、启动 Claude Code,一条龙。

用其他 CLI 的话,加个参数:

# Codex CLI
claude-tap --tap-client codex

# Gemini CLI
claude-tap --tap-client gemini -- -p "hello"

# Kimi Code
claude-tap --tap-client kimi
claude-tap --tap-client kimi-code

# Cursor CLI
claude-tap --tap-client cursor -- -p --trust --model auto "hello"

# 腾讯 CodeBuddy
claude-tap --tap-client codebuddy

以Claude Code为例

# Pass flags through to Claude Code
claude-tap -- --model claude-opus-4-6
claude-tap -c    # continue last conversation

# Skip all permission prompts (auto-accept tool calls)
claude-tap -- --dangerously-skip-permissions

# Live viewer is on by default; pass Claude flags after --
claude-tap -- --dangerously-skip-permissions --model claude-sonnet-4-6

完整参数表 GitHub README 里都有,不啰嗦了。

重点说三个使用场景

场景一:研究 Claude Code 的系统提示词。

很多人好奇——Claude Code 到底靠什么指令把一个 CLI 整得这么能干?系统提示词怎么组织的?工具怎么定义的?跑一遍 claude-tap,所有底牌都摆在你面前

场景二:调试 Agent 的 Prompt。

你在做自己的 Agent,调了半天效果不对。用 claude-tap 把请求抓下来,对比相邻两次的 diff,立刻能看到上下文是怎么累积的、哪一步出了问题。比你瞎猜快十倍。

场景三:Claude Code 接 DeepSeek,对比原生 Claude 的差异。

很多人在用 DeepSeek/GLM 接 Claude Code 省钱。但你想过没有——同一个 Prompt,发到 DeepSeek 和发到 Claude,请求结构有没有被网关改?工具定义有没有丢?用 claude-tap 跑一遍,立刻清楚。

我觉得这个项目意味着什么

说点我自己的看法。

claude-tap 这种工具的出现,说明 AI 编程助手生态真的在成熟

一年前,大家还在讨论"AI 编程助手好不好用"。现在,大家已经开始关心"它具体怎么工作的"——系统提示词怎么写的、工具怎么定义的、上下文怎么管理的、token 怎么花掉的。

从"凭感觉用",到"看清楚用"——这是一个生态走向成熟的标志。

对几类人,这个工具几乎是必备:

  • Prompt 工程师:调试 Agent Prompt,对比相邻请求是核心能力
  • AI 工具评测者:写评测、做对比,看不见请求就只能凭感觉
  • Agent 开发者:学习主流 CLI 怎么设计系统提示词、工具列表、上下文管理
  • 企业技术负责人:审计 AI 编程助手到底发了什么数据出去,这是合规检查的基础

但我也想说一句——工具只是工具,看请求是为了理解,不是为了逆向。

Claude Code 的系统提示词、工具定义,是 Anthropic 工程师精心设计的成果。看可以,学可以,但直接抄去自己产品里,就不太体面了。

写在最后

如果你自己在做 AI 编程、AI Agent相关的开发、Prompt 工程,想调试 API 调用、排查问题,claude-tap 就相当于 AI Agent 领域的 Wireshark,强烈建议去 GitHub 看看,跑一遍 Demo。

别等所有同行都在用了,你才反应过来。

GitHub 项目地址:github.com/liaohch3/claude-tap