> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装

当前该功能仍处于 **beta 阶段**，需要分别安装 PPIO 沙箱的 Python SDK 与命令行工具的 beta 版本：

***

## 使用 pip 安装 Python SDK

需要使用 `--pre` 参数安装最新的 beta 版本：

```bash theme={null}
pip install ppio-sandbox==1.1.3b1
```

***

## 安装 Node.js CLI

### 方式 1：使用 npx 临时运行（推荐）

在项目目录下使用 `npm` 安装 beta 版 CLI，并使用 `npx` 命令运行。无需全局安装 beta 版，避免污染全局环境。

```bash theme={null}
# 安装最新 beta 版本 CLI
npm install ppio-sandbox-cli@beta

# 首先完成认证
npx ppio-sandbox-cli auth login

# 运行 agent configure 命令配置 Agent
npx ppio-sandbox-cli agent configure
```

### 方式 2：全局安装

如果需要频繁使用 CLI，可以全局安装：

```bash theme={null}
# 安装最新 beta 版本
npm install -g ppio-sandbox-cli@beta
```

安装后可以直接使用命令：

```bash theme={null}
ppio-sandbox-cli agent configure
```