# 前置条件与认证

<subtitle>开始使用 SDK/CLI 前需要完成的准备工作：获取 API Key 与配置环境变量。</subtitle>

本页统一说明 UCloud Sandbox 的认证配置。后续文档将不再重复此内容。

---

## 获取 API Key

前往密钥管理页面获取您的 API 密钥：

> [密钥管理](https://astraflow.ucloud.cn/modelverse/api-keys)

---

## 原生 SDK 配置

使用 UCloud Sandbox 原生 Python SDK 时，请配置 `UCLOUD_SANDBOX_API_KEY` 环境变量：

```bash
export UCLOUD_SANDBOX_API_KEY=your_api_key
```

默认情况下 SDK 将会使用`cn-wlcb`地域，如果想要使用不同的地域，请配置 `UCLOUD_SANDBOX_REGION` 环境变量：

```bash
export UCLOUD_SANDBOX_REGION=region
```

关于地域选择更新信息，请参考：[切换地域](/docs/agent-sandbox/product/region.md)。

配置完成后即可使用 SDK：

```python
from ucloud_sandbox import Sandbox

sandbox = Sandbox.create(timeout=60)
print(sandbox.sandbox_id)
```

---

## E2B 兼容模式配置

如果您使用 E2B SDK 以兼容模式接入 UCloud Sandbox，请配置以下环境变量：

```bash
# 设置 UCloud Sandbox 域名，注意不同地域的域名前缀不同，请根据需要选择
export E2B_DOMAIN=cn-wlcb.sandbox.ucloudai.com

# 设置您的 API Key
export E2B_API_KEY=your_api_key

# 关闭e2b格式的 API key 校验，这是必须的，否则 E2B SDK 不识别 UCloud 的 API Key
export E2B_VALIDATE_API_KEY="false"
```

> **注意**：E2B 兼容模式与原生 SDK 使用**不同的环境变量**，请勿混用。

配置完成后，您可以直接使用 E2B SDK：

```python
from e2b_code_interpreter import Sandbox

sbx = Sandbox.create()
```

---

## CLI 配置

CLI 优先读取环境变量中的 API Key，也支持交互式登录：

```bash
# 方式一：环境变量（推荐）
export UCLOUD_SANDBOX_API_KEY=your_api_key

# 方式二：交互式登录
ucloud-sandbox-cli login
```