Mortiflix新手教程：从零安装本地AI视频工作室的5步完整指南

Mortiflix 是一个本地 AI 视频工作室（motion design studio）：你写好创意简报，Claude 分阶段做出脚本、风格帧、动态分镜和成片，每一步都需要你审批才能继续。它不是"一键生成"的黑盒工具，而是把真实动画工作室的工作流程搬到了你自己的电脑上——全程使用你自己的 Claude Code 登录或 Anthropic API key，无需注册任何服务。

本文带你用5 步完成 Mortiflix 的完整安装：准备环境 → 克隆安装 → 初始化 → 交互式配置 → 跑通第一个视频项目。

🧭 快速了解：Mortiflix 的视频制作流程

Mortiflix 的核心思路是**"阶段式制作 + 人工审批"**（gates 机制）：

简报 ──▶ 脚本 ──▶ 风格帧 ──▶ 动态分镜 ──▶ 制作 ──▶ 成片 ──▶ 交付 ▲ ▲ ▲ ▲ ▲ └── 你 ───┴──── 你 ───┴────── 你 ──┴──────── 你 ───────┘ 审批、钉便签、回答问题（每个阶段都会停下来等你）

• 会话在门禁（gate）处停下：Claude 做到一个可审查的阶段就提交并停止，等你批准后才继续，等待期间不产生任何费用；
• 规则写在代码里：提交如果没回答你留下的每一条便签，会被直接拒绝；
• 它会记住你的品味：你指出的问题可以沉淀为永久检查项，跨项目生效。

想深入了解整体架构，可以阅读 docs/ARCHITECTURE.md 和单页总览 OVERVIEW.html。

上图是内置 3D 粒子引擎 Nova FX 的预设面板，Mortiflix 支持在 Blender 中直接调用这类特效制作 3D 镜头。

✅ 第 1 步：安装前准备（3 个必备条件）

开始前确认你的电脑满足以下条件：

📌 平台提示：Mortiflix 目前主要在 Linux 上测试，macOS 大概率可用，Windows 版安装器已就绪（会话功能即将跟进），细节见 docs/WINDOWS.md。

📦 第 2 步：克隆仓库并安装依赖

打开终端，执行以下命令：

git clone https://gitcode.com/gh_mirrors/mo/mortiflix-oss.git && cd mortiflix-oss npm install npm link # 将 mortiflix 命令加入 PATH

npm link之后，你就可以在任意目录直接使用mortiflix命令了（也可以用node bin/mortiflix代替）。

完整命令清单可在 src/cli.mjs 的 HELP 文本中查看，运行mortiflix --help即可随时查阅。

⚙️ 第 3 步：初始化工作室（mortiflix init）

mortiflix init

这一步会：

1. 创建本地工作室文件夹~/Mortiflix（存放项目、密钥和工具）；
2. 自动检测你机器上已有的后端（Claude Code 登录 / API key），让你选择其中一个；
3. 询问你的 API 密钥——输入是隐藏的，每个 key 都会先通过一次免费 API 调用来验证，然后只写入工作室文件夹（权限 600 的secrets.json）。

密钥随时可以用mortiflix keys修改，也可以在 Web 工作室的Settings › Keys页面管理。

🎛️ 第 4 步：交互式配置（mortiflix setup）

mortiflix setup

这是 Mortiflix 最贴心的部分：它会逐项解释每个可选功能的作用、会安装什么、占用多大空间，并且先询问、再安装。除 Claude 外全部可选：

所有工具都装进~/Mortiflix/tools/，删除该目录即可全部移除。各配置项的完整说明在 docs/SETUP.md。

🎬 第 5 步：跑通第一个视频项目

先用免费的 demo 体验完整流程（占位素材，不需要 Claude、不花一分钱）：

mortiflix demo

准备好后，创建一个真正的解说视频项目：

mortiflix new explainer # 会依次问你的简报问题（主题、受众、时长、画幅…） mortiflix run # 会话运行，直到产出内容等待你审批 mortiflix review # 读批注、回答问题、钉便签、批准或要求修改 mortiflix run # 如此往复，直到交付

目前内置的 4 条流水线（pipelines）：

比如explainer流水线的阶段定义就写在 pipelines/explainer/pipeline.json 里——它就是一个"流水线即文件夹"的开放格式，任何人都可以编写新流水线，格式文档见 docs/PIPELINES.md。

🌐 除了终端，还有 2 种使用方式

方式 A：浏览器 Web 工作室（推荐新手）

mortiflix serve # 打开 http://127.0.0.1:4646

浏览器里能看到：正在等待你处理的事项、Claude 的实时日志、以及审查室——点击视频帧钉一条便签、暂停视频对某一时刻留批注、回答会话的问题、批准通过。运行serve时会话会自动启动。

方式 B：在 Claude Code 内使用

/plugin marketplace add GTKottman/mortiflix-oss /plugin install mortiflix@mortiflix /mortiflix

/mortiflix会在对话中一步步带你完成安装、配置、demo 和跑项目，每个门禁都会把会话提交的内容展示给你。注意：对话只是"向导"，视频仍由工作室自己的会话在门禁之后制作。

❓ 新手常见问题

Q1：没有 Claude 订阅/不想花钱，能玩吗？可以。用--backend demo或mortiflix demo，它会用占位帧和测试图案视频完整走一遍所有门禁，完全免费。

Q2：密钥安全吗？Mortiflix 只使用你自己的账号，无需注册；密钥只写入本地~/Mortiflix文件夹，且只有你能发布内容——publish命令会话（Claude）永远无法触及。安全模型详见 docs/SECURITY.md。

Q3：一个视频要花多少 token？docs/COMPUTE.md 用一个真实项目实测了 token、时间和磁盘开销，每个项目也会展示其 Claude 工作的成本（或"如果按 API 计价本应花费"的金额）。

Q4：装错了想卸载怎么办？删除~/Mortiflix/tools/移除全部安装的工具；npm uninstall -g mortiflix移除命令本身。

📚 延伸阅读

• 快速上手：README.md
• 架构详解：docs/ARCHITECTURE.md
• 门禁协议：harness/GATES.md
• 配音方案（ElevenLabs / 本地 GPU / 自己录音）：docs/VOICE.md
• 音乐引擎原理：docs/MUSIC.md

至此，你的本地 AI 视频工作室已经就绪 🎉 从mortiflix new logo-sting开始，体验一次最快的完整视频制作吧。