2026 年 10 月 9 日,字节把 TraeWork 和 TraeCode 正式合并成全新 TRAE,升级为全链路开发平台。听起来是好事,但社区里第一批升级完的用户反馈很有意思:不少人打开新版,盯着默认出现的 Agent 工作区一脸茫然,想回熟悉的 IDE 模式又找不到入口——官方暂无更改默认启动模式的选项,切换引导也不明显。你花几小时升级,结果只学会了点下一步,那这次合并等于白升。
这篇 SOP 把升级后的全新 TRAE 从下载到用顺手拆成六步:认清双模式、跑通第一个 Agent 任务、试 SOLO 模式、装配工具、盘活产物中枢、打通三端同步。每一步都给你操作和预期结果,四个高频坑提前拆掉。合并事件本身的来龙去脉看这篇热点解析,本文只管怎么用。
适用前提先自查:
- 已从官网下载全新 TRAE:国内版 trae.cn,国际版 trae.ai,别从第三方渠道拿安装包;
- TraeWork 或 TraeCode 的老账号可直接登录,聊天记录、账号数据、登录状态、商业积分等自动迁移;
- TraeWork 用户需要手动升级客户端,TraeCode 用户会自动更新——推送是灰度分批,没收到更新属正常,别反复卸载重装。
第一步:认清双模式,别把 Agent 模式用成 IDE
操作:升级完首次打开 TRAE,你会先看到 Agent 工作区(社区反馈口径:这是默认入口)。花五分钟做两件事——找到 IDE 模式的切换入口并亲自切一次、切回来;把两种模式的分工写在便签上:
- Agent 模式:从想法拆解到交付结果,支持跨项目调度多个 Agent 并行,适合「我要一个能跑的登录页」这类目标式任务;
- IDE 模式:保留完整智能开发环境,适合单项目深度编码、调试、精细修改,顺带一提这轮 Cue 续写也升级了,能感知仓库上下文和编辑轨迹,Tab 快速应用多行编辑并给出 diff。
预期结果:你能在两种模式间自如往返,并且清楚哪些活归 Agent、哪些归 IDE。判断标准很简单:能一句话说清验收标准的目标式任务交给 Agent 模式;需要你逐行把关的重构和调试留给 IDE 模式。
别小看这一步。两种模式切换引导不明显是社区反馈的原话口径,很多用户升级一周还在用 IDE 模式硬扛本该交给 Agent 的活。选型逻辑上如果你还在纠结「要不要用 AI IDE」,可以看这篇AI 编程 IDE 横评,这里默认你已经决定用 TRAE。
第二步:Agent 模式跑通第一个任务
操作:在 Agent 工作区用自然语言描述一个完整目标,建议第一次就选四段式任务,把全链路跑一遍。示例指令可以直接照抄:
「帮我做一个团队介绍页面:先拆解需求,列出页面需要哪些模块;然后搭页面,风格简洁;搭完跑一轮测试,检查链接和响应式;最后整理一份简要文档说明怎么修改内容。」
预期结果:Agent 按阶段推进——需求拆解清单、页面代码、测试结论、文档,四样东西都会出现在会话里和产物区。中间它会向你确认关键决策,比如技术栈选择;你的回复越明确,返工越少。
这一步有两个实操细节值得说。第一,指令里把验收标准写死,比如「响应式要在手机宽度下不横向滚动」,比写「做好一点」有效得多——Agent 不读心,它只执行写得清的标准。第二,尝试跨项目并行:再开一个项目的 Agent 任务让它同时推进,这是合并版 TRAE 相比旧版的实质增量,官方口径是支持跨项目调度多个 Agent 并行。
跑完这轮你会有个直观判断:哪些环节 Agent 干得好(页面搭建、文档整理),哪些环节需要你盯紧(测试结论要人工复核)。如果你想横向了解各家编码 agent 的能力边界,看这篇AI 编码 agent 横评。
第三步:SOLO 模式,让 agent 独立推进
操作:当任务链路长、你又不想中途反复被打断时,切换到 SOLO 模式。SOLO 内置专属 Coding Agent,能理解目标、规划任务、调度工具,独立推进各阶段开发。给它一个阶段性目标而非每一步指令,比如「把这个模块的接口从 v1 迁到 v2,保证现有测试全部通过」。
预期结果:SOLO 自己拆任务、自己调工具、自己推进,只在关键节点产出结果。你从「逐步指挥」变成「看阶段产出」。
什么时候用 Agent 模式、什么时候用 SOLO?经验口径:需求还模糊、需要你边看边调的用 Agent 模式;目标清晰、路径明确、你想整体甩出去的用 SOLO。第一次用 SOLO 别接太重要的活,拿一个有完整测试覆盖的模块练手——测试通过与否是最诚实的验收标准,比你自己逐行看代码靠谱。另外给 SOLO 的目标里写清楚约束条件,比如改动范围、不能动的文件、依赖版本,约束写得越细,它跑偏后你回收的成本越低。想了解整个 coding agent 生态里 SOLO 这类产品的位置,看这篇编码 agent 生态盘点。
第四步:装配工具,MCP 外部工具与 TRAE Rules
操作:默认配置下的 TRAE 像一台没装附件的机器,这一步给它上配件,分两件事。
第一件,接入 MCP 外部工具。在设置里找到 MCP 装配入口,按你自己的工作流添加服务器——要查数据库就接数据库的 MCP,要发消息就接 IM 的 MCP,要读文档就接文档的 MCP。MCP 协议本身和自建服务器的方法,看这篇MCP 服务器开发 SOP,那边教你从零写一个。
第二件,写 TRAE Rules。把你团队的工作规则配置进去,比如「提交前必须跑 lint」「注释用中文」「不要自动删除测试用例」。
预期结果:配好 MCP 后,Agent 在任务里能主动调用外部工具而不是只会写代码;配好 Rules 后,产出物风格稳定,不用每次在对话里重复交代。验证方法:丢一个会用到外部工具的任务给 Agent,观察它是否调用了你装的 MCP;再让它写一段代码,看输出是否符合你 Rules 里定的规范。
这一步是「调教」的核心。官方给的只是能力,MCP 和 Rules 才是你把它从通用工具改成你专属工具的两根旋钮。
第五步:产物中枢与自动化任务
操作:打开项目产物中枢。合并版 TRAE 把代码变更、HTML、PPT、Word、图片、视频、报告集中放在这里查看和迭代,不用在多个工具间来回切换。接着配置一个自动化任务——官方场景包括周报、例行检查、测试汇总、报告生成,选一个你每周手动做的事,比如周报,设定触发节奏。
预期结果:过去散落各处的交付物现在有一处集中入口,改 PPT、迭代 HTML 都在 TRAE 里完成;到点,自动化任务自动产出周报初稿,你从「写周报」变成「改周报」。
这一步的价值常被低估。很多用户把 TRAE 只当代码工具,但合并后的定位是全链路开发平台——需求文档、演示文稿、测试报告都是产物,都值得进中枢。实操建议:先把你手头项目的交付物全部过一遍,能搬进 TRAE 的搬进来,一周后你对「平台」两个字会有实感。
第六步:三端同步,把碎片时间接进工作流
操作:在手机端登录同一账号,装好移动端应用。然后跑一个真实的完整流程:早上在桌面端启动一个长任务,比如让 Agent 迁移一个模块;中午通勤时在手机上查看进度,补充一条要求,比如「接口命名统一换成驼峰」;晚上回桌面继续推进。
预期结果:任务状态三端一致——桌面启动的进度手机能看到,手机补充的要求回桌面后已生效。你的一天里,等会议、通勤、午休这些碎片时间第一次能参与开发流程。
三端同步是官方「一个入口、两种模式、三端同步」框架的第三块,也是合并版区别于纯 IDE 工具的分水岭。用顺了之后你会发现,启动任务的时机和检查任务的方式都变了——大块时间留给判断,碎片时间留给补要求。
四个坑,提前拆
坑一:TraeWork 将于 2026 年 10 月 23 日停止服务。 这是 pandaily 引官方文档的口径,未升级的 TraeWork 用户届时将失去访问。别拖到最后一周,现在就升级——留给你的操作窗口以天计。
坑二:升级过程中别关窗口。 数据迁移是自动完成的,聊天记录、账号数据、个人资料、登录状态、本地数据、商业积分都完整保留,但迁移期间强退或断网,出问题最麻烦的就是数据完整性。升完先核对老数据都在,再开始干活。
坑三:没收到更新属正常。 推送是灰度分批,TraeCode 用户自动更新有先后,TraeWork 用户手动升级则看客户端提示。没收到就去官网下最新版,别因为「别人有了我没有」反复卸载重装,反而把迁移搞乱。
坑四:模式切换引导弱,自己建肌肉记忆。 社区反馈原话口径:升级后默认打开 Agent 工作区、IDE 模式要手动切、暂无更改默认启动模式的选项、切换引导不明显。官方后续大概率会优化,当下你只能自己适应:记住切换入口的位置,把 IDE 模式的入口路径写进你的 TRAE Rules 或团队文档里,新同事入职少踩一遍。
FAQ
Q1: 升级后我的聊天记录和商业积分还在吗? 在。官方口径是数据迁移自动完成,聊天记录、账号数据、个人资料、登录状态、本地数据、商业积分完整保留。升级完成后先核对再开始工作。
Q2: TraeWork 什么时候停服?我必须升级吗? 2026 年 10 月 23 日停止服务,pandaily 引官方文档口径。不升级将失去访问,这不是可选项,只是早升晚升的区别。
Q3: 打开就是 Agent 工作区,怎么回到 IDE 模式? 在界面中手动切换到 IDE 模式。社区反馈暂无更改默认启动模式的选项,所以每次启动后需要手动切一次,这是当前版本的真实体验,不是你的操作问题。
Q4: 没收到自动更新怎么办? 推送是灰度分批,没收到属正常。TraeWork 用户去官网手动升级客户端,或直接从 trae.cn 下载全新版安装。
Q5: MCP 工具和 TRAE Rules 必须配吗?不配能用吗? 不配也能用,Agent 模式开箱即可跑任务。但配了差别很大:MCP 决定 Agent 能调哪些外部工具,Rules 决定产出风格是否稳定。用两周后再回头看,你大概率会补上这两样。
六步走完,全新 TRAE 的主线功能你就都摸过了:双模式各司其职、Agent 跑通全链路、SOLO 独立推进、MCP 与 Rules 完成调教、产物中枢收拢交付物、三端同步接上碎片时间。两个日期值得设提醒:10 月 23 日 TraeWork 停服(pandaily 引官方文档口径),以及你自己的「两周复盘点」——届时根据实际使用决定 MCP 和 Rules 再加什么。
TRAE 官网:trae.cn(国际版 trae.ai);官方社区公告见 forum.trae.cn/t/topic/183224。功能以官方文档为准,灰度期间界面细节可能随版本微调,以你手上的实际版本为准,本文口径截至 2026 年 10 月 11 日。