Claude Code 日志查看器：如何浏览和搜索你的会话历史

Claude Code 已迅速成为许多开发者首选的 AI 编程助手。但随着使用量增长，一个实际问题也随之而来：如何回头查找之前会话中的内容？

Claude Code 将每个会话以 JSONL 文件的形式存储在本地，这对数据主权来说很好，但对人类可读性来说很糟糕。本指南涵盖了查看 Claude Code 会话历史的每种方法，从原始文件解析到专用查看器应用。

Claude Code 的会话存储位置

Claude Code 将会话数据保存在两个主要位置：

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

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

每个会话是一个 .jsonl 文件 — 每行一个 JSON 对象。单个会话可能包含数百行，混合着：

用户提示词和 AI 回复
工具调用请求和结果（文件读写、shell 命令）
系统消息和上下文
Token 使用元数据

直接阅读这些文件对于除最简单会话外的所有情况都不切实际。

工具对比：找到合适的查看器

Claude Code 生态已经产生了几个专用查看器。以下是它们的对比：

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

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

最适合：当你知道要阅读哪个会话时的快速一次性转换。

功能：

将 JSONL 转换为带语法高亮的清晰 HTML
交互式 TUI 浏览会话
包含消息数和 token 用量的会话摘要
轻量 — 仅需 Python，无重依赖

局限：一次只能查看一个会话，无跨会话搜索。

2. Claude Code History Viewer（CCHV）

一个桌面应用，用于浏览和分析 Claude Code 对话历史。

最适合：想要专用应用深入分析会话数据的开发者。

功能：

在 Claude Code、Codex CLI 和 OpenCode 会话间切换
编程活动的交互式柱状图时间线
跨提供商的 token 使用对比
可作为无头 HTTP 服务器运行，支持远程访问

局限：主要专注于分析；浏览大型会话可能较慢。

3. clog（基于 Web 的查看器）

一个带实时监控和跨平台支持的 Web 查看器。

最适合：想要实时监控会话的团队。

功能：

带元数据显示的会话分组
对话线程化
实时日志监控
跨平台 Web 界面

局限：需要运行本地服务器。

4. VS Code 扩展

Claude Log Navigator 和 Claude Code and Codex Assist 将会话查看带入你的编辑器。

最适合：倾向于留在 VS Code 中的开发者。

功能：

无需离开编辑器即可浏览会话
查看会话期间生成的文件差异
跟踪 token 使用和成本

局限：绑定 VS Code；可视化选项有限。

5. Mantra（统一会话管理器）

Mantra 是一个桌面应用，在单一界面中管理来自 Claude Code、Cursor、Gemini 和其他 AI 工具的会话。

最适合：使用多个 AI 工具、希望统一会话管理的开发者。

功能：

自动发现：扫描你的机器，零配置导入 Claude Code 会话
可视化时间线：使用类似视频播放器的进度条导航会话 — 跳转到对话的任何时间点
全文搜索：同时搜索所有 AI 工具的所有会话
上下文因果：理解哪些提示词导致了哪些代码变更
敏感数据检测：自动高亮会话数据中潜在的密钥或凭证
本地优先：一切在你的机器上运行，不发送任何数据到外部服务器

分步操作：使用 Mantra 查看你的会话

下载 Mantra — 支持 macOS、Windows 和 Linux
打开导入向导 — Mantra 自动检测你的 Claude Code 安装并列出可用会话
导入会话 — 选择要导入的项目和会话。Mantra 解析 JSONL 文件，构建可搜索的可视化表示
浏览时间线 — 每个会话在时间线上显示为可视化块。点击展开并拖动浏览对话
搜索一切 — 使用搜索栏在所有导入的会话中查找特定代码片段、函数名或讨论主题

对比表

功能	claude-code-log	CCHV	clog	VS Code 扩展	Mantra
查看会话	是	是	是	是	是
跨会话搜索	否	有限	否	有限	全文
可视化时间线	否	图表	否	否	完整
多工具支持	否	部分	否	部分	完整
实时监控	否	否	是	否	是
隐私（仅本地）	是	是	是	是	是
Token 分析	基础	详细	基础	基础	详细
设置复杂度	低	中	中	低	低

Claude Code 会话管理建议

理解会话结构：每个 .jsonl 行是一个独立的事件。type 字段告诉你它是人类消息、助手回复还是工具调用。
定期清理：旧会话会累积。定期检查并归档已完成项目的会话。
使用项目组织：Claude Code 按项目目录哈希组织会话。如果你始终从同一项目根目录工作，你的会话将被归组在一起。
备份你的会话：~/.claude/ 目录包含所有会话数据。将其纳入你的备份流程。
查看 token 用量：显示 token 计数的会话查看器帮助你理解 API 消耗并优化提示策略。

结论

Claude Code 强大的 AI 能力和基础的会话管理之间存在真实的差距。无论你选择轻量级 CLI 转换器进行快速查找，还是像 Mantra 这样的全功能桌面应用进行全面的会话管理，关键是拥有可靠的方式来访问和搜索你的会话历史。

随着 Claude Code 持续发展，你的会话档案变成了越来越有价值的知识库。今天投资一个好的查看器意味着你始终能找到几周或几个月前那个关键的对话。

准备好掌控你的 Claude Code 会话了吗？ 获取 Mantra — 所有 AI 编程会话的统一查看器。

Claude Code 日志查看器：如何浏览和搜索你的会话历史 ​

Claude Code 的会话存储位置 ​

工具对比：找到合适的查看器 ​

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

2. Claude Code History Viewer（CCHV） ​

3. clog（基于 Web 的查看器） ​

4. VS Code 扩展 ​

5. Mantra（统一会话管理器） ​

分步操作：使用 Mantra 查看你的会话 ​

对比表 ​

Claude Code 会话管理建议 ​

结论 ​