001만들고 싶은 영상을
말로 설명해 주세요.
PromptFilm은 Claude Code 전용 영상 제작 플러그인입니다. 자료 조사와 장면 설계를 거쳐 브라우저에서 재생되는 3D HTML을 만듭니다. 결과를 확인하고 수정한 뒤 MP4로 출력할 수 있습니다.
001
002
003
1자세히 알아보기
한 편이 만들어지는 단계, 걸리는 시간과 자원, 결과물을 믿을 수 있게 하는 장치를 정리했습니다.
슬라이드가 아니라 실제 3D 영상
결과물은 HTML 파일 하나로 된 실시간 Three.js 영상입니다. 스튜디오 조명과 물리 기반 재질, 끊기지 않는 카메라 한 대로 처음과 끝이 이어지게 반복 재생됩니다. 필요하면 프레임 단위까지 정확한 1080p 60fps MP4로 출력합니다. 화면 비율은 9:16(쇼츠·릴스·틱톡), 16:9, 1:1, 4:5를 고를 수 있고, 자막은 한 언어 또는 두 언어로 넣을 수 있습니다.
한 편이 만들어지는 순서
- 질문 — 조사 깊이, 화면 비율, 길이, 자막 언어를 한 번 묻고 그다음부터는 혼자 진행합니다.
- 조사 — 출처가 있는 사실, 참고 사진, 참고 영상의 프레임을 모읍니다.
- 스토리보드 — 장면별 시간 배분이 들어간 카드를 Studio에 띄워 승인을 받습니다.
- 제작 — 포함된 영상 엔진 위에서 Claude가 영상을 씁니다.
- 검수 — 자동 QA, 영상을 만들지 않은 별도 에이전트의 화면 검토, 최종 관문을 통과할 때까지 고치고 다시 확인합니다.
- 전달 — 모든 버전의 HTML을 남기고, 원하면 MP4를 출력합니다.
화면에 나오는 숫자에는 모두 출처가 있고, 공개되지 않은 정보는 “설명용”으로 표시합니다. 영상 해설 페이지에서 세 편의 출처와 설명용 표현을 확인할 수 있습니다.
시간과 자원
한 편에 몇 시간 분량의 에이전트 작업과 많은 토큰이 듭니다. 조사, 제작, 여러 차례의 검수가 들어가기 때문입니다.
- 직접 설치할 것은 Node.js 20 이상뿐입니다. 첫 실행이 나머지(스크립트 패키지, 헤드리스 Chrome, ffmpeg)를 확인하고 없으면 설치합니다. 관리자 권한이 필요 없고 아무것도 지우지 않습니다.
- 메모리는 8GB면 충분합니다. 검수에는 헤드리스 브라우저 하나(약 1.4GB, 데이터가 많은 영상은 2.6GB)를 씁니다.
- GPU가 없으면 Chrome이 소프트웨어 렌더링으로 바뀌어 느려집니다. macOS(Apple Silicon)에서 개발하고 검증했습니다.
Studio에서 검토하기
제작 중에 로컬 Studio 페이지가 열립니다. 타임라인을 움직이며 장면을 보고, 잘못된 곳을 화면에서 바로 눌러 코멘트를 남기면 Claude가 스냅샷과 함께 받아 고치고 답합니다. 구간별 속도를 바꿀 수 있고, 영상을 다시 만들어도 그 설정은 유지됩니다. Studio는 내 컴퓨터(127.0.0.1)에서만 열립니다.
자주 묻는 질문
설치가 제대로 됐는지 확인하려면요?
Claude Code에 “promptfilm selftest 실행해줘”라고 요청하세요. 약 5분 동안 임시 폴더에서 엔진의 시험 영상을 만들고, 일부러 심어 둔 오류를 잡아내는지까지 모든 검사를 실행합니다.
결과물은 어디에 만들어지나요?
작업 폴더 안에 영상마다 폴더 하나(./영상-이름/)가 생깁니다. 처음 질문에 답한 내용은 ./.promptfilm/settings.json에 저장돼 다음에 먼저 제안됩니다.
설치하고 시작하기
Claude Code에서 두 명령을 입력합니다.
먼저 마켓플레이스를 등록하고, 플러그인 설치 화면에서 설치 범위를 선택해 주세요. 개인 작업용이면 사용자 범위로 설치하면 됩니다.
- 마켓플레이스 등록
- 플러그인 설치
- 설치 후 다시 불러오기
Claude Code를 다시 시작해도 됩니다. 설치 후 /promptfilm:promptfilm으로 실행하거나, 만들고 싶은 영상을 말로 설명해 주세요.
GitHub에서 전체 사용 안내 보기 ↗터미널에서 한 줄로 설치하기
/promptfilm:promptfilm 지구에서 관측 가능한 우주의 끝까지, 실제 크기를 비교하며 이어지는 3D 모션그래픽을 만들어줘.
필요한 환경
Claude Code · Node.js 20 이상 · FFmpeg · Chrome/Chromium · Python 3
FFmpeg는 MP4 출력에, Chrome은 검수와 렌더링에 사용합니다. macOS Apple Silicon에서 개발하고 검증했습니다.
어떤 파일로 만들어지나요?
브라우저에서 재생되는 3D HTML을 만들고, 로컬 Studio에서 검수와 수정 후 MP4·PNG로 출력할 수 있습니다. 자막은 영상에 들어가며 SRT는 요청 시 별도로 만듭니다. 위 자동 미리보기는 실제 HTML에서 녹화한 MP4이며, 클릭하면 HTML 원본을 볼 수 있습니다.
어디에서 사용할 수 있나요?
Claude Code 전용 플러그인입니다. 설치 후 /promptfilm:promptfilm이 보이는지 확인해 주세요. 설치한 플러그인은 터미널에서 claude plugin list로 확인할 수 있습니다.
업데이트는 어떻게 하나요?
터미널에서 아래 명령을 실행한 뒤, 열려 있는 Claude Code에서 /reload-plugins를 실행하거나 다시 시작해 주세요.
제작은 어떻게 진행되나요?
조사, 장면 설계, 제작, 검수를 순서대로 진행합니다. 장면이 복잡하면 시간이 더 걸립니다. 스토리보드를 확인하고 결과를 수정하는 과정이 필요합니다.