# 安装

先确认本机可执行 `moi-cli`，再进入[配置与认证](https://docs.matrixorigin.cn/moi/zh/5.0/developer/cli/config-auth.html.md)。安装方式以目标部署提供的说明为准；下列步骤适用于已取得包含产品 CLI 源码的开发包，并已安装兼容的 Go 工具链。

## 从源码构建

在包含产品 SDK 的源码树中执行：

```bash
cd sdk
make build-cli
```

构建成功后，二进制位于 `sdk/dist/bin/moi-cli`。可选安装到 `GOPATH/bin` 或自定义目录：

```bash
make install-cli
# 或：
INSTALL_CLI_DIR="$HOME/bin" make install-cli
```

也可在 CLI 模块目录直接构建：

```bash
cd sdk/cli
go build -o moi-cli ./cmd/moi-cli/
```

将 `moi-cli` 所在目录加入 `PATH`，或使用绝对路径调用。

## 检查安装

```bash
moi-cli --version
moi-cli --help
```

应看到版本号与顶层命令列表。若命令未找到，检查 `PATH` 或改用构建产物的完整路径。

## 升级

升级后重新构建或替换二进制，再执行一次只读命令（例如 `moi-cli workspace list`）确认认证与端点仍然有效。子命令与标志可能随产品版本变化；以当前二进制的 `--help` 为准。