Mac에 Claude Motion 설치하기

폴더와 호환 도구 선택하기

홈 디렉터리에 전용 폴더를 만들고 패키지와 영상 출력 공간을 확보하세요. 저장소는 Node 20 이상, Python 3, FFmpeg를 요구합니다. 오래된 최소 버전보다 지원 중인 Node LTS를 선택하세요. 각 설치 프로그램의 현재 macOS와 CPU 조건을 확인합니다. 한 도구의 호환성이 전체 렌더링 과정의 호환성을 입증하지는 않습니다. 예제가 성공하기 전에는 원본 프로젝트를 바꾸지 마세요.

유지보수되는 출처에서 필요한 도구 설치하기

Node는 공식 다운로드 페이지, Python은 공식 macOS 설치 문서를 사용합니다. git이 없으면 Git의 Mac 설치 페이지를 확인하세요. FFmpeg는 Homebrew가 아래 명령을 안내하지만 먼저 Homebrew 자체 지침에 따라 설치와 설정을 완료해야 합니다. 자체 운영체제 지원 정책이 있으므로 오래된 Mac은 다른 유지보수 배포판이 필요할 수 있습니다. Python 설치 프로그램이 인증서 완료 단계를 요청하면 따르고 Apple 시스템 Python은 교체하지 마세요.

brew install ffmpeg

새 터미널에서 모든 도구 확인하기

설치 후 새 터미널을 열고 아래 버전 확인을 실행하세요. 모든 명령은 버전을 반환해야 합니다. 설치가 끝났는데 명령이 없으면 재설치 전에 문서의 PATH 설정을 확인합니다. 저장소는 python3를 직접 호출하므로 python 별칭만 작동해서는 부족합니다. 여러 버전이 있으면 셸이 실제로 찾는 실행 파일을 확인하세요. 설치, 미리보기, 렌더링에서 같은 터미널 환경을 사용해 충돌을 피합니다.

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

원본 예제 복제 및 빌드하기

선택한 상위 폴더에서 아래 명령을 실행합니다. npm install은 의존성을 가져오고 npm run build는 소리 생성, 무음 영상 렌더링, 결합을 수행합니다. 문서의 최종 경로는 out/effort.mp4입니다. 실패한 채로 사용자 장면을 만들지 말고 첫 오류와 실패 단계를 기록하세요. Python 누락은 소리 생성에 영향을 주며 FFmpeg가 없으면 영상 프레임이 렌더링되어도 최종 결합에 실패할 수 있습니다.

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

출력과 미리보기 검사하기

Finder에서 out/effort.mp4를 열어 끝까지 재생하세요. 움직임, 소리, 자연스러운 마무리를 확인합니다. 다음으로 npm run studio를 실행하고 터미널에 표시된 로컬 주소를 엽니다. 미리보기를 사용하는 동안 서버를 유지하고 마치면 Control-C로 중지하세요. 미리보기 작동과 유효한 출력 파일은 별도 확인입니다. 새 애니메이션을 요청하기 전에 작동하는 프로젝트 상태를 저장합니다.

npm run studio

올바른 에이전트 또는 사이트 절차로 이어가기

복제한 폴더 안에서 Claude Code나 Codex를 시작하고 프로젝트 지침을 읽은 뒤 작은 수정 하나를 요청하세요. 사이트 템플릿을 원한다면 사이트 시작 안내를 사용합니다. cm-skills 설치는 Node 22 이상이 필요하며 로컬 렌더링은 Chrome, FFmpeg, HyperFrames를 사용합니다. 이 명령은 다른 프로젝트용입니다. 제삼자의 npx claudemotion으로 대체하거나 사이트 선택적 음성 서비스가 제공된다고 가정하지 마세요.