daaain/claude-code-log

A Python CLI tool that converts Claude Code transcript JSONL files into readable HTML / Markdown format.

Claude Code Log – 是什么

Claude Code Log 是一个 Python 命令行工具，可将 Anthropic 的 Claude Code IDE 生成的 JSONL 转录文件转换为干净、可搜索的 HTML 页面或 Markdown 文档。它允许您浏览、过滤并导出与 Claude Code 的每一次对话——从单个会话文件到整个 ~/.claude/projects/ 层次结构。

为何要使用它

回顾过往工作 – 以可读的时间线查看所有提示、助手回复、工具调用和令牌使用情况。
成本意识 – 令牌使用计数器显示每个会话（或整个项目）的成本。
共享与归档 – 生成的 HTML 页面可在浏览器中打开，或与团队成员共享。
搜索与分析 – 按日期、消息类型或关键词过滤；导出紧凑的 Markdown 版本，可输入到 LLM 中进行模式识别。
实时监控 – watch 模式在 Claude 会话编写过程中实时重新生成输出，保持 Obsidian 笔记或浏览器视图的最新状态。

核心功能（如 README 所述）

功能	作用
交互式 TUI	终端用户界面，用于浏览会话、查看摘要，并通过快捷键触发 HTML/Markdown 导出。
监视 / 服务模式	`claude-code-log watch` 实时更新文件；`serve --watch` 启动本地服务器，新消息到达时自动刷新。
项目级处理	扫描 `~/.claude/projects/`，创建顶层索引页和每个项目的合并转录。
单文件或目录转换	可转换任意 JSONL 文件或文件夹，使用 `--output` 指定目标位置。
令牌使用追踪	显示每条消息的令牌数量及每个会话/项目的总计。
运行时过滤	HTML 中的 JavaScript 控件可隐藏/显示用户、助手、系统、工具使用等，无需重新构建。
时间顺序排序与时间线	所有消息按时间戳排序；交互式可缩放时间线可视化对话流程。
主题	`classic`（默认）和 `minimal` – 后者是密集的亮/暗布局，支持子代理的折叠分支。
日期范围过滤	支持自然语言日期（`today`、`last week`、`3 days ago`）限制包含的消息。
丰富消息类型	支持用户、助手、摘要、系统命令、工具调用/结果、思考步骤和嵌入图像。
Markdown 导出	服务端渲染并支持语法高亮；`--detail` 和 `--compact` 标志可生成适合下游 LLM 分析的简洁版本。
Git 提交链接	检测转录中的 SHA 字符串并转换为指向 GitHub/GitLab/Bitbucket 或自定义 URL 模板的可点击链接。
提供者钩子	通过 `--provider` 和 `--session-id` 实验性支持 Antigravity CLI (`agy`) 和 Codex CLI (`codex`)。

适合谁使用？

使用 Claude Code 并希望永久、可搜索地归档交互记录的 开发者。
需要共享对话日志以供审计、入职或可复现性的团队。
希望分析多个会话中令牌消耗或工具使用模式的 研究人员 / 提示工程师。
偏好静态 HTML 视图或紧凑 Markdown 副本以反馈给其他 LLM 的 任何人。

快速入门（来自 README）

# 无需永久安装即可运行最新版本
uvx claude-code-log@latest --open-browser

该命令扫描您的 Claude Code 项目文件夹，构建 HTML 归档并用默认浏览器打开。如需终端体验，请添加 --tui。

安装选项

uv tool（推荐）：uv tool install claude-code-log
uvx（一次性运行）：uvx claude-code-log@latest
pip：pip install claude-code-log
从源码安装：克隆仓库，运行 uv sync，然后 uv run claude-code-log 或使用 uv tool install --editable . 进行可编辑安装。

限制与待办事项（来自 TODO）

尚未内置教程覆盖层。
图像优化（如将 PNG 截图转换为 WebP）已计划但尚未实现。
与其他 Claude 相关日志（claude-trace、GitHub Action 输出）的深度集成仍在进行中。
部分 UI 优化（渐变动画、工作树合并）仍处于路线图中。

总结

claude-code-log 是一个实用、开源的工具，可将 Claude Code 的原始 JSONL 转录转换为人类友好的、可搜索的归档。它注重可用性（TUI、监视模式、主题），并为开发者提供所需的数据，用于审计成本、共享工作或将过往会话反馈至 LLM 流水线。