# 用 Agent 安装

把一段提示词粘贴到你的编程 Agent。它会安装 MiniCut、帮你登录、检查每个工具，并加载 MiniCut 技能。

## 要求

| 要求 | 内容 |
|---|---|
| 系统 | macOS、Linux 或 Windows，ARM64 或 x64 |
| 可用磁盘 | 5 GB |
| 网络 | 安装和登录都要能连上互联网 |
| Agent 应用 | MiniCut 支持的 11 个编程 Agent 应用之一，例如 Claude Code、Codex、Cursor、OpenCode、TRAE、Kimi Code 或 Qoder |

## 运行提示词

1. 在你的 Agent 应用里新开一个对话。
2. 从下面的“提示词”里，复制适合你电脑的提示词。如果你在中国大陆，改从“中国大陆”里复制。
3. 粘贴到对话里，发送。
4. 当你的 Agent 显示一个地址和一个验证码时，打开地址，登录 minicut.ai，然后确认验证码。
5. 等你的 Agent 发出最后一条消息。它会说明装好了什么、还缺什么和原因，以及 MiniCut 应用的地址。

安装要下载几 GB，可能要 30 分钟。只有电脑需要时，你的 Agent 才会向你要电脑密码。

## 提示词

提示词在每个 Agent 应用里都一样。在 Windows 上，提示词里的 `minicut` 指安装在第 1 行结尾打印的完整路径。

```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 步里的网站下载。
```

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

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

## 中国大陆

这些提示词从中国大陆地区安装，并使用在那里能打开的下载网站。

```text macOS, Linux
在这台电脑（macOS 或 Linux）上安装 Minicut，地区：中国大陆。每一行都作为后台命令运行，并等它结束。
1. curl -fsSL https://minicut.ai/install.sh | bash -s -- --region cn   （要下载几 GB，可能要 30 分钟）
2. ~/.minicut/bin/minicut setup。它会下载 Minicut 自带的工具。如果它说缺 Python 3.12 或 ffmpeg，就从对应的网站下载（Python 3.12：https://registry.npmmirror.com/binary.html?path=python/3.12.10/，ffmpeg：https://registry.npmmirror.com/binary.html?path=ffmpeg-static/b6.1.1/），装好后再运行一次 ~/.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 步里的网站下载。
```

```text Windows PowerShell
在这台电脑（Windows PowerShell）上安装 Minicut，地区：中国大陆。每一行都作为后台命令运行，并等它结束。 从第 2 步起，minicut 指第 1 步安装最后打印的 minicut 完整路径。
1. & ([scriptblock]::Create((irm https://minicut.ai/install.ps1))) -Region cn   （要下载几 GB，可能要 30 分钟）
2. minicut setup。它会下载 Minicut 自带的工具。如果它说缺 Python 3.12 或 ffmpeg，就从对应的网站下载（Python 3.12：https://registry.npmmirror.com/binary.html?path=python/3.12.10/，ffmpeg：https://registry.npmmirror.com/binary.html?path=ffmpeg-static/b6.1.1/），装好后再运行一次 minicut setup。只有电脑需要时才问我要密码。
3. 如果你是 Claude Code 或 Codex：minicut agent-rules
4. minicut login --device --lang zh。把地址和验证码给我看。然后每 10 秒运行一次 minicut login --complete，直到它显示 Signed in，最多 15 分钟。不要等我说好了。
5. minicut doctor
6. 读第 1 步建好的 miniharness-short-drama 技能文件夹里的 SKILL.md，并在这个对话里使用它。不要让我重启。
7. minicut。告诉我装好了什么、还缺什么和原因，以及应用地址。
如果某一行失败，就再运行一次；如果还是失败，告诉我错误信息然后停下。Python 和 ffmpeg 只从第 2 步里的网站下载。
```

```text Windows CMD
在这台电脑（Windows CMD）上安装 Minicut，地区：中国大陆。每一行都作为后台命令运行，并等它结束。 从第 2 步起，minicut 指第 1 步安装最后打印的 minicut 完整路径。
1. curl -fsSL https://minicut.ai/install.cmd -o install.cmd && install.cmd -Region cn && del install.cmd   （要下载几 GB，可能要 30 分钟）
2. minicut setup。它会下载 Minicut 自带的工具。如果它说缺 Python 3.12 或 ffmpeg，就从对应的网站下载（Python 3.12：https://registry.npmmirror.com/binary.html?path=python/3.12.10/，ffmpeg：https://registry.npmmirror.com/binary.html?path=ffmpeg-static/b6.1.1/），装好后再运行一次 minicut setup。只有电脑需要时才问我要密码。
3. 如果你是 Claude Code 或 Codex：minicut agent-rules
4. minicut login --device --lang zh。把地址和验证码给我看。然后每 10 秒运行一次 minicut login --complete，直到它显示 Signed in，最多 15 分钟。不要等我说好了。
5. minicut doctor
6. 读第 1 步建好的 miniharness-short-drama 技能文件夹里的 SKILL.md，并在这个对话里使用它。不要让我重启。
7. minicut。告诉我装好了什么、还缺什么和原因，以及应用地址。
如果某一行失败，就再运行一次；如果还是失败，告诉我错误信息然后停下。Python 和 ffmpeg 只从第 2 步里的网站下载。
```

## 提示词的每一行

1. 第 1 行下载 MiniCut，并把 MiniCut 技能加到它找到的每个 Agent 应用里。
2. 第 2 行运行 `minicut setup`，下载 MiniCut 自带的工具。只有 setup 说缺 Python 3.12 或 ffmpeg 时，你的 Agent 才会从提示词里的网站下载它们。
3. 第 3 行在 Claude Code 或 Codex 里运行 `minicut agent-rules`。它会写入这个应用对 MiniCut 命令的允许规则和先询问规则。
4. 第 4 行用你在 minicut.ai 确认的验证码，让这台电脑登录。
5. 第 5 行运行 `minicut doctor`，列出每个工具、它的版本和位置。
6. 第 6 行把 MiniCut 技能加载进你正在用的对话，所以你不用重启应用。
7. 第 7 行运行 `minicut`，在浏览器里打开 MiniCut 应用。

## 错误

| 消息或状态 | 怎么做 |
|---|---|
| 你的 Agent 说某一行失败了两次，然后停下 | 看它显示的错误。先修好它指出的问题，再重新发送提示词。 |
| `minicut setup` 说缺 Python 3.12 或 ffmpeg | 你的 Agent 会从第 2 行里的网站下载它，再运行一次 setup。如果它做不到，你自己从那个网站安装。 |
| 验证码在你确认之前过期了 | 让你的 Agent 再运行一次第 4 行。验证码 15 分钟内有效。 |
| `You are not signed in. Ask your agent to run minicut login.` | 登录没有完成。让你的 Agent 再运行一次第 4 行。 |

## 检查是否成功

让你的 Agent 运行 `minicut status`。已登录的电脑会显示它登录的账号、密钥存放的位置和 CLI 版本。

## 下一步

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