Remotion Installation

Remotion을 처음 설치하는 방법을 안내한다. Node.js가 설치되어 있다는 전제로, 공식 CLI(create-video)로 1분이면 첫 프로젝트를 만들 수 있다.

---

🎯 설치 방법 3가지

방법	추천 상황	명령어
코딩 에이전트 프롬프트	Claude Code·Codex·OpenCode로 자동 빌드	자연어 한 줄
CLI (공식)	일반적인 신규 프로젝트	npx create-video@latest
CLI + 템플릿	즉시 사용 가능한 예제	npx create-video@latest → 템플릿 선택

---

1️⃣ 코딩 에이전트용 프롬프트 (가장 빠름)

Ensure Node.js is installed. Install Remotion Skills: npx -y skills@latest add remotion-dev/skills -g -y Then use them to create a video.

Claude Code / Codex / OpenCode 같은 에이전트에 위 프롬프트를 그대로 붙여넣으면 알아서 셋업 → Skills 설치 → 프로젝트 생성까지 진행한다.

---

2️⃣ CLI 신규 프로젝트 (공식 권장)

# 빈 템플릿 (Tailwind + Skills 포함)
npx create-video@latest --yes --blank my-video
cd my-video
npm i
npx remotion skills add
npm run dev

my-video 디렉터리에 Hello World 스타일의 빈 프로젝트가 생성된다. npm run dev 실행 시 Remotion Studio가 http://localhost:3000에서 열린다.

💡 코딩 에이전트 자세 안내: /docs/ai/coding-agents

---

3️⃣ 패키지 매니저별 명령

매니저	명령
npm	npx create-video@latest
pnpm	pnpm create video
yarn	yarn create video
bun	bun create video

⚠️ Bun 런타임은 대부분 지원되나 일부 환경에서 차이가 있을 수 있다.

---

📋 시스템 요구사항

항목	최소
Node.js	16+
Bun	1.0.3+
macOS	15 (Sequoia) 이상
Linux Libc	2.35+ (Alpine·nixOS 미지원)

🐧 Linux 배포판은 추가 패키지 설치가 필요할 수 있다.

---

🔧 기존 프로젝트에 설치

이미 Next.js / React 프로젝트가 있다면 Brownfield 가이드 참고.

npm i remotion @remotion/cli

---

📚 영역 구분

• 이후 단계: Remotion The Fundamentals
• 한글 hub: Remotion 시작하기

상위 문서: ← Remotion 시작하기 출처: Remotion 공식 문서 — Installation 한글화 (2026-07-29) 공급사: Remotion AG

변경 이력

날짜	변경
2026-07-29	초판 작성 (공식 Installation 가이드 한글화)
2026-07-29	메타데이터 블록을 본문 하단으로 이동