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 指令，也不能默认本站可选配音服务已开放。