Instalação
Preparação do ambiente antes do primeiro uso
Uso rápido
Usuário: Instalar ambiente
Usuário: Inicializar
Lista de dependências
| Dependência | Finalidade | Comando de instalação |
|---|---|---|
| Node.js | Executar scripts | brew install node |
| FFmpeg | Edição de vídeo | brew install ffmpeg |
| curl | Chamadas de API | Incluso no sistema |
Configuração da API
Reconhecimento de fala da Volcano Engine
Console: https://console.volcengine.com/speech/new/experience/asr?projectName=default
- Registrar uma conta na Volcano Engine
- Ativar o serviço de reconhecimento de fala
- Obter a chave de API
Configurar no diretório do projeto .claude/skills/.env:
# Caminho do arquivo: AgenteDeEdicao/.claude/skills/.env
VOLCENGINE_API_KEY=sua_chave_api_aqui
Fluxo de instalação
1. Instalar Node.js + FFmpeg
↓
2. Configurar a chave de API da Volcano Engine
↓
3. Verificar o ambiente
Etapas de execução
1. Instalar dependências
# macOS
brew install node ffmpeg
# Verificar
node -v
ffmpeg -version
2. Configurar a chave de API
# Criar o arquivo .env no diretório .claude/skills/ do projeto
echo "VOLCENGINE_API_KEY=sua_chave" >> .claude/skills/.env
3. Verificar o ambiente
# Verificar Node.js
node -v
# Verificar FFmpeg
ffmpeg -version
# Verificar a chave de API (executar no diretório do projeto)
cat .claude/skills/.env | grep VOLCENGINE
Perguntas frequentes
P1: Onde obter a chave de API?
Console da Volcano Engine → Tecnologia de fala → Reconhecimento de fala → Chave de API
P2: Comando ffmpeg não encontrado
which ffmpeg # Deve exibir o caminho
# Se não, reinstalar: brew install ffmpeg
P3: Erro de nome de arquivo com dois pontos
O comando FFmpeg precisa do prefixo file::
ffmpeg -i "file:2026:01:26 tarefa.mp4" ...