Cómo usar Claude Code para automatizar proyectos de video marketing (Guía completa)
La automatización ya no es un extra en el video marketing, es la diferencia entre publicar una vez a la semana y dominar el feed a diario. En esta guía práctica y orientada a soluciones, convertiremos a Claude Code en tu copiloto de automatización y te mostraremos cómo construir un flujo de trabajo integral: desde la ideación y la redacción de guiones hasta el recorte, los subtítulos, la reutilización y la programación.
Usaremos un enfoque modular para que puedas adoptar solo las partes que necesites. Al final, tendrás un plano claro y patrones de código que podrás adaptar a tu stack.
Nota: Claude Code es el asistente de codificación de Anthropic diseñado para funcionar dentro de tu IDE/terminal e integrarse con tus herramientas y repositorios locales. Anthropic documenta cómo agregar Claude Code a tu IDE e iniciarlo desde una terminal, para que puedas programar en pareja, crear scaffolds y depurar automatizaciones rápidamente. Anthropic también ofrece un flujo de extensión de VS Code para una configuración más sencilla. Si prefieres una extensión de la comunidad, también hay opciones de terceros.
Qué automatizarás (de un vistazo)
- Ideación → brief → borradores de guion
- Listas de tomas/guiones gráficos e indicaciones de B‑roll
- Locuciones y indicaciones de tiempo
- Subtítulos/subtítulos por lotes
- Recorte automático de videos largos en cortos
- Reutilización en publicaciones sociales, miniaturas, títulos y descripciones
- Carga/programación a través de las API de la plataforma (YouTube, TikTok, etc.)
¿Por qué Claude Code para video marketing?
- Es excelente para la creación de scaffolds de código: genera pipelines boilerplate, herramientas CLI y funciones de ayuda rápidamente.
- Mejoras iterativas: pega registros/errores y pide correcciones.
- Gestión del contexto: mantén la voz de la marca y las guías de estilo en un archivo de conocimiento local al que Claude pueda hacer referencia al generar guiones y metadatos.
- Orquestación modular: combina la planificación de Claude con herramientas probadas como
ffmpeg para operaciones de video y tu elección de ASR (por ejemplo, Whisper) para la transcripción.
La arquitectura de automatización
Una estructura simple y fácil de mantener que puedes colocar en cualquier repositorio:
video-automation/
├─ config/
│ ├─ brand_voice.yaml
│ ├─ platforms.yaml
│ └─ prompts/
│ ├─ script_prompt.md
│ ├─ title_desc_prompt.md
│ └─ clip_rules.md
├─ data/
│ ├─ raw/
│ ├─ processed/
│ └─ captions/
├─ scripts/
│ ├─ generate_script.py
│ ├─ transcribe.py
│ ├─ autoclip.py
│ ├─ captions.py
│ ├─ repurpose.py
│ └─ schedule_upload.py
└─ Makefile
- Mantén las indicaciones modulares en
config/prompts para que Claude pueda refinar los pasos individuales sin tocar tu código.
- Almacena la configuración de la plataforma (dimensiones, límites de duración, hashtags) en
platforms.yaml.
- Usa un
Makefile o un ejecutor de tareas para encadenar flujos de trabajo: make shorts, make upload.
Paso 1: Siembra la voz de tu marca y los briefs creativos
Crea config/brand_voice.yaml con atributos como el tono, el público objetivo, las propuestas de valor, las frases prohibidas y las reglas de formato. Claude Code puede ayudarte a normalizar y validar el esquema, y luego hacer referencia a él en las indicaciones.
Ejemplo de esquema:
brand:
persona: "Educador pragmático pero optimista"
audience: "Marketers B2B SaaS y creadores independientes"
pillars:
- "Automatización práctica sobre la teoría"
- "Decisiones basadas en datos"
- "Mostrar, no contar"
banned_phrases:
- "game‑changer"
- "disrupt"
style:
tone: "claro, conciso, amigable"
reading_level: "Grado 8–9"
ctas:
primary: "Suscríbete para obtener versiones de automatización semanales"
secondary: "Obtén la plantilla de flujo de trabajo"
Pídele a Claude Code que genere un script_prompt.md que combine la voz de la marca y tu tema. Ejemplo de contenido de la indicación:
Eres un video marketer y guionista senior. Escribe un guion de 60 a 90 segundos que:
- Enganche en 3 segundos con un punto de datos
- Ofrezca 1 conclusión práctica
- Use la voz de la marca en brand_voice.yaml
- Produzca una lista de escenas con marcas de tiempo, B-roll sugerido y texto en pantalla
Luego, ejecuta una pequeña CLI de Python para compilar el brief creativo + el tema en un borrador de guion.
Paso 2: Genera guiones con Claude + plantillas locales
Crea scripts/generate_script.py que:
- Cargue el tema y la configuración de la marca
- Llame a tu capa LLM (API de Anthropic) para redactar guiones
- Guarde en `data/processed/script_. Algunas plataformas exponen API y encadenamiento de flujos de trabajo para operaciones de contenido complejas. También puedes combinar herramientas de automatización generales y API para escalar.
Crea scripts/transcribe.py:
# extraer audio
ffmpeg -y -i data/raw/input.mp4 -vn -acodec pcm_s16le data/processed/audio.wav
# ejecutar whisper (ejemplo)
whisper data/processed/audio.wav \
<a6>--model medium \</a5><a7>--language en \</a5>--task transcribe \
--output_dir data/captions
Luego, convierte .srt a .ass o incorpora subtítulos:
ffmpeg -i data/raw/input.mp4 -vf subtitles=data/captions/input.srt -c:a copy data/processed/captioned.mp4
Claude Code puede ayudarte a envolver estos comandos en funciones de Python y agregar manejo de errores y registro de progreso.
Paso 4: Recorte automático de videos largos en cortos
Define las reglas de recorte en config/prompts/clip_rules.md:
- Duración máxima por corto: 30–60s
- Elementos requeridos: gancho, un consejo, CTA
- Ritmo visual: 1 corte cada 3–5s, acercamiento en líneas clave
Crea scripts/autoclip.py para:
- Analizar la transcripción
- Usar un LLM para proponer segmentos de clip (inicio/fin)
- Aplicar recortes
ffmpeg y zoom/paneo simples
Ejemplo de corte y acercamiento ffmpeg:
# corte 00:02:10–00:02:40
ffmpeg -ss 00:02:10 -to 00:02:40 -i input.mp4 -c copy out_clip.mp4
# efecto de acercamiento (escala + recorte)
ffmpeg -i out_clip.mp4 -filter:v "scale=iw*1.08:ih*1.08, crop=iw:ih" -c:a copy out_clip_zoom.mp4
Pídele a Claude Code que genere el analizador de transcripciones y la puntuación heurística para la “capacidad de clip” (ganchos, estadísticas, preguntas retóricas). También puede escribir pruebas unitarias para validar las matemáticas de las marcas de tiempo.
Paso 5: Subtítulos, títulos, descripciones y hashtags por lotes
Usa indicaciones LLM ajustadas a cada plataforma. Guarda ejemplos en config/prompts/title_desc_prompt.md y platforms.yaml para restricciones:
- YouTube: título de 70 caracteres, 5–8 palabras clave, marcadores de capítulo
- TikTok/Shorts: gancho de 80–120 caracteres, 3–5 hashtags
- LinkedIn: 1 insight + 1 pregunta CTA
Crea scripts/captions.py y scripts/repurpose.py para:
- Generar títulos/descripciones específicos de la plataforma
- Resumir en hilos de publicaciones de tweet/LinkedIn
- Producir superposiciones de texto en pantalla (ASS/JSON)
Claude Code puede transformar tu guion base en todas las variantes de metadatos en una sola pasada y aplicar la voz de la marca y los límites de longitud utilizando protecciones regex.
Paso 6: Miniaturas con variantes de texto
- Mantén una lista de fórmulas de titulares de miniaturas (por ejemplo, “Haz ESTO para duplicar la producción de video”).
- Haz que Claude Code genere 5–10 opciones de texto por video.
- Alimenta esos a tu sistema de diseño (API de Figma o una plantilla local con ImageMagick + texto
pango) para exportar variaciones.
Paso 7: Carga y programación
- Envuelve la API de datos de YouTube y otros SDK de plataforma en
schedule_upload.py.
- Lee las configuraciones de la plataforma desde
platforms.yaml.
- Almacena las credenciales en
.env y usa flujos de OAuth.
- Agrega el modo de prueba para imprimir las cargas útiles antes de publicar.
Claude Code puede crear stubs de las clases de cliente, paginar listas de reproducción e implementar lógica de reintento/retroceso. También es útil para escribir validadores de esquemas para detectar metadatos mal formados antes de las llamadas a la API.
Paso 8: Orquesta con un Makefile o un ejecutor de tareas
Ejemplo de destinos de Makefile:
shorts: transcribe autoclip captions repurpose
@echo "Cortos creados en data/processed/shorts"
longform: generate_script captions
upload:
python scripts/schedule_upload.py --platform youtube --input data/processed/shorts
Pídele a Claude Code que agregue paralelización (por ejemplo, multiprocesamiento para clips por lotes) y una CLI simple (argparse o typer).
Paso 9: Controles de calidad y análisis
- Lint prompts: Claude puede escribir un linter rápido para marcar instrucciones vagas.
- QA visual: genera una hoja de contacto por clip con códigos de tiempo.
- QA de contenido: exige que el gancho esté presente en los primeros 3 segundos y el CTA en los últimos 5 segundos.
- Bucle de análisis: recupera métricas de rendimiento, luego haz que Claude proponga nuevos ganchos o variantes basados en los datos de retención y CTR.
Flujo de trabajo de ejemplo de extremo a extremo
- Coloca un video largo en
data/raw/.
- Ejecuta
make shorts para transcribir y recortar automáticamente.
- Revisa los clips; regenera los débiles ajustando
clip_rules.md.
- Ejecuta
make upload para programar publicaciones con subtítulos y metadatos.
- Después de 72 horas, ejecuta el script de análisis; pide a Claude que redacte notas de iteración.
Patrones de indicaciones prácticas para Claude Code
- “Dado esta transcripción y
clip_rules.md, propone 6 clips con marcas de tiempo y títulos. Asegúrate de que cada uno tenga un gancho fuerte y un ángulo único.”
- “Refactoriza
autoclip.py para aceptar una transcripción JSON y asegúrate de que las marcas de tiempo sean precisas al fotograma a 29.97fps.”
- “Genera pruebas
pytest para casos extremos de análisis de marcas de tiempo (00:59.97 rollover).”
- “Crea una función que califique los ganchos según la sorpresa, la especificidad y la brevedad (0–100).”
- “Convierte este guion en una descripción de YouTube con 3 clústeres de palabras clave y 2 marcadores de capítulo.”
Notas de herramientas y consejos de configuración
- Integración de IDE: puedes ejecutar Claude Code directamente desde tu terminal y muchos IDE; Anthropic documenta el inicio rápido y la auto‑instalación en VS Code.
- Operaciones de video:
ffmpeg para cortes, escalado, re‑tiempo, normalización de audio.
- Transcripción: Whisper local o ASR alojado; almacena SRT y JSON simultáneamente.
- Almacenamiento: mantén los datos sin procesar/procesados separados; usa slugs estables para la repetibilidad.
- Control de versiones: confirma las indicaciones y las configuraciones; ignora las salidas de medios en
.gitignore.
Ejemplo: Heurística de Autoclip mínima (Python)
import re
from typing import List, Tuple
HOOK_PATTERNS = [r"\bhere's the\b", r"\bthe mistake\b", r"\bdo this\b", r"\bin 30 seconds\b",
]
def score_line(line: str) -> int:
s = 0
if len(line) < 140: s += 10
if re.search(r"\b\d+%|\d+x|\b\d+ (seconds|minutes|steps)\b", line): s += 20
if any(re.search(p, line.lower) for p in HOOK_PATTERNS): s += 20
if line.endswith: s += 10
return min(s, 100)
def propose_clips(transcript: List[Tuple[float, float, str]], max_len=35):
clips = []
cur = []
cur_len = 0
for start, end, text in transcript:
cur.append((start, end, text))
cur_len += (end - start)
if cur_len >= max_len or score_line(text) > 40:
clips.append((cur[0][0], end))
cur, cur_len = [], 0
if cur:
clips.append((cur[0][0], cur[-1][1]))
return clips
Pídele a Claude Code que expanda esto a un módulo completo, agregue pruebas unitarias y mapee las salidas a los comandos ffmpeg.
Escalando el sistema
- Agrega una cola de trabajos (por ejemplo, Redis + RQ) para el procesamiento por lotes.
- Conteneriza con Docker; monta
data/ como un volumen.
- Usa el almacenamiento en la nube para los medios; mantén los manifiestos locales en Git.
- Si eres un equipo, conecta las comprobaciones de PR donde Claude sugiera mejoras y auto‑corrija scripts de shell, indicaciones y cadenas de documentación.
Vale la pena destacar: Usar Sider para acelerar las indicaciones y las revisiones
Si estás redactando briefs e indicaciones en varias pestañas, un asistente de barra lateral que se encuentra dentro de tu navegador y los documentos puede acelerar la iteración. Por cierto, los aspectos destacados del contenido de Sider discuten el uso de Claude de nivel empresarial y los flujos de trabajo de desarrolladores, incluidas las revisiones al estilo GitHub y la navegación de bases de código más grandes: contexto útil si tu repositorio de automatización crece y deseas revisiones de código y planificación asistidas por IA^2. Puedes mantener la voz de tu marca, las indicaciones y las diferencias de código en un solo lugar, luego pedirle a tu asistente de IA que genere comentarios de RP y planes de prueba. Errores comunes (y soluciones)
- Deriva de audio: vuelve a multiplexar el audio después del recorte y normaliza las tasas de muestreo.
- Desajuste de subtítulos: fuerza VFR→CFR o calcula marcas de tiempo precisas al fotograma.
- Rechazos de la plataforma: valida la relación de aspecto, la duración y la tasa de bits antes de las cargas.
- Inflación de metadatos: aplica el número máximo de caracteres con comprobaciones previas al vuelo.
- Automatización excesiva: mantén un paso de revisión humana en el bucle para los ganchos y los CTA.
Tus próximos pasos
- Configura Claude Code en tu IDE/terminal y crea la estructura del repositorio.
- Crea
brand_voice.yaml y archivos de indicaciones.
- Implementa
transcribe.py, autoclip.py y repurpose.py usando los patrones de código aquí.
- Agrega destinos
Makefile y ejecuta tu primer make shorts.
- Itera con comentarios de análisis y deja que Claude Code refactorice los puntos débiles.
Con este plano, puedes pasar de un solo video semanal a una transmisión diaria de cortos pulidos, consistentemente en la marca y optimizados para cada plataforma.
Preguntas frecuentes
P1: ¿Qué es Claude Code y cómo ayuda a la automatización del video marketing?
Claude Code es el asistente de codificación de Anthropic que se ejecuta en tu IDE/terminal para generar, refactorizar y depurar código. Acelera la creación de pipelines para la creación de scripts, el recorte, los subtítulos y la programación mediante la creación de módulos y la corrección rápida de problemas.
P2: ¿Puedo recortar automáticamente videos largos en cortos con Claude Code?
Sí. Usa Claude Code para analizar transcripciones, proponer marcas de tiempo de clips y generar comandos ffmpeg para recortes y acercamientos. Combina heurísticas simples con indicaciones LLM para garantizar que cada clip tenga un gancho, una conclusión y un CTA.
P3: ¿Cómo agrego subtítulos a escala?
Transcribe con Whisper o un ASR alojado, luego convierte SRT a ASS o incorpora usando ffmpeg. Claude Code puede envolver esto en scripts y agregar validación para que las marcas de tiempo permanezcan sincronizadas en todas las plataformas.
P4: ¿Puede este flujo de trabajo cargar automáticamente a YouTube, TikTok o Instagram?
Sí. Envuelve la API de cada plataforma en un script de programación con credenciales de OAuth, metadatos específicos de la plataforma y un modo de prueba. Claude Code puede generar stubs de cliente, reintentos y comprobaciones de esquema.
P5: ¿Cómo mantengo la voz de la marca consistente en todos los scripts y subtítulos?
Almacena las reglas de tu voz y estilo en un brand_voice.yaml y haz referencia a él en las indicaciones. Claude Code puede aplicar restricciones como frases prohibidas, nivel de lectura y ubicación de CTA al generar títulos, descripciones y texto en pantalla.