session-replay

将Claude Code会话转为终端回放GIF

开发流程 全栈开发文档工程师内容创作者 生成GIF动图制作教学演示 claude通用 ★ 1.1k 更新于 2026-08-01

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:session-replay。
它的用途是:将Claude Code会话转为终端回放GIF
完整的 Skill 内容见:https://321skill.com/skills/session-replay-x-6/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我把这个Claude Code会话文件session.jsonl转换成终端回放GIF,设置帧率10fps,终端主题用Monokai。' 它会通过session-replay工具读取JSONL文件,解析每一个操作命令和输出,按时间顺序渲染成终端风格的动画帧,最终合成一个GIF文件。你还可以指定输出文件名和尺寸,生成适合嵌入技术文档或推文的回放动画。

介绍

当你使用Claude Code进行编码时,会话过程会被记录为JSONL文件。这些文件虽然包含完整操作序列,但无法直接分享给他人观看。本工具能将JSONL文件转换为终端风格的动态GIF,直观展示命令输入、输出和代码编辑过程,非常适合用于演示、教学和文档中。

使用方式非常简单:首先确保你有一个Claude Code导出的JSONL会话文件,然后运行本工具指定输入文件,即可生成一个GIF动画。你可以调整帧率、终端尺寸、配色方案等参数,让回放效果更符合你的展示需求。生成的GIF可以直接嵌入网页、文档或社交媒体。

适合所有使用Claude Code的开发者,尤其是需要频繁分享编码过程的全栈开发者、文档工程师和内容创作者。如果你在编写技术教程、录制编码演示、或者需要向团队展示某个问题的排查过程,这个工具能帮你省去手动录屏和剪辑的麻烦。

建议在生成GIF前先预览回放效果,确保关键操作被完整捕获。如果会话文件很大,生成的GIF可能体积较大,可以适当降低帧率或裁剪不必要的操作片段。另外,注意不要在GIF中暴露敏感信息(如API密钥、密码等),因为GIF是静态图片,无法像视频一样被编辑隐藏。

核心特点

与通用录屏工具相比,本工具直接解析Claude Code的JSONL格式,自动聚焦终端操作区域,无需手动裁剪;且生成的是纯终端风格的GIF,不含系统UI元素,更干净专业。

注意事项

仅适用于Claude Code导出的JSONL会话文件,无法转换其他录屏格式或视频文件。

常见问题

生成的GIF文件太大怎么办?

可以降低输出帧率(--fps参数)或跳过空闲时间段(--skip-idle),另外建议只导出关键操作片段,而非整个会话。

如何获取Claude Code的JSONL会话文件?

在Claude Code中完成会话后,可通过导出命令或设置自动保存路径获取JSONL文件,具体请参考Claude Code的文档。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/session-replay-x-6/raw/index.md 读取 session-replay 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。