# 快速开始

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

## 安装 MiniCut

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

```text 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 安装](/zh-cn/docs/cli/install-with-your-agent)里，拿适合你电脑和地区的提示词。

## 登录

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

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

```bash Terminal
minicut me
```

```text Output
You are not signed in. Ask your agent to run minicut login.
```

## 做第一个项目

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

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

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

## 运行环节

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

```bash Terminal
minicut loop next
```

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

## 下一步

[概览](/zh-cn/docs/cli/overview) [在终端安装](/zh-cn/docs/cli/install-in-a-terminal)