開始使用
返回部落格
開始使用 · 13 / 19

在 Windows 上透過 WSL2 安裝 Claude Motion 工具包

依照文件配置開源工具包：區分 PowerShell 與 Ubuntu，安裝所需工具，並檢查第一次算圖結果。

Claude Motion Skills 編輯團隊查證日期

本指南在 Windows Subsystem for Linux 2 中使用 Ubuntu 執行 whaleyxbt/claude-motion 工具包。它不會安裝 Anthropic 內建的 Motion，也不會安裝本站獨立的 CLI。步驟依據專案及微軟文件整理，目前尚未在 Windows 測試機上驗證這一完整流程。

1. 安裝並確認 Linux 環境

以系統管理員身分開啟 PowerShell，執行下方第一個命令，並依提示重新啟動。啟動 Ubuntu，建立 Linux 使用者帳號。接著在 PowerShell 中執行第二個命令，確認 Ubuntu 使用版本 2。微軟文件說明了 Windows 11 及受支援 Windows 10 版本的這條安裝路徑。在組織管理的電腦上，應使用組織核准的安裝流程。從下一步開始，命令都在 Ubuntu 終端機中執行，而非 PowerShell。

wsl --install
wsl --list --verbose
資料來源與延伸閱讀: Microsoft

2. 在 Ubuntu 內安裝工具

在 Ubuntu 內安裝 Git、Python 3 與 FFmpeg。按照引用的微軟 Node-on-WSL 指南安裝 nvm，再用下方命令選擇目前的 LTS 版 Node。工具包要求 Node 20 或更新版本、Python 3 及 FFmpeg；請選擇仍受維護且符合最低需求的 LTS 版本。在同一個終端機檢查所有版本。Windows 磁碟上的 Node 安裝不能取代 Linux 環境中的安裝。執行下面的 nvm 命令前，必須先完成 nvm 設定。

sudo apt update
sudo apt install -y git python3 ffmpeg
# After installing nvm using the Microsoft guide:
nvm install --lts
nvm use --lts
node --version
npm --version
python3 --version
ffmpeg -version
資料來源與延伸閱讀: Microsoftwhaleyxbt

3. 將專案放在 Linux 檔案系統中

在 Linux 使用者家目錄下建立工作資料夾，並將儲存庫複製到那裡。安裝相依套件前，閱讀儲存庫的 README 與 AGENTS.md。讓專案與工具位於同一個檔案系統，有助於減少路徑及權限混淆。避免直接在同步中的 Windows 桌面資料夾開始，也不要重用從其他作業系統複製來的 node_modules。如果目標資料夾已存在，先查看內容再決定如何處理；不要為了重做教學而刪除既有專案。

mkdir -p ~/projects
cd ~/projects
git clone https://github.com/whaleyxbt/claude-motion.git
cd claude-motion
npm install
資料來源與延伸閱讀: Microsoftwhaleyxbt

4. 先算圖產生隨附範例

修改範例前，先執行儲存庫的建置腳本。README 指明範例輸出為 out/effort.mp4。第二個命令會在 Windows 檔案總管中開啟目前的 Linux 資料夾；找到輸出檔案並用影片播放器開啟。檢查能否播放、是否有聲音，以及能否到達最後一個場景。只成功安裝相依套件，並不能證明算圖成功。如果建置停止，保存最先出現的錯誤訊息；沒有改變條件的反覆重試通常無法找出原因。

npm run build
explorer.exe .
資料來源與延伸閱讀: whaleyxbt

5. 預覽並接入程式開發代理

執行 studio 命令，在 Windows 瀏覽器開啟終端機顯示的本機網址。預覽期間保持該終端機運作。按照所選代理的 WSL 官方設定方法，開啟同一個專案目錄。請它先閱讀儲存庫說明，只修改一個標題、保留範例時序，再算圖輸出至另一個檔案。代理的安裝與帳號權限需要另外準備。先完成這種範圍有限的修改，再要求製作完整影片，便於用已知正常的版本比較結果。

npm run studio
資料來源與延伸閱讀: whaleyxbtMicrosoft

6. 先排查環境，再修改動畫

如果缺少工具，用下方命令確認 Ubuntu 實際呼叫的執行檔。出現非預期的 Windows 路徑時，先調查原因，再決定是否另外安裝。如果 Chromium 無法啟動，查看 Remotion 針對所用 Ubuntu 版本的 Linux 相依套件說明，處理明確缺少的函式庫。如果 WSL 本身無法啟動，回到微軟的疑難排解文件。求助時一併提供失敗命令、第一個錯誤、執行環境版本及專案版本。瀏覽器啟動失敗，並不代表需要重寫分鏡。

which node
which npm
which python3
which ffmpeg
資料來源與延伸閱讀: RemotionMicrosoft

下一步行動

第一個目標是在一致的 Ubuntu 環境中取得可播放的範例 MP4。之後保留可用原始碼，先完成一次小範圍、可核對的修改，再開始製作新影片。

探索創作工作區

資料來源與延伸閱讀

引用連結指向原始文件和創作者。產品可用性可能變更，訂閱或安裝前請確認來源。

  1. Install Windows Subsystem for LinuxMicrosoft
  2. Set up Node.js on WSL 2Microsoft
  3. Claude Motion toolkit: requirements and quick startwhaleyxbt
  4. Linux dependenciesRemotion

繼續探索