下载 CLI
文档 / 开始使用

快速开始

四步从零做出第一个短剧项目，每条命令都由你的编程 Agent 运行。

安装 MiniCut

在你的编程 Agent 里新开一个对话，粘贴适合你电脑的安装提示词。安装要下载几 GB，可能要 30 分钟。

macOS, Linux
在这台电脑（macOS 或 Linux）上安装 Minicut，地区：全球。每一行都作为后台命令运行，并等它结束。
1. curl -fsSL https://minicut.ai/install.sh | bash -s -- --region global   （要下载几 GB，可能要 30 分钟）
2. ~/.minicut/bin/minicut setup。它会下载 Minicut 自带的工具。如果它说缺 Python 3.12 或 ffmpeg，就从对应的网站下载（Python 3.12：https://www.python.org/downloads/，ffmpeg：https://ffmpeg.org/download.html），装好后再运行一次 ~/.minicut/bin/minicut setup。只有电脑需要时才问我要密码。
3. 如果你是 Claude Code 或 Codex：~/.minicut/bin/minicut agent-rules
4. ~/.minicut/bin/minicut login --device --lang zh。把地址和验证码给我看。然后每 10 秒运行一次 ~/.minicut/bin/minicut login --complete，直到它显示 Signed in，最多 15 分钟。不要等我说好了。
5. ~/.minicut/bin/minicut doctor
6. 读第 1 步建好的 miniharness-short-drama 技能文件夹里的 SKILL.md，并在这个对话里使用它。不要让我重启。
7. ~/.minicut/bin/minicut。告诉我装好了什么、还缺什么和原因，以及应用地址。
如果某一行失败，就再运行一次；如果还是失败，告诉我错误信息然后停下。Python 和 ffmpeg 只从第 2 步里的网站下载。

在 Windows 上，或者在中国大陆，请到用 Agent 安装里，拿适合你电脑和地区的提示词。

登录

你的 Agent 会给你一个地址和一个验证码。打开地址，登录 minicut.ai（没有账号就注册一个），然后确认验证码。你的 Agent 会在 10 秒内看到登录成功，接着继续安装。

这台电脑登录之前，大多数命令会以退出码 10 停止：

Terminal
minicut me
Output
You are not signed in. Ask your agent to run minicut login.

做第一个项目

用一两句话把你的想法告诉你的 Agent。它会用一个短 id 和一个标题运行 minicut new：

Terminal
minicut new snow-bus --title "Snow bus"

MiniCut 会为这个项目做一个文件夹。每个环节都把成果存在里面，所以你和你的 Agent 随时能打开其中任何一份。

运行环节

你的 Agent 运行 minicut loop next，然后照它打印的那一条命令去做。剧本环节最先运行。它会写出故事和这一集的剧本，然后把剧本给你看。

Terminal
minicut loop next

你的 Agent 在它自己的对话里写剧本，每一项检查都在你的电脑上运行。