Claude CodeでFFmpeg動画処理を自動化する方法

【結論】Claude CodeにFFmpegコマンドを作らせて実行前に検証する

Claude Codeは動画編集ソフトそのものではありませんが、FFmpegやffprobeを使うコマンド、シェルスクリプト、Pythonスクリプトを作成して実行できます。

動画を直接理解できると断定せず、まずffprobeで解像度、コーデック、長さ、音声トラックを取得し、その情報に基づいて処理させます。

一括変換では元動画を上書きせず、別のoutputディレクトリへ保存する設計にしてください。

# macOSでFFmpegを導入
brew install ffmpeg

# 入力動画の情報確認
ffprobe -v error -show_format -show_streams input.mp4

# Claude Codeを起動
claude

具体的な手順・設定方法

1. 入力動画を「input」、変換後を「output」へ分離します。

   ファイル名に空白や日本語が含まれる可能性を伝え、引用符を正しく付けたスクリプトにします。

   mkdir -p input output

2. 最初の1本だけで変換コマンドを試し、映像、音声、長さを確認します。

   成功後にループ処理へ拡張し、既存出力がある場合は停止させます。

実践プロンプト / 活用テクニック

動画処理はCPU、GPU、容量を大きく使うため、最初に見積もりと空き容量を確認させると安全です。

inputフォルダ内のMP4を720pのH.264/AACへ変換するスクリプトを作成してください。
元ファイルは変更せず、出力はoutputフォルダへ同名で保存してください。
最初にffprobeで各動画の長さ、解像度、コーデックを一覧化し、必要な空き容量を概算してください。
既存の出力ファイルがある場合は上書きせず停止してください。
まず1本だけ試し、映像と音声のストリームが存在することを検証してから全件処理してください。

注意点・よくあるエラーと対処法

• 「ffmpeg: command not found」はPATH未設定か未導入が原因です。

  OSに合うパッケージ管理方法を確認し、Claudeへ無断でシステム全体を変更させないでください。

  which ffmpeg
  ffmpeg -version

• 変換中にディスク容量が尽きると不完全なファイルが残ります。

  開始前後に空き容量を確認し、一時ファイル名で出力して成功後にリネームする設計が安全です。

  df -h .