Ce guide utilise Ubuntu dans Windows Subsystem for Linux 2 pour exécuter la boîte à outils whaleyxbt/claude-motion. Il n’installe ni la fonction Motion intégrée d’Anthropic ni la CLI indépendante de ce site. Les instructions reposent sur les documents du projet et de Microsoft ; nous n’avons pas validé cette séquence sur une machine Windows de test.
1. Installer et identifier l’environnement Linux
Ouvrez PowerShell en tant qu’administrateur, exécutez la première commande ci-dessous et redémarrez si cela est demandé. Lancez Ubuntu et créez votre compte utilisateur Linux. Exécutez la deuxième commande dans PowerShell pour vérifier qu’Ubuntu utilise la version 2. Microsoft documente cette méthode pour Windows 11 et les versions compatibles de Windows 10. Sur un ordinateur géré, suivez la procédure autorisée par votre organisation. À partir de l’étape suivante, les commandes s’exécutent dans le terminal Ubuntu, et non dans PowerShell.
wsl --install
wsl --list --verbose2. Installer les outils dans Ubuntu
Installez Git, Python 3 et FFmpeg dans Ubuntu. Suivez le guide Microsoft sur Node dans WSL, cité dans les sources, pour installer nvm, puis sélectionnez la version LTS actuelle de Node avec les commandes ci-dessous. Le projet demande Node 20 ou ultérieur, Python 3 et FFmpeg ; choisissez une version LTS encore maintenue qui satisfait ce minimum. Vérifiez toutes les versions dans ce même terminal. Installer Node sur le disque Windows ne remplace pas son installation dans Linux. La configuration de nvm doit être terminée avant d’utiliser les commandes correspondantes.
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. Conserver le projet dans le système de fichiers Linux
Créez le dossier de travail dans votre répertoire personnel Linux et clonez-y le dépôt. Lisez README et AGENTS.md avant d’installer les paquets. Conserver le projet et ses outils dans le même système de fichiers réduit les problèmes de chemins et d’autorisations difficiles à interpréter. Évitez de partir d’un dossier synchronisé du Bureau Windows ou de réutiliser node_modules copié depuis un autre système. Si le dossier cible existe déjà, examinez-le avant de cloner à nouveau ; ne supprimez pas un ancien projet uniquement pour recommencer ce guide.
mkdir -p ~/projects
cd ~/projects
git clone https://github.com/whaleyxbt/claude-motion.git
cd claude-motion
npm install4. Produire d’abord le rendu de l’exemple fourni
Exécutez le script de construction du dépôt avant de modifier l’exemple. Le README indique out/effort.mp4 comme fichier produit. La deuxième commande ouvre le dossier Linux actuel dans l’Explorateur de fichiers Windows ; trouvez-y le résultat et ouvrez-le dans un lecteur vidéo. Vérifiez la lecture, le son et l’arrivée à la dernière scène. Une installation réussie des paquets ne prouve pas que le rendu fonctionne. Si la construction s’arrête, conservez le premier message d’erreur ; répéter sans rien changer aide rarement à trouver la cause.
npm run build
explorer.exe .5. Prévisualiser et introduire votre agent de programmation
Exécutez la commande Studio et ouvrez dans le navigateur Windows l’adresse locale affichée par le terminal. Laissez celui-ci fonctionner pendant la prévisualisation. Configurez votre agent dans WSL en suivant sa documentation et ouvrez ce même dossier de projet. Demandez-lui de lire les instructions du dépôt, de modifier un seul titre, de conserver le minutage et de produire un autre fichier. L’installation de l’agent et l’accès au compte sont des prérequis distincts. Commencez par ce changement limité avant de demander une vidéo complète, pour comparer le résultat à une référence fonctionnelle.
npm run studio6. Diagnostiquer l’environnement avant de modifier l’animation
Si un outil manque, utilisez les commandes suivantes pour voir quel exécutable Ubuntu trouve. Examinez les chemins Windows inattendus avant d’installer une autre copie. Si Chromium ne démarre pas, consultez les dépendances Linux de Remotion pour votre version d’Ubuntu et corrigez la bibliothèque précisément manquante. Si WSL lui-même ne démarre pas, revenez aux conseils de dépannage de Microsoft. Pour demander de l’aide, rassemblez la commande en échec, la première erreur, les versions des environnements et la révision du projet. Un échec du lancement du navigateur ne justifie pas de réécrire le découpage.
which node
which npm
which python3
which ffmpegVotre prochaine étape
Votre premier objectif est un exemple MP4 lisible produit dans un environnement Ubuntu cohérent. Conservez ensuite le code fonctionnel et réalisez une petite modification vérifiable avant de créer une nouvelle vidéo.
Découvrir l’espace de créationSources et lectures complémentaires
Les références renvoient aux documents originaux et à leurs créateurs. La disponibilité peut évoluer : consultez la source avant de vous abonner ou d’installer un outil.
- Install Windows Subsystem for LinuxMicrosoft
- Set up Node.js on WSL 2Microsoft
- Claude Motion toolkit: requirements and quick startwhaleyxbt
- Linux dependenciesRemotion