claude-code-video-toolkit은 Claude Code를 영상 제작 도구로 확장하는 AI 네이티브 워크스페이스다. 내레이션 생성, 음악 작곡, 이미지 생성, 영상 합성, 최종 렌더링까지 전 과정을 Claude Code 세션 안에서 처리한다. Digital Samba가 제작했으며 Codex로의 마이그레이션도 지원한다.
빠른 시작
git clone https://github.com/digitalsamba/claude-code-video-toolkit.git
cd claude-code-video-toolkit
python3 -m pip install -r tools/requirements.txt # AI 도구 (선택)
claude # Claude Code 실행Claude Code 세션 안에서:
/setup # 클라우드 GPU·스토리지·음성 설정 (약 5분, 대부분 무료)
/video # 첫 번째 영상 제작 시작/setup 없이 즉시 렌더링을 테스트하려면:
cd examples/hello-world && npm install && npm run render
# API 키 없이 즉시 MP4 출력핵심 구성요소
| 스킬/도구 | 역할 |
|---|---|
| ElevenLabs | 음성 클론·보이스오버 생성 |
| Qwen3-TTS | 오픈소스 TTS (무료) |
| FLUX.2 | 이미지 생성 |
| ACE-Step | AI 음악 생성 |
| Remotion | React 기반 영상 렌더링 |
| FFmpeg | 영상·오디오 편집 |
| MoviePy | Python 기반 영상 처리 |
| RunPod / Modal | 클라우드 GPU 배포 |
| Playwright | 화면 녹화·데모 캡처 |
비용 구조
오픈소스 AI 모델 중심으로 설계되어 클라우드 GPU 비용만 발생한다:
- Cloudflare R2: 10GB 무료 + 이그레스 비용 없음 (영상 파일 스토리지)
- Modal: 월 $30 무료 크레딧 (5분짜리 영상 수 편 제작 가능)
- 보이스오버: Qwen3-TTS로 완전 무료 운영 가능, ElevenLabs는 음성 클론 품질 향상 시 사용
Codex 지원
Codex 사용자를 위한 마이그레이션 스크립트를 제공한다:
python3 scripts/migrate_to_codex.py --force
# ~/.codex/skills/ 에 모든 스킬 설치 + AGENTS.md 업데이트25개 이상의 스킬이 Codex 형식으로 변환된다. --reset으로 설치 스킬을 제거할 수 있다.
누가 쓰면 좋은가
- 기술 데모·제품 소개 영상이 필요한 스타트업·개발자: 전통적인 영상 편집 소프트웨어 없이 코드로 재현 가능한 영상을 만들고 싶을 때
- 튜토리얼·스크린캐스트 제작자: Playwright 기반 화면 녹화와 AI 내레이션을 결합해 반복 가능한 제작 파이프라인을 구축할 때
- Claude Code 헤비 유저: 기존 Claude Code 워크플로에 영상 제작을 통합하고 싶을 때
관련 문서
- lathe — Claude Code 에이전트 스킬 기반 학습 도구 (스킬 포맷 참고)
참고 자료
- digitalsamba/claude-code-video-toolkit — GitHub 공식 저장소