# MOI-CLI 下载

MOI-CLI（`moi-cli`）是 MatrixOne Intelligence 的官方命令行工具，用于在终端或自动化脚本中管理工作区、数据流、计算实例等资源。

## 下载发布包

当前稳定版本为 `0.1.0`。CLI 为原生编译的二进制程序，需按操作系统及芯片架构下载对应版本：

| 操作系统 | 芯片架构 | 软件包 | 文件大小 | 状态 | 下载链接 |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **macOS** | Apple Silicon (`arm64`) | `moi-cli-0.1.0-darwin-arm64.zip` | ~8.1 MB | 稳定提供 | [下载 macOS arm64 版](../../../assets/downloads/moi-cli-0.1.0-darwin-arm64.zip) |
| **macOS** | Intel (`amd64`) | - | - | 规划中 | - |
| **Linux** | x86_64 / ARM64 | - | - | 规划中 | - |
| **Windows** | x86_64 | - | - | 规划中 | - |

````{dropdown} 文件校验 (SHA-256)
下载完成后，请通过以下哈希值校验安装包完整性：

```bash
shasum -a 256 moi-cli-0.1.0-darwin-arm64.zip
```

官方 SHA-256：

- `b76c59360f49ed8ad871a6adcab63eea1a500d0aeeee52f11aaf1d1c82a3fc2c`
````

## 解压与运行验证

解压下载的压缩包，得到可执行文件 `moi-cli`：

```bash
unzip moi-cli-0.1.0-darwin-arm64.zip
cd moi-cli-0.1.0-darwin-arm64

# 查看版本
./bin/moi-cli -version

# 查看命令帮助
./bin/moi-cli --help
```

如果输出 `moi-cli version 0.1.0` 及帮助信息，表示二进制可正常运行。

> **macOS 安全提示**：  
> 当前版本采用内测构建签名。首次在 macOS 终端运行时，如系统提示“无法验证开发者”，请进入系统的 **“设置” > “隐私与安全性”**，在下方找到 `moi-cli` 并点击 **“仍要打开”** 即可。

## 下一步

验证二进制可运行后，请配置服务端地址与个人访问令牌：

- [使用 CLI 连接工作区](../ai-studio/cli.md)
- [CLI 配置与身份认证](../../cli/configuration-authentication.md)
- [CLI 常见任务指南](../../cli/tasks/index.md)