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
這是互動式指令。建議選擇 Blank (Hello World) 範本——這是產品影片最簡潔的基礎。CLI 會要求輸入專案目錄和套件管理器;讓使用者選擇,然後 cd 進入新資料夾並安裝:
cd <專案名稱>
npm install
步驟 3 - 安裝 Remotion Agent 技能
讓 Claude Code 在這個儲存庫中擁有 Remotion 自己的技能上下文:
npx remotion skills add remotion
這會將 Remotion 的 agent-skill 檔案放入專案中。如果已安裝的 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 Fonts 有第一等支援,讓文字能夠確定性地渲染。安裝並載入一次:
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 agent 技能、已接線的 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()阻塞,文字可能會在渲染機器上以替代字型渲染。 - 不要為產品影片選擇功能豐富的範本;Blank 範本避免了使用者在事後必須刪除的示範程式碼。
品質標準
node --version至少為 16,且在建立專案前已檢查過。out/smoke-test.mp4存在且播放淡入的標題。- 資料夾慣例完全按照指定存在,且煙霧合成已在
src/Root.tsx中註冊。 - 文字透過
@remotion/google-fonts搭配loadFont()渲染,而非系統替代字型。 - Remotion Studio 在 localhost:3000 啟動,且編輯後可熱重載。
交接
一旦煙霧測試渲染完成且 Studio 已啟動,告訴使用者專案已準備就緒並進行交接:「設定完成。請描述您想要的影片——時長、場景、品牌顏色——我將撰寫合成(remotion-compose),然後渲染並迭代(remotion-render)。」