이 안내서는 Windows Subsystem for Linux 2의 Ubuntu에서 whaleyxbt/claude-motion 도구 모음을 실행합니다. Anthropic에 내장된 Motion이나 이 사이트의 별도 CLI를 설치하지 않습니다. 프로젝트와 Microsoft 문서를 토대로 정리했으며, Windows 테스트 컴퓨터에서 전체 순서를 검증한 것은 아닙니다.
1. Linux 환경을 설치하고 확인하기
PowerShell을 관리자 권한으로 열어 아래 첫 번째 명령을 실행하고, 요청되면 재시작하세요. Ubuntu를 시작해 Linux 사용자 계정을 만듭니다. PowerShell에서 두 번째 명령을 실행해 Ubuntu가 버전 2를 사용하는지 확인하세요. Microsoft는 Windows 11과 지원되는 Windows 10 빌드에 대해 이 설치 경로를 설명합니다. 조직에서 관리하는 컴퓨터라면 승인된 설치 절차를 따르세요. 다음 단계부터는 PowerShell이 아닌 Ubuntu 터미널에서 명령을 실행해야 합니다.
wsl --install
wsl --list --verbose2. Ubuntu 안에 도구 설치하기
Ubuntu 안에 Git, Python 3, FFmpeg를 설치합니다. 출처에 연결된 Microsoft의 Node-on-WSL 안내에 따라 nvm을 설치한 뒤 아래 명령으로 현재 LTS Node 버전을 선택하세요. 도구 모음의 요구 사항은 Node 20 이상, Python 3, FFmpeg입니다. 이 최소 조건을 만족하고 유지 관리 중인 LTS를 선택하세요. 같은 터미널에서 모든 버전을 확인해야 합니다. Windows 드라이브의 Node 설치는 Linux 설치를 대신하지 않습니다. 아래 nvm 명령을 실행하려면 먼저 nvm 설정을 완료해야 합니다.
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. 프로젝트를 Linux 파일 시스템에 두기
Linux 홈 디렉터리에 작업 폴더를 만들고 저장소를 그 안으로 복제합니다. 패키지를 설치하기 전에 README와 AGENTS.md를 읽으세요. 프로젝트와 도구를 같은 파일 시스템에 두면 복잡한 경로 및 권한 문제를 줄일 수 있습니다. 동기화 중인 Windows 바탕 화면 폴더에서 시작하거나 다른 운영체제에서 복사한 node_modules를 재사용하지 마세요. 대상 폴더가 이미 있다면 다시 복제하기 전에 내용을 확인하세요. 이 안내를 반복하려고 기존 프로젝트를 삭제해서는 안 됩니다.
mkdir -p ~/projects
cd ~/projects
git clone https://github.com/whaleyxbt/claude-motion.git
cd claude-motion
npm install4. 제공된 예제를 먼저 렌더링하기
예제를 수정하기 전에 저장소의 빌드 스크립트를 실행하세요. README가 안내하는 예제 출력은 out/effort.mp4입니다. 두 번째 명령은 현재 Linux 폴더를 Windows 파일 탐색기에서 엽니다. 출력 파일을 찾아 일반 동영상 플레이어로 열어 보세요. 재생되는지, 소리가 있는지, 마지막 장면까지 도달하는지 확인합니다. 패키지 설치 성공만으로 렌더링을 검증할 수는 없습니다. 빌드가 멈추면 처음 나온 오류 메시지를 보관하세요. 조건을 바꾸지 않고 반복 실행하는 것만으로는 원인을 찾기 어렵습니다.
npm run build
explorer.exe .5. 미리보기를 열고 코딩 에이전트 연결하기
Studio 명령을 실행하고 터미널에 표시된 로컬 주소를 Windows 브라우저로 여세요. 미리보기를 보는 동안 터미널을 계속 실행해 두세요. 사용하는 에이전트의 WSL 설정 문서를 따라 같은 프로젝트 디렉터리를 엽니다. 저장소 지침을 읽고 제목 하나만 바꾸되 예제의 타이밍을 유지하면서 다른 파일로 렌더링하도록 요청하세요. 에이전트 설치와 계정 접근 권한은 별도 준비 사항입니다. 완전한 맞춤 영상을 요청하기 전에 이런 작은 수정을 마치면, 정상 작동하는 기준 결과와 비교할 수 있습니다.
npm run studio6. 애니메이션을 바꾸기 전에 환경 진단하기
도구가 없다면 아래 명령으로 Ubuntu가 어떤 실행 파일을 찾는지 확인하세요. 예상치 못한 Windows 경로가 나오면 다른 사본을 설치하기 전에 원인을 조사합니다. Chromium이 시작되지 않으면 Ubuntu 버전에 맞는 Remotion Linux 의존성 목록을 참고해 실제로 빠진 라이브러리를 해결하세요. WSL 자체가 시작되지 않는다면 Microsoft 문제 해결 안내로 돌아갑니다. 도움을 요청할 때는 실패한 명령, 첫 오류, 실행 환경 버전, 프로젝트 리비전을 함께 준비하세요. 브라우저 실행 실패를 이유로 스토리보드를 다시 작성할 필요는 없습니다.
which node
which npm
which python3
which ffmpeg다음 단계
첫 목표는 하나의 일관된 Ubuntu 환경에서 재생 가능한 예제 MP4를 얻는 것입니다. 이후 정상 작동하는 소스를 보관하고 작고 확인 가능한 수정을 한 뒤 새 영상을 만드세요.
제작 작업 공간 살펴보기출처와 참고 자료
출처는 원본 문서와 제작자 페이지로 연결됩니다. 제공 기능은 바뀔 수 있으므로 구독하거나 설치하기 전에 해당 출처를 확인하세요.
- Install Windows Subsystem for LinuxMicrosoft
- Set up Node.js on WSL 2Microsoft
- Claude Motion toolkit: requirements and quick startwhaleyxbt
- Linux dependenciesRemotion