Buttercut完全ガイド：Claude Codeで動画編集を自動化するOSSの使い方【370スター】

この記事ではClaude Codeに特化して解説します。Claude Code全般は Claude Code完全ガイド2026：インストールから本番運用まで をご覧ください。

Buttercutとは：Claude Codeを動画エディタにするOSS

Buttercutは「Claude Codeを動画エディタにする」というコンセプトで開発された、MITライセンスのOSSツールだ。 2025年11月に公開され、2026年4月時点で370スター・57フォークを獲得している。

動画編集の現場で最も時間を消費する工程は素材の確認とラフカット作成。数十本のクリップを見返し、使えるシーンを選び、タイムラインに並べるという反復作業をClaude Codeに委譲する仕組みを提供する。

処理は2段階で構成される。まず動画素材を分析して「ライブラリ」を構築し、次にそのライブラリをもとにClaude Codeが編集判断を行い、Final Cut Pro・Premiere Pro・DaVinci Resolve向けのタイムラインXMLを出力する。Claude Code Auto Modeとの組み合わせにより、権限確認を省略した高速バッチ処理も可能だ。

言語構成はRuby（XMLタイムライン生成）とPython（WhisperX音声処理・FFmpegフレーム分析）の混成。Claude Codeのスキルシステムを活用し、ライブラリ作成とラフカット生成の2つのスキルを動的に読み込む設計となっている。

2段階ワークフローの全体像

Buttercutの処理フローを図で整理する。

フェーズ1：ライブラリ作成

Claude Codeが並列処理を管理し、音声・映像・メタデータを統合したライブラリを自動構築する。

フェーズ2：ラフカット生成

ユーザーの自然言語指示とライブラリの分析結果を照合し、Claude Codeがクリップ選択・順序・尺を決定する。

インストール：依存関係と手順

必要な依存関係

公式の docs/installation.md に記載されている必須依存関係は以下の通り。

.ruby-version と .python-version ファイルが同梱されており、rbenv / pyenv / asdf / mise などの主要バージョンマネージャーと互換性がある。

インストール手順

# 1. リポジトリをクローン
git clone https://github.com/barefootford/buttercut.git && cd buttercut

# 2. Claude Codeを起動（権限確認省略オプションあり）
claude
# または高速処理モード（リスクを理解した上で使用）
claude --dangerously-skip-permissions

# 3. Claude Codeにインストールを指示
> Install ButterCut

Claude Codeがシステムをチェックし、未インストールの依存関係（Ruby・Python・FFmpeg・WhisperX）を自動でインストールする。

手動インストールの詳細手順は docs/installation.md に記載されている。

ライブラリの作成：動画素材を分析する

インストール完了後、Claude Codeに対話形式でライブラリ作成を指示する。公式READMEに掲載されている対話例は以下の通り。

You: "I want to build a new library"

Claude: [Guides you through library setup and asks for details]

You:
  - Library name: "wedding"
  - Video location: "/path/to/videos"
  - Language: "English"

Claude: [Automatically processes all videos]
  ✓ Creates library structure
  ✓ Transcribes audio with WhisperX
  ✓ Analyzes video frames
  ✓ Generates visual transcripts

Result: Full footage analysis ready for rough cut creation

Claude Codeが並列処理を管理し、指定フォルダ内のすべての動画に対して音声書き起こし・フレーム分析・メタデータ抽出を自動実行する。処理完了後、ライブラリはラフカット生成に使える状態になる。

ラフカット生成：自然言語で編集を指示する

ライブラリ構築後、Claude Codeに自然言語でラフカットの方針を指示する。公式READMEの対話例では、3つの質問への回答でラフカットが生成される。

You: "Let's create a new roughcut"

Claude: [Analyzes footage and asks]
        What should this roughcut focus on?
        - Full story
        - Just the meetup coverage
        - Short teaser sequence

You: "Just the meetup coverage"

Claude: [Asks 3 preference questions]
        - Narrative structure? (chronological, thematic, hook-based)
        - Target duration? (1-2 min, 3-5 min, 6-10 min)
        - Pacing style? (fast & punchy, conversational, cinematic)

You: "Start with presentations (5 sec clips), then interviews,
      then my closing reflection. 3-5 minutes, conversational pacing."

Claude: [Asks which video editor you want to use]
        - Final Cut Pro X
        - Adobe Premiere Pro
        - DaVinci Resolve

You: "Final Cut Pro X"

Claude: [Creates roughcut with editorial decisions]
        ✓ Combined visual transcripts
        ✓ Selected 29 clips (4:32 total)
        ✓ Exported to FCPXML

Result: Ready-to-import timeline at:
        libraries/[library]/roughcuts/[name]_[datetime].fcpxml

出力されたXMLファイルをFinal Cut Pro・Premiere Pro・DaVinci Resolveにインポートし、そこから微調整を加える形が基本的な使い方だ。

RubyライブラリとしてXMLを直接生成する

Claude Codeを介さずにRubyライブラリとして直接XMLを生成することも可能だ。docs/basic-xml-generation.md に記載されているコード例は以下の通り。

require 'buttercut'

# 3つのクリップからなるタイムラインを生成
videos = [
  { path: '/path/to/video1.mp4', duration: 3.0 },
  { path: '/path/to/video2.mp4', duration: 3.0, start_at: 30.0 },
  { path: '/path/to/video3.mp4', duration: 3.0, start_at: 2.0 }
]

# Final Cut Pro X向けタイムライン
fcpx_generator = ButterCut.new(videos, editor: :fcpx)
fcpx_generator.save('timeline.fcpxml')

# Final Cut Pro 7 / Adobe Premiere / DaVinci Resolve向けタイムライン
fcp7_generator = ButterCut.new(videos, editor: :fcp7)
fcp7_generator.save('timeline.xml')

各クリップで指定できるオプションは3つ。

start_at と duration は最も近いフレーム境界に自動丸めされるため、フレーム単位の精度で出力される。

この直接生成機能は、バッチ処理スクリプトやCI/CDパイプラインにButtercutを組み込む際に有用だ。Insanely Fast Whisperの音声認識高速化と組み合わせれば、大量の動画素材のトランスクリプト生成も高速化できる。

他ツールとの比較

Buttercutの差別化ポイントは「編集判断そのものをAIが行う」こと。

Descriptは文字起こしをベースに人間が編集する補助ツール、Runway MLは映像生成が主目的。Buttercutは「素材の分析→クリップ選択→タイムライン構成」という編集ワークフロー全体をClaude Codeに委任する点で用途が異なる。

Claude Codeベストプラクティスガイドを押さえておくと、Buttercutの対話形式をより効果的に活用できる。

制限事項と注意点

PRやIssueを歓迎しているが、公式のContributing guidelineには「プルリクエストやIssueの本文はエージェント（Claude Code等）を使わず自分で書くこと」と明記されている。

関連記事: Claude Code完全ガイド2026：インストールから本番運用まで

参照ソース

• GitHub: barefootford/buttercut — ソースコード・公式README・ドキュメント
• buttercut.io — 公式サイト
• デモ動画: I Taught Claude Code to Edit Movies — YouTube（動作デモ）
• インストール解説動画 — YouTube
• docs/installation.md — 依存関係とバージョン要件
• docs/basic-xml-generation.md — Rubyライブラリとしての直接XML生成
• docs/example-library-setup.md — ライブラリ構築のウォークスルー例