claude-replay

社区工具 —— 与 Anthropic 无关，亦未经其背书。

AI 编码会话非常适合开发，但却难以分享。屏幕录制文件过大，而文字日志又难以浏览。

claude-replay 可以将 Claude Code、Cursor、Codex CLI、Gemini CLI 以及 OpenCode 的会话日志转换为交互式、可分享的 HTML 回放。生成的回放是一个无需外部依赖的单体 HTML 文件 —— 你可以通过电子邮件发送、部署在任何地方，或嵌入到文档中。使用 --serve --watch 参数还可以实时监控 AI 代理的会话运行情况。

在线尝试 · 实时演示

Claude Code、Cursor、Codex CLI、Gemini CLI 和 OpenCode 会将对话日志存储在磁盘上。claude-replay 会自动检测格式，并将其转换为适合博客文章、演示和文档的视觉化回放。

来源	日志路径
Claude Code	~/.claude/projects//
Cursor	~/.cursor/projects//agent-transcripts//
Codex CLI	~/.codex/sessions//
Gemini CLI	~/.gemini/tmp//chats/
OpenCode	使用 opencode export 导出

功能特点

• 自包含的 HTML 输出（无依赖）
• 带有速度控制的交互式播放
• 可折叠/展开工具调用和思考块（Claude 的内部推理过程）
• 书签/章节支持
• 导出前支持敏感信息脱敏
• 多种颜色主题
• 终端风格的底部向上滚动效果
• 支持通过 iframe 嵌入
• 实时监控模式 —— 实时查看代理会话（--serve --watch）
• 基于 Web 的编辑器 UI，用于可视化编辑和预览会话

应用场景

claude-replay 适用于：

• 博客文章 — 以交互方式展示 AI 辅助开发会话
• 技术文档 — 嵌入 AI 调试过程或代码演示
• 产品演示 — 无需视频即可分享可复现的会话过程
• Bug 报告 — 附带回放而非冗长的日志文件
• 教学 — 逐步演示 AI 的推理过程和工具使用
• 实时监控 — 在远程机器或容器上实时观察 AI 代理会话

安装

npm install -g claude-replay

或者使用 npx 直接运行（无需安装）：

npx claude-replay

Docker

docker run --rm --init -p 7331:7331 \
  -v ~/.claude/projects:/root/.claude/projects:ro \
  ghcr.io/es617/claude-replay

访问 http://localhost:7331 进入 Web 编辑器。会话目录以只读方式挂载。

CLI 使用示例：

docker run --rm --init \
  -v ~/.claude/projects:/root/.claude/projects:ro \
  -v $(pwd):/output \
  ghcr.io/es617/claude-replay \
  /root/.claude/projects/my-project/session.jsonl -o /output/replay.html

快速开始

# 启动 Web 编辑器（默认）
claude-replay

# 通过会话 ID 生成回放（自动查找文件）
claude-replay abc123def456 -o replay.html

# 或者传入完整路径
claude-replay ~/.claude/projects/-Users-me-myproject/session-id.jsonl -o replay.html

# 将多个会话合并为一个回放
claude-replay session1-id session2-id -o combined.html

直接运行 claude-replay（不加参数）将打开一个基于浏览器的编辑器，自动发现你的 Claude Code 和 Cursor 会话。你可以在其中浏览、编辑、预览并可视化导出回放。

对于 CLI 使用，你只需传入会话 ID —— claude-replay 会自动搜索 ~/.claude/projects/、~/.cursor/projects/、~/.codex/sessions/ 和 ~/.gemini/tmp/ 来找到匹配的文件。或者直接传入会话文件的完整路径。

Cursor

支持 Cursor 日志 —— 格式自动检测。由于 Cursor 日志不包含时间戳，默认播放采用匀速计时（请参阅计时模式）。

claude-replay ~/.cursor/projects/*/agent-transcripts//.jsonl -o replay.html

Codex CLI

支持 Codex CLI (OpenAI) 日志 —— 格式自动检测。Codex 的工具调用（exec_command、apply_patch）会被映射到其 Claude Code 的等价物（Bash、Edit/Write），以便以相同的 Diff 视图和命令预览进行渲染。

claude-replay ~/.codex/sessions/2026/03/12/rollout-.jsonl -o replay.html

Gemini CLI

支持 Gemini CLI 日志 —— 格式自动检测。Gemini 将会话存储为单个 JSONL 文件。