Cómo instalar Claude Video en Claude Code y hacer que Claude vea cualquier video
Aprender a instalar Claude Video en Claude Code le da a tu asistente algo que no trae de fábrica: la capacidad de ver un video. Con el comando /watch pegas una URL de YouTube, TikTok, Loom, Vimeo o la ruta de un archivo local, haces una pregunta y Claude descarga el video con yt-dlp, extrae fotogramas con ffmpeg y obtiene la transcripción para responder basándose en lo que realmente aparece en pantalla y se escucha en el audio.
En esta guía verás cómo instalar el plugin paso a paso, qué hace su hook de SessionStart que verifica tus dependencias en cada sesión, y cómo aprovechar /watch para análisis de contenido, marketing y depuración.
- Qué es Claude Video y para qué sirve el comando
/watch. - Cómo instalarlo desde el marketplace en dos comandos.
- Cómo funciona el hook que valida ffmpeg y yt-dlp automáticamente.
- Los modos de detalle y cómo controlar el gasto de tokens.
- Casos de uso reales para marketing digital y SEO.
¿Qué es Claude Video y el comando /watch?
Claude Video es un plugin open source (licencia MIT) creado por Brad Bonanno que añade la skill /watch a Claude Code. Su propósito es simple: darle a Claude un “input de video” del que carece de forma nativa.
Cuando le pasas un video, el flujo interno hace tres cosas en orden. Primero busca los subtítulos nativos con yt-dlp (gratis e instantáneo). Después descarga solo lo necesario y extrae fotogramas con ffmpeg. Por último entrega esos fotogramas y la transcripción con marcas de tiempo a Claude, que los lee como imágenes y responde citando el minuto exacto.
Para qué lo usa la gente en la práctica:
- Analizar contenido ajeno: “¿con qué gancho abrió este video viral?”.
- Diagnosticar un bug: le pasas una grabación de pantalla y encuentra el fotograma donde algo se rompe.
- Resumir un video largo sin verlo a 2x: estructura, momentos clave y lo que realmente se dijo.
- Quitar el relleno a un video de lanzamiento y quedarte solo con lo nuevo.
Requisitos previos
Claude Video se apoya en dos utilidades de línea de comandos y una clave de API opcional:
- yt-dlp — descarga el video y extrae los subtítulos nativos.
- ffmpeg — extrae los fotogramas y, si hace falta, el audio.
- Clave de Whisper (opcional): Groq (preferida, más rápida y barata) u OpenAI, solo se usa cuando el video no tiene subtítulos.
Los subtítulos cubren la mayoría de los videos públicos de forma gratuita, así que la clave de Whisper solo entra en juego con archivos locales, algunos TikToks y subidas sin subtítulos.
Cómo instalar Claude Video en Claude Code
Opción 1: Marketplace (recomendada)
Es la vía recomendada porque el plugin se actualiza solo desde el marketplace. Ejecuta estos dos comandos dentro de Claude Code:
/plugin marketplace add bradautomates/claude-video
/plugin install watch@claude-videoPara actualizarlo más adelante basta con /plugin update watch@claude-video. Si prefieres una alternativa no interactiva, el CLI también acepta claude plugin marketplace add y claude plugin install con los mismos argumentos.
Opción 2: Codex, Cursor, Copilot y otros agentes
Claude Video no es exclusivo de Claude Code. Con la CLI de Agent Skills lo instalas en más de 50 hosts compatibles:
npx skills add bradautomates/claude-video -gLa bandera -g instala la skill de forma global para tu usuario; quítala para limitarla al proyecto actual. Si trabajas con este ecosistema, te conviene revisar cómo instalar skills y MCP en Claude Code para sacarle todo el partido a tu asistente.
El hook de SessionStart: qué hace y por qué importa
Aquí está el detalle que diferencia a este plugin de una skill suelta: trae un hook de SessionStart propio de Claude Code. Un hook es un script que Claude Code ejecuta automáticamente ante ciertos eventos, sin que tú lo pidas.
El hook de Claude Video está definido en hooks/hooks.json y lanza el script check-setup.sh al inicio de cada sesión, con un tiempo límite de 5 segundos. Su única misión es verificar tu entorno antes de que necesites el comando.
- Comprueba en silencio si ffmpeg y yt-dlp están en tu PATH.
- Si falta algo, inyecta un aviso claro en el contexto de la sesión.
- Te recuerda ejecutar
setup.pyuna sola vez para instalar las dependencias y crear la configuración. - Cuando todo está en orden, no dice nada y no te estorba.
El mensaje típico que verás si falta algo es: “/watch: needs ffmpeg + yt-dlp. Run setup.py once to install and scaffold config”. Gracias al hook nunca descubres que falta una dependencia a mitad de una tarea: lo sabes al abrir la sesión.
Primer uso: instala ffmpeg y yt-dlp
En la primera llamada a /watch, la skill ejecuta un preflight. Si detecta que faltan binarios, corre el instalador incluido:
- macOS: instala ffmpeg y yt-dlp automáticamente con Homebrew.
- Linux: imprime los comandos exactos de apt, dnf o pipx.
- Windows: imprime los comandos de winget o pip que debes ejecutar tú.
El instalador también crea el archivo de configuración ~/.config/watch/.env con permisos 0600 y placeholders comentados para tu clave de Groq u OpenAI. Después de esa primera vez, el preflight es silencioso y /watch simplemente funciona.
Modos de detalle y presupuesto de fotogramas
El coste en tokens lo dominan los fotogramas, porque cada uno es una imagen. Por eso Claude Video ofrece un dial de detalle con --detail:
| Modo | Qué hace | Tope de fotogramas |
|---|---|---|
| transcript | Solo transcripción, sin fotogramas | 0 |
| efficient | Fotogramas clave, casi instantáneo | 50 |
| balanced (por defecto) | Fotogramas por cambio de escena | 100 |
| token-burner | Máxima fidelidad, sin tope | Ilimitado |
Para videos de más de 10 minutos, lo eficiente es acotar con --start y --end en lugar de escanear todo. Así concentras el presupuesto de fotogramas en el fragmento que te interesa y ahorras tokens.
Casos de uso para marketing y SEO
Para quienes trabajamos en marketing digital, /watch se convierte en un analista de video a demanda:
- Desglosar el gancho, el ritmo y la estructura de los videos de la competencia.
- Convertir un webinar o un podcast en notas y en un borrador de artículo.
- Auditar creativos de anuncios cuadro por cuadro antes de escalar la inversión.
- Extraer transcripciones con marcas de tiempo para crear contenido optimizado para búsqueda.
Encaja de forma natural con el resto de tu stack de IA. Si ya usas Claude Code para producir, puedes combinarlo con sumar agentes de IA especializados con The Agency o con mapear tu repositorio en un grafo de conocimiento con Graphify para tener un asistente que ve, entiende y organiza tu trabajo.
Preguntas frecuentes
¿Tienes dudas sobre la privacidad de tus archivos, los costos de API, la compatibilidad con Windows o el control de recursos? Aquí encontrarás respuestas claras sobre el funcionamiento local y el uso de Claude Video.
Conclusión
Instalar Claude Video en Claude Code es cuestión de dos comandos, y su hook de SessionStart se encarga de que nunca te falte una dependencia. A partir de ahí, Claude deja de adivinar por el título de un video y empieza a responder por lo que de verdad ve y escucha. Para cualquiera que produzca o analice contenido, es una de las extensiones más útiles que puedes añadir hoy a tu flujo de trabajo con IA.
