# 在终端安装

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

你需要 macOS、Linux 或 Windows（ARM64 或 x64）、5 GB 可用磁盘和互联网连接。想让你的编程 Agent 替你运行这些步骤，请看[用 Agent 安装](/zh-cn/docs/cli/install-with-your-agent)。

## 安装 CLI

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

```bash macOS
brew install python@3.12 ffmpeg
```

```bash Linux
sudo apt install python3.12-venv ffmpeg
```

```powershell Windows
winget install Python.Python.3.12 Gyan.FFmpeg
```

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

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

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

```bat Windows CMD
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` 使用下载镜像站。

```bash Terminal
minicut setup
```

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

## 登录

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

```bash Terminal
minicut login
```

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

## 连接你的 Agent 应用

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

```bash Terminal
minicut install-skill --all-found
```

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

```bash Terminal
minicut agent-rules --app claude-code
```

## 检查是否成功

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

## 错误

| 消息 | 怎么做 |
|---|---|
| `You are not signed in. Ask your agent to run minicut login.` | 运行 `minicut login`。这条命令需要一台已登录的电脑。 |
| `Could not reach minicut.ai` | 连上互联网，再运行同一条命令。已登录的电脑可以离线使用 7 天。 |
| macOS 或 Linux 上出现 `minicut: command not found` | 打开一个新的终端窗口，或者运行 `~/.minicut/bin/minicut`。 |
| setup 说缺 Python 3.12 或 ffmpeg | 从 setup 指出的网站安装它，再运行 `minicut setup`。 |

## 下一步

[快速开始](/zh-cn/docs/cli/quickstart) [概览](/zh-cn/docs/cli/overview)