Mac 安裝 Claude Motion：從環境準備到首個 MP4

選擇目錄與相容工具鏈

在個人目錄建立專用資料夾，預留套件與影片輸出空間。儲存庫要求 Node 20 以上、Python 3 和 FFmpeg。優先使用仍受支援的 Node LTS，而非過時的最低版本。核對每個安裝程式目前的 macOS 與 CPU 要求。單一工具相容不代表整個算繪流程皆相容。內附範例成功前，保持原始專案不變。

從持續維護的來源補齊工具

從 Node 官方下載頁取得 Node，依 Python 的 macOS 文件安裝 Python。缺少 git 時查看 Git 的 Mac 安裝頁。FFmpeg 可用 Homebrew 文件中的下方命令安裝，但須先依 Homebrew 自己的說明完成安裝與設定。Homebrew 有獨立系統支援政策，舊 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 指令，也不能預設本站選用配音服務已開放。