Guide 06 · 설치 가이드
raea 설치 가이드 — 클로드 코드로 영상 만드는 무료 렌더 엔진 + 영상 프롬프트 30개
클로드 코드로 영상을 만들 때 보통은 크롬 브라우저를 띄워서 한 프레임씩 스크린샷을 찍어 붙여요. 그래서 긴 영상은 몇 시간씩 걸리죠. **raea(Render Anything Engine)**는 브라우저 없이 게임 엔진(Bevy)으로 내 컴퓨터 그래픽카드에서 바로 그리는 무료 렌더 엔진이에요. 개발자에 따르면 실제 영상과 복잡한 장면에서 최대 10~20배 빠르다고 해요.
이 페이지에 공식 설치 명령어, 실제로 돌려 본 화면, 바로 쓰는 영상 프롬프트 30개를 정리했어요.

한눈에 보기
| 항목 | 내용 |
|---|---|
| 무엇 | AI 에이전트가 짠 리액트·타입스크립트 코드를 영상으로 뽑는 렌더 엔진 |
| 다른 점 | 브라우저 스크린샷 대신 게임 엔진이 GPU에서 바로 그려요 |
| 만들 수 있는 것 | 영상·모션그래픽, 3D, 게임, 효과음·음악 |
| 클로드 코드 연결 | 설치하면 raea, raea-bevy 스킬이 ~/.claude/skills에 자동으로 들어가요 |
| 지원 | 애플 실리콘 맥, 리눅스(x86_64), 윈도우(가장 덜 검증됨) |
| 비용 | 무료, 계정 필요 없음. 렌더는 내 컴퓨터에서 |
| 상태 | canary(매일 바뀌는 초기 버전) — 기능이 바뀌거나 깨질 수 있어요 |

설치 — 명령어 한 줄
맥·리눅스 (터미널)
Bash
curl -fsSL https://raea.io/install | sh윈도우 (PowerShell)
Bash
irm https://raea.io/install.ps1 | iex
- 설치가 끝나면 클로드 코드를 새로 여세요.
/를 눌러raea가 보이면 준비 끝이에요. raea: command not found가 나오면 터미널을 새로 열거나export PATH="$HOME/.local/bin:$PATH"를 한 번 실행하세요.- 다시 실행하면 최신 버전으로 업데이트돼요.
- 클로드 코드 플러그인으로 깔고 싶으면 클로드 코드 안에서
/plugin marketplace add shinyobjectz/raea→/plugin install raea@raea.
스킬이 안 떠요
- 이건 클로드 코드(터미널)용이에요. 클로드 앱 채팅창에서는 안 보여요.
- 클로드 코드를 완전히 껐다 켜세요.
ls ~/.claude/skills에raea,raea-bevy폴더가 있는지 확인하세요.
실제로 써 봤어요
1) 1분짜리 영상 렌더 — 1,800프레임(30fps × 60초)을 렌더했어요. 프레임당 약 6ms, 맥북(M4)에서 10초 남짓이에요.
Bash
time raea render video.tsx -o video.mp4
2) 클로드 코드에 말로 시켜 보기 — 아래 한 줄만 넣었어요. 클로드가 코드를 짜고, 4.1초 만에 렌더하고, 3·5·9초 프레임을 직접 보고 두 군데(빈 공간, 배경 줄무늬)를 스스로 고쳤어요.
Plain Text
/raea raea로 10초짜리 세로(1080x1920) 모션그래픽 영상을 만들어 줘. 주제: "월요일 아침 할 일 3가지" — 제목이 나오고, 할 일 3개(메일 정리, 회의 준비, 보고서 초안)가 체크 표시와 함께 하나씩 올라오고, 마지막에 "좋은 한 주 되세요". 한국어, 깔끔한 다크 톤. 3,5,9초 프레임을 확인해서 문제 있으면 고쳐 줘.
3) 자주 쓰는 명령
Bash
raea render piece.tsx -o out/piece.mp4 # 영상으로 뽑기
raea render piece.tsx --at 0,45,89 -o frames/ # 특정 프레임만 사진으로
raea check --quick piece.tsx # 글자 잘림·안전 영역 검사(약 1초)
raea play game.tsx # 게임으로 바로 실행
raea help # 전체 명령 보기4) Made in raea — 광고, 짧은 영화, 게임 13편이 전부 에이전트가 코드로 쓰고 raea로 렌더한 거예요(영상은 각 제작자).

바로 쓰는 영상 프롬프트 30개
클로드 코드에 그대로 붙여 넣으세요. 앞에 /raea를 붙이면 스킬을 확실하게 불러요. 숫자·문구만 내 것으로 바꾸면 돼요.
쇼츠·릴스 (세로 1080×1920)
- raea로 10초짜리 세로 영상 만들어 줘. 제목 "월요일 아침 할 일 3가지", 할 일이 체크 표시와 함께 하나씩 올라오게
- 우리 제품 장점 3개를 큰 숫자 카드로 하나씩 보여 주는 15초 세로 영상 만들어 줘
- "이번 주 AI 뉴스 TOP 3"를 순위 카드가 아래에서 올라오는 20초 세로 영상으로 만들어 줘
- 질문 하나 던지고 3초 뒤 답이 나오는 퀴즈형 세로 영상 5개를 한 파일에 만들어 줘
- 인스타 릴스 첫 3초 훅 문구를 크게 흔들리며 등장하게 만들고, 뒤에 본문 자막을 붙여 줘
- 고객 후기 3개를 말풍선이 차례로 뜨는 세로 영상으로 만들어 줘
설명·교육
- "API가 뭔지"를 식당 주문에 비유해서 도형 애니메이션으로 설명하는 30초 영상 만들어 줘
- 우리 회사 업무 흐름 5단계를 화살표가 이어지는 흐름도로 그려 주는 영상 만들어 줘
- 엑셀 함수 VLOOKUP 쓰는 법을 표가 움직이며 보여 주는 20초 영상 만들어 줘
- 숫자 3개(매출 1억 → 3억, 고객 2배, 이탈 -30%)를 카운터가 올라가는 차트 영상으로 만들어 줘
- 온보딩용으로 "첫 주에 할 일 5가지" 체크리스트 영상 만들어 줘
- 용어 10개를 카드 뒤집기로 하나씩 설명하는 1분 영상 만들어 줘
마케팅·광고
- 제품 사진(media/product.png)으로 15초 광고 만들어 줘. 훅 → 특징 3개 → 50% 할인 문구 순서로
- 신제품 출시 카운트다운 영상(D-3, D-2, D-1)을 3편 만들어 줘
- 비교형 광고 만들어 줘: 왼쪽 "기존 방식" 오른쪽 "우리 제품", 차이가 하나씩 체크되게
- 이벤트 안내 영상: 날짜·장소·혜택이 차례로 등장하고 마지막에 신청 링크 문구
- 브랜드 색(#2B6FE0)과 로고(media/logo.svg)로 5초 로고 인트로 만들어 줘
- 같은 광고를 세로·정사각형·가로 3가지 크기로 한 번에 렌더해 줘
데이터·리포트
- data.csv의 월별 매출을 막대가 자라는 차트 영상으로 만들어 줘
- 주간 지표 5개를 대시보드처럼 보여 주는 20초 영상 만들어 줘
- 두 회사 점유율 변화를 선 그래프로 그려 가며 보여 주는 영상 만들어 줘
- 설문 결과(만족 72%, 보통 20%, 불만 8%)를 도넛 차트 애니메이션으로 만들어 줘
편집·자막
- media/talk.mp4에 말한 단어에 맞춰 자막을 넣어 줘(raea cut 사용)
- media/talk.mp4에서 "음", "어" 같은 군말 구간을 잘라 줘
- 인터뷰 영상 위에 이름·직함 자막(로어서드)을 3초 동안 넣어 줘
- 영상 끝에 "구독·좋아요" 엔딩 카드 5초를 붙여 줘
3D·게임·소리
- 우리 로고를 3D로 돌리면서 빛이 지나가는 5초 인트로 만들어 줘(raea-bevy)
- 방향키로 움직이는 간단한 퐁 게임 만들어서 raea play로 실행해 줘
- 장면 전환마다 휙 소리, 체크 표시마다 띵 소리 효과음을 넣어 줘
- 완성한 영상을 3, 5, 9초 프레임으로 확인하고 글자 잘림이나 겹침이 있으면 고쳐 줘(raea check)
이렇게 쓰면 좋아요
- 한 장면씩 확인하며 고치기 — "3초·5초 프레임을 보여 줘"라고 하면 클로드가 사진으로 뽑아 보고 고쳐요. 렌더가 빨라서 이 반복이 금방 끝나요.
- 사진·영상은
media/폴더에 넣고 파일 이름으로 부르세요. - 검사 먼저 — 올리기 전에
raea check가 글자 잘림, 낮은 대비, 화면 멈춤, 음량 문제를 잡아 줘요.
왜 중요한가요
- 렌더가 느리면 클로드가 결과를 보고 고치는 걸 몇 번 못 해요. 빨라지면 사람 손 없이 "만들기 → 보기 → 고치기"를 여러 번 돌릴 수 있어요.
- 평소 쓰던 리액트·타입스크립트로 쓰니까 클로드가 바로 짜요.
- 내 컴퓨터에서 렌더하니까 렌더할 때마다 돈이 들지 않아요.
알아 둘 점
- 라이선스: FSL-1.1(경쟁 제품을 만드는 것만 금지, 버전마다 2년 뒤 Apache-2.0). 개인·회사 작업에 쓰는 건 괜찮아요.
- 초기 버전: 매일 바뀌어요. 안 되면 설치 명령을 다시 실행해 최신으로 업데이트하세요.
- 속도: "최대 20배"는 개발자가 밝힌 수치예요. 장면·컴퓨터에 따라 달라요.
자주 묻는 질문
- 리모션·하이퍼프레임즈랑 같이 써도 되나요? → 네. 코드 모양(리액트 컴포지션)이 비슷해서 옮기기도 쉬워요.
- 인텔 맥에서 되나요? → 아직은 애플 실리콘 맥만 돼요.
- 한국어 글자가 깨져요(리눅스) →
sudo apt install fonts-noto-cjk로 한글 글꼴을 깔아 주세요. - 지우고 싶어요 →
~/.raea,~/.local/bin/raea,~/.claude/skills/raea*를 지우면 돼요.
링크
- 저장소: https://github.com/shinyobjectz/raea
- 공식 사이트: https://raea.io
- 왜 만들었나: https://raea.io/why/
- 문서: https://raea.io/learn/
담PD가 노션에 공개한 자료를 이미지·글 그대로 옮겨 온 아카이브입니다. 최신 내용과 업데이트는 원문에서 확인하세요.
노션 원문에서 보기 →