先看清两个角色：Codex 写代码，Remotion 出画面

很多人第一次听到「用 Codex 做视频」时，脑子里出现的是「对着 AI 说一句话，它自己把片剪好」的画面。这个想象如果不纠正，后面的每一步都会走歪：你会把期望押在「魔法」上，而不是押在流程上。这一章不写一行项目代码，只做一件事——把 Codex 和 Remotion 到底是什么、它们如何分工、你作为人类该站在哪里，彻底想清楚。

1.1 周三要交视频的夜晚：本节要解决的真问题

回到开头那个场景：周四要交 30 秒上新视频，你只有产品图和文案。你有三条路：

• 学剪辑软件：本周内学不会，更做不完；
• 找人代做：来不及，也贵；
• 用代码生成视频：听起来极客，但「用代码写视频」到底是什么意思？

第三条路正是本教程的答案，但它由两个完全不同的工具拼成，缺一不可。很多教程把这两个工具混在一起讲，导致你分不清「哪一步是 Codex 做的」「哪一步是 Remotion 做的」「哪一步出了问题该怪谁」。这一章先把责任边界划清楚，后面所有章节都建立在这张地图上。

1.2 Codex 是什么、不是什么

Codex 是 OpenAI 推出的编码智能体（Coding Agent）：一个跑在你电脑里的程序，能读懂你的项目文件、自己执行终端命令、修改代码，并把过程和结果告诉你。它的官方定位是”Lightweight coding agent that runs in your terminal”（轻量级、运行在终端里的编码智能体），以开源仓库的形式发布，安装后你在终端里输入 codex 就能和它对话。

要把它想清楚，最好同时说清它不是什么：

• 它不是「网页里聊天的 AI 插件」：它在你的项目目录里工作，能看到真实文件、真实报错；
• 它不是「自动剪片软件」：它不输出视频文件，它输出代码改动；
• 它不是「不会犯错的神」：它会猜错 API、改错文件、自作主张，这正是第3章要解决的核心问题；
• 它也不是免费的：它需要 OpenAI 账号（通常配合订阅套餐使用，或配置 API key 后按量计费），具体套餐与额度政策经常调整，以 OpenAI 官方说明为准。

Codex 这类工具的共同工作方式可以概括成一个循环：理解你的需求 → 查看项目现状 → 修改代码或执行命令 → 汇报结果，然后等你给出下一个指令。这个循环在 2026 年已经非常成熟：它可以同时管理多个子任务、在改动前请你批准、也可以被配置成在沙箱里运行以限制它对系统的伤害（第2章会细讲授权与安全）。

你只需要记住一句话：Codex 是你的执行者，不是你的大脑。它替你敲键盘、查文档、跑命令，但「要做什么、做成什么样算好」，一开始就得出自你。

1.3 Remotion 是什么：代码如何变成每一帧

Remotion 是另一回事。它是一个 「用 React 编程式做视频」的框架：你用 JavaScript/TypeScript 和 React 组件描述视频的每一帧长什么样，它负责把这一帧一帧地渲染出来，最终合成一个真正的视频文件（比如 MP4）。

「视频是帧组成的」这句话，在 Remotion 里不是比喻，而是字面事实：

• 你的视频有固定的尺寸（比如 1920 × 1080）和帧率（比如每秒 30 帧）；
• 每一帧，Remotion 都会运行一次你的 React 组件代码，问它「这一帧该画什么」；
• 代码里通常用一个「当前在第几帧」的数字来决定画面：第 0 帧标题在屏幕下方，第 30 帧标题移动到中间——动画就是这么「算」出来的；
• 渲染器把所有这些帧按顺序编码成一个视频文件。

所以 Remotion 的世界里没有时间轴拖拽，没有「关键帧按钮」，只有确定性的代码。任何时刻的画面，都由「当前帧号 + 你的代码」唯一决定。听起来比剪辑软件抽象，但它带来三个普通剪辑软件给不了的好处：

1. 可复用：同一套代码换一组数据，就能批量产出不同内容的视频（第6章）；
2. 可版本管理：视频的「源文件」是代码，可以用 git 管起来，改坏了能回退（第2章）；
3. AI 可编写：因为一切是文本代码，Codex 这样的智能体才能真正帮你写——这正是这套组合成立的根本原因。

1.4 协作心智：导演与执行的分工

把两个角色放在一起看，整条流水线是这样的：

需求（你）→ 代码改动（Codex）→ 逐帧画面（Remotion 渲染器）→ 视频文件（交付物）→ 验收（你）

• 你负责：想清楚视频给谁看、多长、什么节奏、文案是什么、验收标准是什么；
• Codex 负责：把需求翻译成能跑的 React/Remotion 代码，并按照你的反馈反复修改；
• Remotion 负责：忠实地把代码渲染成画面——它不会「理解」你的意图，只会执行代码，代码错它就错给你看。

这个分工意味着：当你看到画面不对劲时，先判断是「需求没说清」还是「代码写错了」。需求没说清，就回去把话说细；代码写错了，就让 Codex 改。把责任分错，是新手最常见的浪费时间的根源——对着写错的代码反复修改需求，或者对着没说清的需求责怪 Codex 太笨。

Remotion 在 2026 年已经是相当成熟的开源框架（其主仓库在 GitHub 上长期保持高活跃度），官方也明确把 Codex、Claude Code 这类编码智能体列为推荐的使用方式：创建一个空项目、启动预览，然后直接在终端里让智能体干活。官方甚至维护了一套「Agent Skills」，用来教智能体遵守 Remotion 的最佳实践。换句话说，「Codex + Remotion」不是社区野路子，而是框架官方支持的主流工作流——这对你很重要：遇到问题时有官方文档和官方推荐流程可以依靠。

1.5 行动：写下你的第一条「导演守则」

1. 我的角色：我负责「要什么」和「怎么算好」；Codex 负责「怎么写」。
2. 完成的定义：画面在预览里亲眼确认过，并逐条对照验收标准，才算完成。
3. 出问题时先归因：是需求没说清，还是代码写错，先分清再行动。

答完这三问，你已经建立了整本教程最重要的地基。下一章开始动手：把两套工具装好、跑通，并且第一次亲眼看到 Remotion 渲染出的画面。