# 使用 MOI-CLI

`moi-cli` 用于在终端或脚本中操作 Product 资源。当前尚未提供可确认的对外分发入口；已通过正式渠道获得 CLI 的读者，可以按本页验证连接和工作区范围。

## 1. 配置 Endpoint 和凭据

```shell
moi-cli config set-endpoint "<Product API Base URL ending in /newmoi>"
moi-cli config set-api-key "<personal-access-token>"
```

Endpoint 必须包含 `/newmoi`。个人访问令牌按原始值传入，不添加 `Bearer` 前缀。命令行参数可能进入终端历史；只在受保护的本地环境中执行凭据配置。

## 2. 发现并选择工作区

```shell
moi-cli -o workspace list
moi-cli config set-workspace "<workspace-id-from-list>"
```

工作区列表成功返回表示 Endpoint 和个人访问令牌可用。工作区名称用于识别，后续命令仍应保存并使用工作区 ID。

## 3. 检查配置

```shell
moi-cli config show
```

输出中应显示完整 Endpoint 和工作区 ID，`api_key` 应以遮蔽形式显示。随后可以运行 `moi-cli --help` 或 `moi-cli <command> --help` 选择任务。

## 下一步

- [了解 MOI-CLI 的适用范围](../cli/index.md)
- [查看完整配置规则](../cli/configuration-authentication.md)
- [选择常见任务](../cli/tasks/index.md)