비개발자용 시작

이 가이드는 풀타임 개발자가 아닌 분을 위한 안내입니다. 본인 컴퓨터에서 환경을 잡고, 트랙을 고르고, 첫 영상을 발행 메타까지 만드는 자리까지 한 단계씩 따라가게 짜여 있습니다. 도중에 막히면 troubleshooting을 옆 탭에 켜두고 같은 증상을 찾아 보면 됩니다.

어떤 분을 염두에 두고 썼나

이 base를 집어 드는 분 중에는 풀타임 개발자가 아닌 경우가 적지 않습니다. 그래서 톤이 손을 잡듯 잡혀 있습니다. 다만 가정하는 학습 수준이 하나 있습니다.

터미널을 한 번이라도 열어 봤고, AI와 작업해 본 경험이 있다는 가정입니다. 명령을 한 줄씩 풀어 적기는 하지만, “터미널이 뭔지”, “ffmpeg가 뭔지”를 처음부터 풀어 주지는 않습니다. 그 자리는 옆 탭에 무료 학습 자료(YouTube의 터미널 입문, Anthropic의 Claude Code 빠른 시작)를 두고 봐 주시면 됩니다.

scene-studio는 다른 base보다 설치할 도구가 많습니다. ffmpeg는 두 트랙 다 필요하고, 생성형이면 Codex CLI, 리믹스면 yt-dlp와 Whisper가 더 필요합니다. 본인이 쓸 트랙에 맞는 도구만 깔면 됩니다.

다음 세 가지를 가정합니다.

• 터미널의 이름과 대략의 쓰임은 알고 있습니다. 그 위에서 명령을 한 줄씩 풀어 적습니다.
• 첫 실행은 /start로 환경을 검증하고 트랙을 고르고 채널 정체성을 잡는 자리까지입니다. 첫 영상은 그다음입니다.
• 영상은 AI가 만듭니다. 이 가이드에서는 Claude Code를 씁니다. 어떤 영상을 만들고 싶은지만 알면 됩니다.

단계 안내

단계	무엇을 하나	대략 시간
1 prerequisites	ffmpeg, OPENAI_API_KEY, 트랙별 도구, Claude Code 설치	처음이면 40~80분
2 clone-and-install	base 받기	5~10분
3 first-run	/start로 환경 검증, 트랙 선택, 채널 정체성	20~40분
4 first-generative-video	생성형 첫 영상 (기획→장면→이미지→영상)	30분~1시간
5 first-remix-video	리믹스 첫 영상 (URL→수집→분석→자동컷)	20~40분
6 publish	발행 메타 만들고 직접 업로드	20~40분
7 automated-safety-net	승인 게이트와 라이선스 게이트, 훅 이해	10분
8 when-ai-gets-stuck	AI 워크플로 자체가 막힌 자리 풀기	필요할 때만
9 troubleshooting	자주 막히는 자리 모음	필요할 때만
10 staying-up-to-date (선택)	base 업데이트를 내 작업에 가져오기	한 사이클당 10~30분

4단계와 5단계는 본인이 쓰는 트랙만 보면 됩니다. 생성형만 쓰면 4단계, 리믹스만 쓰면 5단계, 둘 다면 둘 다입니다. 이미 숏폼 파이프라인이 익숙한 분이라면 전문가용 매뉴얼이 더 짧은 호흡으로 같은 base를 풉니다.

막혔을 때

가장 먼저 볼 자리는 troubleshooting입니다. 외부 도구가 많은 제품이라 설치 자리에서 막히는 경우가 잦은데, 거의 거기에 정리돼 있습니다.

그래도 풀리지 않으면 GitHub 이슈를 열거나 팀 Slack에 올립니다. 어디서 막혔는지, 에러 전체, 환경 정보(운영체제, ffmpeg 버전)를 같이 적습니다.

처음 한 번이 가장 느립니다. 도구가 한 번 깔리면 다음 영상부터는 1단계를 통째로 건너뜁니다.

매뉴얼은 어디까지, base는 어디부터

이 단계 표가 다루는 자리는 base가 자동으로 챙겨주는 자리, 즉 승인 게이트, 라이선스 게이트, template filling, 파이프라인 성능 정책 같은 차별점입니다. 매뉴얼 본문은 무료로 풀려 있습니다.

실제 base 코드와 .claude/ 풀셋(에이전트, 스킬, 훅)은 라이선스 + 업데이트 채널 형태로 곧 풀립니다. 가격과 결제 채널이 정해지면 이 페이지와 랜딩에 같이 안내합니다.