Videos con Claude y HyperFrames
Qué es y qué necesitas
HyperFrames es una herramienta gratuita y de código abierto de HeyGen que crea videos con código (HTML). Tú no programas: le explicas a Claude qué quieres y él escribe el código, te muestra una vista previa y exporta el MP4.
Antes de empezar necesitas:
- Una computadora Mac o Windows. En Mac, mejor con chip Apple (M1 o superior), porque el render usa la GPU.
- Una cuenta de Claude con acceso a Claude Code.
- Tu video crudo, grabado en vertical (9:16) si es para TikTok o Reels.
- Unos 15 minutos para la instalación, que se hace una sola vez.
1. Instalación (una sola vez)
Son cuatro piezas: Node.js, FFmpeg, Claude Code y el plugin de HyperFrames. Los comandos van en la Terminal (Mac) o en PowerShell (Windows).
- Instala Node.js. Entra en nodejs.org, descarga la versión LTS (22 o superior) e instálala con siguiente, siguiente, finalizar.
- Instala Claude Code. Necesitas un plan Pro, Max, Team o Enterprise; el plan gratuito no lo incluye.
- Mac:
curl -fsSL https://claude.ai/install.sh | bash - Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex - Si prefieres no usar la terminal, existe la app de escritorio de Claude, que trae Claude Code.
- Mac:
- Inicia sesión. Abre una terminal nueva, escribe
claudey sigue los pasos del navegador. - Instala FFmpeg. Lo más fácil es pedírselo a Claude: “Instálame FFmpeg y verifica que Node y FFmpeg funcionen”. En Mac con Homebrew también sirve
brew install ffmpeg. - Añade HyperFrames a Claude Code. Dentro de la terminal escribe:
claude plugin marketplace add heygen-com/hyperframes
claude plugin install hyperframes@hyperframes
Para comprobar que todo quedó bien, escribe npx hyperframes doctor. Si Node, FFmpeg y Chrome aparecen con ✓, estás listo.
2. Graba y prepara la carpeta
Una carpeta por video, con el crudo dentro, le da a Claude todo lo que necesita.
- Graba en vertical, con buena luz y fondo limpio. Deja aire arriba de tu cabeza: ahí van los títulos.
- Puedes grabar en varios clips. Claude los une y quita las pausas en las que lees el guion.
- Crea una carpeta (por ejemplo
Videos/mi-video/) y mete ahí los clips. - Opcional: añade un video de referencia cuyo estilo te guste. Claude copia el ritmo y el estilo, no el contenido.
- Abre Claude Code en esa carpeta: en la terminal escribe
cd+ la ruta de la carpeta, y luegoclaude.
3. Cómo promptear
Un buen prompt dice cuatro cosas: qué video, qué quitar, qué añadir y que te muestre el preview antes de exportar. Copia este y cambia lo que va entre corchetes:
Usa /hyperframes:hyperframes para editar mi video para TikTok.
No renderices hasta que yo apruebe el preview.
VIDEO CRUDO: [nombre del archivo o de los clips]
REFERENCIA (opcional): [archivo] — copia el estilo y el ritmo, no el contenido.
1. Antes de editar, analízalo y dime: de qué trata, dónde hay tiempos
muertos o repeticiones, cuál es la mejor frase para abrir y qué plan propones.
2. Edición:
- Quita silencios, errores y los momentos en que miro la pantalla.
- Subtítulos palabra por palabra, legibles y con la ortografía revisada.
- Texto animado en las ideas clave, sin taparme la cara.
- Música de fondo suave y efectos de sonido sutiles.
- Formato vertical 9:16, respetando la interfaz de TikTok.
3. Revisa varios fotogramas y ábreme el preview.
Cómo pedir cambios. Sé concreto y di el segundo o la frase:
- “En el segundo 0:45 la tarjeta me tapa la boca, bájala.”
- “Más dinámico: más transiciones, zooms y efectos de sonido.”
- “Cuando aparezca una tarjeta, quita los subtítulos.”
- “Sube los negros: más contraste, sin exagerar.”
Un cambio por mensaje o una lista corta funciona mejor que un párrafo largo.
4. Revisa y renderiza
Cuando el preview te guste, escríbele a Claude: “Aprobado. Renderiza en 1080p” (o 4K). Te deja el MP4 en la carpeta.
- Preview: Claude lo abre en el navegador. Mira el video completo con sonido: él no puede oír el audio.
- Renderiza en tu propia computadora. Con la GPU de una Mac con chip Apple, 2 minutos en 1080p tardan unos 6 minutos. En 4K tardan unos 25. En un servidor sin GPU puede tardar 5 veces más.
- Comando manual, por si quieres lanzarlo tú desde la carpeta del proyecto:
PRODUCER_BROWSER_GPU_MODE=hardware npx hyperframes render . -o video.mp4 --fps 30 --quality delivery
- Para 4K añade
--resolution portrait-4ky usa de fondo un video base en 4K, no el de 1080p. - Para subir desde el celular, pídele también una versión comprimida (menos de 280 MB).
5. Consejos y errores comunes
- “Claude no puede oír el audio”. Es normal: revisa tú la música, los efectos y que ningún corte se coma una palabra.
- Nombres mal escritos en los subtítulos (“Cloud” en vez de “Claude”): díselo una vez y pídele que lo corrija en todo el video.
- El texto te tapa la cara: pide que los textos vayan arriba sobre la pared y las tarjetas en la zona de subtítulos.
- Zonas de TikTok: deja libres ~150 px arriba, ~450 px abajo y el borde derecho, donde están los botones.
- El render tarda mucho o se corta: asegúrate de que corre en tu computadora y no en la nube, y cierra programas pesados.
- Guarda tu prompt base en un archivo dentro de la carpeta para reutilizarlo en cada video.
Fuentes: HyperFrames en GitHub · Instalación de Claude Code