インストール
初回使用前の環境準備
クイックスタート
ユーザー: 環境をインストール
ユーザー: 初期化
依存関係一覧
| 依存 | 用途 | インストールコマンド |
|---|---|---|
| Node.js | スクリプト実行 | brew install node |
| FFmpeg | 動画編集 | brew install ffmpeg |
| curl | API呼び出し | システム標準搭載 |
API 設定
火山引擎音声認識
管理画面:https://console.volcengine.com/speech/new/experience/asr?projectName=default
- 火山引擎のアカウントを登録
- 音声認識サービスを有効化
- APIキーを取得
プロジェクトディレクトリの .claude/skills/.env に設定します:
# ファイルパス:クリップエージェント/.claude/skills/.env
VOLCENGINE_API_KEY=your_api_key_here
インストールフロー
1. Node.js + FFmpeg をインストール
↓
2. 火山引擎 APIキーを設定
↓
3. 環境を検証
実行手順
1. 依存関係のインストール
# macOS
brew install node ffmpeg
# 検証
node -v
ffmpeg -version
2. APIキーの設定
# プロジェクトの .claude/skills/ ディレクトリに .env ファイルを作成
echo "VOLCENGINE_API_KEY=your_key" >> .claude/skills/.env
3. 環境の検証
# Node.js を確認
node -v
# FFmpeg を確認
ffmpeg -version
# APIキーを確認(プロジェクトディレクトリで実行)
cat .claude/skills/.env | grep VOLCENGINE
よくある質問
Q1: APIキーはどこで取得できますか?
火山引擎管理画面 → 音声技術 → 音声認識 → APIキー
Q2: ffmpeg コマンドが見つからない
which ffmpeg # パスが表示されるはず
# 表示されない場合は再インストール:brew install ffmpeg
Q3: ファイル名にコロンが含まれていてエラーになる
FFmpeg コマンドには file: プレフィックスを付けてください:
ffmpeg -i "file:2026:01:26 task.mp4" ...