LESSON 02

도구 세팅과 프로젝트 폴더

ffmpeg, API 키, 폴더 구조, 규칙 파일

오늘의 목표

ffmpeg를 설치하고, ElevenLabs API 키를 환경변수로 보관하고, 쇼츠 프로젝트 폴더와 CLAUDE.md를 만들어 Claude Code가 파이프라인 규칙을 알게 합니다.

예상 소요 시간 약 40분

내 컴퓨터:

1. ffmpeg 설치

ffmpeg는 영상·음성을 자르고 붙이고 자막을 입히는 무료 도구입니다. 7강 합성의 주인공이고, 6강에서 음성 길이를 재는 데도 씁니다. Claude Code가 명령을 대신 쓰지만 프로그램은 설치되어 있어야 합니다.

클로드 데스크탑 Code 탭에서 이렇게 시키세요

클로드 데스크탑 앱에서 Code 탭을 열고 작업 폴더를 고릅니다. (아직 폴더가 없으면 아래 3번에서 만든 shorts-factory를 고르거나, 우선 바탕화면 아무 폴더나 괜찮아요.)
입력창에 이렇게 씁니다.

ffmpeg가 설치되어 있는지 확인하고, 없으면 설치해줘. 내 컴퓨터는 [맥 / 윈도우]야. 끝나면 버전을 확인해줘.

클로드가 "이 명령을 실행해도 될까요?" 하고 권한 요청을 띄웁니다. 어떤 명령인지(brew install ffmpeg 또는 winget install ffmpeg) 읽고 수락하세요.
마지막에 ffmpeg -version의 결과가 여러 줄 나오면 성공입니다. 에러가 나면 화면 그대로 클로드에게 "이 에러 고쳐줘"라고 말하세요.

터미널로도 할 수 있어요

PowerShell(VS Code 터미널)에서:

winget install ffmpeg

winget이 없다는 에러가 나면 Microsoft Store에서 "앱 설치 관리자"를 업데이트하세요. 설치 후 터미널을 닫았다 다시 열고 확인:

ffmpeg -version

Homebrew가 있으면:

brew install ffmpeg

brew가 없으면 먼저 brew.sh의 설치 명령 한 줄을 실행합니다 (Claude Code에게 "Homebrew 설치 명령 알려줘"). 확인:

ffmpeg -version

버전이 여러 줄 출력되면 성공입니다.

2. ElevenLabs API 키

elevenlabs.io 가입 → 오른쪽 위 프로필 → API Keys → Create
키(sk_…)를 복사. 이 화면을 닫으면 다시 못 봅니다.
무료 플랜의 월 글자 수 한도를 확인해두세요 (편당 약 1,000~1,500자 소모)

키는 코드나 대화에 절대 붙여넣지 않습니다. 환경변수 파일에 둡니다 (아래).

용어 한 줄: API 키는 내 계정의 비밀번호 같은 것이고, *.env*는 그런 키를 한곳에 모아 두는 파일입니다. .env는 Git(변경 이력 저장 도구)에 올라가지 않게 제외해서 키가 새지 않게 합니다. 커밋은 "지금 상태를 이름 붙여 저장"하는 것입니다.

3. 프로젝트 폴더

클로드 데스크탑 Code 탭에서 이렇게 시키세요

바탕화면에 shorts-factory라는 빈 폴더를 만듭니다. (Finder/탐색기에서 새 폴더, 또는 Code 탭에서 "바탕화면에 shorts-factory 폴더 만들어줘"라고 시켜도 됩니다.)
Code 탭에서 폴더 선택으로 그 shorts-factory 폴더를 엽니다.
폴더 구조는 Claude Code에게 만들게 합니다. 아래 프롬프트를 입력창에 붙여넣고, 뜨는 권한 요청(파일 만들기 diff)을 읽고 수락하세요.

터미널로도 할 수 있어요

cd ~/Desktop
mkdir shorts-factory
cd shorts-factory
code .

~가 안 되면 cd $HOME\Desktop.

터미널에서는 이 폴더에서 claude를 실행한 뒤 아래 프롬프트를 붙여넣으면 됩니다.

프롬프트:

#2 프롬프트 2-1🔴 고급

쇼츠 자동화 프로젝트 폴더 구조를 만들어줘:

topics.md (내가 채울 주제 목록, 비워둬)
projects/ (영상 한 편당 폴더 하나. 예: projects/2025-01-pyramid/)
각 영상 폴더 안에는 script.json, prompts/, clips/, voice/, output/
assets/bgm/ (배경음악), assets/fonts/ (자막 글꼴)
scripts/ (더빙·합성용 실행 스크립트, 나중에)
.env 파일 (비워둬) 와 .env를 제외하는 .gitignore
지금은 폴더와 빈 파일만, 코드는 쓰지 마.

.env 파일을 열어 키를 넣습니다.

ELEVENLABS_API_KEY=sk_여기에_붙여넣기

.gitignore에 .env가 있는지 확인하세요. 나중에 Git에 올려도 키는 안 올라갑니다.

4. BGM과 글꼴

BGM: 유튜브 오디오 라이브러리(studio.youtube.com → 오디오 보관함)에서 저작권 무료 곡 2~3개를 받아 assets/bgm/에. 잔잔한 다큐풍이 지식 쇼츠에 맞습니다.
자막 글꼴: Pretendard 또는 Noto Sans KR의 Bold를 assets/fonts/에. 7강 자막 굽기에 씁니다.

5. CLAUDE.md

이 프로젝트의 규칙 파일입니다. 파이프라인 프로젝트에서는 폴더 규칙과 비용 규칙이 특히 중요합니다.

#3 프롬프트 2-2🔴 고급

CLAUDE.md를 만들어줘:

프로젝트

건축 지식 쇼츠(9:16, 80~100초) 자동 제작 파이프라인. 단계: 대본 → 비주얼 프롬프트 → Google Flow 클립 → ElevenLabs 더빙 → ffmpeg 합성.

폴더 규칙

영상 한 편 = projects/YYYY-MM-주제/ 폴더 하나
script.json이 그 영상의 유일한 진실. 컷 번호, 한국어 대본, 영문 프롬프트, 초 단위 길이를 담는다
클립은 clips/cut-01.mp4 형식, 음성은 voice/cut-01.mp3 형식. 번호는 두 자리
최종 결과물은 output/final.mp4

작업 규칙

한국어로 짧게 설명, 코드 먼저
파일을 만들거나 고친 뒤 확인 방법을 알려준다
외부 API 호출(ElevenLabs 등)은 실행 전에 예상 소모량(글자 수·크레딧)을 알려주고 허락을 받는다
브라우저 자동화로 Google Flow를 조작할 때는 클립 하나를 먼저 만들어 확인받은 뒤 나머지를 진행한다
.env 파일을 읽거나 출력하지 않는다. 키는 process.env / os.environ으로만 참조

명령

ffmpeg, python3 (또는 node) 사용 가능

만들어진 파일을 직접 읽어보세요. 특히 "허락을 받는다" 두 줄은 크레딧과 돈을 지키는 규칙입니다.

6. 첫 커밋

클로드 데스크탑 Code 탭에서 이렇게 시키세요

이 폴더를 git 저장소로 만들고, 지금까지 만든 파일을 "쇼츠 파이프라인 프로젝트 시작"이라는 메시지로 커밋해줘. .env가 커밋 목록에 없는지도 확인해서 알려줘.

권한 요청이 뜨면 명령(git init, git add, git commit)을 읽고 수락합니다. 클로드가 알려주는 목록에 .env가 없으면 정상입니다.

터미널로도 할 수 있어요

git init
git add .
git commit -m "쇼츠 파이프라인 프로젝트 시작"

git status에 .env가 안 보이면 정상입니다.

🧪 실습

ffmpeg -version을 실행(또는 클로드에게 시켜서)해 버전이 여러 줄 나오는 것을 눈으로 봤다
shorts-factory 폴더를 열어 projects/, assets/, scripts/, topics.md가 실제로 있는 것을 확인했다
.gitignore 파일을 열어 .env 한 줄이 들어 있는 것을 확인했다 (키 값은 화면에 띄우지 않았다)
CLAUDE.md를 직접 읽고 "외부 API 호출은 허락을 받는다" 줄이 있는지 확인했다
git status 또는 클로드의 커밋 목록에 .env가 없는 것을 확인했다

오늘의 체크리스트

ffmpeg -version이 출력된다
.env에 ElevenLabs 키가 있고 .gitignore에 .env가 있다
폴더 구조와 CLAUDE.md가 있다
BGM 2곡과 글꼴 1개가 assets/에 있다
커밋했다

다음 강의

3강, 레퍼런스 채널을 분석하고 첫 영상의 대본을 뽑습니다. 4초 × 22컷.