Instalar.
Install.
O projeto tem um instalador, o instalar.sh, que faz quase tudo sozinho. Você só prepara o computador uma vez e conecta o Claude. Os dois caminhos terminam no mesmo lugar: Tudo pronto.
The project ships an installer, instalar.sh, that does almost everything on its own. You just prepare your computer once and connect Claude. Both paths end in the same place: Tudo pronto. ("All set.")
O que você precisa
What you need
- Windows, macOS ou LinuxWindows, macOS or LinuxWindows 10 (22H2) ou 11 pelo WSL, macOS 13+, ou Linux (Ubuntu 22.04+, Debian 12+, Fedora, Arch).Windows 10 (22H2) or 11 via WSL, macOS 13+, or Linux (Ubuntu 22.04+, Debian 12+, Fedora, Arch).
- Placa de vídeo NVIDIANVIDIA graphics cardRecomendada: deixa a transcrição muitas vezes mais rápida. Sem ela também funciona, só demora mais.Recommended: makes transcription many times faster. It works without one, just slower.
- Conta Claude ou chave de APIClaude account or API keyClaude Pro, Max, Team ou Enterprise, ou uma chave de API da Anthropic. O plano gratuito não inclui o Claude Code.Claude Pro, Max, Team or Enterprise, or an Anthropic API key. The free plan doesn't include Claude Code.
- Uns 20 GB livres e internetAbout 20 GB free and internetPara as ferramentas e o modelo do Whisper, mais o espaço dos seus vídeos.For the tools and the Whisper model, plus room for your videos.
-
Tenha o básico
Have the basics
git,curl,ffmpeg, Python 3.10+ e Node 18+. No Windows, tudo dentro do Ubuntu do WSL. Faltando algo? Abra o comando do seu sistema:git,curl,ffmpeg, Python 3.10+ and Node 18+. On Windows, everything inside WSL's Ubuntu. Missing something? Open your system's command:Ubuntu / Debian / WSL
sudo apt update sudo apt install -y git curl ca-certificates ffmpeg python3 python3-venv sudo apt install -y libnss3 libdbus-1-3 libatk1.0-0 libatk-bridge2.0-0 libgbm1 libxrandr2 libxkbcommon0 libxfixes3 libxcomposite1 libxdamage1 libpango-1.0-0 libcairo2 libcups2 fonts-noto-color-emoji sudo apt install -y libasound2 || sudo apt install -y libasound2t64 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejsmacOS (Homebrew)
brew install git python@3.12 node ffmpeg bashFedora
sudo dnf install -y git curl python3 nodejs ffmpeg-free nss atk at-spi2-atk libdrm libxkbcommon libXcomposite libXdamage libXrandr mesa-libgbm pango cairo alsa-lib cups-libs google-noto-emoji-color-fontsArch / Manjaro
sudo pacman -S --needed git curl python nodejs npm ffmpeg nss atk at-spi2-atk libxkbcommon libxcomposite libxdamage libxrandr mesa pango cairo alsa-lib libcups noto-fonts-emoji -
Claude Code com login
Claude Code, logged in
Instale, abra o
claudeuma vez, entre com a sua conta e saia com/exit.Install it, open
claudeonce, sign in with your account and leave with/exit.curl -fsSL https://claude.ai/install.sh | bash claude -
Clone e instale
Clone and install
O
chmod +xdá permissão de execução ao instalador e ao atalho./ae. O instalador liga a skillcorte-viral, baixa o video-use, o Whisper, o yt-dlp e o Remotion, e termina rodando a verificação. Leva de 5 a 15 minutos.chmod +xmakes the installer and the./aeshortcut executable. The installer links thecorte-viralskill, downloads video-use, Whisper, yt-dlp and Remotion, and finishes by running the check. Takes 5 to 15 minutes.git clone https://github.com/pedro-oscar/claude-ai-shorts-editor.git cd claude-ai-shorts-editor chmod +x instalar.sh ae skill/corte-viral/scripts/ae ./instalar.sh -
Primeiro corte
First cut
Em prévia, meia resolução. Gostou?
./ae produzirgera a versão final.As a half-resolution preview. Like it?
./ae produzirrenders the final version../ae auto "https://www.youtube.com/watch?v=XXXX" --rapido
Sem navegador na máquina? Gere um token com claude setup-token e coloque no .env do projeto como CLAUDE_CODE_OAUTH_TOKEN=…. Com chave de API, use ANTHROPIC_API_KEY=….
No browser on the machine? Create a token with claude setup-token and put it in the project's .env as CLAUDE_CODE_OAUTH_TOKEN=…. With an API key, use ANTHROPIC_API_KEY=….
Quer testar sem vídeo nenhum antes? ./ae demo gera publicar/demo.mp4 com todos os tipos de animação.
Want to test without any video first? ./ae demo creates publicar/demo.mp4 with every kind of animation.
Para atualizar, rode de novo o instalador: ele pode ser rodado quantas vezes quiser.
To update, run the installer again: it's safe to run as many times as you like.
$ git pull && chmod +x instalar.sh ae skill/corte-viral/scripts/ae && ./instalar.shTravou em algo? O passo a passo explica cada comando e tem uma tabela de problemas comuns.
Stuck? The step-by-step guide explains every command and has a troubleshooting table.
Sem pressa. Cada etapa diz quanto tempo leva e o que você deve ver na tela. Você vai copiar e colar comandos; não precisa entender todos.
No rush. Each step says how long it takes and what you should see on screen. You'll copy and paste commands; you don't need to understand all of them.
-
~ 20–40 min, só uma vez~ 20–40 min, once
Prepare o computador
Prepare your computer
Escolha o seu sistema.
Pick your system.
No Windows o projeto roda dentro do WSL, um "Linux dentro do Windows" oficial da Microsoft. O Windows sem WSL não é suportado. Precisa do Windows 10 22H2 ou do 11.
On Windows the project runs inside WSL, Microsoft's official "Linux inside Windows". Windows without WSL isn't supported. You need Windows 10 22H2 or 11.
a. Driver da placa de vídeo (só se tiver NVIDIA)
a. Graphics driver (NVIDIA only)
- Não sabe se tem NVIDIA? Aperte Ctrl + Shift + Esc, vá em Desempenho e veja se aparece uma GPU NVIDIA.
- Instale o driver mais recente em nvidia.com/drivers ou pelo NVIDIA App, e reinicie.
- Instale o driver só no Windows. Dentro do Ubuntu não se instala driver: ele usa o do Windows.
- Not sure you have NVIDIA? Press Ctrl + Shift + Esc, go to Performance and look for an NVIDIA GPU.
- Install the latest driver from nvidia.com/drivers or the NVIDIA App, and restart.
- Install the driver on Windows only. Don't install a driver inside Ubuntu: it uses the Windows one.
b. Instale o WSL com Ubuntu
b. Install WSL with Ubuntu
- Menu Iniciar → digite PowerShell → botão direito → Executar como administrador.
- Cole o comando abaixo e aperte Enter. Quando terminar, reinicie o computador.
- Depois, abra Ubuntu pelo menu Iniciar. Ele pede um nome de usuário (minúsculas, sem espaço, ex.:
maria) e uma senha. Anote a senha.
- Start menu → type PowerShell → right-click → Run as administrator.
- Paste the command below and press Enter. When it's done, restart your computer.
- Then open Ubuntu from the Start menu. It asks for a username (lowercase, no spaces, e.g.
maria) and a password. Write the password down.
PS> wsl --install -d Ubuntu-22.04Installing, this may take a few minutes... Please create a default UNIX user account. Enter new UNIX username: maria New password: ← nada aparece enquanto você digita; é normal← nothing shows as you type; that's normal Retype new password: passwd: password updated successfully Installation successful! maria@PC:~$
Essa janela preta é o terminal do Ubuntu. Todos os comandos daqui para a frente são colados nela.
That black window is the Ubuntu terminal. Every command from here on is pasted into it.
quero… I want to… faça do colar no terminalpaste into the terminal botão direito do mouse, ou Ctrl+Shift+Vright-click, or Ctrl+Shift+V abrir a pasta atual no Exploreropen the current folder in Explorer explorer.exe .achar meus vídeos do Windowsfind my Windows videos /mnt/c/Users/SEU_USUARIO/Videosc. Atualize o Ubuntu e instale os programas
c. Update Ubuntu and install the programs
Vai pedir a senha que você criou. Se tiver NVIDIA, o último comando (
nvidia-smi) deve mostrar uma tabela com o nome da placa.It will ask for the password you created. If you have NVIDIA, the last command (
nvidia-smi) should show a table with your card's name.sudo apt update && sudo apt upgrade -y sudo apt install -y git curl ca-certificates ffmpeg python3 python3-venv sudo apt install -y libnss3 libdbus-1-3 libatk1.0-0 libatk-bridge2.0-0 libgbm1 libxrandr2 libxkbcommon0 libxfixes3 libxcomposite1 libxdamage1 libpango-1.0-0 libcairo2 libcups2 fonts-noto-color-emoji sudo apt install -y libasound2 || sudo apt install -y libasound2t64 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs nvidia-smiDeixe o projeto dentro do Ubuntu (na pasta pessoal,
~), nunca em/mnt/c/…: por lá tudo fica muito mais lento.Keep the project inside Ubuntu (in your home folder,
~), never under/mnt/c/…: everything is much slower there.macOS 13 (Ventura) ou mais novo, chip Apple ou Intel. Macs não têm NVIDIA, então a transcrição roda no processador: funciona, mas é bem mais lenta. Em vídeos longos, use
--trechopara processar só a parte que interessa.macOS 13 (Ventura) or newer, Apple chip or Intel. Macs have no NVIDIA, so transcription runs on the CPU: it works, but it's much slower. For long videos, use
--trechoto process only the part you need.a. Abra o Terminal
a. Open Terminal
Aperte ⌘ + Espaço, digite Terminal e aperte Enter.
Press ⌘ + Space, type Terminal and press Enter.
b. Instale o Homebrew
b. Install Homebrew
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"- Ele pede a senha do Mac. Ao digitar, nada aparece; é normal.
- No fim aparece "Next steps" com 2 ou 3 comandos (começando com
echoeeval). Copie e rode esses comandos. - Feche o Terminal e abra de novo.
brew --versiondeve responder.
- It asks for your Mac password. Nothing shows as you type; that's normal.
- At the end you'll see "Next steps" with 2 or 3 commands (starting with
echoandeval). Copy and run them. - Close Terminal and open it again.
brew --versionshould answer.
c. Instale os programas
c. Install the programs
Inclui um
bashnovo: o do macOS é de 2007 e os scripts do projeto precisam da versão 4 ou maior.Includes a new
bash: macOS ships one from 2007 and the project's scripts need version 4 or newer.brew install git python@3.12 node ffmpeg bashFeche e abra o Terminal e confira:
bash --versiondeve mostrar 5 ou mais,node -vv18 ou mais epython3 --version3.10 ou mais.Close and reopen Terminal and check:
bash --versionshould show 5 or higher,node -vv18 or higher andpython3 --version3.10 or higher.Os comandos com
sudopedem a sua senha; ao digitar, nada aparece.Commands with
sudoask for your password; nothing shows as you type.Ubuntu 22.04+ / Debian 12+
sudo apt update sudo apt install -y git curl ca-certificates ffmpeg python3 python3-venv sudo apt install -y libnss3 libdbus-1-3 libatk1.0-0 libatk-bridge2.0-0 libgbm1 libxrandr2 libxkbcommon0 libxfixes3 libxcomposite1 libxdamage1 libpango-1.0-0 libcairo2 libcups2 fonts-noto-color-emoji sudo apt install -y libasound2 || sudo apt install -y libasound2t64 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejsTem NVIDIA? Instale o driver e reinicie. Depois,
nvidia-smideve mostrar a placa. Não precisa do CUDA Toolkit: o projeto baixa o que precisa.Have NVIDIA? Install the driver and restart. Afterwards,
nvidia-smishould show the card. You don't need the CUDA Toolkit: the project downloads what it needs.$ sudo ubuntu-drivers install && sudo rebootFedora
sudo dnf install -y git curl python3 nodejs ffmpeg-free nss atk at-spi2-atk libdrm libxkbcommon libXcomposite libXdamage libXrandr mesa-libgbm pango cairo alsa-lib cups-libs google-noto-emoji-color-fontsO
ffmpeg-freenão tem alguns codecs. Se der erro ao cortar, instale o ffmpeg completo pelo RPM Fusion.ffmpeg-freelacks some codecs. If cutting fails, install the full ffmpeg from RPM Fusion.Arch / Manjaro
sudo pacman -S --needed git curl python nodejs npm ffmpeg nss atk at-spi2-atk libxkbcommon libxcomposite libxdamage libxrandr mesa pango cairo alsa-lib libcups noto-fonts-emoji -
~ 5 min
Instale e conecte o Claude Code
Install and connect Claude Code
O Claude Code é o programa que deixa o Claude trabalhar no seu computador: ele lê a transcrição, escolhe os cortes, escreve o roteiro e revisa os vídeos.
Claude Code is the program that lets Claude work on your computer: it reads the transcript, picks the cuts, writes the script and reviews the videos.
$ curl -fsSL https://claude.ai/install.sh | bash- Feche o terminal e abra de novo.
claude --versiondeve mostrar algo como2.1.xxx (Claude Code). No Mac também dá:brew install --cask claude-code. - Digite
claudee aperte Enter. Um link abre no navegador (no WSL, o do Windows; se não abrir, copie o link do terminal). Entre com a sua conta e autorize. - Quando o Claude estiver pronto para conversar, digite
/exitpara sair. - Teste o modo automático, que é o que o projeto usa. Deve responder OK.
- Close the terminal and open it again.
claude --versionshould show something like2.1.xxx (Claude Code). On a Mac you can also usebrew install --cask claude-code. - Type
claudeand press Enter. A link opens in your browser (on WSL, the Windows one; if it doesn't, copy the link from the terminal). Sign in with your account and authorize. - When Claude is ready to chat, type
/exitto leave. - Test the automatic mode, which is what the project uses. It should answer OK.
$ claude -p "Responda só: OK"Quanto consome? Cada vídeo usa duas sessões do Claude (roteiro e revisão). No teste com 10 minutos de vídeo e 2 cortes, equivaleu a uns US$ 4,60 em preço de API. Com Pro/Max, entra no limite do plano e não é cobrado à parte.
How much does it use? Each video takes two Claude sessions (script and review). In the 10-minute, 2-cut test it came to about US$4.60 at API prices. With Pro/Max it counts against your plan limit and isn't billed separately.
- Feche o terminal e abra de novo.
-
~ 5–15 min, depende da internet~ 5–15 min, depends on your connection
Baixe o projeto e rode o instalador
Get the project and run the installer
- Baixe o projeto para a sua pasta pessoal e entre nela.
- Dê permissão de execução ao instalador e ao
./ae, o atalho que você vai usar para tudo (ele aponta paraskill/corte-viral/scripts/ae). Não aparece nenhuma mensagem: é normal. - Rode o instalador.
- Download the project into your home folder and enter it.
- Make the installer and
./aeexecutable;./aeis the shortcut you'll use for everything (it points toskill/corte-viral/scripts/ae). No message appears: that's normal. - Run the installer.
cd ~ git clone https://github.com/pedro-oscar/claude-ai-shorts-editor.git cd claude-ai-shorts-editor chmod +x instalar.sh ae skill/corte-viral/scripts/ae ./instalar.shDepois disso, o instalador faz sozinho, em 7 etapas:
From there, the installer does this on its own, in 7 steps:
- confere se os programas do passo 1 estão instalados (e diz o que falta);
- liga a skill corte-viral, as instruções do Claude, em
~/.claude/skills/; - baixa a skill video-use, que corta os vídeos;
- instala o Whisper (transcrição) e o OpenCV (rosto), e as bibliotecas da GPU se houver NVIDIA;
- instala o yt-dlp, que baixa vídeos do YouTube;
- cria a pasta
remotion/e baixa o Remotion e o navegador que ele usa para desenhar os vídeos; - dá os toques finais e roda a verificação.
- checks that the programs from step 1 are installed (and says what's missing);
- links the corte-viral skill, Claude's instructions, into
~/.claude/skills/; - downloads the video-use skill, which cuts the videos;
- installs Whisper (transcription) and OpenCV (faces), plus GPU libraries if you have NVIDIA;
- installs yt-dlp, which downloads YouTube videos;
- creates the
remotion/folder and downloads Remotion and the browser it uses to draw the videos; - finishes up and runs the check.
O fim esperado é uma lista de ✓ terminando em Tudo pronto. Sem NVIDIA aparece um ! no lugar da GPU, e tudo bem. Cada ✗ diz como corrigir.
The expected ending is a list of ✓ ending in Tudo pronto. Without NVIDIA you'll see a ! for the GPU, and that's fine. Each ✗ tells you how to fix it.
== 7/7 Toques finais ✓ permissões e .env ✓ skills oficiais do Remotion para o Claude Conferindo tudo… == Ferramentas ✓ ffmpeg ffmpeg version 4.4.2-0ubuntu0.22.04.1 ✓ yt-dlp 2026.08.19 ✓ claude 2.1.291 (Claude Code) … == GPU ✓ GPU 0: NVIDIA GeForce RTX 4090 == Skills ✓ corte-viral em /home/maria/.claude/skills/corte-viral ✓ faster-whisper enxerga a GPU == Claude ✓ claude -p autenticado Tudo pronto. Próximo passo: ./ae demo
Na primeira transcrição o programa baixa o modelo do Whisper, cerca de 3 GB. Isso acontece uma vez só.
On the first transcription the program downloads the Whisper model, about 3 GB. That happens only once.
Daqui em diante, sempre que for usar o projeto, abra o terminal e entre na pasta:
cd ~/claude-ai-shorts-editorFrom now on, whenever you use the project, open the terminal and enter the folder:
cd ~/claude-ai-shorts-editor -
~ 1 min
Teste com a demonstração
Test with the demo
Gera
publicar/demo.mp4, um reel de exemplo com todos os tipos de animação, sem vídeo de fundo. Se o vídeo abrir, a instalação está completa.Creates
publicar/demo.mp4, a sample reel with every kind of animation and no background video. If the video opens, installation is complete.$ ./ae demoPara abrir a pasta:
explorer.exe publicarno Windows,open publicarno Mac,xdg-open publicarno Linux.To open the folder:
explorer.exe publicaron Windows,open publicaron a Mac,xdg-open publicaron Linux. -
~ 30 min, rodando sozinho~ 30 min, running on its own
Seus primeiros cortes
Your first cuts
Comece pequeno: 10 minutos de um vídeo, 2 cortes, em prévia. Troque o endereço pelo link de um vídeo seu, entre aspas. Para um arquivo do computador, use o caminho dele (no Windows,
/mnt/c/Users/SEU_USUARIO/Videos/…).Start small: 10 minutes of a video, 2 cuts, as a preview. Replace the address with a link to one of your videos, in quotes. For a file on your computer, use its path (on Windows,
/mnt/c/Users/YOUR_USER/Videos/…).$ ./ae auto "https://www.youtube.com/watch?v=XXXX" --trecho 10:00 20:00 --cortes 2 --rapido== 1/5 Fonte baixa o vídeodownloads the video == 2/5 Transcrição transcreve o áudiotranscribes the audio == 3/5 Roteiro (Claude) escolhe os cortes e escrevepicks cuts and writes → Read edit/takes_packed.md cada ação do Claude aparece com →each Claude action shows with → == 4/5 Produção corta, enquadra, legenda, animacuts, frames, captions, animates [1/2] c01 — A série que uniu a família == 5/5 Revisão do Claude olha os reels e corrigereviews and fixes == Pronto em 28 min
Pode deixar rodando e fazer outra coisa, mas não feche o terminal até aparecer "Pronto". As prévias ficam em
publicar/rapido/e o porquê de cada corte emedit/roteiros/. Gostou?./ae produzirgera a versão final. Quer mudar algo?./ae revisar --pedido "o que mudar". Todas as opções (só um trecho, mais cortes, arquivo local…) estão em Comandos e receitas.You can leave it running and do something else, but don't close the terminal until it says "Pronto" (done). Previews land in
publicar/rapido/and the reasoning for each cut inedit/roteiros/. Like it?./ae produzirrenders the final version. Want changes?./ae revisar --pedido "what to change". Every option (just a part, more cuts, local file…) is in Commands and recipes.
Problemas comuns
Common problems
Primeiro passo sempre: ./ae verificar. Cada linha com ✗ diz o que corrigir.
Always start with ./ae verificar. Every ✗ line says what to fix.
| sintoma | symptom | o que fazer | what to do |
|---|---|---|---|
| claude: command not found | Feche e abra o terminal. Se continuar: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc e source ~/.bashrc (no Mac, ~/.zshrc).Close and reopen the terminal. If it persists: echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc and source ~/.bashrc (on a Mac, ~/.zshrc). | ||
| Permission denied (./instalar.sh, ./ae) | chmod +x instalar.sh ae skill/corte-viral/scripts/ae | ||
| macOS: precisa do bash 4macOS: needs bash 4 | brew install bash, feche e abra o Terminal; bash --version deve mostrar 5.brew install bash, close and reopen Terminal; bash --version should show 5. | ||
| ENETUNREACH / Headless Shell | Comum no WSL, que não tem IPv6: Common on WSL, which has no IPv6: cd remotion && NODE_OPTIONS=--dns-result-order=ipv4first npx remotion browser ensure && cd .. | ||
| error while loading shared libraries | Faltam bibliotecas do navegador. Rode de novo os comandos de bibliotecas do passo 1 (Linux/WSL).Browser libraries are missing. Re-run the library commands from step 1 (Linux/WSL). | ||
| claude -p não respondeu | O Claude não está logado. Rode claude, entre e saia com /exit. Teste com claude -p "Responda só: OK".Claude isn't logged in. Run claude, sign in and leave with /exit. Test with claude -p "Responda só: OK". | ||
| HTTP Error 429 | O YouTube bloqueou por um tempo. Espere alguns minutos, ou baixe de outro jeito e use ./ae auto arquivo.mp4.YouTube blocked you temporarily. Wait a few minutes, or download another way and use ./ae auto file.mp4. | ||
| Vídeo veio só com áudioVideo came audio-only | Use sempre ./ae auto ou ./ae baixar. Se persistir: uv tool upgrade yt-dlp.Always use ./ae auto or ./ae baixar. If it persists: uv tool upgrade yt-dlp. | ||
| Transcrição muito lentaTranscription very slow | ./ae verificar mostra se achou a GPU. Sem NVIDIA (ou no Mac), use --trecho../ae verificar shows whether it found the GPU. Without NVIDIA (or on a Mac), use --trecho. | ||
| Rosto cortado / nome erradoFace cropped / wrong name | Peça: ./ae revisar --pedido "no c02 o rosto está cortado perto dos 15 segundos" e depois ./ae produzir.Ask: ./ae revisar --pedido "in c02 the face is cropped around 15 seconds" then ./ae produzir. | ||
| Permission denied / EACCES (WSL) | Arquivos editados pelo Explorer do Windows ficam com outro dono: sudo chown -R $(whoami): ~/claude-ai-shorts-editor.Files edited from Windows Explorer end up with another owner: sudo chown -R $(whoami): ~/claude-ai-shorts-editor. |
Não achou? Abra uma issue no GitHub com a saída do ./ae verificar, o erro e, se for do Claude, o arquivo mais recente de edit/logs/.
Not listed? Open a GitHub issue with the output of ./ae verificar, the error and, if it's a Claude error, the latest file in edit/logs/.
Atualizar
Update
cd ~/claude-ai-shorts-editor
git pull
chmod +x instalar.sh ae skill/corte-viral/scripts/ae
./instalar.sh
Desinstalar
Uninstall
rm -rf ~/claude-ai-shorts-editor ~/.claude/skills/corte-viral ~/.claude/skills/video-use
Isso apaga também os vídeos e reels dentro das pastas do projeto. Copie antes o que quiser guardar.
This also deletes the videos and reels inside the project folders. Copy anything you want to keep first.
Este passo a passo resume os guias do repositório, que têm todos os detalhes.
This walkthrough summarizes the repository guides (in Portuguese), which have every detail.