Instalar Claude Motion en Mac: hasta el primer MP4

Elige carpeta y herramientas compatibles

Crea una carpeta exclusiva dentro de tu directorio personal y reserva espacio para paquetes y vídeos. El repositorio pide Node 20 o posterior, Python 3 y FFmpeg. Prefiere un Node LTS compatible a un mínimo obsoleto. Comprueba requisitos actuales de macOS y CPU de cada instalador. Que funcione una herramienta no demuestra compatibilidad de toda la cadena. Conserva el proyecto intacto hasta completar el ejemplo.

Instala lo que falta desde fuentes mantenidas

Obtén Node en su página oficial y Python siguiendo su documentación macOS. Si falta git, usa la página de instalación Mac de Git. Homebrew documenta el comando FFmpeg inferior; ejecútalo solo después de instalar y configurar Homebrew según sus instrucciones. Tiene su propia política de sistemas compatibles, por lo que Macs antiguos pueden necesitar otra distribución mantenida. Completa el paso de certificados de Python si se solicita y no sustituyas el Python del sistema Apple.

brew install ffmpeg

Verifica en una ventana nueva de Terminal

Después de instalar, abre Terminal de nuevo y ejecuta las comprobaciones inferiores. Todos los comandos deben mostrar una versión. Si terminó la instalación pero falta el comando, revisa su configuración PATH documentada antes de reinstalar. El repositorio llama expresamente a python3: un alias python funcional no basta. Si hay varias instalaciones, comprueba qué ejecutable resuelve la terminal. Usa el mismo entorno para instalación, vista previa y renderizado para evitar conflictos.

node --version
npm --version
python3 --version
ffmpeg -version
ffprobe -version
git --version

Clona y construye el ejemplo original

Ejecuta los comandos del repositorio desde la carpeta superior elegida. npm install obtiene paquetes; npm run build genera sonido, renderiza vídeo silencioso y los combina. La salida documentada es out/effort.mp4. Si falla, no pases directamente a una escena personalizada: registra el primer error y su etapa. Sin Python puede fallar el sonido; sin FFmpeg puede fallar la combinación final aunque se rendericen los fotogramas.

git clone https://github.com/whaleyxbt/claude-motion
cd claude-motion
npm install
npm run build

Abre el archivo e inspecciona la vista previa

Abre out/effort.mp4 desde Finder y reprodúcelo completo. Comprueba movimiento, sonido y un final correcto. Después ejecuta npm run studio y abre la dirección local indicada; deja el servidor activo mientras utilizas la vista previa y detenlo con Control-C al terminar. Una vista previa funcional y un archivo exportado válido son comprobaciones separadas. Guarda el estado funcional antes de encargar una nueva animación al agente.

npm run studio

Continúa por el flujo correcto

Inicia Claude Code o Codex dentro de la carpeta clonada, pide leer las instrucciones y solicita una revisión pequeña. Si buscabas las plantillas de este sitio, utiliza nuestra página de primeros pasos. Su instalador cm-skills necesita Node 22 o posterior y renderiza localmente con Chrome, FFmpeg y HyperFrames. Son comandos de otro proyecto. No los sustituyas por instrucciones ajenas de npx claudemotion ni supongas que nuestro servicio opcional de voz está disponible.