claude-code-trace
一款本地Claude Code会话日志查看器,支持GUI、Web和TUI。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:claude-code-trace。 它的用途是:一款本地Claude Code会话日志查看器,支持GUI、Web和TUI。 完整的 Skill 内容见:https://321skill.com/skills/claude-code-trace/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我查看昨天下午调试树莓派程序的那个Claude会话,看看具体调用了哪些MCP工具,参数是什么。”,它会打开Claude Code Trace,加载历史日志,通过搜索功能快速定位到相关会话,并以可展开的视图展示完整的对话链和工具调用详情,帮助你复盘问题。或者,在运行一个长时间的Claude Code自动化任务时,打开实时跟踪模式,监控每一步的响应和工具调用情况。
介绍
Claude Code Trace 解决了开发者难以直接阅读和分析 Claude Code 本地会话日志(JSONL格式)的问题。这些日志文件记录了AI编码会话的完整历史,包含消息、工具调用和元数据,但原始格式可读性差。
该工具通过读取 ~/.claude/projects/ 目录下的JSONL文件,将原始日志渲染为清晰、可交互的对话视图。用户可以浏览历史会话,实时监控正在进行的会话,按用户消息搜索特定会话,并展开查看工具调用的详细参数、MCP调用、时间戳和Token使用情况。
它非常适合需要深度调试Claude Code工作流、审查AI代码生成过程或构建个人AI助手平台的开发者。无论是排查复杂代码生成问题,还是研究Claude Code与MCP工具的交互模式,都能提供直观的洞察。
使用前请确保Claude Code已在本地生成会话日志。该工具为只读操作,不会修改原始日志文件。建议在调试长会话或监控实时任务时开启实时跟踪功能。
核心特点
专注于Claude Code的本地JSONL日志解析与可视化,提供桌面、网页和终端三种界面,并原生支持MCP工具调用的识别与友好展示,这是通用日志查看器或普通JSON工具所不具备的。
注意事项
仅支持Claude Code生成的特定格式的本地JSONL日志文件,无法用于其他AI工具或远程服务的日志分析。
常见问题
Claude Code Trace 能查看哪些日志?
只能查看 Claude Code 本地存储在 `~/.claude/projects/` 目录下的 JSONL 格式会话日志文件。
它需要网络连接吗?
不需要。所有操作均在本地进行,不依赖网络,保护隐私。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/claude-code-trace/raw/index.md 读取 claude-code-trace 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/claude-code-trace/raw/index.md(查看排版版本)