安裝
首次使用前的環境準備
快速使用
使用者: 安裝環境
使用者: 初始化
依賴清單
| 依賴 | 用途 | 安裝命令 |
|---|---|---|
| Node.js | 運行腳本 | brew install node |
| FFmpeg | 影片剪輯 | brew install ffmpeg |
| curl | API 調用 | 系統內建 |
API 配置
火山引擎語音辨識
控制台:https://console.volcengine.com/speech/new/experience/asr?projectName=default
- 註冊火山引擎帳號
- 開通語音辨識服務
- 取得 API Key
配置到專案目錄 .claude/skills/.env:
# 檔案路徑:剪輯Agent/.claude/skills/.env
VOLCENGINE_API_KEY=your_api_key_here
安裝流程
1. 安裝 Node.js + FFmpeg
↓
2. 配置火山引擎 API Key
↓
3. 驗證環境
執行步驟
1. 安裝依賴
# macOS
brew install node ffmpeg
# 驗證
node -v
ffmpeg -version
2. 配置 API Key
# 在專案 .claude/skills/ 目錄下建立 .env 檔案
echo "VOLCENGINE_API_KEY=your_key" >> .claude/skills/.env
3. 驗證環境
# 檢查 Node.js
node -v
# 檢查 FFmpeg
ffmpeg -version
# 檢查 API Key(在專案目錄下執行)
cat .claude/skills/.env | grep VOLCENGINE
常見問題
Q1: API Key 在哪取得?
火山引擎控制台 → 語音技術 → 語音辨識 → API Key
Q2: ffmpeg 命令找不到
which ffmpeg # 應輸出路徑
# 若無,重新安裝:brew install ffmpeg
Q3: 檔名含冒號報錯
FFmpeg 命令需加上 file: 前綴:
ffmpeg -i "file:2026:01:26 task.mp4" ...