GUIA · CLAUDE CODE + EDIÇÃO DE VÍDEO
Editar vídeo é uma daquelas tarefas que parecem simples até você começar. Cortar silêncio, corrigir legenda, adicionar zoom, criar títulos, ajustar ritmo, exportar vertical, assistir tudo de novo porque alguma coisa ficou errada. Um vídeo de poucos minutos pode facilmente consumir uma tarde inteira.
Existe uma forma bem diferente de fazer isso: entregar o vídeo para o Claude Code e descrever a edição que você quer, em português. Hoje existem pelo menos três ferramentas muito interessantes para isso, e elas não fazem exatamente a mesma coisa.
01
O ponto mais importante é entender que elas possuem propostas diferentes. Troque os placeholders abaixo pelo vídeo de cada resultado.
02
É uma ferramenta para construir vídeos programaticamente usando React. Na prática, o Claude consegue criar a edição como código: textos, animações, legendas, zooms, elementos gráficos, transições e praticamente qualquer composição visual que você conseguir especificar.
A documentação oficial atualmente indica o comando abaixo como forma de iniciar um projeto.
npx create-video@latestSegue uma ideia parecida, mas trabalha com HTML, CSS e JavaScript para produzir vídeo. Foi construído especificamente para funcionar bem com agentes de programação como Claude Code, Codex, Cursor e Gemini CLI.
É especialmente interessante quando o vídeo possui bastante motion design, textos animados, interfaces, gráficos, apresentações, componentes visuais, animações com GSAP, vídeos de produto, conteúdo mais motion do que simplesmente corte de câmera.
A própria documentação recomenda começar instalando as skills.
npx skills add heygen-com/hyperframesDepois, dentro do Claude Code, você trabalha usando:
/hyperframesA documentação também oferece o comando abaixo para instalar ou atualizar o conjunto principal de skills.
npx hyperframes skills updatePossui uma abordagem diferente: funciona como uma camada de edição de vídeo para agentes de IA construída sobre ferramentas como FFmpeg.
Se o seu objetivo é mais próximo de uma edição tradicional (cortar, reenquadrar, gerar versões, normalizar áudio, adicionar legenda, criar thumbnails e exportar), ele pode ser extremamente interessante. O projeto se descreve como um servidor MCP local para edição de vídeo, com integração direta com Claude Code.
claude mcp add kinocut -- uvx --from kinocut kinoDepois você consegue fazer pedidos como:
Transforme esta entrevista em um vídeo vertical de 45 segundos, adicione legendas, normalize o áudio, crie uma thumbnail e me mostre uma versão para revisão antes da exportação.Não pense neles simplesmente como concorrentes. Pense assim:
Dependendo do projeto, você pode inclusive combinar ferramentas.
03
O mais importante é entender uma coisa: não é o Claude do navegador simplesmente pegando seu vídeo e editando magicamente. Você está usando o Claude Code, que consegue trabalhar com ferramentas e arquivos existentes no seu computador.
Instalado e funcionando no computador.
Remotion e HyperFrames dependem do ecossistema Node. O HyperFrames pede Node.js 22 ou superior.
node -v
Fundamental para boa parte dos fluxos de processamento. O HyperFrames lista FFmpeg entre seus requisitos, e o Kinocut também exige FFmpeg disponível no PATH.
ffmpeg -version
04
Por que eu prefiro estes prompts? Porque eles separam duas tarefas: configurar o ambiente e editar o vídeo. Quando você mistura as duas coisas no primeiro prompt, fica muito mais difícil descobrir o que deu errado caso alguma instalação falhe.
Crie uma pasta para o projeto, coloque dentro dela o vídeo que você deseja editar e abra essa pasta no Claude Code. Depois envie:
Quero transformar esta pasta em um ambiente completo para edição de vídeos
verticais para TikTok, Instagram Reels e YouTube Shorts.
Primeiro execute:
npx create-video@latest
Instale todas as dependências necessárias para utilizar o Remotion.
Analise o projeto depois da instalação e verifique se tudo está funcionando.
Também verifique se temos as ferramentas necessárias para:
- trabalhar com vídeos MP4;
- manipular áudio;
- criar legendas;
- renderizar vídeo;
- trabalhar com timestamps;
- executar FFmpeg quando necessário;
- gerar vídeos em 1080x1920;
- exportar H.264 + AAC.
Não comece a editar meu vídeo ainda.
Primeiro configure o ambiente, teste o projeto e me informe:
1. o que foi instalado;
2. se existe alguma dependência faltando;
3. qual comando abre o preview;
4. qual comando renderiza o vídeo;
5. onde devo colocar os vídeos originais.Dentro da pasta do projeto, envie:
Quero configurar esta pasta para criação e edição de vídeos verticais usando
HyperFrames com Claude Code.
Execute:
npx skills add heygen-com/hyperframes --full-depth
Instale também todas as dependências necessárias para produzir vídeos para:
- Instagram Reels;
- TikTok;
- YouTube Shorts.
Quero trabalhar principalmente em 1080x1920.
Verifique:
- Node.js;
- FFmpeg;
- dependências do HyperFrames;
- skills instaladas;
- sistema de preview;
- sistema de renderização.
Depois execute as verificações disponíveis do HyperFrames.
Não crie nenhum vídeo ainda.
No final, me informe:
1. se o ambiente está funcionando;
2. quais skills foram instaladas;
3. como abrir o preview;
4. como renderizar;
5. se existe alguma dependência faltando.Observação importante: o HyperFrames atualmente recomenda instalar o conjunto principal de skills e deixar workflows especializados serem carregados quando necessário. Para ambientes comuns, você não necessariamente precisa instalar todas as skills.
Depois da instalação, você pode pedir:
Use /hyperframes para este projeto.Primeiro confirme que possui FFmpeg. Depois adicione o MCP ao Claude Code:
claude mcp add kinocut -- uvx --from kinocut kinoO projeto oficial também recomenda verificar a instalação com:
uvx --from kinocut kino doctorVocê também pode simplesmente entregar essa responsabilidade ao Claude:
Quero utilizar Kinocut para edição local de vídeos.
Configure tudo o que for necessário para editar vídeos verticais para
TikTok, Instagram Reels e YouTube Shorts.
Adicione o MCP usando:
claude mcp add kinocut -- uvx --from kinocut kino
Verifique também:
- FFmpeg;
- ffprobe;
- uv/uvx;
- Kinocut;
- conexão MCP;
- suporte aos formatos de vídeo que estão nesta pasta.
Execute os diagnósticos necessários.
Não edite nenhum vídeo ainda.
Quando terminar, me diga exatamente o que está funcionando e se existe
alguma dependência faltando.05
Não mande simplesmente "edita esse vídeo para mim". Esse é provavelmente o pior prompt possível: o Claude precisaria decidir sozinho quanto silêncio remover, quando dar zoom, como fazer a legenda, quantas palavras mostrar, onde colocar a legenda, quais momentos destacar, quanto tempo deve durar cada animação, qual formato exportar.
Quanto mais decisões subjetivas você deixa abertas, mais inconsistente fica o resultado. O segredo é transformar seu estilo de edição em regras objetivas.
Troque apenas as informações entre colchetes.
Quero editar:
[ARQUIVO.mp4]
Destino:
Instagram Reels / TikTok / YouTube Shorts.
Antes de fazer qualquer alteração destrutiva, analise o vídeo inteiro.
Crie uma transcrição com timestamps precisos.
=====================================
ETAPA 1 - TRANSCRIÇÃO
=====================================
Transcreva toda a fala.
Quando possível, mantenha timestamps precisos por palavra.
Identifique separadamente:
- pausas;
- vícios de linguagem;
- repetições;
- frases interrompidas;
- erros de fala;
- trechos potencialmente removíveis.
Não faça cortes ainda.
=====================================
ETAPA 2 - LIMPEZA
=====================================
Identifique:
- silêncios maiores que 0,6 segundo;
- "é...";
- "ã...";
- "tipo..." quando estiver isolado;
- repetições claramente acidentais;
- falsas partidas de frase.
Não remova automaticamente pausas que estejam sendo usadas como pontuação,
ênfase ou respiração natural.
Ao realizar um corte, preserve aproximadamente 120 ms de room tone quando
isso ajudar a evitar uma sensação artificial.
Prioridade:
fala natural > vídeo excessivamente rápido.
=====================================
ETAPA 3 - LEGENDAS
=====================================
Crie legendas dinâmicas.
Regras:
- aproximadamente 3 a 4 palavras por bloco;
- nunca deixar uma única palavra isolada quando puder ser agrupada;
- fonte sans-serif;
- peso bold;
- texto branco;
- contorno ou sombra preta;
- palavra atualmente falada destacada em [COR];
- centralização horizontal;
- largura máxima aproximada de 900 px;
- posicionamento aproximadamente em 70% da altura do vídeo;
- respeitar área segura do Instagram/TikTok.
A sincronização precisa acompanhar a fala.
=====================================
ETAPA 4 - RITMO
=====================================
Não quero zoom aleatório em cada frase.
Analise o conteúdo e escolha apenas momentos em que existe alguma mudança
de importância.
Procure principalmente:
- afirmações fortes;
- números;
- listas;
- revelações;
- perguntas;
- frases de contraste;
- conclusões;
- mudanças importantes de assunto.
Selecione no máximo 5 momentos principais.
Mantenha distância suficiente entre eles para não transformar o vídeo em
uma sequência contínua de efeitos.
=====================================
ETAPA 5 - ZOOMS
=====================================
Nos momentos selecionados:
aplique aproximadamente 6% a 8% de zoom.
Entrada:
aproximadamente 0,35 a 0,45 segundo.
O movimento deve ser suave.
Priorize o rosto do apresentador.
Não corte olhos, boca ou topo da cabeça.
Não aplique zoom se o enquadramento já estiver apertado.
=====================================
ETAPA 6 - TÍTULOS
=====================================
Para cada momento importante, proponha um título curto.
Máximo:
24 caracteres quando possível.
O título não deve simplesmente repetir a legenda.
Ele deve funcionar como uma camada adicional de contexto.
Exemplos:
fala:
"80% dos clientes abandonam aqui."
título:
"ONDE VOCÊ PERDE"
fala:
"existem três erros principais."
título:
"3 ERROS"
=====================================
ETAPA 7 - FORMATO
=====================================
Formato final:
1080x1920
Aspect ratio:
9:16
Frame rate:
30 fps
Vídeo:
H.264
Áudio:
AAC
Não distorça o vídeo original.
Se for necessário adaptar enquadramento, preserve o rosto e elementos
principais.
=====================================
ETAPA 8 - PORTÃO DE APROVAÇÃO
=====================================
NÃO renderize o vídeo final imediatamente.
Primeiro quero revisar o plano de edição.
Me mostre:
1. transcrição completa;
2. cortes sugeridos;
3. motivo de cada corte;
4. timestamps;
5. os 5 momentos destacados;
6. títulos sugeridos;
7. zooms sugeridos.
Monte uma tabela:
| Tempo | Ação | Texto/Fala | Motivo |
Depois espere minha aprovação.
Somente depois que eu disser:
APROVADO
você poderá aplicar todas as alterações e renderizar.
=====================================
ETAPA 9 - EXPORTAÇÃO
=====================================
Depois da aprovação, renderize para:
saida/[NOME]_editado.mp4
Ao terminar, informe:
- duração original;
- duração final;
- quantidade de cortes;
- quantidade de títulos;
- resolução;
- fps;
- codec;
- caminho do arquivo final.
Também gere frames de referência dos principais momentos editados para
que eu possa revisar visualmente o resultado.Porque ele remove ambiguidade. Compare:
Corte os silêncios.Considere para corte silêncios maiores que 0,6 segundo, preservando pausas que estejam sendo usadas como pontuação e mantendo aproximadamente 120 ms de room tone quando necessário.São instruções completamente diferentes. Uma diz apenas o objetivo. A outra explica como tomar a decisão. Essa diferença é enorme quando estamos trabalhando com agentes.
06
Não deixe o Claude transcrever, cortar, editar e renderizar tudo sem você olhar. O melhor fluxo é:
Antes do render, confira principalmente três coisas.
Transcrição automática ainda erra muito aqui. "Claude" pode virar "cloud". R$ 4.000 pode virar R$ 40. Nome de empresa pode virar praticamente qualquer coisa. Corrija isso antes de gerar as legendas.
Uma pausa longa não significa necessariamente que aquele trecho precisa ser removido. Às vezes ela existe justamente porque o apresentador está criando expectativa.
O agente pode identificar um momento tecnicamente forte que não é necessariamente o melhor momento narrativo. Você continua sendo o diretor.
07
Agora você possui um padrão de edição. Em vez de explicar tudo de novo, pode simplesmente pedir variações.
Pegue a edição aprovada e crie uma segunda versão com no máximo 30 segundos.
Use apenas os três momentos mais fortes.
Preserve:
- estilo das legendas;
- tipografia;
- cores;
- zooms;
- títulos;
- tratamento de áudio.
Não altere a edição original.
Exporte como:
saida/[NOME]_30s.mp4Crie uma segunda versão em 1920x1080.
Não estique o vídeo vertical.
Mantenha o vídeo original centralizado com altura máxima possível.
Preencha as laterais usando uma versão ampliada e desfocada do próprio
vídeo.
O fundo deve acompanhar o vídeo principal.
Preserve legendas e títulos dentro da região central segura.
Exporte como:
saida/[NOME]_horizontal.mp4Um vídeo vertical não simplesmente "vira" 16:9. Você precisa escolher entre crop ou preenchimento lateral.
Nos cortes em que o enquadramento praticamente não muda, alterne
sutilmente entre:
100%
e
106%
de escala.
Não faça isso em todos os cortes automaticamente.
Use apenas quando ajudar a esconder o jump cut.
O efeito precisa parecer enquadramento de câmera e não zoom animado.Essa última frase faz diferença. Você não quer zoom entrando. Você quer plano A → corte → plano B ligeiramente aproximado.
Adicione uma barra de progresso fina na parte inferior.
Cor:
[#F5A623]
A barra deve crescer continuamente de acordo com a duração do vídeo.
Nos primeiros quatro segundos, exiba também:
[SEU NOME]
[@SEUUSUARIO]
Use animação curta e discreta.
Não cubra a legenda.É aqui que o processo começa a ficar realmente interessante.
Existem vários arquivos .mp4 dentro de:
origem/
Aplique a todos exatamente o mesmo sistema visual aprovado neste projeto.
Preserve:
- regras de corte;
- legendas;
- tipografia;
- cores;
- posicionamento;
- títulos;
- zoom;
- resolução;
- áudio;
- codec.
Analise cada vídeo individualmente.
Não reutilize automaticamente os mesmos timestamps ou títulos.
Cada vídeo precisa possuir seus próprios momentos importantes.
Salve os resultados em:
saida/
Nunca sobrescreva os arquivos originais.Isso começa a transformar uma edição manual em um sistema de edição.
08
Esse é provavelmente o próximo nível. Pegue alguns vídeos que representam exatamente como você gosta de editar e coloque na pasta referencias/. Depois peça:
Analise os vídeos existentes em referencias/.
Não copie o conteúdo.
Quero que você identifique o sistema de edição.
Analise:
- duração média dos cortes;
- quantidade de palavras por legenda;
- localização das legendas;
- cores;
- tamanho;
- tipografia aproximada;
- frequência de zoom;
- intensidade de zoom;
- ritmo;
- animações;
- títulos;
- transições;
- uso de imagens;
- uso de B-roll;
- espaçamento;
- safe areas;
- padrões recorrentes.
Crie um arquivo:
STYLE_GUIDE.md
Transforme todas essas observações em regras objetivas.
Depois me mostre o documento para aprovação.
Não edite nenhum vídeo ainda.Depois de aprovado:
A partir de agora utilize STYLE_GUIDE.md como referência obrigatória para
todos os vídeos deste projeto.Agora você deixou de possuir simplesmente um prompt. Você possui um sistema de edição documentado.
Eu recomendo instruir o agente a separar toda mudança em três categorias.
Para qualquer edição, classifique as decisões desta forma:
AUTOMÁTICAS
Alterações extremamente seguras que podem ser executadas sem aprovação.
Exemplo:
- adequar resolução;
- organizar arquivos;
- corrigir caminhos;
- preparar composição.
SUGERIDAS
Alterações criativas que quero aprovar antes.
Exemplo:
- remover uma pausa;
- escolher um título;
- destacar uma palavra;
- aplicar zoom;
- alterar ritmo.
PROIBIDAS SEM APROVAÇÃO
Mudanças que não podem ser realizadas automaticamente.
Exemplo:
- remover frases inteiras;
- mudar o significado da fala;
- adicionar informação que não aparece na gravação;
- inventar dados;
- substituir voz;
- criar uma fala inexistente.Isso melhora bastante a previsibilidade.
09
Também vale colocar expectativa no lugar certo. O Claude pode analisar frames, áudio, transcrição e estrutura do projeto. Mas você ainda precisa revisar coisas subjetivas, por exemplo:
Ele pode acelerar muito o trabalho. Não significa que todo primeiro render vai estar pronto para publicação.
10
| Erro | Como evitar |
|---|---|
| Pedir simplesmente "edite meu vídeo" | Transforme seu estilo em regras |
| Cortar todo silêncio automaticamente | Defina duração mínima e preserve pausas narrativas |
| Renderizar antes de revisar | Use o portão de aprovação |
| Confiar cegamente na transcrição | Confira nomes, marcas e números |
| Colocar efeito em todo corte | Use movimento apenas quando houver motivo |
| Publicar o primeiro render | Assista o vídeo inteiro pelo menos uma vez |
11
A pergunta correta não é "qual é o melhor". A pergunta é: que tipo de edição eu quero automatizar?
Se seu vídeo depende muito de identidade visual, componentes e layouts
Teste Remotion
Se seu conteúdo parece mais um motion design, apresentação ou animação baseada em elementos de web
Teste HyperFrames
Se você quer operações próximas de um editor tradicional: cortes, transformação, áudio e diferentes entregas
Teste Kinocut
O mais interessante é perceber que o Claude está se tornando menos um botão de "gere um vídeo" e mais uma interface para controlar ferramentas profissionais através de linguagem natural. Você continua decidindo como o vídeo deve ficar. A diferença é que cada vez menos dessas decisões precisam ser executadas manualmente em uma timeline.