Este guia usa o Ubuntu no Windows Subsystem for Linux 2 para executar o kit whaleyxbt/claude-motion. Ele não instala o Motion integrado da Anthropic nem a CLI independente deste site. As instruções se baseiam na documentação do projeto e da Microsoft; não validamos esta sequência em uma máquina de teste com Windows.
1. Instale e identifique seu ambiente Linux
Abra o PowerShell como administrador e execute o primeiro comando abaixo; reinicie se solicitado. Inicie o Ubuntu e crie a conta de usuário Linux. Execute o segundo comando no PowerShell para confirmar que o Ubuntu usa a versão 2. A Microsoft documenta essa instalação para Windows 11 e versões compatíveis do Windows 10. Em um computador gerenciado, use o processo aprovado pela organização. A partir da próxima etapa, os comandos devem ser executados no terminal Ubuntu, não no PowerShell.
wsl --install
wsl --list --verbose2. Instale as ferramentas dentro do Ubuntu
Instale Git, Python 3 e FFmpeg no Ubuntu. Siga o guia da Microsoft sobre Node no WSL indicado nas fontes para instalar nvm; depois selecione a versão LTS atual do Node com os comandos abaixo. O kit pede Node 20 ou mais recente, Python 3 e FFmpeg; escolha uma versão LTS ainda mantida que cumpra esse mínimo. Confira todas as versões no mesmo terminal. A instalação do Node no disco Windows não substitui uma instalação Linux. É necessário concluir a configuração do nvm antes de executar seus comandos mostrados aqui.
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. Mantenha o projeto no sistema de arquivos Linux
Crie a pasta de trabalho no diretório pessoal Linux e clone o repositório nela. Leia README e AGENTS.md antes de instalar os pacotes. Manter o projeto e as ferramentas no mesmo sistema de arquivos reduz problemas confusos de caminhos e permissões. Evite começar em uma pasta sincronizada da Área de Trabalho do Windows ou reutilizar node_modules copiado de outro sistema operacional. Se a pasta de destino já existir, confira seu conteúdo antes de clonar novamente; não apague um projeto anterior apenas para repetir este guia.
mkdir -p ~/projects
cd ~/projects
git clone https://github.com/whaleyxbt/claude-motion.git
cd claude-motion
npm install4. Renderize primeiro o exemplo incluído
Execute o script de build do repositório antes de alterar o exemplo. O README identifica out/effort.mp4 como a saída do exemplo. O segundo comando abre a pasta Linux atual no Explorador de Arquivos do Windows; localize a saída e abra em um reprodutor. Confira se o arquivo reproduz, tem som e chega à última cena. Instalar os pacotes com sucesso não comprova que a renderização funciona. Se o build parar, guarde a primeira mensagem de erro; repetir sem mudar nada raramente revela a causa.
npm run build
explorer.exe .5. Abra a prévia e introduza seu agente de programação
Execute o comando de Studio e abra no navegador Windows o endereço local mostrado no terminal. Mantenha o terminal em execução durante a prévia. Configure seu agente no WSL conforme a documentação dele e abra esta mesma pasta do projeto. Peça que leia as instruções, mude apenas um título, preserve o tempo do exemplo e renderize outro arquivo. A instalação do agente e o acesso à conta são requisitos separados. Comece com essa alteração limitada antes de pedir um vídeo completo, para comparar a saída revisada com uma referência que já funciona.
npm run studio6. Diagnostique o ambiente antes de mudar a animação
Se uma ferramenta estiver ausente, use os comandos abaixo para conferir qual executável o Ubuntu encontra. Investigue caminhos inesperados do Windows antes de instalar outra cópia. Se o Chromium não iniciar, consulte a lista de dependências Linux do Remotion para sua versão do Ubuntu e resolva a biblioteca específica que falta. Se o próprio WSL não iniciar, volte à orientação de diagnóstico da Microsoft. Ao pedir ajuda, reúna o comando que falhou, o primeiro erro, as versões dos ambientes e a revisão do projeto. Uma falha ao abrir o navegador não exige reescrever o storyboard.
which node
which npm
which python3
which ffmpegSeu próximo passo
O primeiro objetivo é obter um MP4 de exemplo reproduzível em um ambiente Ubuntu consistente. Depois, preserve o código que funciona e faça uma edição pequena e verificável antes de criar um novo vídeo.
Explore o espaço de criaçãoFontes e leituras adicionais
As referências levam à documentação original e aos criadores. A disponibilidade pode mudar; confira a fonte antes de assinar ou instalar.
- Install Windows Subsystem for LinuxMicrosoft
- Set up Node.js on WSL 2Microsoft
- Claude Motion toolkit: requirements and quick startwhaleyxbt
- Linux dependenciesRemotion