結論
最初にやること:OSのターミナルでmkdir -p preview outを実行します。
Claude Codeは動画編集ソフトのタイムラインではなく、FFmpeg・ffprobeを呼ぶ再現可能なスクリプトを作成・検証する用途に向きます。
カット、結合、音量正規化、サムネイル、字幕焼き込み、形式変換は自動化できますが、映像の良し悪しを完全に判断する工程は試写が必要です。
元動画を上書きせず、まず10秒のプレビューを生成して映像・音声・字幕を確認します。
実行場所:OSのターミナルで実行します。
# ターミナルで実行:必要なフォルダを作成
mkdir -p preview out
# ターミナルで実行:動画・音声のメタデータを確認
ffprobe -v error -show_streams -show_format input.mp4 > preview/probe.json
# ターミナルで実行:動画または音声を変換
ffmpeg -ss 00:00:00 -i input.mp4 -t 10 -vf "scale=-2:720" -c:v libx264 -crf 23 -c:a aac preview/sample.mp4
具体的な手順
大量ファイルではClaude Codeが動画内容を毎回読むのではなく、ffprobeの構造化結果とサムネイルだけを調査材料にします。
変換処理自体は決定的なシェルへ固定し、Claude Codeは設定生成、失敗ログ解析、テストケース作成に使います。
- ffprobeで解像度・FPS・音声・字幕を取得
- 変換仕様をYAMLまたはJSONへ固定
- 短いプレビューでフィルターを確認
- 全ファイルを出力専用ディレクトリへ処理
- 再生確認後にのみ配布用エンコード
入力場所:Claude Codeの対話画面へ貼り付けます。
# Claude Codeの対話画面へ貼り付ける依頼文
次の要件でtools/transcode.shを作成してください。
入力はraw/*.mp4、出力はout/とし、元ファイルを変更しないでください。
720p、H.264、AAC、Web最適化を行い、失敗ファイルをCSVへ記録してください。
最初は1本の10秒プレビューだけを生成し、全件処理は実行しないでください。
実践プロンプト
次のプロンプトをたたき台にし、対象範囲、禁止事項、完了条件を自分の環境へ合わせて具体化します。
入力場所:Claude Codeの対話画面へ貼り付けます。
動画編集自動化を安全に自動化する計画を作成してください。
対象、必要権限、検証コマンド、停止条件を提示し、承認前には変更を実行しないでください。
注意点
FFmpegの再エンコードは画質劣化と長時間のCPU・GPU使用を伴うため、コーデック、CRF、フレームレートを明示してください。
結合する動画のコーデックや時間基準が異なる場合は単純concatで失敗するため、事前検査と必要な再エンコードを行ってください。
著作権、肖像権、字幕の正確性をAIへ委任せず、公開前に人間が全編を再生確認してください。