跳到正文
子在川上曰
返回

Remotion 入门:让 AI 编程代理帮你做第一个视频

编辑此页

Remotion 是一个用 React 写视频的框架——把视频当成组件来写,时间轴就是 props,改一行代码就能重渲染。2021 年它就出来了,那时候还没有 AI 代理这回事,大家是手写代码做视频的。

现在不一样了。Remotion 官方维护了一套 Agent Skills,把在 Remotion 项目里干活的最佳实践打包成技能包,直接装给 Claude Code、Codex、Cursor、OpenCode 这些编程代理用。你只要描述需求,它来写代码。

本文翻译并整理自 Remotion 官方文档的 Your first video、Installation、Agent Skills、Studio 与 Coding Agents 五页内容,命令与路径均按官方最新文档核对(更新至 2026 年 11 月)。

目录

展开目录

一、先把项目搭起来

1.1 三种起手方式

官方给的第一条路径是直接用编程代理建项目。把下面这段提示词粘给 Claude Code、Codex 或 OpenCode:

确保已安装 Node.js。

安装 Remotion 技能:npx -y skills@latest add remotion-dev/skills -g -y

然后用这些技能帮我做一个视频。

第二条路径是走命令行,最省事:

npx create-video@latest --yes --blank my-video
cd my-video
npx remotion skills add
npm run dev

这会在 my-video 目录里用 Blank 模板建好项目,装上 Agent Skills,并不包含 TailwindCSS。

第三条是用 ChatGPT 桌面版,配合 Remotion 插件可以直接生成一个完整、可本地编辑和渲染的项目。

1.2 模板与向导

create-video 也有交互式向导,可以选包管理器和模板:

包管理器命令
npmnpx create-video@latest
pnpmpnpm create video
Yarnyarn create video
Bunbun create video
Nubnubx create-video@latest

第一次做视频,官方推荐用 Hello World 模板。向导里还会问你要不要一并安装 Agent Skills——要装,这是后面所有步骤的前提。

1.3 系统要求

项目要求
Node≥ 16
Bun≥ 1.0.3(作为运行时基本可用)
macOS15 (Sequoia) 及以上,旧版本不支持
Linuxglibc ≥ 2.35;Amazon Linux 2023 ARM64 支持 glibc 2.34,x64 不支持
Alpine Linux / nixOS不支持

1.4 ESLint

Remotion 模板自带一套推荐的 ESLint 配置。如果你的项目是别的 ESLint 版本,或者想在已有项目里接入,可以参考 @remotion/eslint-config 来适配。

二、装好技能,打开代理

项目起好之后,接下来的动作是:在编程代理里打开这个项目。

官方原文列了几个用得顺手的代理:Codex、Claude Code、Cursor、Copilot、OpenCode,以及 Pi。

2.1 技能怎么装

技能包托管在 GitHub 上(remotion-dev/remotion),两种装法:

npx skills add remotion-dev/skills

或者用 GitHub CLI:

gh skill install remotion-dev/skills

在项目目录里执行 npx remotion skills add 也可以,效果一样。

2.2 技能清单

官方一共维护了 12 个技能:

技能用途
/remotion-best-practices汇总了其他所有技能,不确定用哪个就用它
/remotion-create创建新项目或新 composition
/remotion-markup写 Remotion React 标记的最佳实践:composition、动画、布局、排版、媒体、效果、音频、字体、时间控制
/remotion-studio启动 Studio 预览视频
/remotion-render触发渲染,输出视频或静帧
/remotion-maps地图动画:静态地图、动态路线与标记、地理讲解、Mapbox、MapLibre、MapTiler、GeoJSON、CesiumJS 3D 地理飞行
/remotion-captions字幕与说明文字的处理指引
/remotion-saas用 Remotion 造 SaaS 应用与产品集成的架构指引
/remotion-interactivity让 Remotion 代码在 Studio 里变得可选取、可编辑
/remotion-docs检索 Remotion 文档并以 Markdown 抓取任意页面,实现前先查当前 API 参考、组件 props 和包指南
/remotion-license查找 Remotion 许可证信息、常见问题、条款与购买入口
/remotion-upgrade升级 Remotion、相关包、兼容的 Mediabunny 包以及已安装的 Agent Skills
/remotion-multimedia基于 Mediabunny 的浏览器端多媒体处理,读取音视频元数据

/remotion-docs 这个技能值得单独说一句:它让代理能直接查官方文档的当前版本,而不是靠训练数据里的记忆写 API。改 Remotion 版本之后尤其重要。

2.3 启动代理

另开一个终端,进到项目目录里把代理跑起来:

cd my-video
claude   # 或者 codex / kimi / opencode

三、第一条提示词

这就是 Remotion 文档里说的「用提示词做视频」。

官方推荐的开场提示词有这几条:

  • /remotion-create 把我在下载文件夹里的视频放到时间轴上
  • /remotion-create 给我做一个唱片店的宣传片
  • /remotion-create 给我的视频加字幕:~/Downloads/IMG_0001.mov
Remotion 官方文档中用编程代理制作视频的示意图
官方文档:提示词驱动的视频创作流程

四、预览视频

理想情况下,代理会自动帮你打开 Remotion Studio。没打开的话,运行:

/remotion-studio

也可以直接用命令行。Remotion Studio 需要 Remotion CLI,大多数模板自带,没有的话装一下:

npm i @remotion/cli

启动:

npm start        # 等价于 npx remotion studio
npm run remotion # Next.js / React Router 7 模板

服务会跑在 3000 端口(被占用就往上顺延),浏览器会自动打开 Studio。

Remotion Studio 界面
Remotion Studio:可视化预览与编辑
Remotion Studio 交互式预览
交互式预览界面
Remotion Studio 视频编辑界面
在 Studio 里直接编辑时间轴

Studio 里可以直接浏览和使用 Elements,包含第一方的 Remotion Elements,也可以接入第三方元素库。

五、后续:改与渲染

Studio 里的任何东西都能改——用代理改、用界面改、写代码改,都可以:

  • 选中元素,按 Delete 删掉
  • 再发一条提示词让代理继续改
  • 点顶部的编辑图标直接跳到代码
环节做法
预览/remotion-studio,或在终端跑 npm start
改代码/remotion-create、/remotion-markup,或手动编辑
查文档/remotion-docs
渲染Studio 里按渲染按钮,或 /remotion-render
升级/remotion-upgrade

视频满意之后,按渲染按钮,或者让代理帮你渲染。

六、上手路线

官方文档给「用代码做视频」列了五个进阶方向,按这个顺序读比较顺:

  • 核心理念 —— 视频为什么可以用 React 组件来写
  • 组件 —— <Video>、<Img>、<Audio> 这些内置组件
  • 时间与裁剪 —— useCurrentFrame()、delayRender()、trim() 怎么配合
  • 属性动画 —— 用 interpolate() 和 spring() 做动画
  • 组合组件 —— 把子视频拼进主视频

七、几点提醒

  • 先装技能再提问。没有 /remotion-create 这类技能,代理只能用训练数据里可能过时的 Remotion API 写代码。
  • 代理订阅要花钱。官方明确说大多数编程代理需要付费订阅。
  • Studio 是 3000 端口,跟博客这类站点开发不冲突,但同一个项目里同时起 Astro 和 Remotion 时注意端口。
  • Bun 当运行时是「基本支持」,官方措辞很谨慎,生产环境建议还是用 Node。
  • macOS 版本卡得很死,15 以下直接不支持——不是「可能有 bug」,是官方不提供支持。

参考资料


编辑此页