Remotion 搭建
你将搭建一个全新的 Remotion 项目并完成配置,使后续工作流程变成“只需向 Claude 提需求”。这是一次性的环境搭建工作。每个项目执行一次即可;之后 remotion-compose 和 remotion-render 将直接进入创意循环。
请主动触发该技能。如果用户提到任何关于 用 Claude 制作视频 的内容——“搭建 Remotion”、“创建 Remotion 项目”、“我想用 Claude 制作产品视频”、“开始一个视频项目”——请运行此技能。
第 1 步 - 验证工具链
Remotion 使用无头 Chromium 渲染,因此在搭建前先检查 Node:
node --version # 需要 >= 16;建议使用活跃的 LTS 版本
如果 Node 版本低于 16,请停止并告知用户升级(使用 nvm:nvm install --lts && nvm use --lts)。
同时确认 npx 可用(随 npm 5.2+ 一起提供)。
第 2 步 - 搭建项目
npx create-video@latest
这是一个交互式命令。推荐选择 空白(Hello World)模板——它是产品视频最简洁的基础。CLI 会要求输入项目目录和包管理器;让用户自行选择,然后 cd 到新文件夹并安装依赖:
cd <project-name>
npm install
第 3 步 - 安装 Remotion 代理技能
以便 Claude Code 在此仓库中拥有 Remotion 自身的技能上下文:
npx remotion skills add remotion
此命令会将 Remotion 的代理技能文件放入项目。如果已安装的 Remotion 版本中该命令不可用,请提示用户升级到更新的 @remotion/cli 并继续——这是一个便利功能,并非硬性依赖。
第 4 步 - 建立文件夹规范
标准化布局,以便后续技能始终知道文件存放位置:
src/
Root.tsx # 注册每个 <Composition>(入口注册表)
index.ts # registerRoot(RemotionRoot)
compositions/ # 每个视频一个 .tsx 文件 - remotion-compose 将写入此处
public/
assets/ # 图片、标志、音频 - 通过 staticFile() 引用
如果模板未创建这些文件夹,请手动创建:
mkdir -p src/compositions public/assets
src/Root.tsx 是注册表。每个视频都是一个在此注册的 <Composition>:
// src/Root.tsx
import { Composition } from "remotion";
import { HelloWorld } from "./compositions/HelloWorld";
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="HelloWorld"
component={HelloWorld}
durationInFrames={90}
fps={30}
width={1920}
height={1080}
/>
);
};
// src/index.ts
import { registerRoot } from "remotion";
import { RemotionRoot } from "./Root";
registerRoot(RemotionRoot);
注册时使用合理的默认值:横向产品视频使用 30 fps 和 1920x1080(纵向社交媒体使用 1080x1920),以及较短的时长——90 帧在 30 fps 下是 3 秒,而大多数产品演示视频长度在 15 到 60 秒之间(450-1800 帧)。
第 5 步 - 加载 Google 字体
Remotion 对 Google 字体有一流支持,因此文本能够确定性渲染。一次性安装并加载:
npm install @remotion/google-fonts
// 在合成文件顶部附近加载
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
// 然后使用:<div style={{ fontFamily }}>...</div>
loadFont() 会阻塞渲染直至字体就绪,因此屏幕上的文本永远不会闪现无样式的后备字体。选择与品牌匹配的字体——将 Inter 替换为 Poppins、Roboto 等。
第 6 步 - 冒烟测试合成
编写一个简单的合成,以证明环境能够端到端渲染:
// src/compositions/HelloWorld.tsx
import { AbsoluteFill, useCurrentFrame, interpolate } from "remotion";
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
export const HelloWorld: React.FC = () => {
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: "clamp",
});
return (
<AbsoluteFill style={{ backgroundColor: "#0B0B0F", justifyContent: "center", alignItems: "center" }}>
<h1 style={{ fontFamily, color: "white", fontSize: 90, opacity }}>
成功了。
</h1>
</AbsoluteFill>
);
};
确保它在 src/Root.tsx 中注册(第 4 步),然后渲染它:
npx remotion render src/index.ts HelloWorld out/smoke-test.mp4
首次渲染会下载无头 Chromium(几百 MB——在正常网络下预计等待几分钟);之后,这个 90 帧的冒烟测试应在不到一分钟内渲染完成。如果 out/smoke-test.mp4 能播放一个淡入的标题,则环境正常。如果渲染失败,几乎总是因为:
(a) Chromium 下载/权限问题,(b) 合成未在 Root.tsx 中注册,或 (c) 第 1 步中的 Node 版本问题。
第 7 步 - 启动 Remotion Studio 进行预览
如需交互式预览(拖拽时间线、编辑后热重载):
npx remotion studio
这将在 http://localhost:3000 提供 Studio 服务。create-video 模板也将 npm run dev 指向相同的命令。在迭代过程中保持 Studio 运行——对合成文件的编辑会即时热重载。
交付物
用户最终将获得一个可工作的 Remotion 项目:搭建好的仓库,包含 src/compositions/ + public/assets/ 布局、已安装的 Remotion 代理技能、已配置的 Google 字体、已注册的冒烟测试合成、实际可播放的 out/smoke-test.mp4 渲染文件,以及正在运行的 Remotion Studio 用于预览。在冒烟测试 MP4 文件存在并播放之前,不能认为“搭建完成”。
禁止事项
- 不要跳过 Node 检查就直接搭建——低于 16 的 Node 会在 Chromium 渲染深处出现令人困惑的错误,而不会在安装时提示。
- 不要在没有渲染冒烟测试的情况下就宣布搭建完成;一个能编译但从未生成过 MP4 的项目无法证明 Chromium 管线正常工作。
- 不要将合成或资源放在临时位置——后续技能(
remotion-compose、remotion-render)依赖于src/compositions/和public/assets/存在。 - 不要通过相对路径或 URL 引用资源;应使用来自
public/的staticFile(),否则渲染在本地正常,换到其他环境就会出错。 - 不要为屏幕上的文本使用系统字体或 CSS 导入的字体——不使用
loadFont()阻塞,文本在渲染机器上可能以后备字体显示。 - 不要为产品视频选择功能繁多的模板;空白模板避免了携带用户稍后必须删除的演示代码。
质量标准
node --version>= 16,并且在搭建之前已检查。out/smoke-test.mp4存在并播放一个淡入的标题。- 文件夹规范完全按照指定方式存在,并且冒烟合成已在
src/Root.tsx中注册。 - 文本通过
@remotion/google-fonts的loadFont()渲染,而不是系统后备字体。 - Remotion Studio 在 localhost:3000 启动,并且编辑文件后能热重载。
交接
一旦冒烟测试渲染完成并且 Studio 启动,告诉用户项目已就绪并交接:“搭建完成。请描述你想要的视频——时长、场景、品牌颜色——我将编写合成(remotion-compose),然后渲染并迭代(remotion-render)。”