开始使用
返回博客
开始使用 · 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

继续探索