핵심 요약: MIT 라이선스 기반의 스킬인 cinecode를 설치하면 Claude Code로 무료 동영상을 제작할 수 있습니다. cinecode는 대본 작성부터 헤드리스 Chrome을 통한 코드 기반 프레임 생성, 사운드 디자인, MP4 렌더링까지 모두 처리해 줍니다. 이 툴킷 자체는 유료 서비스를 전혀 요구하지 않습니다. 다만 Claude Code 자체는 유료 플랜이나 Console 계정이 필요하므로, 여기서 '무료'란 이미 이용 중인 플랜 외에 추가 비용이 들지 않는다는 뜻입니다.
Claude Code로 무료 동영상 제작이 가능할까?
솔직한 단서가 하나 붙긴 하지만, 가능합니다. 동영상 제작 툴 자체는 무료이지만 이를 실행하는 에이전트는 그렇지 않다는 점입니다.
cinecode는 일종의 스킬(skill)입니다. 사용자가 영상 제작을 요청할 때 Claude Code가 불러오는 지침과 스크립트가 담긴 폴더죠. cinecode의 README에 따르면, 사용자의 로컬 컴퓨터 환경인 Claude Code(데스크톱 앱, VS Code 확장 프로그램, 터미널)나 Cursor 내부에서 실행되며 "유료 서비스가 전혀 필요하지 않다"고 안내되어 있습니다. 이 저장소는 생성된 지 6일 만인 2026년 11월 9일에 별(star) 1,700개 이상을 달성하며 GitHub 트렌딩 1위에 올랐습니다.
각 구성 요소별 비용은 다음과 같습니다.
| 구성 요소 | 비용 | 비고 |
|---|---|---|
| cinecode 툴킷 | $0 | MIT 라이선스 |
| Node.js 22+, Python 3.9+, ffmpeg, Chrome | $0 | 부족한 프로그램은 에이전트가 확인을 거친 후 직접 설치 |
| 내레이션 (선택 사항) | 무료 ~ 유료 | 개인 Gemini 키(무료 티어), ElevenLabs 또는 무료 음성 사용 |
| 스톡 이미지 및 비디오 (선택 사항) | $0 | 무료 Pixabay 키 및 공개 아카이브 활용 |
| Claude Code | 유료 플랜 | “Pro, Max, Ultra, Team, Enterprise 또는 Console 계정 필요” |
마지막 항목은 2026년 11월 9일 기준으로 확인한 Anthropic의 Claude Code 설정 문서에 따른 것입니다. 무료 claude.ai 플랜에는 Claude Code가 포함되어 있지 않으며, claude.ai의 일반 대화창에서는 로컬 컴퓨터의 ffmpeg나 Chrome을 직접 실행할 수 없습니다. 관련 플랜 세부 정보는 Claude Code 무료 이용 여부 관련 포스팅을 참고하시고, 이를 우회하는 방법은 Claude Code 무료로 사용하는 방법 글에서 확인하실 수 있습니다.
이미 Claude Code 유료 플랜을 이용 중이라면, 영상을 제작할 때 추가로 드는 비용은 토큰 사용량뿐입니다. 만약 팀 차원에서 에이전트에게 동영상 제작을 요청해야 한다면 Sharkly를 통해 이러한 요청을 보드 형태로 체계적으로 관리할 수 있으며, 해당 설정 방법은 본문 하단에서 다룹니다.
cinecode가 문장 한 줄을 MP4 영상으로 완성하는 원리
cinecode는 일반적인 이미지나 비디오 생성 모델 대신 '코드'를 직접 작성해 화면을 구성합니다. 각 장면은 시간의 함수로 정의되며, Canvas 2D나 3D WebGL 라이브러리인 three.js를 통해 렌더링됩니다. 그런 다음 헤드리스 Chrome에서 이를 프레임 단위로 캡처한 뒤 사운드트랙과 함께 ffmpeg로 전달해 영상을 완성합니다.
이러한 설계 방식에는 두 가지 장점이 있습니다. 첫째, 모델이 픽셀을 직접 생성하는 대신 코드를 작성하므로 이미지/비디오 생성에 들어가는 별도의 모델 크레딧이 들지 않습니다. 둘째, 모든 프레임이 시간에 따른 순수 함수로 작동하기 때문에 다시 렌더링해도 결과물이 완벽히 동일하여 수정 작업의 예측 가능성이 매우 높습니다.
README에 소개된 제작 과정은 다음 5단계로 나뉩니다.
- 아이디어 제시: 한 문장 정도면 충분합니다.
- 질문 응답: 미디어 유형, 분량, 포맷, 시각적 스타일, 사운드 및 음악에 대해 몇 가지 질문을 던집니다. 권장 답변에는 별표가 표시됩니다.
- 기획안 제시: 초 단위 비트(beat) 테이블과 줄 단위로 직접 수정 가능한 디렉터 카드, 그리고 스틸컷 2장을 보여줍니다.
- 초안 렌더링: 첫 프레임의 움직임, 음량, 가독성, 불필요한 반복 여부 등을 자동으로 점검합니다.
- 최종 영상 렌더링: 인지 음량을 나타내는 단위인 -14 LUFS 규격에 맞춰 마스터링된 풀 사이즈 영상과 함께, 영상 설명란에 넣을 수 있는 크레딧 텍스트 파일을 출력합니다.
Claude Code에 cinecode를 설치하는 방법
설치는 명령어 한 줄로 끝납니다. Claude Code의 3가지 실행 환경(데스크톱 앱, VS Code 확장 프로그램, 터미널) 중 원하는 곳을 열고 다음과 같이 입력하세요.
Install the cinecode skill from https://github.com/sarpstar/cinecode
또는 직접 저장소를 클론(clone)할 수도 있습니다.
git clone https://github.com/sarpstar/cinecode.git ~/.claude/skills/cinecode
에이전트가 복사본을 중복 인식하지 않도록 한 곳에만 설치해야 합니다. 설치가 끝나면 빈 폴더에서 새 대화창을 열고 “단편 영화를 만들고 싶어(I want to make a short film)”라고 입력하면 됩니다. Cursor 사용자의 경우 ~/.cursor/skills/cinecode 경로에 클론하면 되지만, 작업 중 실수를 사전에 잡아주는 가드 훅(guard hook)은 Claude Code에서만 동작한다는 점을 참고하세요.
또한 Chrome이 활용할 수 있는 GPU 환경이 필요합니다. 최근 출시된 Mac이나 정상 작동하는 그래픽 드라이버가 설치된 PC라면 충분합니다. 적절한 GPU가 없으면 CPU 기반 렌더링으로 대체되는데, README에 따르면 테스트용으로는 괜찮지만 영상 전체를 렌더링하기에는 속도가 다소 느릴 수 있습니다.
스타터 영상을 직접 렌더링해 본 결과
저희는 Apple M1 Pro 기기에서 툴킷을 클론한 뒤 init_film.py로 퀵 모드 프로젝트를 생성하고, 기본 제공되는 스타터 템플릿을 수정 없이 그대로 초안 렌더링해 보았습니다.
python3 ~/.claude/skills/cinecode/scripts/init_film.py my-film --quick --title "Test"
cd my-film && python3 tools/make.py draft
| 측정 항목 | 결과 |
|---|---|
| 출력 사양 | 8초, 540 x 960 세로형, 24 fps, H.264 및 AAC 오디오 |
| 파일 크기 | 2.2 MB |
| 렌더링 시간 | 실제 소요 시간 약 21초 |
| 음량 | -13.2 LUFS, 피크 -3.1 dBFS |
| 최종 납품 여부 | 반려 (No) |
여기서 흥미로운 부분은 마지막 항목입니다. 툴킷 자체 검증 시스템이 스타터 영상의 납품을 거부한 것인데요. 프레임의 94%가 거의 검은색에 가까웠고, 8초 동안 사운드 이벤트가 2개에 불과했으며, 모든 소리가 코드로 합성되었다는 점이 걸렸습니다. 시스템은 초안을 renders/ 폴더에 저장한 뒤 그대로 최종본을 넘기지 않고 수정 작업을 요구했습니다.
참고할 점이 두 가지 있습니다. 저희는 Claude Code 세션 외부에서 스크립트를 직접 실행했기 때문에 툴킷에 “GUARD OFF”가 표시되었으며, 에이전트가 영상을 직접 작성하지는 않았습니다. 즉, 작성 능력이 아니라 렌더링 파이프라인과 품질 검증 단계(Quality Gate)만을 테스트한 것입니다. 실제로 영상을 제작할 때는 렌더링에 앞서 먼저 질의응답과 기획안 검토 단계를 거치게 됩니다.
퀵 모드 vs 필름 모드
cinecode는 작업을 시작할 때 원하는 모드를 먼저 묻고, 사용자의 목표에 맞춰 적절한 모드를 추천해 줍니다.
| Quick mode | Film mode | |
|---|---|---|
| 추천 용도 | 약 3분 이내의 클립, 광고, 설명용 영상 | 다큐멘터리, 내레이션 기반 영상, 영화제 출품용 단편 |
| 승인 단계 | 약 3회 | 단계별 진행 시 약 6~8회, 일괄 진행 시 약 3회 |
| 화면 구성 | 단일 독립 실행형 film.html |
8가지 룩(look) 프리셋이 적용된 three.js 씬 |
| 수정 방식 | 초안 기준 최대 2회 라운드 | 수정 사항이 해당 샷에만 개별 적용 |
처음에는 퀵 모드로 시작했다가 나중에 필름 모드로 전환할 수도 있습니다. 이때 구성해 둔 비트(beats)가 전체 작업의 로드맵 역할을 하게 됩니다.
'무료' 사용에 따르는 토큰 비용 이해하기
툴킷 자체는 무료이지만 토큰은 공짜가 아닙니다. README의 FAQ에 따르면 30~60초 분량의 퀵 모드 영상을 제작할 때 보통 100~250회의 에이전트 단계(step)가 소요되며, 단계마다 전체 대화 내용을 다시 읽어 들입니다. 대부분 캐시를 통해 처리되긴 하지만, 대화가 길어질수록 컨텍스트 용량은 계속 늘어납니다.
이러한 토큰 사용량은 플랜의 사용량 한도에 반영되므로, 영상이 길어지면 단일 세션 윈도우 한도를 빠르게 소진할 수 있습니다. cinecode는 다음과 같은 3가지 방식으로 토큰 비용을 최소화합니다.
- 풀 사이즈 프레임 대신 크기가 작은 콘택트 시트(밀착 인화본)를 확인합니다.
- 영상 데이터가 파일 형태로 저장되므로, 주요 체크포인트마다 새로운 대화창에서 작업을 이어가도록 안내합니다.
- 대화별 토큰 사용량을 확인할 수 있는
tools/usage.py스크립트를 제공합니다.
Claude Code 사용량 한도 가이드에서는 5시간 단위 윈도우 규칙과 이를 효율적으로 활용하는 팁을 다룹니다. 또한 README에 따르면 영상 제작에 불필요한 스킬과 커넥터를 비활성화하면 매 단계의 실행 비용을 더 낮출 수 있습니다.
동영상 요청을 에이전트의 보드 태스크로 전환하는 방법
개인이 영상을 한 편 만드는 것이라면 Claude Code와 cinecode만으로 충분합니다. 하지만 매주 제품 홍보 클립을 제작해야 하는 팀이라면 요청을 접수하고, 승인 단계를 추적하며, 완성된 최종 파일을 체계적으로 보관할 공간이 필요합니다.
사람과 AI 에이전트를 위한 업무 협업 시스템인 Sharkly에서는 이를 다음과 같이 처리할 수 있습니다.
- Computer에 cinecode 설치하기: Computer는 Sharkly에 연결되어 에이전트가 실행되는 디바이스를 뜻합니다. 스킬(Skills) 관련 문서에 따르면, 에이전트 런타임에서 이미 사용 가능한 스킬은 제품 내에서 따로 바인딩할 필요가 없습니다.
- 기획 요약본(Brief)을 태스크(Task)로 작성하기: README에 따르면 비트, 대사, 분량, 포맷 등이 완벽히 정리된 브리프가 있으면 추가 질의응답 없이 곧바로 초안 제작에 들어가므로, 태스크 본문에 이러한 세부 사항을 명시하는 것이 좋습니다.
- Claude Code를 실행하는 에이전트에 태스크 할당하기: 모든 영상 파일이 지정된 폴더에 저장되도록 작업 디렉터리(working directory)를 설정합니다.
- 대화창에서 승인 진행하기: cinecode는 기획안 및 스틸컷 검토 단계에서 사용자의 승인을 기다립니다. 에이전트 태스크 실행 문서에 나와 있듯, Sharkly에서는 에이전트가 태스크 대화를 '답변 대기(needing reply)' 또는 '검토 대기(needing review)' 상태로 남겨둘 수 있으며 이러한 인수인계 상황은 Task Chats 모듈에 표시됩니다.
- MP4 파일 수령하기: Sharkly 변경 로그에 따르면 에이전트는 녹화본을 포함한 파일을 대화창에서 직접 전송할 수 있습니다.
아직 Sharkly 에이전트를 통해 cinecode로 영상 전체를 제작해 본 것은 아니므로, 검증된 정석이라기보다는 시도해 볼 만한 구성 방식으로 참고해 주시기 바랍니다. 에이전트 및 컴퓨터 설정 단계는 AI 에이전트에 첫 태스크 할당하기 가이드에서 확인하실 수 있습니다.
Sharkly의 Free 플랜은 최대 5인 규모의 조직까지 지원하며, 에이전트는 시트(사용자 라이선스)를 차지하지 않습니다. 모델 사용량은 Computer에서 이미 사용 중인 Claude Code 플랜의 사용량으로 청구됩니다.
AI 코딩 에이전트로 영상을 제작할 수 있는 다른 대안
cinecode 외에도 목적에 따라 활용할 수 있는 다양한 대안이 있습니다.
- OpenMontage: 다단계 에이전트 기반 동영상 파이프라인을 구동합니다. 이 방식과 여기서 발생하는 승인 절차 이슈는 OpenMontage: 에이전트 기반 영상 제작 글에서 다룬 바 있습니다.
- Remotion: 영상을 React 컴포넌트로 제작하므로 자체 코드베이스 내에서 영상을 다루고자 하는 개발자에게 적합합니다. 기업 사용 시 라이선스 조건을 확인하세요.
- 직접 작성한 ffmpeg 스크립트: 자막 합성, 슬라이드쇼, 화면 녹화 등의 간단한 작업은 별도의 툴킷 없이도 Claude Code가 ffmpeg 명령어를 직접 작성해 처리할 수 있습니다.
- ChatGPT Images: 짧은 반복 영상(루프) 제작에 유용합니다. 자세한 방법은 ChatGPT로 무료 GIF 만들기 가이드를 참고하세요.
마치며
Claude Code를 활용한 동영상 제작은 이미 지불 중인 플랜 비용 외에 추가 비용이 전혀 들지 않습니다. 한 줄의 명령어로 cinecode를 설치하고, 한 문장의 아이디어를 건넨 뒤, 기획안과 스틸컷을 승인하기만 하면 마스터링된 사운드와 크레딧 텍스트가 포함된 MP4 영상을 얻을 수 있습니다. 첫 렌더링 테스트에서 확인했듯, 너무 어둡거나 콘텐츠가 부실한 초안은 자체 검증 로직이 납품을 거부할 정도로 완성도를 꼼꼼히 챙깁니다.
동영상 제작이 팀 단위 업무로 확장되고 있다면 요청을 한곳에서 체계적으로 관리해 보세요. Sharkly 무료 워크스페이스를 생성하고, 다음 영상 브리프를 태스크에 등록한 뒤, 담당자가 컷을 직접 검토하고 승인하도록 설정할 수 있습니다. Computer 연결 방법은 Sharkly 문서에서 자세히 안내하고 있습니다.
자주 묻는 질문 (FAQ)
cinecode는 무료인가요?
네, 무료입니다. 툴킷 자체는 MIT 라이선스이며 유료 서비스가 필요하지 않습니다. 내레이션은 선택 사항으로 무료 Gemini 티어나 무료 음성을 활용할 수 있습니다. 다만 이를 구동하려면 Claude Code 플랜이나 Cursor가 필요합니다.
무료 claude.ai 플랜에서도 Claude Code로 동영상을 만들 수 있나요?
아니요, 불가능합니다. Anthropic의 설정 문서에 따르면 무료 claude.ai 플랜에는 Claude Code 접근 권한이 포함되지 않습니다. Pro, Max, Ultra, Team, Enterprise 또는 Console 계정이 필요합니다.
cinecode로 영상을 렌더링하는 데 시간이 얼마나 걸리나요?
M1 Pro 기기에서 테스트했을 때 8초짜리 스타터 초안은 약 21초 만에 렌더링되었습니다. README에 따르면 30초 분량의 퀵 모드 영상은 짧은 세션 하나로 충분히 완성할 수 있으며, 대부분의 시간은 사용자가 피드백을 검토하고 작성하는 데 쓰입니다.
cinecode는 AI 이미지나 비디오 생성기를 사용하나요?
기본적으로는 사용하지 않습니다. 모든 화면은 코드를 통해 직접 그려집니다. 사용자가 외부 이미지/비디오 생성기를 별도로 연결하고 명시적으로 요청한 경우에만 사용합니다.
cinecode로 제작한 영상을 상업적으로 이용할 수 있나요?
README에 따르면 툴킷 차원에서는 가능합니다. 기본 폰트는 상업적 이용을 허용하며, 외부 에셋은 라이선스 출처가 기록된 경우에만 가져옵니다. 다만 사용자가 직접 삽입한 로고, 영상 푸티지, 음원에 대한 책임은 사용자 본인에게 있습니다.
cinecode는 Cursor에서도 동작하나요?
네, 동작합니다. ~/.cursor/skills/cinecode 경로에 클론하여 사용할 수 있습니다. 단, 가드 훅 기능은 Claude Code에서만 실행됩니다.
