Criando vídeo profissional com Claude Code + /remotion-video

Manual operacional pra produzir Reels, anúncio e motion graphics descrevendo em português.

Mateus Castro · Doism · Edição 2026

---

Carta de abertura

Fala, pessoal.

Esse manual aqui é diferente dos guias conceituais que eu venho soltando nas últimas semanas. Não é um material de leitura editorial pra você entender o que está mudando no mercado de IA. É um passo a passo de operação, pra você (ou alguém do seu time) sair do zero e chegar num vídeo .mp4 cinematográfico pronto pra publicar no Instagram, TikTok ou YouTube, sem nunca ter editado vídeo na vida.

A ferramenta é a combinação Claude Code + Remotion via a skill /remotion-video da equipe oficial Remotion. Antes dela, fazer vídeo animado pedia conhecimento de After Effects, Premiere, Final Cut, ou Capcut profissional. Pedia hora de produção, designer freelance, ou agência. A skill /remotion-video quebra isso: você descreve o vídeo em português, o Claude entende, o Remotion executa, e o arquivo final sai pronto.

Esse manual cobre da instalação dos pré-requisitos até a renderização do primeiro vídeo. Tempo estimado de leitura: 20 minutos. Tempo estimado de execução pra alguém zero técnico fazer o primeiro vídeo dar certo: 60 a 90 minutos. Depois disso, vídeo novo sai em 10 minutos.

Pra empresa de academia, restaurante, clínica, distribuidora, loja ou autoescola que vive de conteúdo de Reels, isso vira alavanca grande. Pra time de marketing interno, é gargalo a menos.

Bora juntos?

Mateus Castro

---

Requisitos prévios

Antes de começar, garanta os 4 itens abaixo. Sem eles, o manual não roda.

1. Computador Mac ou Windows. Funciona em qualquer um. Se for Linux, também roda, mas o manual usa screenshot Mac e Windows como referência. Recomendado 16 GB de RAM pra renderizar vídeo mais longo sem travamento.

2. Conta paga do Claude. Pro ou Max (Pro funciona, mas Max é o realista pra uso intenso de vídeo, porque consome muito token). Sem conta paga não tem Claude Code.

3. Internet estável. A geração de código e a comunicação com Anthropic precisa de rede boa. Pra render local final, internet não precisa, mas pra fluxo de trabalho dia a dia precisa.

4. 1 hora livre na agenda. Não tenta fazer entre uma reunião e outra. Reserva tempo dedicado.

Tempo total estimado pra primeira execução completa: 60 a 90 minutos.
Tempo de cada vídeo novo depois da configuração: 10 a 20 minutos.

---

Visão geral do processo, 7 etapas

PASSO 1                    PASSO 2                    PASSO 3
Instalar Node.js   →     Instalar Claude     →    Criar projeto
(10 min)                  Code (15 min)            Remotion (10 min)
                                                              ↓
PASSO 7                    PASSO 6                    PASSO 4
Renderizar         ←     Pré-visualizar      ←    Instalar skill
.mp4 (10 min)             no Studio (5 min)        /remotion-video (5 min)
                                                              ↓
                          PASSO 5
                          Descrever o vídeo
                          em português (10 min)

Pra primeira execução: faça em sequência os passos 1 a 7.
Pra próximos vídeos: pula direto pro Passo 5. O ambiente já está pronto.

---

PASSO 01, INSTALAR O NODE.JS

Objetivo: ter o Node.js 18 ou superior funcionando no seu computador. É o motor que vai executar todo o código de vídeo.

Tempo estimado: 10 minutos.

1.1 Verifique se já está instalado

Abra o terminal. No Mac, abre o "Terminal" pelo Spotlight (cmd + espaço, digita "Terminal"). No Windows, abre o "PowerShell" pelo menu Iniciar.

Cole esse comando e aperta Enter:

node --version

Três resultados possíveis:

• Sai algo como v20.10.0 ou v18.18.0. Você já tem Node 18 ou superior. Pula pro Passo 1.4 e segue.
• Sai algo como v16.20.0. Você tem Node antigo. Precisa atualizar. Segue pro Passo 1.2.
• Sai mensagem de erro tipo "command not found". Você não tem Node instalado. Segue pro Passo 1.2.

1.2 Baixe o instalador oficial

Abre o navegador e vai em nodejs.org. Clica no botão grande do meio que mostra a versão LTS (Long Term Support). Vai baixar um arquivo .pkg (Mac) ou .msi (Windows).

1.3 Execute o instalador

Clica duas vezes no arquivo baixado. Segue o assistente apertando "Continuar" em todas as telas. Aceita os termos. No final, clica "Instalar". Se pedir senha do computador, coloca.

1.4 Confirme a instalação

Volta no terminal. Cole o comando de novo:

node --version

Agora deve aparecer v20.x.x ou superior. Cole também esse:

npm --version

Deve aparecer 10.x.x ou superior.

\n>

Olha, pessoal, esse é o passo que mais trava cliente novo. Se o node --version continua dando erro depois de instalar, feche o terminal completamente, abre de novo, e roda. Terminal velho não enxerga programa novo.

Checkpoint: ao terminar este passo, você deve ver duas versões aparecendo: uma do Node (18 ou superior) e uma do npm (9 ou superior).

---

PASSO 02, INSTALAR O CLAUDE CODE

Objetivo: ter o Claude Code rodando no terminal, conectado à sua conta paga.

Tempo estimado: 15 minutos.

2.1 Entenda o que é Claude Code

Pequena pausa pra orientar. A Anthropic publica 2 produtos pra empresário operador com nome parecido:

• Claude Cowork (também chamado Claude Desktop em algumas referências): o aplicativo de desktop pra trabalho de escritório (e-mail, documento, planilha, jurídico, marketing). É o que a maioria das pessoas instala primeiro.
• Claude Code: o agente de código que roda no terminal. É a ferramenta certa pra criar vídeo, programar aplicativo ou rodar tarefa técnica.

Pra esse manual, você vai instalar o Claude Code, não o Cowork. Os dois podem coexistir no mesmo computador.

2.2 Instale o Claude Code

No terminal, cole:

npm install -g @anthropic-ai/claude-code

Aperta Enter. A instalação leva 1 a 3 minutos.

2.3 Faça login

Cole esse comando pra fazer login na sua conta Claude:

claude

Vai abrir uma página no seu navegador. Faça login com sua conta paga (Pro ou Max). Autoriza o Claude Code a acessar sua conta. Volta pro terminal e confirma a autorização quando ele pedir.

2.4 Teste rápido

Ainda no terminal, com o Claude Code já logado, digita:

Quem é você?

E aperta Enter. O Claude vai responder. Se a resposta apareceu, está tudo certo.

Pra sair do Claude Code, aperta Ctrl + C (duas vezes) ou digita /exit.

\n>

Pra empresário que nunca usou terminal, terminal parece coisa de filme antigo. Mas é só uma janela de texto onde você digita comandos. Tudo que você digita o computador executa. Sem mistério.

Checkpoint: ao terminar este passo, você consegue abrir o Claude Code com claude no terminal, manda uma pergunta e recebe resposta.

---

PASSO 03, CRIAR O PROJETO REMOTION

Objetivo: ter uma pasta nova no seu computador com a estrutura do Remotion pronta pra receber código de vídeo.

Tempo estimado: 10 minutos.

3.1 Escolha onde vai morar o projeto

Pensa numa pasta organizada do seu computador onde os seus projetos de vídeo vão viver. Recomendação: dentro da pasta de Documentos, cria uma subpasta chamada "videos-claude".

No terminal, navega até essa pasta:

cd ~/Documents
mkdir videos-claude
cd videos-claude

(O cd é "change directory", muda de pasta. O mkdir é "make directory", cria pasta nova.)

3.2 Crie o projeto Remotion

Cole o comando oficial do Remotion:

npx create-video@latest meu-primeiro-video

(Pode trocar meu-primeiro-video por qualquer nome sem espaço e sem acento.)

Vai aparecer um assistente fazendo 3 perguntas:

Choose a template: escolhe Blank. É o template em branco, mais flexível.

Add TailwindCSS for styling?: responde Yes. O Tailwind é o sistema de estilo que vai te dar acesso a cor e fonte fácil.

Install Agent Skills?: responde Yes. É aqui que a skill /remotion-video é instalada junto.

A instalação demora 2 a 5 minutos. Café, água, banheiro, volta.

3.3 Confirme a estrutura

Quando terminar, navega pra dentro da pasta criada:

cd meu-primeiro-video
ls

(O ls lista os arquivos da pasta atual.)

Você vai ver arquivos como package.json, tsconfig.json, e pastas src/ e node_modules/. Está tudo certo.

Checkpoint: ao terminar este passo, você tem uma pasta chamada meu-primeiro-video (ou o nome que você escolheu), com um projeto Remotion configurado dentro.

---

PASSO 04, INSTALAR A SKILL /REMOTION-VIDEO

Objetivo: ter a skill oficial Remotion-Dev disponível pro Claude Code, pra ele saber criar vídeo com método certo.

Tempo estimado: 5 minutos.

4.1 Entenda o que é a skill

A skill /remotion-video é um arquivo de instrução publicado pela equipe oficial do Remotion no GitHub remotion-dev/skills. Quando você instala, o Claude Code passa a saber quando usar Remotion, como estruturar a animação, quais regras de melhor prática seguir, e como renderizar o vídeo final. Sem essa skill, o Claude vai tentar adivinhar, e o resultado fica desigual. Com ela, sai padronizado.

4.2 Instale a skill

Ainda no terminal, dentro da pasta do projeto, cole:

npx -y skills@latest add remotion-dev/skills -g -y

Aperta Enter. A instalação leva 30 a 60 segundos.

\n>

A flag -g no final é importante. Ela instala a skill globalmente, no usuário do seu computador, e não só nesse projeto. Assim, no próximo vídeo, você já vai ter ela disponível sem reinstalar.

4.3 Confirme que instalou

Abre o Claude Code com:

claude

E digita:

Que skills você tem disponível?

A resposta deve incluir remotion-video na lista. Se incluir, está tudo certo.

Checkpoint: ao terminar este passo, o Claude Code reconhece a skill remotion-video e está pronto pra criar vídeo.

---

PASSO 05, DESCREVER O VÍDEO EM PORTUGUÊS

Objetivo: gerar o código do seu primeiro vídeo apenas com descrição em texto.

Tempo estimado: 10 minutos.

5.1 Abra o Claude Code dentro do projeto

Garante que você está na pasta do projeto:

cd ~/Documents/videos-claude/meu-primeiro-video
claude

5.2 Faça o primeiro pedido

Cola a descrição abaixo no Claude Code. Esse é um exemplo pra testar, depois você adapta pro seu negócio.

/remotion-video Cria um Reel vertical de 15 segundos pra
academia chamada PowerCore.
Cenário: fundo escuro premium em tons de marrom e dourado.
Texto principal aparecendo em 3 momentos:
(0 a 5s) "MATRÍCULAS DE JUNHO"

(5 a 10s) "PRIMEIRO MÊS GRÁTIS"

(10 a 15s) "POWERCORE · VILA MADALENA"

Tipografia: sans-serif geométrica em caixa alta, com leve
sombra dourada.
Transição entre frases: fade suave de 0.5s.
Resolução: 1080x1920 (vertical).
Taxa de quadros: 30fps.
Áudio: sem trilha (vou colocar depois no editor).

Aperta Enter. O Claude lê o pedido, ativa a skill /remotion-video, e começa a criar o arquivo de composição.

5.3 Acompanhe a execução

O Claude vai mostrar no terminal cada passo: o arquivo que está criando, qual primitiva do Remotion ele usou (interpolate, spring, Sequence, TransitionSeries), e se houve algum ajuste. Tempo médio de geração do primeiro vídeo: 2 a 5 minutos.

\n>

Olha, esse momento é mágico. Cliente novo passa o primeiro minuto descrente, e quando o Claude termina e ele vê o código pronto rodando, vira. Aproveita pra prestar atenção em como o Claude conversa com você. Cada decisão que ele toma, ele explica. Você aprende mais nesses 3 minutos do que num curso de 8 horas.

Checkpoint: ao terminar, o Claude Code mostra uma mensagem dizendo "Composition created" ou similar, e cita o arquivo .tsx que ele gerou (normalmente dentro de src/).

---

PASSO 06, PRÉ-VISUALIZAR NO REMOTION STUDIO

Objetivo: abrir o vídeo gerado num player visual interativo pra revisar antes de exportar.

Tempo estimado: 5 minutos.

6.1 Inicie o Studio

No terminal, fora do Claude Code (digita /exit se ainda estiver lá), cola:

npm run dev

Vai aparecer uma mensagem dizendo algo como "Server is running at http://localhost:3000". Abre o navegador e cola esse endereço.

6.2 Conheça o Studio

O Remotion Studio é o player visual. Você vê o vídeo na tela central, controla a timeline embaixo, e pode ajustar parâmetros na lateral direita.

6.3 Ajuste se quiser

Você pode mexer no texto, na cor, na duração diretamente pela lateral direita. Cada mudança aparece em tempo real no preview central. Bom pra calibrar antes de renderizar.

6.4 Peça correção pro Claude

Se a animação ficou diferente do esperado (timing errado, cor que não combina, fonte sem peso), volta no Claude Code e descreve a correção:

A transição da segunda pra terceira frase está abrupta.
Suaviza, troca pra um fade de 0.8s com saída por baixo
em vez de fade direto.

O Claude ajusta o código. Atualiza o Studio (botão de reload do navegador) e vê o resultado.

Checkpoint: você está vendo o vídeo rodar no Studio, e está satisfeito com o resultado.

---

PASSO 07, RENDERIZAR PRA .MP4

Objetivo: gerar o arquivo final .mp4 pronto pra publicar.

Tempo estimado: 10 minutos.

7.1 Identifique o ID da composição

No Remotion Studio, no painel lateral esquerdo, você vai ver o nome da composição. Pode ser algo como MyVideo ou Reel-PowerCore. Anote.

7.2 Renderize

No terminal, fora do Studio (pode deixar o Studio rodando em outra aba), cole:

npx remotion render NomeDaComposicao saida.mp4

Substitui NomeDaComposicao pelo ID exato (atenção a maiúscula e minúscula). O arquivo saida.mp4 vai ser criado na pasta atual.

Pra vídeo vertical (Reels, TikTok, Shorts), cole:

npx remotion render NomeDaComposicao saida.mp4 --width 1080 --height 1920

7.3 Aguarde a renderização

Tempo médio: 2 a 5 minutos pra vídeo de 15 segundos, 5 a 15 minutos pra vídeo de 60 segundos. Depende muito da complexidade da animação e da potência do computador.

7.4 Confirme o arquivo

Quando terminar, no terminal:

ls -la saida.mp4

Se aparece o tamanho do arquivo (algo como 2 a 5 MB pra Reel curto), está pronto. Pode abrir o arquivo, jogar no celular pra revisar, e publicar.

\n>

Pessoal, esse é o momento de vitória. Você acabou de criar vídeo profissional só descrevendo em português. Esse vídeo na mão de cliente novo já valeu o tempo de leitura desse manual. A partir daqui, é só repetir e ir refinando o briefing.

Checkpoint final: arquivo .mp4 pronto na sua pasta, com qualidade pra publicar.

---

Problemas comuns e correções rápidas

Problema 1, node --version continua dando erro depois de instalar

Sintoma: você instalou o Node.js no Passo 1, mas o terminal continua dizendo "command not found".

Correção: feche o terminal completamente (fecha a janela toda, não só a aba) e abre de novo. Terminal aberto antes da instalação não enxerga programa novo. Se ainda assim não rolar, reinicia o computador uma vez e tenta de novo.

---

Problema 2, Claude Code pede login várias vezes

Sintoma: você roda claude e o navegador abre, você faz login, mas o terminal continua pedindo autorização.

Correção: na hora que o navegador autoriza, ele te mostra um código pra colar de volta no terminal. Esse passo às vezes passa rápido. Faz de novo, presta atenção na tela de retorno do navegador, copia o código e cola no terminal.

---

Problema 3, npx create-video trava no meio

Sintoma: a instalação do Remotion fica parada em alguma porcentagem por mais de 5 minutos.

Correção: cancela com Ctrl + C, e roda de novo. Provavelmente é problema de rede momentâneo. Se travar em rede da empresa com firewall, tenta na sua casa ou em rede móvel.

---

Problema 4, Claude Code não reconhece /remotion-video

Sintoma: você instalou a skill mas o Claude diz que não conhece.

Correção: confere que rodou com a flag -g no final (npx -y skills@latest add remotion-dev/skills -g -y). Se rodou sem a -g, a skill foi instalada só naquele projeto, não globalmente. Roda de novo com a flag.

---

Problema 5, Remotion Studio abre em branco

Sintoma: você roda npm run dev, abre http://localhost:3000 e a tela fica em branco ou dá erro.

Correção: confere o terminal pra mensagem de erro de compilação. Geralmente é erro pequeno no código gerado. Cola o erro completo no Claude Code e pede "corrige esse erro". Ele detecta e ajusta.

---

Problema 6, renderização falha no Passo 7

Sintoma: você roda npx remotion render e dá erro no meio.

Correção: volta no Claude Code e cola a mensagem de erro completa. Pede "verifica esse erro de render e corrige". O Claude resolve em 90 por cento dos casos.

---

Problema 7, vídeo final fica fora do formato vertical

Sintoma: o .mp4 saiu em 1920x1080 (horizontal) quando você queria 1080x1920 (vertical).

Correção: sempre adiciona os parâmetros --width 1080 --height 1920 no comando de render. Sem isso, ele renderiza no formato padrão da composição.

---

Problema 8, computador trava na renderização

Sintoma: durante o npx remotion render, seu computador fica lento ou trava.

Correção: renderização é processo pesado. Fecha o navegador, fecha outros aplicativos, deixa só o terminal aberto. Se ainda trava, sua composição tem cena pesada demais (muita partícula, vídeo embutido grande, áudio sem compressão). Pede pro Claude simplificar.

---

Fechamento

Resumindo o que ficou na sua mesa, pessoal.

Em sete passos, você saiu do zero técnico e chegou num vídeo .mp4 cinematográfico saindo da sua máquina. Sem After Effects. Sem Premiere. Sem agência. Sem freelancer. Só descrição em português.

Pra empresário operador BR, isso muda a equação inteira do conteúdo de vídeo. Reels diário pra academia, anúncio mensal pra distribuidora, vídeo de estatística pra apresentação do mês, abertura institucional pro YouTube. Tudo isso passa a sair na sua bancada, com a sua marca, no seu padrão. Velocidade de máquina em cima de briefing humano.

A skill /remotion-video da equipe Remotion é o ponto de partida. Ela cobre o essencial e te dá autonomia. Mas é importante uma transparência: o resultado padrão da skill é um vídeo limpo e funcional, no estilo da própria Remotion. Pra ter resultado com a sua identidade visual completa (paleta da sua marca, fonte autoral, ritmo de criador específico, B-roll cinematográfico integrado, voz da sua marca), você precisa briefar muito bem, ou usar uma camada de skill por cima que já carregue tudo isso.

Eu desenvolvi pro meu uso interno uma evolução em cima do Remotion, chamada castro-remotion-editor-oficial. Ela combina a estrutura técnica do Remotion com FFmpeg, Whisper.cpp e Higgsfield, e roda 4 padrões cinematográficos validados (Dinâmico, Comparativo, Venda e Bíblico). É o que eu uso pros meus próprios Reels e pros vídeos da consultoria. Quem assina o Kit Negócios Inteligentes recebe acesso a essa evolução junto com o restante do arsenal.

Pra começar essa semana, instala o que esse manual ensinou. Pra dar o salto pro padrão Castro, eu te explico no próximo bloco.

Excelente operação pra nós.

Mateus Castro

---

Te vejo lá dentro.

Mateus Castro