Editar vídeo com Claude Code e FFmpeg: cinco tarefas passo a passo

Todas as semanas gravas um podcast em vídeo de uma hora. Daí saem seis clips verticais com legendas, todos com o mesmo volume e o mesmo formato de nome. É um trabalho que sabes fazer de cor e que te come a tarde de segunda-feira.

Esse tipo de trabalho (repetido, com regras claras e sobre ficheiros) é onde o Claude Code rende a sério. Não porque «edite» como um editor humano, mas porque escreve e executa os comandos de FFmpeg que terias de ir procurar a um fórum.

Este guia é para criadores e editores que não programam mas não se assustam com um terminal. Se antes quiseres saber o que o Claude pode e não pode fazer com vídeo em geral, começa por como editar vídeos com o Claude.

O que precisas

• Claude Code instalado. Precisa de uma subscrição paga do Claude ou de uma conta na Consola da Anthropic.
• FFmpeg instalado e acessível a partir do terminal. Se não o tiveres, pede ao Claude Code que o instale e te explique o que faz.
• Uma pasta de trabalho com uma cópia do material, nunca os brutos originais.
• Recomendado: a app para computador do Polimake, gratuita. Transcreve com Whisper no teu computador, traz um editor de vídeo para os retoques que o FFmpeg não resolve e deixa o Claude consultar a tua biblioteca por MCP. Com ela poupas-te a instalar e configurar o Whisper à mão. Para já, só há versão para Windows.

Antes de começar: as regras da pasta

Ao arrancar, o Claude Code lê um ficheiro chamado CLAUDE.md na pasta onde o abres. Usa-o para fixar as regras que não queres repetir todas as semanas:

# Regras desta pasta

- Os originais estão em `brutos/`. Nunca os alteres nem apagues.
- Tudo o que gerares vai para `saida/`, com o nome `AAAA-MM-DD_clip-NN.mp4`.
- Exporta em H.264, CRF 18, áudio AAC 192k.
- Clips verticais: 1080 × 1920. Horizontais: 1920 × 1080.
- Antes de processar mais de um ficheiro, testa com um e mostra-me o resultado.

Se tiveres dúvidas sobre o codec ou o contentor de saída, tens a decisão explicada em H.264 ou H.265 e em que formato pedir na entrega.

A primeira regra é a importante. O Claude Code pede autorização antes de executar cada comando, mas com vinte ordens seguidas é fácil aprovar sem ler. Com os originais protegidos, um erro custa um minuto, não uma gravação.

Tarefa 1: localizar silêncios longos

O que pedes:

Analisa brutos/episodio-42.mp4 e dá-me uma lista dos silêncios com mais de 0,6 segundos, com início e fim.

O que deve executar, mais ou menos:

ffmpeg -i brutos/episodio-42.mp4 -af silencedetect=noise=-35dB:d=0.6 -f null -

O FFmpeg escreve no ecrã cada silêncio com o seu início e fim, e o Claude devolve-te a lista ordenada.

O que verificar: o limiar de -35dB. Numa sala com ruído de fundo pode não detetar nada; num estúdio muito silencioso, pode marcar como silêncio uma pausa intencional. Se o resultado não bater certo, pede-lhe que experimente outro valor. E decide tu se queres eliminar os silêncios: numa entrevista, algumas pausas são o melhor do vídeo.

Tarefa 2: transcrever e preparar as legendas

O que pedes:

Transcreve o episódio em português e gera um SRT. Depois revê o texto: corrige os nomes próprios usando esta lista (Marta Vidal, Lumen, Polimake) e parte as linhas com mais de 42 caracteres.

Para transcrever, o Claude Code vai usar a ferramenta que tiveres instalada. Com o Whisper seria algo assim:

whisper brutos/episodio-42.mp4 --model medium --language Portuguese --output_format srt --output_dir saida/

Se não quiseres instalar o Whisper por tua conta, a transcrição local da app para computador do Polimake faz o mesmo no teu computador e exporta o texto com marcas de tempo. Além disso, deixa o que foi transcrito indexado, por isso daqui a seis meses vais poder procurar o episódio por uma frase.

O que verificar: os nomes próprios e os números. É onde qualquer transcrição automática mais se engana, e um erro numa legenda gravada na imagem não se corrige depois. Para fixar o estilo das legendas de todo o canal, vê como sistematizar a legendagem.

Tarefa 3: escolher e cortar os clips

Esta é a parte que mais tempo poupa, porque o Claude faz duas coisas seguidas: decide com base no texto e executa os cortes.

O que pedes:

Com o SRT, propõe seis clips de 30 a 50 segundos, cada um com uma única ideia que se perceba sem contexto. Mostra-me a tabela (início, fim, primeira e última frase) antes de cortares alguma coisa. Usa só tempos que existam no SRT.

Quando aprovares a tabela, vai cortar cada clip com algo assim:

ffmpeg -i brutos/episodio-42.mp4 -ss 00:12:04.500 -to 00:12:51.200 -c:v libx264 -crf 18 -c:a aac -b:a 192k saida/2026-10-29_clip-01.mp4

Com -ss e -to depois de -i, o corte é exato à imagem, embora demore um pouco mais, porque volta a codificar.

O que verificar: o início e o fim de cada clip. Que não comece a meio de uma palavra nem acabe numa inspiração. Se acontecer, pede-lhe que mova o corte meio segundo; é mais rápido do que corrigi-lo no editor. E antes de publicares os seis em todo o lado, decide que versão vai para cada plataforma.

Tarefa 4: reenquadrar para vertical e gravar as legendas na imagem

O que pedes:

Passa os seis clips para 1080 × 1920 recortando o centro da imagem e grava na imagem as legendas do respetivo troço, com letra grande e contorno. Antes de os processares todos, extrai uma imagem do primeiro e verifica-a.

Para cada clip, algo parecido com:

ffmpeg -i saida/2026-10-29_clip-01.mp4 -vf "crop=trunc(ih*9/16/2)*2:ih,scale=1080:1920,subtitles=saida/clip-01.srt:force_style='FontSize=14,Outline=2'" -c:a copy saida/2026-10-29_clip-01_vertical.mp4

Repara na última frase do pedido. O Claude Code consegue abrir imagens, por isso pode olhar para a imagem extraída e dizer-te se a pessoa sai do recorte. Se estiver à esquerda do plano, o recorte centrado corta-a: pede-lhe que desloque o enquadramento.

O que verificar: o recorte em planos onde há duas pessoas. Um recorte fixo ao centro não segue quem fala. Se o vídeo alterna entre dois interlocutores, este passo tens de o resolver no editor (o da app para computador do Polimake abre os clips diretamente a partir da pasta) ou com uma ferramenta de reenquadramento automático. Se o caso for o contrário, de vertical para horizontal, tens as opções em adaptar um vídeo vertical a todos os canais.

Tarefa 5: igualar o volume e exportar em lote

O que pedes:

Normaliza o áudio de todos os clips verticais para cerca de -14 LUFS e deixa a versão final com o nome combinado.

Para cada clip:

ffmpeg -i saida/2026-10-29_clip-01_vertical.mp4 -af loudnorm=I=-14:TP=-1.5:LRA=11 -ar 48000 -c:v copy saida/2026-10-29_clip-01.mp4

Cerca de -14 LUFS é uma referência habitual para vídeo nas redes sociais; se o teu cliente tiver outra especificação, dá-lha. O -ar 48000 está lá porque o loudnorm sobe o áudio para 96 kHz se não lhe disseres outra coisa, e isso só engorda o ficheiro.

O que verificar: ouve pelo menos um clip inteiro com auscultadores. O loudnorm iguala o volume, não corrige um áudio mau; para isso é preciso uma mistura de áudio a sério.

Transformá-lo numa rotina

Quando as cinco tarefas correrem bem uma vez, pede ao Claude Code que as guarde como um script ou como uma skill da pasta. Na semana seguinte, o trabalho resume-se a largar o bruto em brutos/, aprovar a tabela de clips e rever o resultado.

Onde não compensa

• Peças que se montam uma só vez. Preparar as regras leva mais tempo do que montar à mão um vídeo único.
• Montagens que dependem do ritmo visual. Um spot ou um vídeo de produto decidem-se a olhar, não a ler uma transcrição.
• Reenquadramentos com movimento. Um recorte fixo não segue ninguém.
• Correção de cor e mistura de áudio. O FFmpeg pode aplicar uma LUT ou um filtro, mas o critério de cor e de acabamento continua no editor.

Para as restantes tarefas de montagem que a IA te pode tirar de cima, mesmo sem passar pelo terminal, vê editar vídeos com IA.

Começa pela app para computador

A forma mais curta de montar tudo isto é descarregar a app para computador do Polimake, que é gratuita para esta utilização. Traz a transcrição com Whisper, a pesquisa nas tuas pastas, o editor de vídeo para os retoques e o MCP com que o Claude chega à tua biblioteca. Só tens de acrescentar o Claude Code e o FFmpeg. Para já, só há versão para Windows.

Perguntas frequentes

O Claude Code é gratuito?

Não. O Claude Code precisa de uma subscrição paga do Claude (Pro, Max, Team ou Enterprise) ou de uma conta na Consola da Anthropic com pagamento por utilização; o plano gratuito do claude.ai não o inclui. O FFmpeg, pelo contrário, é software livre e gratuito.

Funciona no Windows?

Sim. O Claude Code funciona em macOS, Linux e Windows, tanto de forma nativa como dentro do WSL. O FFmpeg também está disponível para os três sistemas, por isso o fluxo deste guia pode ser seguido em qualquer um deles.

O Claude edita o vídeo diretamente?

Não vê o vídeo como um editor humano nem o monta numa linha de tempo. Escreve e executa comandos de FFmpeg, lê transcrições e pode rever imagens extraídas do vídeo. Por isso rende em tarefas com regras claras, como cortar, reenquadrar ou normalizar, e não em decisões de ritmo visual.

Porque é que o corte não cai exatamente onde pedi?

Se o comando copia o vídeo sem recodificar (-c copy), o FFmpeg só pode cortar em fotogramas-chave, que podem estar a vários segundos do ponto pedido. Para um corte exato é preciso recodificar, como nos exemplos deste guia: demora mais, mas o clip começa e acaba onde diz a tabela.