# 概览

UCloud Sandbox 为您提供安全可靠的弹性沙箱计算服务。只需几秒钟，您就可以在云端获取和启用具备完整操作系统能力的沙箱，用于执行 AI Agent 生成的代码、进行自动化测试或运行不可信的脚本。

随着业务需求的变化，您可以实时扩展或缩减计算资源。UCloud Sandbox 支持按实际使用的资源计费，可以为您节约计算成本。

#### <center>[快速开始](/docs/agent-sandbox/product/quickstart.md)   |   [CLI 指南](/docs/agent-sandbox/product/cli.md)   |   [模板指南](/docs/agent-sandbox/template/quickstart.md)   |   [E2B 兼容模式](/docs/agent-sandbox/product/e2b-compatibility.md)</center>

---

## 推荐学习路径

按「先跑起来 → 深入能力 → 构建自定义环境」的顺序开始：

### 第一步：快速上手

1. [前置条件与认证](/docs/agent-sandbox/product/prerequisites.md) - 获取 API Key 并配置环境
2. [SDK 快速开始](/docs/agent-sandbox/product/quickstart.md) - 5 分钟创建第一个沙箱
3. [CLI 指南](/docs/agent-sandbox/product/cli.md) - 命令行工具入门
4. [切换地域](/docs/agent-sandbox/product/region.md) - 学习如何切换地域
5. [计费说明](/docs/agent-sandbox/product/fee.md) - 了解沙箱计费情况

### 第二步：深入使用沙箱

1. [沙箱生命周期](/docs/agent-sandbox/sandbox/lifecycle.md) - 超时、暂停、恢复与销毁
2. [命令执行](/docs/agent-sandbox/commands/overview.md) - 在沙箱中运行命令
3. [文件系统](/docs/agent-sandbox/filesystem/overview.md) - 文件读写与传输
4. [网络访问](/docs/agent-sandbox/network/internet-access.md) - 控制沙箱的互联网访问

### 第三步：构建自定义模板

1. [模板快速开始](/docs/agent-sandbox/template/quickstart.md) - 构建自定义模板
2. [模板工作原理](/docs/agent-sandbox/template/how-it-works.md) - 快照机制详解
3. [模板示例](/docs/agent-sandbox/template/examples/claude-code.md) - 常见场景的模板示例

---

## 核心能力

| 能力 | 说明 | 相关文档 |
|-----|------|---------|
| **代码执行** | 安全运行 Agent 生成的 Python 等代码 | [命令执行](/docs/agent-sandbox/commands/overview.md) |
| **文件操作** | 在沙箱与本地之间读写、上传、下载文件 | [文件系统](/docs/agent-sandbox/filesystem/overview.md) |
| **自定义模板** | 预装依赖、预置文件、毫秒级启动 | [模板指南](/docs/agent-sandbox/template/quickstart.md) |
| **网络控制** | 灵活控制沙箱的互联网访问权限 | [网络访问](/docs/agent-sandbox/network/internet-access.md) |
| **公开访问** | 通过公开 URL 暴露沙箱内运行的服务 | [公开 URL](/docs/agent-sandbox/network/public-url.md) |
| **数据持久化** | 暂停并恢复沙箱，保留完整运行状态 | [持久化](/docs/agent-sandbox/sandbox/persistence.md) |
| **快照** | 从运行中的沙箱创建可复用的时间点快照 | [快照](/docs/agent-sandbox/sandbox/snapshots.md) |
| **多地域切换** | 支持在不同地域创建沙箱 | [切换地域](/docs/agent-sandbox/product/region.md) |
| **E2B 兼容** | 使用现有 E2B SDK 无缝接入 | [E2B 兼容模式](/docs/agent-sandbox/product/e2b-compatibility.md) |

---

## 典型应用场景

- **AI Agent 代码执行**：安全运行 LLM 生成的代码，隔离风险
- **自动化测试**：在隔离环境中运行测试用例
- **数据分析**：提供预装分析工具的沙箱环境
- **教育培训**：为学员提供独立的实验环境

> 更多最佳实践请参阅 [远程开发环境](/docs/agent-sandbox/best-practices/codeagent.md)、[远程代码执行器](/docs/agent-sandbox/best-practices/code-interpreter.md) 和 [远程桌面](/docs/agent-sandbox/best-practices/desktop.md)。

---

## 快速链接

| 类别 | 链接 |
|-----|------|
| **入门** | [前置条件](/docs/agent-sandbox/product/prerequisites.md) · [SDK 快速开始](/docs/agent-sandbox/product/quickstart.md) · [CLI 指南](/docs/agent-sandbox/product/cli.md) |
| **沙箱** | [生命周期](/docs/agent-sandbox/sandbox/lifecycle.md) · [持久化](/docs/agent-sandbox/sandbox/persistence.md) · [快照](/docs/agent-sandbox/sandbox/snapshots.md) |
| **模板** | [快速开始](/docs/agent-sandbox/template/quickstart.md) · [定义模板](/docs/agent-sandbox/template/defining-template.md) · [模板示例](/docs/agent-sandbox/template/examples/claude-code.md) |
| **参考** | [计费说明](/docs/agent-sandbox/product/fee.md) · [配额说明](/docs/agent-sandbox/product/ratelimit.md) · [E2B 兼容模式](/docs/agent-sandbox/product/e2b-compatibility.md) |