Was macht Remotion-Setup?
Sie richten ein neues Remotion-Projekt ein und konfigurieren es so, dass der Rest des Workflows so einfach ist wie "Claude etwas sagen". Dies ist die einmalige Umgebungseinrichtung. Führen Sie dies einmal pro Projekt durch; danach springen remotion-compose und remotion-render direkt in die kreative Schleife.
Reagieren Sie sofort. Wenn der Nutzer etwas sagt über Videos mit Claude erstellen – "Remotion einrichten", "ein Remotion-Projekt erstellen", "Ich möchte mit Claude Produktvideos erstellen", "ein Videoprojekt starten" – führen Sie dieses Skill aus.
Schritt 1 – Werkzeugkette überprüfen
Remotion rendert mit Headless Chromium, also überprüfen Sie Node vor dem Scaffold:
node --version # benötigt >= 16; bevorzugt eine aktive LTS-Version
Wenn Node älter als 16 ist, brechen Sie ab und fordern Sie den Nutzer auf, zu aktualisieren (nvm: nvm install --lts && nvm use --lts).
Überprüfen Sie auch, dass npx verfügbar ist (wird mit npm 5.2+ ausgeliefert).
Schritt 2 – Projekt erstellen
npx create-video@latest
Dies ist interaktiv. Empfehlen Sie die Blank (Hello World)-Vorlage – sie ist die sauberste Basis für Produktvideos. Die CLI fragt nach einem Projektverzeichnis und einem Paketmanager; lassen Sie den Nutzer wählen, dann cd in den neuen Ordner und installieren Sie:
cd <projektname>
npm install
Schritt 3 – Remotion Agent Skills installieren
Damit Claude Code die Remotion-eigenen Skill-Kontexte in diesem Repository zur Verfügung hat:
npx remotion skills add remotion
Dies legt die Agent-Skill-Dateien von Remotion im Projekt ab. Falls der Befehl in der installierten Remotion-Version nicht verfügbar ist, weisen Sie den Nutzer auf eine neuere @remotion/cli hin und fahren Sie fort – es ist eine Annehmlichkeit, keine harte Abhängigkeit.
Schritt 4 – Ordnerkonventionen festlegen
Standardisieren Sie die Struktur, damit spätere Skills immer wissen, wo was hingehört:
src/
Root.tsx # registriert jede <Composition> (das Eintragsregister)
index.ts # registerRoot(RemotionRoot)
compositions/ # eine .tsx-Datei pro Video – remotion-compose schreibt hier hinein
public/
assets/ # Bilder, Logos, Audio – referenziert über staticFile()
Erstellen Sie die Ordner, falls die Vorlage dies nicht getan hat:
mkdir -p src/compositions public/assets
src/Root.tsx ist das Register. Jedes Video ist eine hier registrierte <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);
Sinnvolle Standardwerte zur Registrierung: 30 fps und 1920x1080 für horizontale Produktvideos (1080x1920 für vertikale soziale Medien), und kurze Dauern – 90 Bilder bei 30 fps sind 3 Sekunden, und die meisten Produkt-Demo-Videos liegen zwischen 15 und 60 Sekunden (450-1800 Bilder).
Schritt 5 – Eine Google-Schriftart laden
Remotion bietet erstklassige Google Fonts, sodass Texte deterministisch gerendert werden. Installieren und laden Sie einmal:
npm install @remotion/google-fonts
// am Anfang einer Kompositionsdatei laden
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
// dann verwenden: <div style={{ fontFamily }}>...</div>
loadFont() blockiert den Render, bis die Schriftart bereit ist, sodass Text auf dem Bildschirm niemals in einem ungestylten Fallback erscheint. Wählen Sie die Schriftart, die zur Marke passt – tauschen Sie Inter gegen Poppins, Roboto usw. aus.
Schritt 6 – Smoke-Test-Komposition
Schreiben Sie eine triviale Komposition, um zu beweisen, dass die Umgebung Ende-zu-Ende rendert:
// 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 }}>
It works.
</h1>
</AbsoluteFill>
);
};
Stellen Sie sicher, dass es in src/Root.tsx registriert ist (Schritt 4), und rendern Sie es dann:
npx remotion render src/index.ts HelloWorld out/smoke-test.mp4
Der erste Render lädt Headless Chromium herunter (einige hundert MB – rechnen Sie mit einer einmaligen Wartezeit von einigen Minuten bei normaler Verbindung); danach sollte dieser 90-Bilder-Smoke-Test in deutlich unter einer Minute gerendert werden. Wenn out/smoke-test.mp4 einen einblendenden Titel abspielt, ist die Umgebung in Ordnung. Wenn der Render fehlschlägt, liegt es fast immer an (a) Chromium-Download/Berechtigungen, (b) nicht in Root.tsx registrierter Komposition oder (c) einem Node-Versionsproblem aus Schritt 1.
Schritt 7 – Remotion Studio zur Vorschau starten
Für die interaktive Vorschau (Timeline scruben, Hot-Reload bei Änderungen):
npx remotion studio
Dies stellt das Studio unter http://localhost:3000 bereit. Die create-video-Vorlage verknüpft auch npm run dev mit demselben. Lassen Sie Studio während der Iteration laufen – Änderungen an Kompositionsdateien werden sofort heiß nachgeladen.
Ergebnis
Der Nutzer erhält ein funktionierendes Remotion-Projekt: das erstellte Repository mit der src/compositions/ + public/assets/-Struktur, installierte Remotion-Agent-Skills, eine eingebundene Google-Schriftart, eine registrierte Smoke-Test-Komposition, ein gerendertes out/smoke-test.mp4, das tatsächlich abspielt, und das laufende Remotion Studio zur Vorschau. Nichts ist "eingerichtet", bis das Smoke-Test-MP4 existiert und abspielt.
NICHT
- Überspringen Sie nicht die Node-Prüfung und führen Sie den Scaffold trotzdem durch – ein Node unter 16 führt tief im Chromium-Render zu einem verwirrenden Fehler, nicht zur Installationszeit.
- Erklären Sie die Einrichtung nicht für abgeschlossen, ohne den Smoke-Test gerendert zu haben; ein Projekt, das kompiliert, aber noch nie ein MP4 produziert hat, hat die Chromium-Pipeline nicht nachgewiesen.
- Legen Sie Kompositionen oder Assets nicht an willkürlichen Orten ab – spätere Skills (
remotion-compose,remotion-render) verlassen sich auf vorhandenesrc/compositions/undpublic/assets/. - Referenzieren Sie Assets nicht über relative Pfade oder URLs; verwenden Sie
staticFile()auspublic/, sonst funktionieren Render lokal, aber nicht woanders. - Verwenden Sie keine System- oder CSS-importierten Schriftarten für Bildschirmtext – ohne
loadFont(), das blockiert, kann Text auf der Rendermaschine in einer Fallback-Schriftart erscheinen. - Wählen Sie keine funktionsreiche Vorlage für Produktvideos; die Blank-Vorlage vermeidet Demo-Code, den der Nutzer später löschen müsste.
Qualitätskriterien
node --versionist >= 16 und wurde vor dem Scaffold überprüft.out/smoke-test.mp4existiert und zeigt einen einblendenden Titel.- Die Ordnerkonventionen existieren genau wie angegeben, und die Smoke-Komposition ist in
src/Root.tsxregistriert. - Text wird über
@remotion/google-fontsmitloadFont()gerendert, nicht mit einem System-Fallback. - Remotion Studio startet unter localhost:3000 und lädt Änderungen heiß nach.
Übergabe
Sobald der Smoke-Test gerendert wurde und Studio läuft, teilen Sie dem Nutzer mit, dass das Projekt bereit ist, und übergeben Sie: "Die Einrichtung ist abgeschlossen. Beschreiben Sie das gewünschte Video – Dauer, Szenen, Markenfarben – und ich schreibe die Komposition (remotion-compose), rendere und iteriere (remotion-render)."