# 使用 CLI

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

全部命令和任务见 [CLI](../../cli/index.md)。

## 1. 配置服务地址和凭据

```shell
moi-cli config set-endpoint "<以 /newmoi 结尾的 AI Studio API 服务地址>"
moi-cli config set-api-key "<个人访问令牌>"
```

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

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

```shell
moi-cli -o workspace list
moi-cli config set-workspace "<列表中的工作区标识>"
```

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

## 3. 检查配置

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

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

## 下一步

- [查看完整配置规则](../../cli/configuration-authentication.md)
- [选择常见任务](../../cli/tasks/index.md)