claude-code-transcripts 完整指南#
最简单易用的 Claude Code 会话导出工具,由 Simon Willison 开发,专注于将会话转换为 HTML 页面。
安装#
# 方式 1:uvx 直接运行(无需安装,推荐)
uvx claude-code-transcripts
# 方式 2:pip 安装
pip install claude-code-transcripts
# 方式 3:pipx 安装
pipx install claude-code-transcripts命令列表#
| 命令 | 说明 |
|---|---|
local | 选择并转换本地会话为 HTML(默认命令) |
all | 转换所有本地会话为可浏览的 HTML 归档 |
json | 转换指定的 JSON/JSONL 文件为 HTML |
web | 从 Claude API 导出 web 会话 |
核心功能#
1. 交互式导出本地会话#
uvx claude-code-transcripts
# 或
uvx claude-code-transcripts local2. 导出所有会话#
# 导出所有会话为 HTML 归档
uvx claude-code-transcripts all -o ./claude-archive
# 导出后自动在浏览器中打开
uvx claude-code-transcripts all -o ./claude-archive --open
# 预览模式(不创建文件)
uvx claude-code-transcripts all -o ./claude-archive --dry-run
# 包含 agent 子会话
uvx claude-code-transcripts all -o ./claude-archive --include-agents3. 转换指定文件#
uvx claude-code-transcripts json path/to/session.jsonlall 命令详细参数#
uvx claude-code-transcripts all [OPTIONS]
选项:
-s, --source PATH 源目录(默认 ~/.claude/projects)
-o, --output PATH 输出目录(默认 ./claude-archive)
--include-agents 包含 agent-* 会话文件(默认排除)
--dry-run 预览模式,不创建文件
--open 导出后在浏览器中打开
-q, --quiet 静默模式优缺点#
优点#
- 最简单,命令最少,上手最快
- HTML 输出带样式,移动端友好
- 支持 web 会话导出
- 归档结构清晰(按项目分组)
缺点#
- 只支持 HTML 格式(不支持 Markdown/JSON)
- 没有搜索功能
- 没有日期/发言者过滤
- 不支持 Codex