Este guia instala o repositório whaleyxbt/claude-motion. Não instala Motion oficial da Anthropic nem o serviço independente Claude Motion Skills deste site. Revisamos documentação e scripts originais, mas não afirmamos ter testado recentemente todos os Macs Intel e Apple Silicon.
Escolha pasta e ferramentas compatíveis
Crie uma pasta exclusiva no diretório pessoal e reserve espaço para pacotes e vídeos. O repositório pede Node 20 ou superior, Python 3 e FFmpeg. Prefira Node LTS suportado a um mínimo obsoleto. Confira requisitos atuais de macOS e CPU de cada instalador. Uma ferramenta funcionar não comprova compatibilidade de toda a cadeia. Mantenha o projeto intacto até o exemplo funcionar.
Instale o que falta por fontes mantidas
Obtenha Node no site oficial e Python seguindo a documentação para macOS. Se faltar git, use a página de instalação Mac do Git. Homebrew documenta o comando FFmpeg abaixo; execute-o somente após instalar e configurar Homebrew conforme suas instruções. Sua política de sistemas suportados é própria, então Macs antigos podem precisar de outra distribuição mantida. Complete a etapa de certificados do Python quando solicitada e não substitua o Python de sistema da Apple.
brew install ffmpegConfira em uma nova janela do Terminal
Após instalar, abra um novo Terminal e execute as verificações abaixo. Todos os comandos devem mostrar uma versão. Se a instalação terminou, mas o comando falta, confira a configuração PATH documentada antes de reinstalar. O repositório chama explicitamente python3: apenas um alias python funcionando não basta. Com várias instalações, verifique qual executável o terminal encontra. Use o mesmo ambiente para instalação, prévia e renderização para evitar conflitos.
node --version
npm --version
python3 --version
ffmpeg -version
ffprobe -version
git --versionClone e compile o exemplo original
Execute os comandos do repositório na pasta superior escolhida. npm install obtém pacotes; npm run build gera som, renderiza vídeo silencioso e combina ambos. A saída documentada é out/effort.mp4. Se falhar, não avance para uma cena personalizada: registre o primeiro erro e a etapa. Sem Python, a geração de som pode falhar; sem FFmpeg, a combinação final pode falhar mesmo com os quadros renderizados.
git clone https://github.com/whaleyxbt/claude-motion
cd claude-motion
npm install
npm run buildAbra o arquivo e examine a prévia
Abra out/effort.mp4 pelo Finder e reproduza por inteiro. Confira movimento, som e um final adequado. Depois execute npm run studio e abra o endereço local mostrado; mantenha o servidor ativo durante a prévia e encerre com Control-C ao terminar. Prévia funcional e arquivo exportado válido são verificações distintas. Salve o estado funcional antes de pedir uma nova animação ao agente.
npm run studioContinue pelo fluxo correto
Inicie Claude Code ou Codex dentro da pasta clonada, peça leitura das instruções e solicite uma pequena revisão. Se queria os modelos deste site, use nossa página de primeiros passos. Seu instalador cm-skills precisa de Node 22 ou superior e renderiza localmente com Chrome, FFmpeg e HyperFrames. São comandos de outro projeto. Não substitua por instruções alheias de npx claudemotion nem suponha que nosso serviço opcional de voz está disponível.
Seu próximo passo
Uma instalação bem-sucedida termina com MP4 de exemplo reproduzível e prévia funcional. Guarde essa referência antes de personalizar.
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.
- Claude Motion repository and quick startwhaleyxbt
- Project build scriptswhaleyxbt
- Download Node.jsOpenJS Foundation
- Using Python on macOSPython Software Foundation
- Install HomebrewHomebrew
- FFmpeg formulaHomebrew
- Install Git for macOSGit
- Claude Motion Skills getting startedClaude Motion Skills