Qué necesitas
Nada raro, pero sí instalado antes de empezar:
- Claude Code, que es el que escribe y corre el código. Yo uso Claude Opus 5.5.
- Node.js, porque Remotion es React y corre sobre Node.
- Python 3, para los scripts de voz y música. Si no vas a usar ninguno de los dos, no lo necesitas.
- Una cuenta de ElevenLabs (solo si quieres voz), con tu API key y el ID de la voz que elijas.
Ojo: Remotion es gratis para uso personal y para equipos pequeños, pero tiene licencia de pago para empresas grandes. Revisa su licencia si vas a usarlo para un negocio.
Crear el proyecto
Una carpeta vacía y un solo comando. Si ya tienes un proyecto de Remotion, sáltate esto: el prompt base también lo crea por ti cuando no encuentra uno.
Comando para crear el proyecto
npx create-video@latest
Cada video vive en su propia carpeta, videos/<nombre>/, como una composición aparte. Así los videos no se pisan entre sí y puedes borrar uno sin romper los demás.
El bloque de hechos
Este es el paso que más pesa y el que casi todo el mundo se salta. Antes de pedir el video, le dices a Claude qué sí puede decir, qué debe atribuir y qué no puede afirmar. Sin esto, la IA rellena huecos con datos que suenan bien y no son ciertos.
Son cuatro cosas: la frase gancho, lo que se puede afirmar, lo que hay que atribuir a una fuente y lo que está prohibido. Más la estructura que quieres que siga.
Plantilla del bloque de hechos
Tema: "[la frase gancho del video]".
Se puede afirmar: [hechos comprobados, con nombres, fechas y cifras que ya verificaste].
Atribuir (decir "según [persona o fuente], en [año]"): [lo que solo dijo alguien y no está confirmado].
NO afirmar: [lo que la gente suele dar por cierto pero no lo es, o no está probado].
Estructura: gancho → contexto → [tus escenas intermedias] → cierre.
Cómo llenarlo bien
- Verifica antes. Busca la fuente primaria (el informe, el paper, la entrevista) y no te quedes con el titular. Lo que no puedas respaldar va en "atribuir" o en "NO afirmar".
- "NO afirmar" es tu seguro. Pon ahí las exageraciones típicas del tema (el "primero del mundo", el lugar famoso que nadie confirmó).
- Una idea por escena. La estructura te obliga a decidir el orden antes de que Claude empiece a dibujar.
Abajo, en los ejemplos, tienes dos bloques ya llenos para ver cómo se ve uno bien hecho.
El prompt base
Es el prompt que no cambia entre videos. Lo pegas en Claude Code y en TEMA Y HECHOS metes tu bloque del paso anterior. Todo lo demás se queda igual.
Prompt base: crea videos con Claude (Remotion)
Crea un Short vertical de YouTube (35-55 s) con motion graphics en Remotion 4.x (React/TypeScript). Si no hay proyecto, créalo con npx create-video@latest. Una composición por video en videos/<nombre>/.
TEMA Y HECHOS: [pega aquí el bloque del tema]
REGLAS TÉCNICAS:
- 1080x1920, 30 fps. Una sola capa de texto a la vez.
- Subtítulos a ~65% de altura, dentro de zonas seguras.
- Nunca más de ~0.7 s sin movimiento en pantalla.
- Tiempos internos proporcionales a la duración de cada escena.
- El primer frame hace de miniatura: que se vea potente.
- Estética libre: decídela tú. Todo hecho con código (SVG, partículas, diagramas).
- Guion en escenas.json: {"titulo": "...", "escenas": [{"id": 1, "texto": "...", "duracion": 6, "texto_voz": "opcional, pronunciación"}]}. Entre 6 y 8 escenas.
- No inventes datos: usa solo los hechos que te di.
VOZ (opcional): script en Python con la API de ElevenLabs (modelo eleven_v4, stability 0.4). Mi API key y voice ID están en .env (nunca los imprimas ni los subas; agrega .env al .gitignore). Un mp3 por escena, recorta silencios al final y ajusta la duración de cada escena a la duración real del audio.
MÚSICA (opcional): script en Python con librería estándar y semilla fija que sintetice la pista (bombo, caja, bajo, pad) y baje el volumen bajo la narración (ducking: 0.85 sin voz, 0.22 con voz).
ORDEN: guion → visuales → voz → duraciones reales → música → subtítulos sincronizados → verificar que compile. No renderices a mp4 hasta que yo apruebe. Hazlo de corrido, sin pedirme confirmaciones.
Qué hace cada parte
- 1080x1920 a 30 fps: el formato vertical de Shorts, Reels y TikTok.
- Una sola capa de texto a la vez: en el celular, dos textos juntos se leen mal.
- Subtítulos a ~65% de altura: las apps tapan la parte baja con botones y la descripción. Ahí es donde sí se ve.
- Nunca más de ~0.7 s sin movimiento: si algo se queda quieto, la gente se va. Esta regla sola mejora mucho el resultado.
- El primer frame es la miniatura: le pides que ese cuadro se vea bien, porque es lo primero que ve cualquiera.
- Estética libre: dejas que Claude decida el estilo. Si quieres uno concreto, descríbelo aquí.
- "No inventes datos": la frase que conecta con el bloque de hechos.
- El orden y el "no renderices": trabaja por etapas y no gasta tiempo en un mp4 hasta que tú digas que sí. Lo de "sin pedirme confirmaciones" es para que no te interrumpa en cada paso del camino.
Seguridad: tu .env va en el .gitignore y nunca se sube a un repositorio. Y este prompt no lleva claves: cada quien usa las suyas.
El guion: escenas.json
Claude arma primero el guion, como un archivo escenas.json, antes de dibujar nada. Es la columna del video: de ahí salen los textos, las duraciones, la voz y los subtítulos.
Formato del archivo
{
"titulo": "...",
"escenas": [
{ "id": 1, "texto": "...", "duracion": 6, "texto_voz": "opcional, pronunciación" }
]
}
- De 6 a 8 escenas. Con menos queda plano, con más no cabe en 55 segundos.
textoes lo que se lee en pantalla.texto_vozes lo que se dice en voz alta, por si una sigla o un nombre necesita escribirse "como suena".- Revísalo tú antes de seguir. Si el guion está mal, todo lo demás también lo estará.
La voz (opcional)
Claude escribe un script en Python que le manda cada escena a ElevenLabs y guarda un mp3 por escena. Lo importante es lo último: la duración de cada escena se ajusta al audio real. Así el video no queda con silencios raros ni con la voz cortada.
- Crea un archivo
.enven la raíz con tuELEVENLABS_API_KEYy tuVOICE_ID. - Agrega
.enval.gitignoreantes de tu primer commit. - Pide el script. El bloque ya viene dentro del prompt base, pero si lo quieres añadir después, aquí va suelto:
Solo el bloque de voz
VOZ: script en Python con la API de ElevenLabs (modelo eleven_v4, stability 0.4). Mi API key y voice ID están en .env (nunca los imprimas ni los subas; agrega .env al .gitignore). Un mp3 por escena, recorta silencios al final y ajusta la duración de cada escena a la duración real del audio.
Sin voz también sirve: el video queda con música y subtítulos, que es como se ve la mayoría de los Shorts.
La música, hecha con código (opcional)
Sin librerías de música, sin derechos de autor y sin buscar pistas: Claude escribe un script de Python puro que sintetiza la canción desde cero y la guarda como .wav. Como tiene semilla fija, da el mismo resultado cada vez.
Además genera un partitura.json con cada golpe y cada nota, para que las animaciones reaccionen a la música en el instante exacto.
Prompt: música hecha con código
Crea scripts/musica.py (solo Python, librería estándar, sin dependencias) que genere música de fondo y la guarde como .wav.
- Re menor, 120 BPM, progresión Dm - Bb - F - C.
- Todo sintetizado desde cero: bombo, caja y hi-hat (ruido filtrado), bajo de sierra, arpegio tipo Karplus-Strong, campanas FM y un pad suave, con delay y reverb.
- Determinista: semilla fija, mismo resultado siempre.
- La energía sube con el video (entra una capa por escena) y cierra limpio.
- Genera también un partitura.json con eventos {t, capa, nota|golpe, vel, dur} para que las animaciones reaccionen a la música en el instante exacto.
- Ducking en Remotion: 0.85 sin voz y 0.22 bajo la narración.
Ducking quiere decir que la música baja de volumen cuando alguien habla (0.85 sin voz, 0.22 con voz) para que la narración se entienda.
Cambia lo que quieras: la tonalidad, el tempo, la progresión de acordes o los instrumentos. Es tu canción.
Revisar y renderizar
El prompt base le dice a Claude que no renderice hasta que tú apruebes, y es a propósito. Un render tarda y no hay vuelta atrás con el tiempo gastado.
- Abre Remotion Studio (
npm run dev) y mira el video en el navegador. - Revisa el primer cuadro (la miniatura), los subtítulos y que ningún texto se salga de la zona segura.
- Comprueba cada dato contra tu bloque de hechos.
- Pide los ajustes que falten y, cuando todo esté bien, di "aprobado, renderiza".
Errores típicos
- Datos inventados. Casi siempre es un bloque de hechos flojo. Reescribe el "NO afirmar".
- Subtítulos tapados por la interfaz. Revisa que estén a ~65% de altura y dentro de las zonas seguras.
- Escenas que se quedan quietas. Recuérdale la regla de los 0.7 segundos.
- La voz no coincide con la escena. Falta el paso de ajustar las duraciones al audio real.
- Claves subidas por error. Si pasó, cambia la clave ya (da igual que borres el commit) y revisa el
.gitignore. - Mucha animación pesada. Si el Studio va lento, pide partículas más simples o menos capas.


