첫 실행

이 단계의 목표는 초기 설정입니다. /start가 환경을 검증하고, 어느 트랙을 쓸지 묻고, 채널 정체성을 정합니다. 아직 영상을 만들지는 않습니다. 트랙과 채널이 정해지는 데까지가 이 단계입니다.

1) base 폴더에서 Claude Code 실행

clone-and-install에서 cd my-channel까지 했다면 같은 터미널에서 실행합니다.

claude

프롬프트가 뜨면 CLAUDE.md와 자동화 규칙을 화면에 드러내지 않고 읽어 들입니다. 출력이 거의 보이지 않을 수 있는데 정상입니다.

2) 한 줄로 시작

/start

또는 자연어로 프로젝트 시작이나 “처음 만들어”라고 해도 됩니다. 어느 쪽이든 start 라우터를 실행합니다.

3) 환경 검증

/start가 환경을 읽기 전용으로 확인합니다. 공통 도구(ffmpeg, OPENAI_API_KEY)를 먼저 보고, 사용자가 고른 트랙에 맞는 도구만 추가로 검증합니다.

항목	트랙	없으면
ffmpeg	공통	설치 안내
OPENAI_API_KEY	공통	환경변수 설정 안내
codex CLI	생성형	설치 안내. 없으면 생성형 트랙에 진입할 수 없음
yt-dlp	리믹스	설치 안내
whisper-cli	리믹스(선택)	없으면 Whisper API로 대체

외부 도구는 자동으로 설치하지 않습니다. 빠진 도구는 안내만 하고 설치는 사용자가 직접 합니다(또는 명시적으로 승인한 뒤에 진행합니다).

4) git 이력 분리는 clone 받은 분만

base를 git clone으로 받았다면 /start가 origin URL을 검사해 한 번 물어봅니다. Template로 본인 저장소를 만들어 받았다면 자동으로 건너뜁니다.

5) 트랙 선택

/start가 어느 트랙을 쓸지 묻습니다. 생성형만, 리믹스만, 둘 다 중에서 고릅니다. 이 선택에 따라 다음 단계가 달라집니다. 생성형이면 first-generative-video로, 리믹스면 first-remix-video로 갑니다.

6) 채널 정체성

/start가 채널 정체성을 정합니다. 플랫폼(TikTok, Reels, Shorts), 언어, 월간 편수, IP나 캐릭터 같은 항목을 묻습니다. 답은 _workspace/channel.json과 .claude/state/channel.json에 저장됩니다. 다음 세션부터는 이 파일을 읽어 같은 채널 정체성 위에서 작업합니다.

이 단계가 끝나면 이렇게 됩니다: 환경이 검증되고, 트랙이 정해지고, channel.json에 채널 정체성이 저장됩니다. 아직 영상은 없습니다. 그것이 정상입니다.

다음

초기 설정이 끝났으면 본인 트랙에 맞는 페이지로 갑니다. 생성형이면 first-generative-video이고, 리믹스면 first-remix-video입니다.