本地版
什么是本地版？
本地版是 302 AI Studio 提供的本地化运行环境，通过 Docker 容器技术将 Agent 部署在您的本地计算机上。相比云端版本，本地版让您拥有更快的响应速度和更强的数据掌控力。
为什么使用容器而不是直接使用 Claude Code?
- 沙盒隔离 - 容器类似一个独立的沙盒环境，AI 执行的所有操作都被限制在容器内部，即使 AI 代码存在问题或执行危险操作，也不会影响你的真实系统
- 目录挂载 - 我们的工作目录是通过挂载方式映射到容器中的，你可以自由选择要共享给 AI 的文件夹，其他文件夹对 AI 完全不可见，有更好的隐私保护
- 权限控制 - 容器内的 AI 执行环境拥有受限的权限，无法访问你的敏感文件、系统配置或网络凭证
- 环境一致性 - 容器提供统一的运行环境，确保 AI 代码在任何机器上都能以相同的方式运行，避免"在我的机器上能跑"的问题
- 资源限制 - 可以精确控制 AI 任务能使用的 CPU、内存和磁盘资源，防止失控的代码占满你的系统资源
- 便于清理 - 所有 AI 执行痕迹、临时文件、安装的依赖都包含在容器中，关闭客户端时可以快速完全清理，不留残留
工作原理
本地版通过以下技术实现：
- 容器化部署：使用 Podman 作为容器引擎，运行预打包的 Agent 服务镜像
- 本地服务：Agent 服务运行在本地，通过 localhost 访问
- 自动管理：客户端自动管理容器的启动、停止和资源分配
适用场景
本地版特别适合以下使用场景：
| 场景 | 说明 |
|---|---|
| 高频使用 | 需要频繁使用 AI 功能，追求极致响应速度 |
| 数据隐私 | 对数据隐私有严格要求，希望数据不离开本地 |
| 离线使用 | 在网络不稳定或需要离线工作的环境中使用 |
| 开发调试 | 开发者需要本地调试和测试 AI 功能 |
注意事项
本地版需要在您的计算机上安装 Podman 和 Docker Compose。首次启动时会自动下载所需的容器镜像，请确保有足够的磁盘空间（建议至少 10GB）和稳定的网络连接。
本地版会占用一定的系统资源（CPU、内存、磁盘），建议在配置较高的计算机上使用。推荐配置：8GB 以上内存，4 核以上 CPU。