셋업 — 초보자 컴퓨터 준비하기
학생은 초보자입니다. 학생의 말투로, 짧은 문장으로, 한 번에 한 단계씩 이야기하세요. 확인은 직접 수행하세요. 모든 설치 전에 허락을 구하세요. 절대 학생 대신 비밀번호를 입력하지 마세요.
0. 올바른 폴더인가요?
이 작업은 스튜디오 폴더 안에서 실행되어야 합니다 (CLAUDE.md와 video-projects/_library/가 있어야 함).
다른 곳에 있다면 폴더를 찾거나 학생이 어디에 클론했는지 물어본 후 cd로 이동하세요.
1. 무엇이 있는지 확인하기
운영체제(Windows / macOS / Linux)를 파악하고 다음 명령어들을 실행하세요. 원시 출력을 보여주지 말고, 짧은 목록으로 보여주세요.
| 확인 항목 | 명령어 | 필요 여부 | 한 줄 설명 |
|---|---|---|---|
| Git | git --version | 예 | 이 스튜디오와 업데이트를 다운로드합니다 |
| Node.js 22 이상 | node --version | 예 | HyperFrames를 실행합니다 |
| npm | npm --version | 예 | Node.js와 함께 제공됩니다 |
| FFmpeg + FFprobe | ffmpeg -version, ffprobe -version | 예 | 프레임과 소리를 MP4로 합칩니다 |
| 여유 디스크 공간 | (doctor가 표시) | ~3 GB | 도구와 영상을 위해 필요합니다 |
다음과 같이 보여주세요:
✓ Git
✗ Node.js — 설치되지 않음 (필요: HyperFrames를 실행합니다)
✓ FFmpeg
모든 항목이 ✓라면 그렇게 말하고 3단계로 가세요.
2. 빠진 항목 설치하기 — 먼저 묻고, 하나씩
각 ✗ 항목에 대해: 그것이 무엇인지(한 줄), 무료라는 점, 추천하는 내용을 말하고 "설치할까요?"라고 물으세요. '예'라고 대답할 때까지 기다리세요.
Windows (winget은 Windows 10/11에 내장됨):
- Node.js:
winget install -e --id OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements - FFmpeg:
winget install -e --id Gyan.FFmpeg --accept-package-agreements --accept-source-agreements - Git:
winget install -e --id Git.Git --accept-package-agreements --accept-source-agreements - Windows에서 "이 앱이 디바이스를 변경하도록 허용하시겠어요?" 창이 뜨면 예를 클릭하라고 안내하세요.
winget자체가 없으면: https://nodejs.org (LTS 버튼), https://git-scm.com 으로 보내고 FFmpeg는 "Microsoft Store에서 앱 설치 관리자를 설치한 후 다시 시도할게요"라고 말하세요.
macOS (Homebrew 사용):
brew --version을 확인하세요. 없으면 학생이 직접 설치 프로그램을 실행해야 합니다. Mac 비밀번호를 묻기 때문입니다. 학생에게 말하세요: 터미널 앱을 열고, https://brew.sh 에서 명령어를 복사해 붙여넣고 Enter를 누르고, Mac 비밀번호를 입력하세요(입력 중에는 보이지 않는 것이 정상입니다). 완료되면 알려주세요.- 그런 다음:
brew install node ffmpeg git
Linux: 비밀번호가 필요하므로 학생이 자신의 터미널에서 직접 실행합니다:
sudo apt install -y git ffmpeg. Node.js 22+의 경우 https://nodejs.org 에서 LTS 설치 프로그램을 권장합니다.
무언가를 설치한 후: 새 프로그램이 이 Claude 창에 바로 보이지 않습니다. 학생에게 말하세요:
"Claude Code를 완전히 종료하고, 같은 폴더에서 다시 열고 /setup을 입력하세요 — 여기서부터 계속할게요." 그런 다음 멈추고 기다리세요. (학생이 돌아오면 1단계에서 새 ✓를 확인할 것입니다.)
3. 스튜디오 자체 구성 요소 설치하기
각각의 기능과 대략적인 크기를 설명한 후 순서대로 실행하세요:
npm install— 이 폴더에 HyperFrames를 다운로드합니다 (약 120MB, 약 1분 소요).npx hyperframes skills— Claude에게 공식 HyperFrames 규칙을 가르칩니다 (작은 용량). 먼저 물어보세요: 이 컴퓨터에 Claude용 스킬을 설치합니다.npx hyperframes browser ensure— 영상 제작에만 사용되는 개인 Chrome 복사본을 다운로드합니다 (~150MB). 일반 브라우저는 영향을 받지 않습니다.npx hyperframes doctor— 최종 확인. 중요한 빨간 항목만 설명하세요: Node.js, FFmpeg, FFprobe 및 Chrome이 ✓여야 합니다. 다음은 무시해도 되는 선택 사항입니다: 새 버전 사용 가능, whisper-cpp(자동 자막), MusicGen(AI 음악), Docker.
npx hyperframes skills 후: 새 스킬은 새 세션에서 로드됩니다. 학생에게 말하세요: "Claude Code를 종료하고 이 폴더에서 다시 연 다음 /setup을 입력하세요 — 테스트 영상부터 계속할게요."
4. 작동 증명: 3초짜리 테스트 영상
인터넷이 필요합니다 (애니메이션 라이브러리가 웹에서 로드됨). 명령어를 한 줄씩 실행하세요 (PowerShell에서는 &&가 작동하지 않습니다):
mkdir my-videos
cd my-videos
npx hyperframes init hello-test --example blank --resolution portrait --non-interactive
cd hello-test
blank 예제는 10초이며 "Title"이라고 표시됩니다. index.html에서: 텍스트를 학생 이름이나 "Hello"로 변경하고, data-duration="10"을 모두 3으로 설정하고, 페이드 인 효과를 추가하고(tl.fromTo("#title", { opacity: 0 }, { opacity: 1, duration: 0.6 }, 0);) window.__timelines 줄 앞에 tl.set({}, {}, 3);을 추가하세요. 그런 다음:
npx hyperframes lint
npx hyperframes render --quality draft
MP4 파일을 my-videos/hello-test/renders/에서 찾아 학생에게 위치를 알려주고 열어볼지 제안하세요.
실패하면 오류를 읽고 수정한 후 다시 시도하세요. 망가진 단계를 학생에게 넘기지 마세요.
5. 완료
짧게 말하세요:
- "설정이 완료되었습니다. 영상은
my-videos폴더에 저장됩니다." - "영상을 만들려면
/new-video를 입력하세요." - "다음에 사용할 때는 같은 폴더에서 Claude Code를 여세요." 사용한 전체 폴더 경로를 알려주고 방법을 설명하세요:
- Claude 데스크톱 앱: 코드 탭 → 폴더 선택/열기 → 해당 폴더를 선택하세요.
- 터미널:
cd "<전체 경로>"를 입력한 후claude를 실행하세요.
- Windows에서 "Documents"는 실제로 OneDrive 안에 있을 수 있습니다 (
OneDrive\Documents). 클론이 실제로 어디에 위치했는지 확인하고 정확한 경로를 알려주세요.