claude-inspector
一个用于拦截和分析Claude Code CLI API流量的本地代理工具。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:claude-inspector。 它的用途是:一个用于拦截和分析Claude Code CLI API流量的本地代理工具。 完整的 Skill 内容见:https://321skill.com/skills/claude-inspector/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
当你发现Claude Code执行一个复杂指令时行为不符合预期,可以使用Claude Inspector。启动代理后,重新运行指令,然后在AI分析标签页中选择捕获到的请求序列,点击“分析会话流程”。Claude Sonnet会为你生成一份详细的步骤总结和流程图,帮你理解是哪个工具调用出了问题,或是子代理的协作出现了偏差。
介绍
Claude Inspector是一个本地MITM代理工具,旨在帮助开发者和AI研究者深入了解Claude Code CLI与后端API之间的实际交互。它能实时拦截Claude Code发出的所有网络请求,让你看到原始JSON载荷、分析会话流程,并理解其内部工作机制,如技能加载、MCP工具调用等。
使用方式非常简单:启动应用并开启代理,然后在终端中设置环境变量ANTHROPIC_BASE_URL=http://localhost:9090来运行Claude Code。所有经过代理的请求和响应都会被捕获并展示在应用界面中,你可以通过四个不同的标签页(AI分析、请求、响应、机制剖析)进行详细审查。
这个工具非常适合智能体开发者、后端工程师以及对Claude内部工作原理感兴趣的研究者。通过它,你可以清晰地看到Claude Code如何将你的指令拆解为工具调用、如何加载MCP服务、以及子代理是如何被创建和调度的。
建议在使用时,先从一个简单的命令开始,观察其完整的请求-响应链条,再逐步尝试更复杂的多步骤任务。注意,此工具仅用于学习、调试和优化目的,请勿将其用于恶意拦截或篡改非你本人授权的流量。
核心特点
与同类网络调试工具(如Charles、Fiddler)相比,它专为Claude Code CLI深度定制,不仅能展示原始JSON,还能通过AI(Claude Sonnet)自动分析会话流程,生成包含Mermaid流程图的机制总结,并智能识别和标注CLAUDE.md、Skills、MCP、Sub-agents等特定机制。
注意事项
目前仅支持macOS系统,且主要针对Claude Code CLI的流量分析,不适用于Web版Claude或其他AI模型。
常见问题
Claude Inspector是做什么的?
它是一个本地代理,用于拦截、查看和分析Claude Code命令行工具与Anthropic API之间的真实通信数据。
使用它需要修改Claude Code的代码吗?
不需要。只需在运行Claude Code时设置一个环境变量,将其流量导向本地的代理服务器即可。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/claude-inspector/raw/index.md 读取 claude-inspector 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/claude-inspector/raw/index.md(查看排版版本)