Diese Anleitung führt das Toolkit whaleyxbt/claude-motion in Ubuntu unter Windows Subsystem for Linux 2 aus. Sie installiert weder Anthropics integrierte Motion-Funktion noch die separate CLI dieser Website. Die Schritte beruhen auf der Projekt- und Microsoft-Dokumentation; wir haben diese Abfolge nicht auf einem Windows-Testrechner überprüft.
1. Die Linux-Umgebung installieren und prüfen
Öffne PowerShell als Administrator, führe den ersten Befehl aus und starte den Rechner bei Aufforderung neu. Öffne Ubuntu und lege das Linux-Benutzerkonto an. Führe den zweiten Befehl in PowerShell aus, um zu prüfen, ob Ubuntu Version 2 verwendet. Microsoft beschreibt diesen Installationsweg für Windows 11 und unterstützte Windows-10-Versionen. Nutze auf einem verwalteten Rechner das von deiner Organisation genehmigte Verfahren. Ab dem nächsten Schritt gehören alle Befehle in das Ubuntu-Terminal, nicht in PowerShell.
wsl --install
wsl --list --verbose2. Die Werkzeuge innerhalb von Ubuntu installieren
Installiere Git, Python 3 und FFmpeg in Ubuntu. Folge der verlinkten Microsoft-Anleitung zu Node unter WSL, um nvm einzurichten. Wähle anschließend mit den folgenden Befehlen die aktuelle LTS-Version von Node. Das Toolkit verlangt Node 20 oder neuer, Python 3 und FFmpeg; nutze eine noch gepflegte LTS-Version, die diese Mindestanforderung erfüllt. Prüfe sämtliche Versionen im selben Terminal. Eine Node-Installation auf dem Windows-Laufwerk ersetzt keine Linux-Installation. Bevor die nvm-Befehle funktionieren, muss nvm eingerichtet sein.
sudo apt update
sudo apt install -y git python3 ffmpeg
# After installing nvm using the Microsoft guide:
nvm install --lts
nvm use --lts
node --version
npm --version
python3 --version
ffmpeg -version3. Das Projekt im Linux-Dateisystem ablegen
Erstelle den Arbeitsordner in deinem Linux-Benutzerverzeichnis und klone das Repository dorthin. Lies README und AGENTS.md, bevor du die Pakete installierst. Wenn Projekt und Werkzeuge im selben Dateisystem liegen, lassen sich verwirrende Pfad- und Berechtigungsprobleme verringern. Beginne nicht in einem synchronisierten Windows-Desktop-Ordner und übernimm keine node_modules von einem anderen Betriebssystem. Falls der Zielordner bereits existiert, prüfe ihn vor einem erneuten Klonen. Lösche kein vorhandenes Projekt, nur um diese Anleitung zu wiederholen.
mkdir -p ~/projects
cd ~/projects
git clone https://github.com/whaleyxbt/claude-motion.git
cd claude-motion
npm install4. Zuerst das mitgelieferte Beispiel rendern
Führe das Build-Skript des Repositorys aus, bevor du das Beispiel veränderst. Laut README ist out/effort.mp4 die Beispieldatei. Der zweite Befehl öffnet den aktuellen Linux-Ordner im Windows-Datei-Explorer. Suche dort die Ausgabe und öffne sie in einem Videoplayer. Prüfe, ob sie abspielt, Ton enthält und die letzte Szene erreicht. Eine erfolgreiche Paketinstallation bestätigt noch keinen funktionierenden Render. Halte bei einem abgebrochenen Build die erste Fehlermeldung fest; unveränderte Wiederholungen erklären die Ursache selten.
npm run build
explorer.exe .5. Vorschau öffnen und den Coding-Agenten einbeziehen
Starte Studio und öffne die im Terminal angezeigte lokale Adresse im Windows-Browser. Lass das Terminal während der Vorschau laufen. Richte deinen Agenten gemäß seiner WSL-Dokumentation ein und öffne dasselbe Projektverzeichnis. Bitte ihn, die Repository-Anweisungen zu lesen, nur eine Überschrift zu ändern, die Zeitabläufe beizubehalten und eine weitere Datei zu rendern. Die Agenteninstallation und der Kontozugang sind eigene Voraussetzungen. Beginne mit dieser begrenzten Änderung, bevor du ein vollständiges neues Video verlangst, damit eine funktionierende Vergleichsversion erhalten bleibt.
npm run studio6. Vor Änderungen an der Animation die Umgebung prüfen
Fehlt ein Werkzeug, zeigen die folgenden Befehle, welche ausführbare Datei Ubuntu findet. Untersuche unerwartete Windows-Pfade, bevor du eine weitere Kopie installierst. Startet Chromium nicht, schlage in Remotions Linux-Abhängigkeiten für deine Ubuntu-Version nach und behebe die konkret fehlende Bibliothek. Startet WSL selbst nicht, nutze Microsofts Hinweise zur Fehlerbehebung. Halte für eine Hilfeanfrage den fehlgeschlagenen Befehl, den ersten Fehler, die Laufzeitversionen und den Projektstand zusammen. Ein Browserstartfehler ist kein Anlass, das Storyboard neu zu schreiben.
which node
which npm
which python3
which ffmpegDein nächster Schritt
Das erste Ziel ist eine abspielbare Beispiel-MP4 aus einer einheitlichen Ubuntu-Umgebung. Bewahre danach den funktionierenden Quellcode auf und mache eine kleine, überprüfbare Änderung, bevor du ein neues Video entwickelst.
Den Arbeitsbereich entdeckenQuellen und weiterführende Informationen
Die Verweise führen zur Originaldokumentation und zu den Urhebern. Die Verfügbarkeit kann sich ändern. Prüfe die Quelle vor einem Abo oder einer Installation.
- Install Windows Subsystem for LinuxMicrosoft
- Set up Node.js on WSL 2Microsoft
- Claude Motion toolkit: requirements and quick startwhaleyxbt
- Linux dependenciesRemotion