博客 · 2026-11-17

HyperFrames 在 Claude Code 里实测:6 条产品片,2 轮修改

同一条 15 秒产品片的需求,我们让 Claude Code 做了 6 次:3 次装 HeyGen 的 HyperFrames skill,3 次用原生 Claude Code,再提两轮修改。每次都渲出了合格的 1080p 成片。HyperFrames 把真实网站搬进了画面,耗时约三倍,每轮修改两分钟左右。

概述

想让视频看起来像你自己的产品,就值得装 HyperFrames。装上它的 skill,Claude Code 抓取了 agentcraft.dev,沿用网站的字体、配色和图库图片,再用 HyperFrames 命令行渲染。原生 Claude Code 也每次都交出了合格的成片,更快更省,画面是干净的文字动画。要做带品牌、之后还会反复改的视频选 HyperFrames;只要一张标题卡,原生 Claude Code 就够了。

上面这条是 HyperFrames 改完两轮后的成片:换掉了图库图片,加了一段柔和的背景音乐。

最要紧的三条:

  • 每次都渲出来了。 6 条成片都是 1920×1080、30 帧、正好 15.0 秒,计数器都停在 5,087。
  • HyperFrames 把网站搬进了画面。 3 条 HyperFrames 成片都用了抓下来的真实图库图片;3 条原生成片都只有文字。3 次 HyperFrames 里有 2 次还挑中了图库里的一张动漫海报和一张耳机广告,抓取会把页面上的东西都拿来,要自己把关。
  • 改起来很快。 换图用了 81 秒、0.020 美元;让计数器停住并加音乐用了 127 秒、0.019 美元。

怎么测的

  1. 需求。 所有运行用同一段提示词:为 AgentCraft 做一条 15 秒、1920×1080 的产品介绍片,三拍:名字淡入,一句讲提示词附真实成品,一句讲 skills 目录并让 5,087 这个数字从零数上去,最后是网址,在本机渲染成 MP4。
  2. 分组。 HyperFrames 组:把 heygen-com/hyperframes 的 4 个核心 skill(hyperframes、hyperframes-cli、hyperframes-registry、media-use)放进 .claude/skills/,提示词以 Using /hyperframes 开头并点名 npx hyperframes 命令行。原生组:同样的需求,空文件夹。两组都禁止登录 HeyGen、发布、分享和云端渲染。
  3. 安装。 官方的 npx skills add heygen-com/hyperframes 会克隆整个仓库,约 540 MB,我们这边克隆中途断了,于是只检出它的 skills 目录,把 4 个 skill 拷进去。
  4. 运行。 每组 3 次,每次都是新开的 claude -p 会话,Claude Code 2.1.322,加 --model haiku 和 --setting-sources project。费用、轮数和 token 取自 Claude Code 的 JSON 输出,耗时按实际时钟算。
  5. 检查。 每个 MP4 都用 ffprobe 核对,并在 2、6、10、11 到 12、14 秒处截帧。然后在新会话里,对第一个 HyperFrames 项目提了两轮修改。

我们最早跑的 3 次原生组翻了上层目录,读到了这次测试的笔记和第一个 HyperFrames 项目,照着做了。这 3 次作废,原生组换到隔离的文件夹重跑,下面的数字都来自重跑的结果。

测试结果

HyperFrames原生 Claude Code
渲出合格的 15 秒 1080p 成片3/33/3
计数器停在 5,0873/33/3
画面里有真实网站图片3/30/3
带进了动漫角色或品牌产品图2/30/3
耗时中位数272 秒92 秒
平均费用0.032 美元0.012 美元
轮数中位数2913
输出 token 中位数13,9108,358

两条 15 秒 AgentCraft 介绍片各 4 帧:上面是改过两轮的 HyperFrames 版本,有图库图片和停在 5,087 的计数器;下面是原生 Claude Code 版本,深色背景上的文字

两组各自怎么做的:

  • HyperFrames 按 skill 的流程走:npx hyperframes capture https://agentcraft.dev 抓取文字、配色、字体和图片,init 建项目,写一个带时间轴动画的 index.html,check 检查,snapshot 看关键帧,render 出 MP4,最后用 ffprobe 核对。第一次运行里抓站就花了约两分钟。第一次运行的 check 查出一处字号太小,渲染前就改掉了。
  • 原生 Claude Code 写了一个 Python 脚本逐帧绘制,再把帧送进 ffmpeg。我们的机器装有 ffmpeg,但它在 agent 的 PATH 之外,所以每次原生运行都自己找来一个编码器包:npm 的 ffmpeg-static、新建虚拟环境里的 imageio-ffmpeg、用 pip 装的 static-ffmpeg。它们装的东西我们事后都清掉了。
  • 两轮修改 在第一个 HyperFrames 项目上进行。第 1 轮把动漫海报和耳机广告换成了海獭、纸模奶牛和一张旅行海报,版式照旧,还主动指出新换的一张卡片标题被裁掉了。第 2 轮,计数器在 11.0 秒到达 5,087 并停到网址出现;音乐是它自己生成的:写了一个 Node 脚本,把一段柔和的合成音垫写成 WAV 文件。第 2 轮的渲染本身约 8 秒。

推荐

要反复修改的品牌产品片: HyperFrames,11 月 15 日 84,399 星,Apache 2.0 许可。在 Claude Code 里用 claude plugin marketplace add heygen-com/hyperframes 和 claude plugin install hyperframes@hyperframes 装插件,然后提需求并说明要抓哪个网站。项目留下的是 HTML,用对话就能改,我们的测试里每次重新渲染只要几秒。

快速做一张标题卡或计数动画: 原生 Claude Code。告诉它分几拍、多长,它会自己写逐帧渲染再编码。先把 ffmpeg 放进 agent 的 PATH,免得它自己去装。

两种都一样: 写明哪些图片可以出现。抓取会拿走页面上的所有图,我们的图库里就有属于别人的同人图和产品广告。

该忽略什么

  • 耗时当质量。 HyperFrames 多出来的时间大多花在抓站和检查画面上,画面更丰富也来自这里。
  • Studio 桌面版。 HyperFrames 另有免费桌面应用,Pro 套餐接入 HeyGen 的模型;这次只在本机用了开源的命令行和 skill。
  • 我们的美元数字当你的账单。 这是 Haiku 做一条 15 秒短片的价格。片子更长、换更大的模型或多改几轮,都会更贵。

常见问题

HyperFrames 是什么?

HeyGen 开源的视频框架,把 HTML、CSS、媒体和可拖动时间轴的动画渲染成 MP4。可以用它的命令行,也可以让编程 agent 通过 skill 调用,或者用桌面应用。它的口号是 Write HTML. Render video. Built for agents.

要装哪些东西?

Node 22 或更新版本、ffmpeg,以及命令行能无头运行的 Chrome。npx hyperframes doctor 会逐项检查;我们这台提示 Docker 和 Kokoro 语音合成缺失,只靠 Node、ffmpeg 和 Chrome 就能正常渲染。

能加音乐或配音吗?

第 2 轮修改里,它自己生成了一段合成音乐,作为音频元素挂进合成。skill 里还有通过 Kokoro 做语音合成的说明,这次测试跳过了 Kokoro。

局限

一个需求,每组 3 次,一个小模型。修改只在一个项目上做了一遍。我们靠截帧和 ffprobe 判断成片;哪条更好看有一部分是口味,请自己看上面的成片和关键帧。

自己复现

脚本是运行脚本:bash run.sh hf 1 或 bash run.sh plain 1,旁边的 proj/.claude 文件夹里放 4 个 skill 和一个禁止登录、发布的设置文件。原生组放在隔离的文件夹里跑,远离测试资料。hyperframes-claude-code-2026-11.json 里每次运行一行:耗时、费用、轮数、token 和画面里出现了什么,另有两轮修改的记录。

来源

  1. heygen-com/hyperframes · official
  2. HyperFrames 文档:快速开始 · official
  3. Claude Code 文档:Agent Skills · official
  4. AgentCraft:Claude Code 内容与多媒体 skill · blog