在终端安装

自己安装 MiniCut，一次一条命令：下载它、设置它的工具、登录，再连接你的 Agent 应用。

你需要 macOS、Linux 或 Windows（ARM64 或 x64）、5 GB 可用磁盘和互联网连接。想让你的编程 Agent 替你运行这些步骤，请看用 Agent 安装。

安装 CLI

1. 可选：先用你的包管理器安装 Python 3.12 和 ffmpeg。如果缺少，minicut setup 之后会提示你。

brew install python@3.12 ffmpeg

sudo apt install python3.12-venv ffmpeg

winget install Python.Python.3.12 Gyan.FFmpeg

2. 运行适合你电脑的安装命令。在中国大陆，把 global 换成 cn。

curl -fsSL https://minicut.ai/install.sh | bash -s -- --region global

& ([scriptblock]::Create((irm https://minicut.ai/install.ps1))) -Region global

curl -fsSL https://minicut.ai/install.cmd -o install.cmd && install.cmd -Region global && del install.cmd

3. 等它结束。它要下载几 GB，可能要 30 分钟。结束时它会打印 minicut: 和这个命令的完整路径。
4. 如果你用 macOS 或 Linux，打开一个新的终端窗口。安装会把 ~/.minicut/bin 加进 .zshrc、.bashrc 或 .profile 里的 PATH，新窗口才会读到它。
5. 如果你用 Windows，下面的步骤里写 minicut 的地方，都用安装打印的完整路径。

安装还会把 MiniCut 技能加到这台电脑上找到的每个 Agent 应用里。

设置工具

1. 运行 setup。它会做出主文件夹，并下载 MiniCut 自带的工具。在中国大陆，加上 --china 使用下载镜像站。

minicut setup

2. 如果 setup 说缺 Python 3.12 或 ffmpeg，就从 python.org/downloads 或 ffmpeg.org/download 下载、安装，再运行一次 minicut setup。
3. 可选：运行 minicut setup --local-speech，加上 1 GB 的语音模型。有了它们，第 8 步的台词核对就在你的电脑上免费运行。

登录

1. 运行登录命令。它会在浏览器里打开 minicut.ai，然后等待。

minicut login

2. 在页面上登录，或者注册一个账号。命令结束时会显示 Signed in. 和你账号的邮箱。
3. 如果这台电脑没有浏览器，例如通过 SSH 连接，就改运行 minicut login --device。它会打印一个地址和一个验证码。
4. 在浏览器里打开那个地址，登录，并确认验证码。
5. 运行 minicut login --complete 完成登录。验证码 15 分钟内有效。

连接你的 Agent 应用

1. 不带任何参数运行 minicut install-skill，列出这台电脑上的 Agent 应用和它们的技能文件夹。
2. 把技能加到它找到的每个应用，或者按名字只加到一个应用：

minicut install-skill --all-found

3. 如果你用 Claude Code 或 Codex，写入这个应用对 MiniCut 命令的允许规则和先询问规则：

minicut agent-rules --app claude-code

检查是否成功

1. 运行 minicut doctor。它会显示可用磁盘和主文件夹，然后列出每个工具的状态、版本和所在文件夹。如果缺少某个工具，它的最后一行会写出要运行的 setup 命令。
2. 运行 minicut status。已登录的电脑会显示 Signed in as 和你的账号、密钥存放的位置，以及 CLI 版本。

错误

下一步