Claude Code "透视" 工具：claude-trace 看穿系统提示词 + 工具定义 + 请求参数
Claude Code "透视" 工具：claude-trace 看穿系统提示词 + 工具定义 + 请求参数
来源类型： 工具介绍 + 实战教程
日期： 2026-06-17
标签： #ClaudeCode #claude-trace #系统提示词 #工具定义 #悟鸣AI #可观测性 #开源
核心问题
"Claude Code 到底给大模型发了什么？"
"除了我们在终端里输入的内容，它背后还带了哪些系统提示词、工具定义、上下文和请求参数？"
claude-trace 工具介绍
claude-trace = 一个做得挺完整的观察面板——拦截 Claude Code 发往 Anthropic API 的请求，记录成 .jsonl 日志，同时生成一份可以直接打开的 HTML 报告。
GitHub
- 地址：
github.com/badlogic/lemmy/tree/main/apps/claude-trace
安装
npm install -g @mariozechner/claude-trace
核心能力
1. 直接看到 Claude Code 的"内部"
- 系统提示词
- 工具定义
- 工具输出
- 原始请求和响应内容
"这对想研究 agent 工作流的人来说，非常直观。"
2. 自包含 HTML 文件
- 不需要额外起服务
- 双击 / 浏览器打开即可看
3. 长期记录和回看
- 支持
--index参数 - 扫描
.claude-trace/目录下日志 - 调用 Claude CLI 自动生成会话标题、摘要、索引页
- 唯一注意：这一步会额外消耗 token
实战命令
# 启动带日志记录的 Claude Code
claude-trace
# 包含所有 API 请求（默认只记录更完整的对话）
claude-trace --include-all-requests
# 使用指定参数运行 Claude
claude-trace --run-with chat --model sonnet-3.5
# 显示帮助
claude-trace --help
# 提取 OAuth token
claude-trace --extract-token
# 从 .jsonl 文件手动生成 HTML 报告
claude-trace --generate-html logs.jsonl report.html
# 生成包含所有请求的 HTML
claude-trace --generate-html logs.jsonl --include-all-requests
# 生成对话摘要和可搜索索引
claude-trace --index
默认行为 vs 详细行为
默认行为
"默认情况下，它不会把所有零碎请求都一股脑记下来，而是优先保留更完整、更有分析价值的对话。"
详细行为（--include-all-requests）
"如果你想看得更细，也可以加上
--include-all-requests，把所有请求都抓出来。"
安全设计
敏感请求头脱敏
"源码里对敏感请求头做了脱敏处理，所以它不是那种把 token 原样暴露出来的粗糙脚本，用起来会更安心一点。"
日志位置
"最终日志会保存在当前项目目录下的
.claude-trace/log-YYYY-MM-DD-HH-MM-SS.{jsonl,html}文件里。"
核心价值
对 Agent 工作流研究者
- 直接看到系统提示词
- 理解 Claude Code 的工具调用逻辑
- 学习 Anthropic 的agent 设计
对开发者
- 调试 Claude Code 使用问题
- 优化提示词
- 理解 API 行为
对安全研究者
- 审计请求内容
- 验证脱敏效果
- 理解 API 调用边界
与已有知识的关联
- wiki/entities/claude-code — Claude Code
- wiki/entities/claude-trace — claude-trace 工具
- wiki/entities/badlogic — badlogic（开发者）
- wiki/concepts/agent-observability — Agent 可观测性
- wiki/concepts/system-prompt — 系统提示词
- wiki/concepts/tool-definition — 工具定义
- wiki/concepts/llm-trace — LLM Trace
资料来源
- 原文：https://mp.weixin.qq.com/s/WgXE1xl8zr-Qk3YDMlSv-A
- 原始文件：
raw/articles/claude/Claude Code 到底给模型发了什么？这个工具能直接看.md - 作者：悟鸣 AI
我的判断（高置信度）
这是 2026 年 Claude Code 调试与学习的必备工具——把"黑箱"变成"白盒"。
关键洞察：
1. "拦截 + 记录 + 报告"三件套 —— 完整可观测性
2. "默认不抓所有请求" —— 智能过滤
3. "敏感请求头脱敏" —— 安全设计
4. "--index 自动摘要" —— 长期记录便利
5. "自包含 HTML" —— 离线可看
预测：
- 2026 H2：类似工具可能成为 Agent 标配
- 2027：可能形成"Agent Trace"标准
- 2028：可观测性可能成为 Agent 选型核心指标
- 对 Agent 开发者的建议：
- 立即使用 claude-trace——调试必备
- 学习系统提示词设计——Claude Code 最佳实践
- 关注 token 消耗——--index 会额外消耗
- 对工具派的启示：
- "黑箱变白盒"是 AI 工具的核心价值
- 可观测性 = AI 工具的调试能力
对安全研究者的建议：
- 审计 AI 工具调用——重要安全实践
- 关注脱敏实现——保护 token