Claude Code 会话回放：JSONL 历史浏览工具对比

Claude Code 将每个会话存储为 ~/.claude/projects/ 中的 JSONL 文件。这在数据主权方面很棒——所有数据都在本地。但直接阅读原始 JSONL 文件对于复杂会话来说几乎不可能。

随着 Claude Code 使用量的增长（已达到 10 亿美元 ARR），对会话回放工具的需求也在增长。本指南对比了 2026 年所有可用的方案。

Claude Code 的会话存储位置

# 项目特定会话
~/.claude/projects/<project-hash>/sessions/

# 桌面应用会话（Claude Desktop）
~/Library/Application Support/Claude/claude-code-sessions/  # macOS

每个 .jsonl 文件包含交错的 JSON 对象：用户提示、AI 响应、工具调用（文件读写、bash 命令）、系统消息和 token 元数据。一个复杂会话可能有数百条记录。

工具逐一对比

1. claude-code-log（CLI → HTML）

Python CLI 工具，将 JSONL 转录转换为可读的 HTML。

pip install claude-code-log
claude-code-log --session <session-id>

方面	详情
类型	CLI → HTML 转换器
安装	pip install，简单
查看方式	浏览器中的 HTML
跨会话搜索	❌
代码差异	❌
逐步回放	❌
适合	快速查看单个会话

2. cclog（VS Code 扩展）

在编辑器中直接渲染 Claude Code 会话的 VS Code 扩展。

方面	详情
类型	VS Code 扩展
安装	从市场安装
查看方式	编辑器面板
跨会话搜索	❌
代码差异	有限
逐步回放	❌
适合	不离开 VS Code 浏览会话

3. claude-transcript（CLI）

从 JSONL 文件提取对话文本的轻量级 CLI 工具。

方面	详情
类型	CLI 文本提取器
安装	npm/pip install
查看方式	终端输出
跨会话搜索	❌
代码差异	❌
逐步回放	❌
适合	将会话内容传输到其他工具（grep、less）

4. Mantra — 可视化时间旅行

Mantra 是专为回放 AI 编码会话而构建的桌面应用。它不只是渲染文本——它用可视化差异、工具调用上下文和逐步导航重建整个会话时间线。

方面	详情
类型	桌面应用（Tauri）
安装	下载安装，自动发现会话
查看方式	可视化时间线 + 代码差异
跨会话搜索	✅ 全文搜索所有会话
代码差异	✅ 语法高亮
逐步回放	✅ 时间旅行每个交互
适合	定期复盘会话或管理团队 AI 使用的开发者

综合对比

功能	claude-code-log	cclog	claude-transcript	Mantra
自动发现会话	❌	✅	❌	✅
可视化时间线	❌	❌	❌	✅
代码差异	❌	部分	❌	✅
跨会话搜索	❌	❌	❌	✅
工具调用可见性	✅	✅	❌	✅
Token 用量追踪	✅	❌	❌	✅
多工具支持	❌ 仅 Claude	❌ 仅 Claude	❌ 仅 Claude	✅ Claude + Cursor + 更多
导出选项	HTML	N/A	文本	Markdown
本地运行	✅	✅	✅	✅
免费	✅	✅	✅	✅ 免费版

什么时候用什么

快速查看一个会话：claude-code-log 最快——pip install 然后指向会话文件。

边编码边浏览：cclog VS Code 扩展让你留在编辑器中。

认真的会话管理：Mantra 是唯一提供跨会话搜索、可视化时间旅行和多工具支持的方案。如果你同时使用 Claude Code 和 Cursor 等其他工具，Mantra 将一切统一在一个地方。

深入阅读：Claude Code 日志查看器：浏览和搜索会话历史 包含每个工具的分步安装说明。

相关阅读：

• AI 编码会话回放：为什么你需要一台时间机器
• Cursor 会话历史替代方案
• 如何复盘 AI 编码会话

---

你的 Claude Code 会话包含宝贵的知识。不要让它们以 JSONL 文件的形式沉睡。试试 Mantra — 个人开发者免费使用。