# 快速开始

用 `moi-cli` 完成一次最小只读调用，确认端点、凭据与工作区配置可用。

## 前提

- 已安装 `moi-cli`，见 [安装](https://docs.matrixorigin.cn/moi/zh/5.0/developer/cli/install.html.md)。
- 已在 [访问凭据](https://docs.matrixorigin.cn/moi/zh/5.0/guides/billing/credentials.html.md) 领取个人访问令牌。
- 已知产品 API 端点（含 `/newmoi` 等前缀）以及目标工作区 ID。

## 配置

```bash
moi-cli config set-endpoint https://<product-host>/newmoi
moi-cli config set-api-key <personal-access-token>
moi-cli config set-workspace <workspace-id>
moi-cli config show
```

确认 `endpoint` 与 `workspace_id` 正确；`api_key` 应显示为 `********`。

## 列出工作区

```bash
moi-cli workspace list
```

成功时会输出当前身份可见的工作区。需要机器可读结果时加 `-o`：

```bash
moi-cli -o workspace list
```

## 列出 Catalog（可选）

若当前工作区已开通 Catalog 相关能力：

```bash
moi-cli catalog list
```

## 失败时怎么查

按顺序缩小范围：

1. `moi-cli --version` 是否可用。
2. `config show` 中的端点是否包含正确的产品 API 前缀，且网络可达。
3. PAT 是否完整、未过期，且属于当前环境。
4. 工作区 ID 是否正确；需要 Role 时，`set-role` 映射是否被标记为 invalid。
5. 若提示 `No request was sent.`，先修复配置中的 Role 映射，再重试业务命令。

更多命令见 [命令概览](https://docs.matrixorigin.cn/moi/zh/5.0/developer/cli/commands.html.md)。对象级行为与限制见对应 [SDK](https://docs.matrixorigin.cn/moi/zh/5.0/developer/sdk/index.html.md) 或 [Product API](https://docs.matrixorigin.cn/moi/zh/5.0/developer/api/product-api/index.html.md) 文档。