Esta guía utiliza Ubuntu dentro de Windows Subsystem for Linux 2 para ejecutar el kit whaleyxbt/claude-motion. No instala la función Motion integrada de Anthropic ni la CLI independiente de este sitio. Las instrucciones se basan en la documentación del proyecto y de Microsoft; no hemos validado esta secuencia en un equipo de prueba con Windows.
1. Instala e identifica el entorno Linux
Abre PowerShell como administrador y ejecuta el primer comando; reinicia si se solicita. Inicia Ubuntu y crea su cuenta de usuario de Linux. Ejecuta el segundo comando en PowerShell para confirmar que Ubuntu utiliza la versión 2. Microsoft documenta esta instalación para Windows 11 y versiones compatibles de Windows 10. En un equipo administrado, utiliza el proceso autorizado por tu organización. A partir del siguiente paso, los comandos se ejecutan en la terminal de Ubuntu, no en PowerShell.
wsl --install
wsl --list --verbose2. Instala las herramientas dentro de Ubuntu
Instala Git, Python 3 y FFmpeg dentro de Ubuntu. Sigue la guía de Microsoft sobre Node en WSL enlazada para instalar nvm y selecciona la versión LTS actual de Node con los comandos siguientes. El kit requiere Node 20 o posterior, Python 3 y FFmpeg; elige una versión LTS con mantenimiento que cumpla ese mínimo. Verifica todas las versiones en esta misma terminal. Instalar Node en la unidad de Windows no sustituye su instalación en Linux. Antes de ejecutar los comandos de nvm debes haber completado su configuración.
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. Guarda el proyecto en el sistema de archivos de Linux
Crea la carpeta de trabajo dentro de tu directorio personal de Linux y clona allí el repositorio. Lee README y AGENTS.md antes de instalar los paquetes. Mantener el proyecto y sus herramientas en un mismo sistema de archivos reduce problemas confusos de rutas y permisos. Evita empezar en una carpeta sincronizada del escritorio de Windows o reutilizar node_modules copiado de otro sistema operativo. Si la carpeta de destino ya existe, examínala antes de volver a clonar; no borres un proyecto anterior solo para repetir esta guía.
mkdir -p ~/projects
cd ~/projects
git clone https://github.com/whaleyxbt/claude-motion.git
cd claude-motion
npm install4. Renderiza primero el ejemplo incluido
Ejecuta el script de compilación del repositorio antes de modificar el ejemplo. README identifica out/effort.mp4 como su archivo de salida. El segundo comando abre la carpeta actual de Linux en el Explorador de archivos de Windows; busca allí el resultado y ábrelo en un reproductor. Comprueba que se reproduce, tiene sonido y llega a la última escena. Una instalación correcta de los paquetes no verifica el renderizado. Si la compilación se detiene, guarda el primer mensaje de error; repetir sin cambiar nada rara vez permite encontrar la causa.
npm run build
explorer.exe .5. Previsualiza e incorpora tu agente de programación
Ejecuta el comando de Studio y abre en el navegador de Windows la dirección local que muestra la terminal. Mantén la terminal abierta durante la previsualización. Configura tu agente en WSL siguiendo su documentación y abre esta misma carpeta del proyecto. Pídele que lea las instrucciones, cambie un único título, conserve los tiempos del ejemplo y renderice otro archivo. La instalación del agente y el acceso a su cuenta son requisitos separados. Empieza con este cambio limitado antes de solicitar un video completo, para comparar el resultado con una referencia que funciona.
npm run studio6. Diagnostica el entorno antes de cambiar la animación
Si falta una herramienta, utiliza los comandos siguientes para comprobar qué ejecutable encuentra Ubuntu. Investiga las rutas inesperadas de Windows antes de instalar otra copia. Si Chromium no arranca, consulta las dependencias Linux de Remotion para tu versión de Ubuntu y resuelve la biblioteca concreta que falta. Si WSL no se inicia, vuelve a la guía de diagnóstico de Microsoft. Al pedir ayuda, reúne el comando fallido, el primer error, las versiones de los entornos y la revisión del proyecto. Un fallo al iniciar el navegador no justifica reescribir el guion gráfico.
which node
which npm
which python3
which ffmpegTu siguiente paso
Tu primer objetivo es obtener un MP4 de ejemplo reproducible desde un único entorno Ubuntu coherente. Conserva después el código que funciona y haz un cambio pequeño y comprobable antes de crear un video nuevo.
Explora el espacio de creaciónFuentes y lecturas adicionales
Las referencias enlazan a la documentación original y a sus creadores. La disponibilidad puede cambiar; consulta la fuente antes de suscribirte o instalar.
- Install Windows Subsystem for LinuxMicrosoft
- Set up Node.js on WSL 2Microsoft
- Claude Motion toolkit: requirements and quick startwhaleyxbt
- Linux dependenciesRemotion