Einrichtung – Bereiten Sie den Computer eines Anfängers vor
Der Student ist ein Anfänger. Sprechen Sie in seiner Sprache, kurze Sätze, Schritt für Schritt. Führen Sie die Überprüfungen selbst durch. Fragen Sie vor jeder Installation um Erlaubnis. Geben Sie niemals ein Passwort für sie ein.
0. Das richtige Verzeichnis?
Dies muss innerhalb des Studio-Ordners ausgeführt werden (enthält CLAUDE.md und video-projects/_library/).
Wenn Sie sich woanders befinden, suchen Sie den Ordner oder fragen Sie, wohin er geklont wurde, und wechseln Sie dorthin (cd).
1. Prüfen, was vorhanden ist
Ermitteln Sie das System (Windows / macOS / Linux) und führen Sie diese Befehle aus. Zeigen Sie nicht die rohe Ausgabe; zeigen Sie eine kurze Liste.
| Prüfung | Befehl | Benötigt? | Was es ist, in einem Satz |
|---|---|---|---|
| Git | git --version | ja | lädt dieses Studio und seine Updates herunter |
| Node.js 22 oder neuer | node --version | ja | führt HyperFrames aus |
| npm | npm --version | ja | wird mit Node.js mitgeliefert |
| FFmpeg + FFprobe | ffmpeg -version, ffprobe -version | ja | fügt die Bilder und den Ton zu einem MP4 zusammen |
| Freier Speicherplatz | (wird von doctor angezeigt) | ~3 GB | für die Werkzeuge und Ihre Videos |
Zeigen Sie es so an:
✓ Git
✗ Node.js – nicht installiert (benötigt: es führt HyperFrames aus)
✓ FFmpeg
Wenn alles ✓ ist, sagen Sie dies und gehen Sie zu Schritt 3.
2. Fehlendes installieren – erst fragen, einzeln
Für jedes ✗: Sagen Sie, was es ist (ein Satz), dass es kostenlos ist, was Sie empfehlen, und fragen Sie „Soll ich es installieren?“. Warten Sie auf ein Ja.
Windows (winget ist in Windows 10/11 integriert):
- 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 - Wenn Windows ein Fenster „Möchten Sie zulassen, dass diese App Änderungen an Ihrem Gerät vornimmt?“ anzeigt, sagen Sie ihnen, sie sollen auf Ja klicken.
- Wenn
wingetselbst fehlt: Senden Sie sie zu https://nodejs.org (der LTS-Button), https://git-scm.com und für FFmpeg sagen Sie „Installieren Sie den App Installer aus dem Microsoft Store, dann versuche ich es erneut“.
macOS (verwendet Homebrew):
- Prüfen Sie
brew --version. Wenn es fehlt, müssen sie den Installer selbst ausführen, da er nach ihrem Mac-Passwort fragt. Sagen Sie ihnen: Öffnen Sie die Terminal-App, fügen Sie den Befehl von https://brew.sh ein, drücken Sie die Eingabetaste, geben Sie ihr Mac-Passwort ein (es bleibt unsichtbar während der Eingabe – das ist normal), und sagen Sie Ihnen Bescheid, wenn es fertig ist. - Dann:
brew install node ffmpeg git
Linux: Diese benötigen ihr Passwort, also führen sie sie in ihrem eigenen Terminal aus:
sudo apt install -y git ffmpeg. Für Node.js 22+ empfehlen Sie den LTS-Installer von https://nodejs.org.
Nach der Installation von etwas: Das neue Programm ist für dieses Claude-Fenster noch nicht sichtbar. Sagen Sie ihnen: „Schließen Sie Claude Code vollständig, öffnen Sie es erneut in diesem selben Ordner und geben Sie /setup ein – ich mache hier weiter.“ Dann anhalten und warten. (Wenn sie zurückkommen, zeigt Schritt 1 das neue ✓.)
3. Die studiolokalen Teile installieren
Sagen Sie, was jeder Teil tut und wie groß er ungefähr ist, dann führen Sie sie der Reihe nach aus:
npm install– lädt HyperFrames in diesen Ordner herunter (ca. 120 MB, etwa eine Minute).npx hyperframes skills– bringt Claude die offiziellen HyperFrames-Regeln bei (klein). Fragen Sie zuerst: Es installiert Skills für Claude auf diesem Computer.npx hyperframes browser ensure– lädt eine private Kopie von Chrome herunter, die nur zum Erstellen von Videos verwendet wird (~150 MB). Ihr normaler Browser wird nicht berührt.npx hyperframes doctor– die abschließende Prüfung. Erklären Sie nur die roten Elemente, die wichtig sind: Node.js, FFmpeg, FFprobe und Chrome müssen ✓ sein. Diese sind optional – ignorieren Sie sie: eine neuere Version verfügbar, whisper-cpp (automatische Untertitel), MusicGen (KI-Musik), Docker.
Nach npx hyperframes skills: Neue Skills werden in einer neuen Sitzung geladen. Sagen Sie ihnen: „Schließen Sie Claude Code und öffnen Sie es erneut in diesem Ordner, dann geben Sie /setup ein – ich fahre beim Testvideo fort.“
4. Beweisen, dass es funktioniert: ein 3-Sekunden-Testvideo
Benötigt Internet (die Animationsbibliothek wird aus dem Web geladen). Führen Sie diese einzeln pro Zeile aus (in PowerShell funktioniert && nicht):
mkdir my-videos
cd my-videos
npx hyperframes init hello-test --example blank --resolution portrait --non-interactive
cd hello-test
Das leere Beispiel ist 10 Sekunden lang und zeigt „Title“. Ändern Sie in index.html den Text zu ihrem Namen oder „Hallo“, setzen Sie beide data-duration="10" auf 3, fügen Sie einen Einblend-Effekt hinzu (tl.fromTo("#title", { opacity: 0 }, { opacity: 1, duration: 0.6 }, 0);) und tl.set({}, {}, 3); vor der Zeile window.__timelines. Dann:
npx hyperframes lint
npx hyperframes render --quality draft
Finden Sie die MP4-Datei in my-videos/hello-test/renders/, sagen Sie ihnen, wo sie ist, und bieten Sie an, sie zu öffnen.
Wenn es fehlschlägt, lesen Sie den Fehler, beheben Sie ihn und versuchen Sie es erneut. Geben Sie ihnen keinen defekten Schritt.
5. Fertig
Sagen Sie ihnen kurz:
- „Die Einrichtung ist abgeschlossen. Ihre Videos werden im Ordner
my-videosgespeichert.“ - „Um ein Video zu erstellen, geben Sie
/new-videoein.“ - „Öffnen Sie Claude Code beim nächsten Mal in diesem selben Ordner.“ Sagen Sie ihnen den vollständigen Ordnerpfad, den Sie verwendet haben, und wie:
- Claude Desktop-App: Code-Tab → Ordner wählen / öffnen → diesen Ordner auswählen.
- Terminal:
cd "<der vollständige Pfad>"dannclaude.
- Unter Windows kann „Dokumente“ tatsächlich in OneDrive liegen (
OneDrive\Dokumente). Überprüfen Sie, wo das Klon tatsächlich gelandet ist, und geben Sie diesen genauen Pfad an.