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 local

2. 导出所有会话#

# 导出所有会话为 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-agents

3. 转换指定文件#

uvx claude-code-transcripts json path/to/session.jsonl

all 命令详细参数#

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