沙箱

沙箱为智能体生成的命令提供受限的执行环境，确保智能体在安全隔离的环境中运行命令，防止未经授权的文件访问。

支持的操作系统

macOS

TRAE Work 桌面版：Code 模式

安全策略

云端任务

在 TRAE Work 桌面版 Code 模式中，所有云端任务均运行于独立的安全沙箱容器内。每个云端会话拥有隔离的运行环境（包括磁盘、缓存等资源），以确保会话之间互不干扰。

在云端会话中，智能体执行命令时的文件访问权限默认遵循 “自动运行”（Auto-Run）模式的策略。

启用沙箱后，智能体的文件访问范围将被严格限制在当前会话对应的沙箱容器内，无法访问宿主机或其他会话的数据。这种隔离机制确保了各会话的工作目录、临时文件、缓存及运行环境彼此独立，从而提升整体安全性与稳定性。

文件访问权限如下：

本地任务

对于 TRAE Work 桌面版 Code 模式中的本地任务，启用沙箱后，TRAE Work 的文件访问权限如下：

配置沙箱的运行环境

基于 macOS 的 sandbox-exec 工具，TRAE Work会自动为你创建一个受限的命令执行环境。你无需进行任何额外配置。

在 TRAE Work 中启用沙箱

在 TRAE Work 中启用沙箱后，智能体将自动在沙箱中运行命令。为 TRAE Work 启用沙箱的步骤如下：

你将进入设置中心。

你将进入对话流设置面板。

白名单中的命令将跳过沙箱，直接在沙箱外执行。

TRAE Work 桌面版：Work 模式

TRAE Work 桌面版的 Work 模式为你提供了一个安全、隔离的虚拟化运行环境，具有以下特点：

安全策略：文件访问控制

在 TRAE Work 桌面版的 Work 模式中启用沙箱后，TRAE Work 仅能读写当前项目的目录。

TRAE Work 网页版：Code 和 Work 模式

在 TRAE Work 网页版中，所有云端任务均运行于独立的安全沙箱容器内。每个云端会话拥有隔离的运行环境（包括磁盘、缓存等资源），以确保会话之间互不干扰。

安全策略：文件访问控制

在云端会话中，智能体执行命令时的文件访问权限默认遵循 “自动运行”（Auto-Run）模式的策略。

启用沙箱后，智能体的文件访问范围将被严格限制在当前会话对应的沙箱容器内，无法访问宿主机或其他会话的数据。这种隔离机制确保了各会话的工作目录、临时文件、缓存及运行环境彼此独立，从而提升整体安全性与稳定性。

文件访问权限如下：

命令的运行策略

普通命令

启用沙箱后，系统将根据命令是否在白名单内，决定其执行方式：

高风险命令

为了防范系统风险，当智能体生成 rm -rf 等高风险命令时，系统会拦截该操作并向你弹出提示。你可以选择：