Remotion 설정
새로운 Remotion 프로젝트를 스캐폴딩하고 나머지 워크플로우가 "그냥 Claude에게 프롬프트"만으로 동작하도록 연결합니다. 이는 일회성 환경 설정 작업입니다. 프로젝트당 한 번만 수행하면 되며, 이후 remotion-compose와 remotion-render는 바로 창의적인 루프로 넘어갑니다.
적극적으로 트리거하세요. 사용자가 "Claude로 비디오 만들기"와 관련된 어떤 말이라도 하면 - "Remotion 설정", "Remotion 프로젝트 생성", "Claude로 제품 비디오를 만들고 싶어", "비디오 프로젝트 시작" - 이 스킬을 실행하세요.
1단계 - 도구 체인 확인
Remotion은 헤드리스 Chromium으로 렌더링하므로 스캐폴딩 전에 Node를 확인하세요:
node --version # >= 16 필요; 활성 LTS 릴리스 권장
Node 버전이 16보다 낮으면 중단하고 사용자에게 업그레이드하도록 안내하세요 (nvm: nvm install --lts && nvm use --lts).
또한 npx를 사용할 수 있는지 확인하세요 (npm 5.2+와 함께 제공됨).
2단계 - 프로젝트 스캐폴딩
npx create-video@latest
이 명령은 대화형입니다. Blank (Hello World) 템플릿을 추천합니다 - 제품 비디오에 가장 깔끔한 기반입니다. CLI가 프로젝트 디렉토리와 패키지 매니저를 묻습니다. 사용자가 선택하게 한 후, 새 폴더로 이동하여 설치하세요:
cd <project-name>
npm install
3단계 - Remotion Agent Skills 설치
Claude Code가 이 저장소에서 Remotion 자체 스킬 컨텍스트를 사용할 수 있도록 합니다:
npx remotion skills add remotion
이 명령은 Remotion의 에이전트 스킬 파일을 프로젝트에 넣습니다. 설치된 Remotion 버전에서 이 명령을 사용할 수 없으면 사용자에게 최신 @remotion/cli를 안내하고 계속 진행하세요 - 이는 편의 기능일 뿐 필수 종속성은 아닙니다.
4단계 - 폴더 규칙 설정
나중에 사용할 스킬이 항상 파일 위치를 알 수 있도록 레이아웃을 표준화합니다:
src/
Root.tsx # 모든 <Composition>을 등록 (항목 레지스트리)
index.ts # registerRoot(RemotionRoot)
compositions/ # 비디오당 하나의 .tsx 파일 - remotion-compose가 여기에 작성
public/
assets/ # 이미지, 로고, 오디오 - staticFile()을 통해 참조
템플릿이 폴더를 생성하지 않은 경우 생성하세요:
mkdir -p src/compositions public/assets
src/Root.tsx는 레지스트리입니다. 모든 비디오는 여기에 등록된 <Composition>입니다:
// src/Root.tsx
import { Composition } from "remotion";
import { HelloWorld } from "./compositions/HelloWorld";
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="HelloWorld"
component={HelloWorld}
durationInFrames={90}
fps={30}
width={1920}
height={1080}
/>
);
};
// src/index.ts
import { registerRoot } from "remotion";
import { RemotionRoot } from "./Root";
registerRoot(RemotionRoot);
합리적인 기본값으로 등록: 가로 제품 비디오의 경우 30fps 및 1920x1080 (세로 소셜 미디어의 경우 1080x1920), 짧은 지속 시간 - 30fps에서 90프레임은 3초이며 대부분의 제품 데모 비디오는 15초에서 60초 사이입니다 (450-1800프레임).
5단계 - Google Font 로드
Remotion은 Google Font를 일급으로 지원하여 텍스트가 결정적으로 렌더링됩니다. 한 번 설치하고 로드하세요:
npm install @remotion/google-fonts
// 구성 파일 상단 근처에서 로드
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
// 그런 다음: <div style={{ fontFamily }}>...</div>
loadFont()는 글꼴이 준비될 때까지 렌더를 차단하므로, 화면의 텍스트가 스타일이 지정되지 않은 대체 글꼴로 깜빡이는 일이 없습니다. 브랜드에 맞는 글꼴을 선택하세요 - Inter를 Poppins, Roboto 등으로 바꾸세요.
6단계 - 스모크 테스트 구성
환경이 엔드 투 엔드로 렌더링되는지 증명하는 간단한 구성을 작성하세요:
// src/compositions/HelloWorld.tsx
import { AbsoluteFill, useCurrentFrame, interpolate } from "remotion";
import { loadFont } from "@remotion/google-fonts/Inter";
const { fontFamily } = loadFont();
export const HelloWorld: React.FC = () => {
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: "clamp",
});
return (
<AbsoluteFill style={{ backgroundColor: "#0B0B0F", justifyContent: "center", alignItems: "center" }}>
<h1 style={{ fontFamily, color: "white", fontSize: 90, opacity }}>
작동합니다.
</h1>
</AbsoluteFill>
);
};
src/Root.tsx (4단계)에 등록되었는지 확인한 후 렌더링하세요:
npx remotion render src/index.ts HelloWorld out/smoke-test.mp4
첫 번째 렌더는 헤드리스 Chromium을 다운로드합니다 (수백 MB - 일반 연결에서 처음에 몇 분 정도 기다려야 합니다); 그 후 이 90프레임 스모크 테스트는 1분 이내에 렌더링되어야 합니다. out/smoke-test.mp4가 서서히 나타나는 제목을 재생하면 환경이 올바른 것입니다. 렌더가 실패하면 거의 항상 (a) Chromium 다운로드/권한 문제, (b) Root.tsx에 구성이 등록되지 않은 경우, 또는 (c) 1단계의 Node 버전 문제입니다.
7단계 - 미리보기를 위한 Remotion Studio 실행
대화형 미리보기 (타임라인 스크러빙, 편집 시 핫 리로드):
npx remotion studio
이 명령은 Studio를 http://localhost:3000 에 제공합니다. create-video 템플릿은 npm run dev도 동일한 작업에 연결합니다. 반복 작업하는 동안 Studio를 계속 실행하세요 - 구성 파일의 편집 내용이 즉시 핫 리로드됩니다.
결과물
사용자는 작업 중인 Remotion 프로젝트를 갖게 됩니다: src/compositions/ + public/assets/ 레이아웃이 적용된 스캐폴딩된 저장소, 설치된 Remotion 에이전트 스킬, 연결된 Google Font, 등록된 스모크 테스트 구성, 실제로 재생되는 렌더링된 out/smoke-test.mp4, 그리고 미리보기용으로 실행 중인 Remotion Studio입니다. 스모크 테스트 MP4가 존재하고 재생될 때까지 아무것도 "설정된" 것이 아닙니다.
하지 말아야 할 것
- Node 확인을 건너뛰고 그냥 스캐폴딩하지 마세요 - 16 미만의 Node는 설치 시가 아닌 Chromium 렌더 내부에서 혼란스러운 오류와 함께 실패합니다.
- 스모크 테스트를 렌더링하지 않고 설정 완료를 선언하지 마세요; 컴파일은 되지만 MP4를 한 번도 생성하지 않은 프로젝트는 Chromium 파이프라인이 작동한다는 것을 증명하지 못했습니다.
- 구성이나 에셋을 임시 위치에 넣지 마세요 - 이후 스킬 (
remotion-compose,remotion-render)은src/compositions/및public/assets/가 존재한다고 가정합니다. - 에셋을 상대 경로나 URL로 참조하지 마세요.
public/에서staticFile()을 사용하세요. 그렇지 않으면 로컬에서는 작동하지만 다른 곳에서 렌더가 깨집니다. - 화면 텍스트에 시스템 또는 CSS 가져오기 글꼴을 사용하지 마세요 -
loadFont()가 차단되지 않으면 렌더 머신에서 텍스트가 대체 글꼴로 렌더링될 수 있습니다. - 제품 비디오에 기능이 많은 템플릿을 선택하지 마세요. Blank 템플릿은 사용자가 나중에 삭제해야 하는 데모 코드를 피합니다.
품질 기준
node --version이 16 이상이며 스캐폴딩 전에 확인되었습니다.out/smoke-test.mp4가 존재하고 서서히 나타나는 제목을 재생합니다.- 폴더 규칙이 명시된 대로 정확히 존재하며, 스모크 구성이
src/Root.tsx에 등록되었습니다. - 텍스트가 시스템 대체 글꼴이 아닌
@remotion/google-fonts와loadFont()를 통해 렌더링됩니다. - Remotion Studio가 localhost:3000에서 실행되고 편집 내용을 핫 리로드합니다.
인계
스모크 테스트가 렌더링되고 Studio가 실행되면, 사용자에게 프로젝트가 준비되었음을 알리고 인계하세요: "설정이 완료되었습니다. 원하는 비디오 - 길이, 장면, 브랜드 색상 - 을 설명해 주시면 구성을 작성하고 (remotion-compose), 렌더링 및 반복 작업 (remotion-render)을 진행하겠습니다."