Mac に Claude Motion を導入する手順

フォルダーと対応ツールを選ぶ

ホーム内に専用フォルダーを作り、パッケージと動画の容量を確保します。必要なのは Node 20 以上、Python 3、FFmpeg です。古い最低版ではなく、サポート中の Node LTS を選んでください。各インストーラーの現在の macOS と CPU 条件を確認します。一つのツールが対応しても、描画全体の互換性が保証されるわけではありません。付属例が成功するまで元のプロジェクトを変えません。

保守されている配布元から不足分を入れる

Node は公式ダウンロードページ、Python は公式 macOS 説明から導入します。git がなければ Git の Mac 向けページを確認します。FFmpeg は Homebrew が下記コマンドを案内していますが、先に Homebrew 自体の導入・設定を終えてください。独自の OS 対応方針があり、古い Mac には別の保守中の配布形態が必要な場合があります。Python が証明書の設定を求めたら説明に従い、Apple のシステム Python は置き換えないでください。

brew install ffmpeg

新しいターミナルでツールを確認する

導入後に新しいターミナルを開き、下記のバージョン確認を実行します。すべてバージョンを表示する必要があります。インストール済みでも見つからなければ、再導入前に PATH の公式手順を確認します。リポジトリは python3 を呼ぶため、python という別名だけでは不十分です。複数版があればシェルがどの実行ファイルを使うか調べます。導入、プレビュー、描画で同じ環境を使い、競合を避けます。

node --version
npm --version
python3 --version
ffmpeg -version
ffprobe -version
git --version

取得して元の例をビルドする

選んだ親フォルダーで下記を実行します。npm install が依存関係を入れ、npm run build が音、無音映像、結合を順に行います。記載された最終出力は out/effort.mp4 です。失敗したまま独自場面を作り始めず、最初のエラーと段階を記録します。Python がないと音の生成に影響し、FFmpeg がないと映像が描画できても最終結合に失敗します。

git clone https://github.com/whaleyxbt/claude-motion
cd claude-motion
npm install
npm run build

出力とプレビューを別々に確認する

Finder で out/effort.mp4 を開き、最後まで再生します。動き、音、自然な終わりを確かめます。次に npm run studio を実行し、ターミナルに表示されたローカルアドレスを開きます。利用中はプレビューサーバーを動かしたままにし、終了時は Control-C で停止します。プレビューと有効な出力ファイルは別の確認です。新しい制作を依頼する前に動作状態を保存してください。

npm run studio

正しいエージェントまたは当サイトの手順へ進む

取得したフォルダー内で Claude Code または Codex を起動し、プロジェクトの説明を読ませて小さな修正を依頼します。当サイトのテンプレートが目的なら入門ページを使います。cm-skills の導入には Node 22 以上が必要で、ローカル描画は Chrome、FFmpeg、HyperFrames を使います。これらは別のプロジェクトのコマンドです。第三者の npx claudemotion で代用したり、当サイトの追加音声が使えると決めつけたりしないでください。