Instalación
Preparación del entorno antes del primer uso
Uso rápido
Usuario: instalar entorno
Usuario: inicializar
Lista de dependencias
| Dependencia | Uso | Comando de instalación |
|---|---|---|
| Node.js | Ejecutar scripts | brew install node |
| FFmpeg | Edición de video | brew install ffmpeg |
| curl | Llamadas API | Integrado en el sistema |
Configuración de API
Reconocimiento de voz de Volcengine
Consola: https://console.volcengine.com/speech/new/experience/asr?projectName=default
- Registrarse en Volcengine
- Activar el servicio de reconocimiento de voz
- Obtener la API Key
Configurar en el archivo .claude/skills/.env del proyecto:
# Ruta del archivo: 剪辑Agent/.claude/skills/.env
VOLCENGINE_API_KEY=tu_clave_api_aqui
Flujo de instalación
1. Instalar Node.js + FFmpeg
↓
2. Configurar API Key de Volcengine
↓
3. Verificar el entorno
Pasos de ejecución
1. Instalar dependencias
# macOS
brew install node ffmpeg
# Verificar
node -v
ffmpeg -version
2. Configurar API Key
# Crear archivo .env en el directorio .claude/skills/ del proyecto
echo "VOLCENGINE_API_KEY=tu_clave" >> .claude/skills/.env
3. Verificar el entorno
# Verificar Node.js
node -v
# Verificar FFmpeg
ffmpeg -version
# Verificar API Key (ejecutar en el directorio del proyecto)
cat .claude/skills/.env | grep VOLCENGINE
Preguntas frecuentes
P1: ¿Dónde se obtiene la API Key?
Consola de Volcengine → Tecnología de voz → Reconocimiento de voz → API Key
P2: No se encuentra el comando ffmpeg
which ffmpeg # Debería mostrar una ruta
# Si no aparece, reinstalar: brew install ffmpeg
P3: Error por nombre de archivo con dos puntos
Los comandos FFmpeg deben usar el prefijo file::
ffmpeg -i "file:2026:01:26 tarea.mp4" ...