必须开启专家模式并切换至办公任务模式,才能让项目在云端ubuntu沙箱中真正运行;需明确指令启用trae沙盒执行,支持python/node.js即时运行,但不支持编译型语言全流程及root操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想在豆包专业版里把写好的项目真正跑起来,而不是只看代码片段或静态预览,就得让项目进入沙箱系统执行。沙箱不是本地电脑,它是一台远程的、隔离的 Ubuntu 虚拟机,所有运行都发生在云端,不占你本地资源,但必须走对路径才能启动。
确认已开启专家模式并进入办公任务环境
打开豆包App或网页版,确保账号已开通专家模式——这是沙箱功能的前提,未开通则后续所有操作无效。进入对话界面后,找到输入框左下角的「快速」标签,点击切换为「办公任务」。此时你才正式接入沙箱运行环境,界面上会显示“当前处于办公任务模式”提示。
这一步不可跳过。如果还停留在「快速」或「聊天」模式,哪怕代码再完整,也只会被当作文本解析,不会触发任何执行动作。
用TRAE沙盒模式提交可执行代码
在办公任务模式下,直接输入你的项目需求,例如:“请用Python写一个HTTP服务器,监听端口8000,返回‘Hello from sandbox’”。豆包会生成代码并自动尝试在TRAE沙盒中运行。
但更可靠的方式是:先让豆包生成完整项目结构(含main.py、requirements.txt等),然后你明确追加指令:【请在TRAE沙盒环境中执行并返回运行日志】。这句话会强制模型启用实时执行通道,而非仅输出代码。
TRAE沙盒支持Python、Node.js、Shell脚本即时运行,但不支持编译型语言(如Go、Rust)的build+run全流程,也不支持需要root权限的systemd服务注册。
手动部署多文件项目到沙箱
方法一:用“上传文件”功能注入项目
点击输入框右侧的「+」→选择「上传文件」,一次最多传5个文件。上传后豆包会自动识别项目结构,若含requirements.txt或package.json,会主动执行pip install或npm install。注意:上传的.zip包会被解压,但层级不能超过3级,否则路径识别失败。
方法二:用shell命令逐层构建
第一步:输入mkdir -p myproject && cd myproject创建空目录;
第二步:用echo "print('ok')" > main.py写入Python文件;
第三步:输入python main.py执行。每条命令单独发送,不要合并成一行——沙箱命令行不支持&&链式执行。
方法三:调用内置模板快速初始化
直接说:“用Next.js模板新建一个项目”,豆包会调用MarsCode IDE后端,在沙箱中拉取官方模板、安装依赖、启动dev server。项目启动后,会在网络服务面板给出可访问的临时域名(如https://xxx.doubao.run),点击即可在浏览器中查看运行效果。
注意:MarsCode IDE创建的项目默认绑定沙箱生命周期,关闭对话或超时闲置15分钟后,进程会被回收,端口释放。如需长期运行,必须配合保活脚本或定时心跳请求。
查看运行结果与调试日志
项目启动后,豆包会在对话中嵌入「网络服务面板」组件,列出所有监听端口。点击端口右侧的「打开浏览器」按钮,即可访问沙箱内服务——该链接是反向代理地址,实际流量经火山引擎网关转发,不暴露真实IP。
若服务未响应,点开「日志」标签页,查看stdout/stderr输出。常见失败原因包括:端口被占用(沙箱只开放3000/5000/8000/8080)、缺少依赖(如requests未pip install)、代码抛出未捕获异常。此时可追加提问:“查看当前目录文件列表”或“运行pip list”,定位问题根源。
沙箱无文件持久化能力,每次新对话都是干净环境。若需保留数据,必须将结果输出为base64编码或通过curl上传至外部对象存储。











