Setup — preparar o computador de um iniciante
O aluno é um iniciante. Fale na linguagem dele, frases curtas, um passo de cada vez. Faça as verificações você mesmo. Peça permissão antes de cada instalação. Nunca digite uma senha por ele.
0. Está na pasta certa?
Isso deve ser executado dentro da pasta do estúdio (ela tem CLAUDE.md e video-projects/_library/).
Se você estiver em outro lugar, encontre a pasta ou pergunte onde ele a clonou, e use cd para ir até lá.
1. Verificar o que já existe
Descubra o sistema (Windows / macOS / Linux) e execute esses comandos. Não mostre a saída bruta; mostre uma pequena lista.
| Verificação | Comando | Necessário? | O que é, em uma linha |
|---|---|---|---|
| Git | git --version | sim | baixa este estúdio e suas atualizações |
| Node.js 22 ou mais novo | node --version | sim | executa o HyperFrames |
| npm | npm --version | sim | vem com Node.js |
| FFmpeg + FFprobe | ffmpeg -version, ffprobe -version | sim | junta os frames e o som em um MP4 |
| Disco livre | (o doctor mostra) | ~3 GB | para as ferramentas e seus vídeos |
Mostre assim:
✓ Git
✗ Node.js — não instalado (necessário: executa o HyperFrames)
✓ FFmpeg
Se tudo estiver ✓, diga isso e vá para o passo 3.
2. Instalar o que está faltando — pergunte primeiro, um de cada vez
Para cada ✗: diga o que é (uma linha), que é gratuito, o que você recomenda e pergunte "Devo instalar?" Aguarde um "sim".
Windows (winget já vem embutido no Windows 10/11):
- Node.js:
winget install -e --id OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements - FFmpeg:
winget install -e --id Gyan.FFmpeg --accept-package-agreements --accept-source-agreements - Git:
winget install -e --id Git.Git --accept-package-agreements --accept-source-agreements - Se o Windows mostrar uma caixa "Deseja permitir que este aplicativo faça alterações?", peça para clicarem em Sim.
- Se o
wingetestiver faltando: envie-os para https://nodejs.org (o botão LTS), https://git-scm.com e para o FFmpeg diga "instale o App Installer pela Microsoft Store, e então tentarei novamente".
macOS (usa Homebrew):
- Verifique
brew --version. Se estiver faltando, eles devem executar o instalador sozinhos, porque ele pede a senha do Mac. Diga a eles: abra o aplicativo Terminal, cole o comando de https://brew.sh, pressione Enter, digite a senha do Mac (ela fica invisível enquanto digita — é normal) e avise quando terminar. - Depois:
brew install node ffmpeg git
Linux: esses comandos precisam da senha, então eles executam no próprio terminal:
sudo apt install -y git ffmpeg. Para Node.js 22+, recomende o instalador LTS de https://nodejs.org.
Depois de instalar algo: o novo programa ainda não está visível para esta janela do Claude. Diga a eles:
"Feche o Claude Code completamente, abra-o novamente nesta mesma pasta e digite /setup — continuarei daqui."
Então pare e aguarde. (Quando voltarem, o passo 1 mostrará o novo ✓.)
3. Instalar as partes do próprio estúdio
Diga o que cada uma faz e aproximadamente o tamanho, depois execute-as em ordem:
npm install— baixa o HyperFrames para esta pasta (cerca de 120 MB, aproximadamente um minuto).npx hyperframes skills— ensina ao Claude as regras oficiais do HyperFrames (pequeno). Pergunte primeiro: instala skills para o Claude neste computador.npx hyperframes browser ensure— baixa uma cópia privada do Chrome usada apenas para fazer vídeos (~150 MB). O navegador normal deles não é tocado.npx hyperframes doctor— a verificação final. Explique apenas os itens vermelhos que importam: Node.js, FFmpeg, FFprobe e Chrome devem estar ✓. Estes são opcionais — ignore-os: uma versão mais nova disponível, whisper-cpp (legendas automáticas), MusicGen (música com IA), Docker.
Após npx hyperframes skills: novas skills carregam em uma nova sessão. Diga a eles:
"Feche o Claude Code e abra-o novamente nesta pasta, depois digite /setup — continuarei no vídeo de teste."
4. Provar que funciona: um vídeo de teste de 3 segundos
Precisa de internet (a biblioteca de animação carrega da web). Execute um por linha (no PowerShell,
&& não funciona):
mkdir my-videos
cd my-videos
npx hyperframes init hello-test --example blank --resolution portrait --non-interactive
cd hello-test
O exemplo "blank" tem 10 segundos e mostra "Title". Em index.html: mude o texto para o nome do aluno ou
"Hello", defina ambos data-duration="10" para 3, adicione um fade-in
(tl.fromTo("#title", { opacity: 0 }, { opacity: 1, duration: 0.6 }, 0);) e tl.set({}, {}, 3);
antes da linha window.__timelines. Depois:
npx hyperframes lint
npx hyperframes render --quality draft
Encontre o MP4 em my-videos/hello-test/renders/, diga a eles onde está e ofereça-se para abri-lo.
Se falhar, leia o erro, corrija-o e tente novamente. Não entregue uma etapa quebrada.
5. Concluído
Diga a eles, de forma resumida:
- "A configuração está concluída. Seus vídeos vão ficar na pasta
my-videos." - "Para fazer um vídeo, digite
/new-video." - "Da próxima vez, abra o Claude Code nesta mesma pasta." Diga a eles o caminho completo da pasta que você usou e como:
- Aplicativo Claude desktop: guia Código → escolher / abrir pasta → selecione essa pasta.
- Terminal:
cd "<caminho completo>"depoisclaude.
- No Windows, "Documentos" pode estar dentro do OneDrive (
OneDrive\Documents). Verifique onde o clone realmente caiu e forneça esse caminho exato.