TraeWork 的云端运行环境：任务在云上跑意味着什么
一、先说清楚这个开关是给谁准备的
如果你让一个智能体改代码，绕不开一个很现实的问题：它到底在哪台机器上跑这份代码。
在本机跑，好处是你熟悉那台机器；坏处也很直接——项目依赖装在你的机器上，Node 版本是你三个月前定的，Python 虚拟环境是同事帮你建的，换一台机器就复现不出来。你自己一个人开发时这不是问题，但一旦让智能体去「跑一下、看报错、再改」这种循环，本机环境的历史包袱就会变成排查噪音：到底是代码错了，还是你这台机器上少装了一个东西。
TraeWork 的官方文档《云端运行环境》把这件事说得比较直白。文档写明，云端智能体为了提供基于云的代码分析、执行和调试，需要在你的活动会话期间临时存储和处理与会话相关的代码、配置和对话上下文，为此你需要配置自定义云端运行环境；文档自述这个功能适用于需要在云端隔离环境中运行代码、管理项目依赖、或与 AI 协作进行复杂调试的场景，解决的是本地环境不一致、资源受限的问题。
这段是官方的定位表述，我照抄不加工。要注意它把「隔离」和「一致」放在一起讲——真正对你有意义的那部分收益，是每次开会话都从同一个镜像和同一份配置起步，而不是「云上就一定更快」。速度、资源规格这类事，我们在文档里没有找到可核对的说明，所以本文一个字都不写。
二、官方文档写明的配置方式
文档给出的配置入口路径是：在界面左下角点击头像，进入设置，在左侧导航栏选择「云端运行环境」，进入配置面板后在右上角点击「创建」，填完配置点「确认」。我们没有开通这个产品，界面长什么样、按钮什么形状一概不写，上面这条路径是照抄文档里的步骤描述，你可以拿它去帮助中心里对照。
创建时的参数，文档列了五项：
| 参数 | 文档里的说明 |
|---|---|
| 环境名称 / Environment Name | 环境的基本信息，用于标识和区分不同的开发环境 |
| 预装依赖 / Preinstalled Packages | 定义基础镜像和预装的语言版本，是云端环境的基础系统 |
| 环境变量 / Environment Variables | 程序运行时的配置，保存接口地址、运行模式这类普通配置 |
| 敏感变量 / Sensitive Variables | 存储敏感信息，文档提示所有敏感变量都会被加密存储、仅在运行时使用 |
| 运行方式 / Runtime Configuration | 项目需要指定启动命令时在这里设置，文档举的例子是 npm run dev |
预装依赖这一块，配置项叫 preinstalled_packages，文档列出了八种语言及其字段名与支持版本：Python（python_version，3.10 到 3.14）、Node.js（node_version，18/20/22/24）、Go（go_version，1.22.12、1.23.8、1.24.3、1.25.1）、Rust（rust_version，1.83.0 ~ 1.92.0）、Java（java_version，11/17/21/22/23/24/25）、Ruby（ruby_version，3.2.3、3.3.8、3.4.4）、PHP（php_version，8.2 到 8.5）、Swift（swift_version，5.10、6.1、6.2）。文档还写明：未手动指定版本时默认使用最新版本；手动指定的版本必须是支持的版本；可以通过 GET /api/v1/environment_configs/supported_versions 获取最新支持的版本列表。
运行时配置里有三个脚本位，各自的限制文档写得很清楚，这是全篇最值得记住的一张表：install 是环境启动时自动执行的命令，触发时机是代码 clone 完成后、阻塞执行等待完成，命令长度不得超过 10KB；start 在依赖安装完成后执行，后台执行不阻塞，长度同样不得超过 10KB；terminals 是与主程序并行运行的后台任务，文档说最多同时打开 10 个终端，命令长度不得超过 4KB，并且所有终端并行启动、无先后顺序。文档同时给出了顺序图和三条注意事项，其中一条是 install 失败会阻断后续步骤。
这三行的实际含义值得展开一句：install 是唯一阻塞的一步，所以把「必须成功才有意义」的动作放在这里；start 和 terminals 都是长时间运行的进程（文档原话），意味着你在这两处写的东西不会「跑完就结束」。
使用侧，文档写明一条硬限制：自定义云端运行环境只能在 Code 模式中使用。两个端的用法也不一样——网页版的任务皆在云端环境中运行，因此与 AI 对话前可以直接在对话框右下方选择所需的自定义环境；桌面版同时支持本地环境和云端环境，文档给出的步骤是先打开一个从 GitHub 拉取的远程项目，再在对话输入框左下角把运行环境设置为「云端」，然后选择所需的自定义环境。
三、边界在哪：三处「暂不支持」和一份数据声明
这一段是本篇真正的重点。云端环境最容易踩的不是配置写法，而是你以为能改、实际上文档明说改不了的东西。
第一处，基础镜像不能自定义。 文档写明 TraeWork 官方构建并维护了一个 all-in-one 通用容器镜像，预装了常见的工具链和语言生态；紧接着的提示框写的是「暂不支持由用户自定义容器镜像」，并举例说明包括通过 container_image 字段来指定镜像地址（如 universal:latest）这种方式。也就是说，你能选语言版本，但换不掉底座。如果你的项目依赖某个必须预置在镜像层的系统组件，这条限制会直接咬到你——文档里能核到的可写入口只有运行时配置那三个脚本位，除此之外有没有别的办法，官方文档没有说明这一点。
第二处，网络策略不能自定义。 文档在「网络策略配置」这一节同样挂了「暂不支持由用户自定义网络策略」的提示。文档说明网络策略用于控制沙箱的网络访问权限，目前通过 network_policy 对象限制出站流量，仅允许环境访问指定的常用依赖源，并且这个配置块是固定模式：mode 固定为 1 表示启用，allowlist_policy 固定为 0 表示使用 common_dependencies 列表作为白名单，common_dependencies 是允许访问的依赖源数组。文档列出的常用依赖源是 npm、pypi、maven、goproxy、rubygems、packagist、crates、docker、github、gitlab 这十项。所以云端环境的出站是走白名单的——你的 install 脚本如果要访问公司私有源或者某个不在这十项里的地址，文档没有给出可配置的口子。
第三处，变量有数量上限，而且两类变量不是一回事。 文档给的对比是：敏感变量走 KMS 加密存储，API 只返回 key 列表不返回值，最多 50 个，建议放 API 密钥、数据库密码、访问令牌；环境变量是明文 JSON 存储，API 返回完整 key-value，最多 100 个，建议放 DEBUG 开关、LOG_LEVEL、端口号这类。这里要盯住的是「API 返回完整 key-value」那一栏——把密钥填进环境变量而不是敏感变量，性质完全不同。
第四处，也是最该先读的一处：数据存在云上，而且存的不只是代码。 官方文档《云端智能体数据存储声明》写明，为确保云端智能体正常运行，系统需要在云端存储与当前会话相关的代码及配置数据，包括但不限于：你授权访问的代码仓库内容；系统运行所需的规则与状态数据，包括 MCP、规则、记忆、自定义运行环境、Hooks 及 Context 等；你的代码及其相关配置信息；与当前会话关联的其他必要信息。同一份声明承诺，上述数据仅用于维持产品功能的正常运行，绝不会用于任何模型训练。
关于保留期限，这份声明分了两种情况。若你未主动删除云端会话（Session），系统将在云端保存当前会话中拉取的代码数据、你与云端智能体的对话内容、会话中的上下文信息，以及会话维度的必要指标信息，声明说这是保障云端会话持续工作的必要技术行为。当你主动删除云端会话后，声明写明系统将永久删除与该会话相关的代码数据、历史对话内容、上下文信息和会话维度的指标信息，且不再保留。
把这两份文档摆在一起读，结论很清楚：删除动作是用户主动发起的，声明里我们没有找到「会话闲置多久后自动清理」这样的时限说明，它写的是「若你未主动删除云端会话，系统将在云端保存以下数据」，删除这个动作的发起方是你。这一点在你把内部仓库接上去之前值得先想明白。至于加密细节、存储区域、审计方式，官方文档没有说明这一点，我们不替它补。
四、什么时候值得开，什么时候不必
按文档里核得到的这些条件，可以倒推出几种场景。
值得开的情况：你要处理的是一个从 GitHub 拉取的远程项目，依赖装起来麻烦、多人协作时环境经常对不齐，而且你打算让智能体反复「跑—看错—改」；或者你的项目需要同时起前端、后端、数据库几个进程，正好对得上 terminals 那个并行终端位；再或者你主要在网页版用——文档写明网页版的任务本来就都在云端跑，配一个自定义环境等于给它一个像样的起点。
不必开的情况也很具体。第一，你用的不是 Code 模式——文档明写自定义云端运行环境只能在 Code 模式中使用，其它模式下不用纠结。第二，你的项目必须依赖特定的系统级组件或私有镜像，而 install 脚本补装不了——镜像自定义这条路文档说了暂不支持。第三，你的构建过程要访问白名单十项之外的地址，比如公司内网私服。第四，代码本身不允许离开你的环境——这时候要看的不是功能页而是那份数据存储声明，先过合规再谈好不好用。
最后提醒一句口径问题：TraeWork 仍在快速迭代，我们抓取的这两页文档顶部都挂着一条「以积分为核心的计费模式正式上线」的公告，功能项、参数限制与计费口径都可能随版本变动。上面这些数字（10KB、4KB、10 个终端、50 个 / 100 个变量、十项依赖源）我是逐个从官方文档抄下来的，你真要照着配之前，还是回帮助中心对一遍当前值。
本文依据 TraeWork 官方文档（docs.trae.cn）于 2026-08-17 的公开内容整理。
我们没有开通付费账号，也没有实际操作过该产品，因此不涉及界面外观、操作手感与生成质量的任何描述。
该产品仍在快速迭代，功能与计费口径随版本变动，文中涉及积分与套餐的表述均为复述官方文档原文，
请以官方最新公告与定价页为准。
安全与合规相关做法请结合自身环境评估，本文不构成安全方案建议。