文档 / 开始使用

用 Agent 安装

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

要求

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

运行提示词

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

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

提示词

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

在这台电脑（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 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 步里的网站下载。

在这台电脑（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 步里的网站下载。

中国大陆

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

在这台电脑（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 步里的网站下载。

在这台电脑（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 步里的网站下载。

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

下一步

快速开始在终端安装概览