| Anforderung | Hinweis |
|---|---|
| Claude Code | Das Plugin läuft in Claude Code. |
| Python 3.10 oder neuer | Wird für den MCP-Server und die Dokument-Analyse benötigt. |
| HeyGen- oder Synthesia-Konto | Nur für die manuelle Generierung der Videos. |
| OpenAI Whisper und ffmpeg | Optional, nur für /vidcraft:subtitle-generator. |
Laut README des Projekts:
claude plugin add vidcraft
In Claude Code:
/vidcraft:setup
Der Setup-Skill erledigt der Reihe nach:
python3, python, danach py -3 unter Windows).~/.vidcraft/ an.~/.vidcraft/venv/, falls es fehlt.requirements.txt. Das passiert bei jedem Aufruf, damit neue Abhängigkeiten nach einem Update nicht fehlen.config/config.example.yaml nach ~/.vidcraft/config.yaml, falls die Datei noch nicht existiert. Eine vorhandene Konfiguration wird nicht überschrieben.~/.vidcraft/cache/ an./vidcraft:configure für deine persönlichen Einstellungen.Installierte Python-Pakete: mcp[cli], pyyaml, pypdf, pdfplumber und python-docx.
Mit /vidcraft:configure legst du Content-Root, Plattform und Marke fest, siehe Konfiguration.
Mit /vidcraft:session-start prüfst du, ob der MCP-Server läuft, die Konfiguration passt und Projekte gefunden werden.
Der MCP-Server wird von Claude Code über
bin/run-servergestartet und nutzt ausschließlich das Python unter~/.vidcraft/venv/. Ohne dieses Environment startet der Server nicht. Dann hilft ein erneutes/vidcraft:setup.
Der Skill /vidcraft:subtitle-generator ruft das Kommandozeilen-Programm whisper lokal auf. Dafür brauchst du:
pipx install openai-whisper
Alternativ pip install openai-whisper. Außerdem muss ffmpeg installiert sein, zum Beispiel unter Debian/Ubuntu mit sudo apt install ffmpeg.
Der Repo enthält mit bin/run-server.cmd einen eigenen Startwrapper, der %USERPROFILE%\.vidcraft\venv\Scripts\python.exe verwendet. Der Setup-Skill erkennt Windows und probiert py -3, falls python nur der Microsoft-Store-Platzhalter ist.
Nach einem Plugin-Update führst du /vidcraft:setup erneut aus. Das synchronisiert die Abhängigkeiten im bestehenden Environment und lässt deine config.yaml unangetastet.
~/.vidcraft/ löschen. Es enthält Virtual Environment, Konfiguration und Cache (cache/state.json).Deine Projektdateien unter dem konfigurierten content_root bleiben bei beiden Schritten unberührt.