claude-replay

Công cụ cộng đồng
Claude Code sessions hữu ích cho phát triển nhưng khó chia sẻ. claude-replay biến các bản ghi của Claude Code thành các bản phát lại HTML tương tác, dễ chia sẻ. File HTML này là tự chứa, không phụ thuộc ngoài — bạn có thể gửi email, lưu trữ ở bất kỳ đâu hoặc nhúng vào tài liệu.
Đặc điểm nổi bật
- File HTML tự chứa
- Phát lại tương tác với điều khiển tốc độ
- Thu gọn/mở rộng các đoạn gọi tool và suy nghĩ
- Đánh dấu trang / chương
- Che giấu thông tin mật trước khi xuất
- Nhiều chủ đề màu sắc
- Cuộn từ dưới lên theo kiểu terminal
- Có thể nhúng qua iframe
Trường hợp sử dụng
- Bài viết blog — Trình diễn các phiên phát triển với AI
- Tài liệu — Nhúng phiên gỡ lỗi AI hoặc hướng dẫn mã
- Demo — Chia sẻ phiên không cần video
- Báo cáo lỗi — Đính kèm phát lại thay vì log dài
- Giảng dạy — Trình diễn quá trình suy luận của AI và sử dụng công cụ
Cài đặt
npm install -g claude-replay
Hoặc chạy trực tiếp với npx:
npx claude-replay session.jsonl -o replay.html
Khởi động nhanh
# Tìm bản ghi phiên
ls ~/.claude/projects/*/
# Tạo phát lại
claude-replay ~/.claude/projects/-Users-me-myproject/session-id.jsonl -o replay.html
# Mở file
open replay.html
Sử dụng
claude-replay <input.jsonl> [options]
Lựa chọn
| Lựa chọn | Mô tả |
|---|---|
-o, --output FILE | File HTML đầu ra (mặc định: stdout) |
--turns N-M | Chỉ bao gồm phần N đến M |
--from TIMESTAMP | Lọc thời gian bắt đầu (ISO 8601) |
--to TIMESTAMP | Lọc thời gian kết thúc (ISO 8601) |
--speed N | Tốc độ phát ban đầu, ví dụ 2.0 (mặc định: 1.0) |
--no-thinking | Ẩn phần suy nghĩ theo mặc định |
--no-tool-calls | Ẩn phần gọi công cụ theo mặc định |
--theme NAME | Chủ đề tích hợp (mặc định: tokyo-night) |
Các ví dụ
# Phát lại từ phần 5 đến 15 với tốc độ 2x
claude-replay session.jsonl --turns 5-15 --speed 2.0 -o replay.html
# Lọc theo phạm vi thời gian
claude-replay session.jsonl --from "2026-02-26T02:00" --to "2026-02-26T03:00" -o replay.html
Tùy chỉnh chủ đề
Tạo file JSON với giá trị màu CSS:
{
"bg": "#0d1117",
"text": "#e6edf3"
}
Sử dụng:
claude-replay session.jsonl --theme-file my-theme.json -o replay.html