# Setup Claude Code untuk Edit Video & Motion Graphic

> **Untuk peserta:** buka Claude Code, lalu drag file ini ke kolom chat (atau sebut path-nya) dan ketik:
> **"Tolong jalankan setup di file ini, langkah demi langkah."**
> Claude akan mengecek laptop kamu, memasang yang kurang, dan melapor di akhir.

---

## Instruksi untuk Claude Code

Kamu sedang membantu peserta kelas **People Dev AI · Edit Video Pakai Claude** menyiapkan laptopnya supaya bisa mengedit video (talking-head shorts, video campaign) dan membuat motion graphic dengan HyperFrames.

Aturan kerja:
- Pakai **Bahasa Indonesia santai** dan jelaskan tiap langkah dengan singkat, karena peserta belum tentu paham terminal.
- **Cek dulu sebelum install.** Kalau alatnya sudah ada, lewati dan cukup laporkan versinya.
- **Minta izin dulu** sebelum perintah yang butuh password admin (misalnya install Homebrew). Biarkan peserta sendiri yang mengetik password di Terminal, dan jangan pernah meminta password lewat chat.
- Jalankan perintah yang lama (download model, install besar) di background kalau bisa, lalu beri tahu perkiraan waktunya.
- Kalau ada langkah yang gagal, jelaskan penyebabnya dengan bahasa sederhana, coba satu alternatif, lalu lanjut ke langkah berikutnya. Jangan berhenti total.
- Di akhir, tampilkan **tabel status**: nama alat, versi, ✅ atau ❌, dan apa yang masih perlu dilakukan peserta.

### Langkah 0: Kenali sistemnya
- Cek OS dengan `uname -a`, cek juga sisa ruang disk dengan `df -h ~`.
- Butuh **minimal 10 GB** ruang kosong. Kalau kurang, peringatkan peserta sebelum lanjut.
- **macOS:** ikuti langkah di bawah apa adanya.
- **Windows:** sarankan memakai WSL (Ubuntu). Di dalam WSL, ganti `brew install X` dengan `sudo apt install X`. Untuk Node.js, pakai versi 20 atau lebih baru (via nvm atau NodeSource).
- **Linux:** pakai `apt` atau package manager distro yang dipakai.

### Langkah 1: Homebrew (khusus macOS)
- Cek dengan `which brew`.
- Kalau belum ada, minta izin peserta dulu, lalu jalankan:
  `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
  Proses ini akan meminta password Mac. Minta peserta mengetiknya sendiri di Terminal.
- Setelah selesai, pastikan `brew` sudah masuk PATH. Ikuti petunjuk "Next steps" yang dicetak installer (biasanya menambahkan `eval "$(/opt/homebrew/bin/brew shellenv)"` ke `~/.zprofile`).

### Langkah 2: ffmpeg, Node.js, Python
- Cek dengan `ffmpeg -version`, `node -v`, dan `python3 --version`.
- Pasang yang belum ada: `brew install ffmpeg node python@3.12`
- Syaratnya: ffmpeg versi 6 atau lebih baru, Node 20 atau lebih baru, Python 3.10 sampai 3.12.

### Langkah 3: Library Python
```
pip3 install -U faster-whisper pillow numpy librosa "rembg[cpu]"
```
- Kalau muncul error `externally-managed-environment`, ulangi dengan tambahan `--user`. Kalau masih gagal, pakai `--break-system-packages`, tapi jelaskan dulu risikonya ke peserta.
- **Pakai faster-whisper, bukan openai-whisper.** Di beberapa Mac, openai-whisper bisa crash (segfault) saat transkrip.
- Verifikasi dengan:
  `python3 -c "import faster_whisper, PIL, numpy, librosa, rembg; print('python ok')"`
- Model rembg (~176 MB) dan model Whisper `small` akan otomatis terunduh saat pertama dipakai. Tidak perlu diunduh sekarang.

### Langkah 4: Font
```
brew install --cask font-poppins font-bebas-neue
```
- Verifikasi dengan `ls ~/Library/Fonts /Library/Fonts | grep -iE "poppins|bebas"`.

### Langkah 5: Skill publik (HyperFrames & animasi)
```
npx skills add heygen-com/hyperframes
npx skills add emilkowalski/skill
```
- Kalau ditanya, pilih **Claude Code** sebagai agent tujuan dan install secara **global** (berlaku untuk user, bukan hanya project ini).
- Lalu jalankan `npx hyperframes doctor` dan laporkan apa pun yang belum OK. Kalau doctor meminta Chrome atau Chromium untuk render, ikuti petunjuknya.

### Langkah 6: Skill kelas (shorts-edit & campaign-video-edit)
- Kedua skill ini dibagikan sebagai file zip di grup kelas. Tanyakan ke peserta lokasi file zip-nya (biasanya `~/Downloads/`).
- Ekstrak keduanya:
  ```
  mkdir -p ~/.claude/skills
  unzip -o <path>/shorts-edit.zip -d ~/.claude/skills/
  unzip -o <path>/campaign-video-edit.zip -d ~/.claude/skills/
  ```
- Pastikan file `~/.claude/skills/shorts-edit/SKILL.md` dan `~/.claude/skills/campaign-video-edit/SKILL.md` ada. Kalau hasil ekstrak masuk ke folder bertingkat (misalnya `shorts-edit/shorts-edit/SKILL.md`), rapikan strukturnya.
- Kalau peserta belum punya zip-nya, catat langkah ini sebagai ❌ di tabel akhir dan lanjutkan.

### Langkah 7: Folder kerja
Buat folder kerja (tanyakan dulu ke peserta kalau mau nama atau lokasi lain):
```
mkdir -p ~/"Video Edit"/{raw-video,raw-done,B-roll,music,"sound effect",assets,work,output/Posted}
```
Jelaskan isi tiap folder:
- `raw-video/`: video mentah yang mau diedit (antrean)
- `raw-done/`: video mentah yang sudah selesai diedit
- `B-roll/`: footage pendukung untuk video campaign
- `music/`: musik latar
- `sound effect/`: efek suara (ting, whoosh, pop)
- `assets/`: logo, kartu profil, video penutup
- `work/`: dapur Claude, satu subfolder per video (transkrip, `config.json`, `fx.json`, potongan sementara)
- `output/`: hasil final, dengan subfolder `Posted/` untuk video yang sudah diunggah

Konvensi penamaan: pakai 4 angka terakhir nama file kamera sebagai ID video (misalnya `DJI_…_0084_D.MP4` → `work/0084/` → `output/0084_judul.mp4`).

### Langkah 8: Tes cepat
- Buat video tes 3 detik untuk memastikan ffmpeg bisa encode:
  `ffmpeg -v error -f lavfi -i testsrc=size=1080x1920:rate=30 -t 3 -pix_fmt yuv420p ~/"Video Edit"/output/test-setup.mp4`
- Cek hasilnya dengan `ffprobe` (harus 1080×1920, 3 detik), lalu hapus file tes itu.

### Langkah 9: Laporan akhir
Tampilkan tabel status, lalu tutup dengan pesan ini:
1. **Tutup lalu buka lagi Claude Code** supaya skill baru terbaca.
2. Buka Claude Code dari folder `~/"Video Edit"`.
3. Coba prompt pertama:
   > Edit video terbaru di raw-video/ jadi Reels 9:16 maksimal 60 detik. Buang gagap dan jeda panjang, kasih caption per kata di bawah dagu, headline besar di kata kunci, dan jangan ubah suaraku. Tanya dulu soal font dan warna sebelum render.

---

## Tips untuk peserta setelah setup
- **Satu video, satu sesi baru** supaya token hemat.
- **Matikan plugin atau konektor yang tidak dipakai** saat edit video.
- **Minta preview frame dulu** sebelum render penuh.
- **Minta Claude mengingat selera kamu**, misalnya: "simpan ini sebagai style kelas-ai".

*Materi kelas People Dev AI · peopledevai.com · Oktober 2026*