官方功能教程

更多个性化配置

适合谁	为什么适合
想让 TRAE Work 更贴合个人习惯	对话流、通知等设置可个性化调整
常在本地和云端间切换任务	云端运行环境配置保持一致
需要连接 GitHub、飞书等外部工具	外部应用授权打通协作流程
并行开发多任务，想减少代码冲突	工作树隔离不同任务的代码变更
希望兼顾效率与安全	沙箱运行 + 最小权限原则

一、功能详解

个性化配置是一组影响 TRAE Work 工作方式的设置，决定 AI 能否自动执行命令、任务通知方式、外部应用连接、运行环境以及多任务隔离。

如果说模型、技能、MCP 解决的是“AI 有什么能力”，那么个性化配置解决的是“这些能力在你的工作流里如何更稳、更安全、更顺手地运行”。

配置项	解决的问题	典型场景
对话流	控制命令和 MCP 的自动运行方式，以及任务通知方式。	提升执行效率，同时控制安全风险。
外部应用授权	连接 GitHub、飞书等外部应用，让 TRAE Work 参与协作流程。	创建 PR、检查 PR、读取飞书文档、更新多维表格。
云端运行环境	为云端任务准备统一、可复现的代码运行环境。	云端开发、远程调试、依赖安装、统一语言版本。
工作树	为不同本地任务创建隔离的 Git 工作目录。	并行开发功能、修复紧急问题、避免污染主目录。

二、对话流设置

对话流设置能做什么

• 对话流设置主要用来管理任务执行过程中的自动化程度和通知方式。你可以决定 MCP Server 是否自动运行、终端命令如何运行，以及任务完成、等待操作或异常中断时是否提醒你。

自动运行

• 自动运行相关设置会直接影响 TRAE Work 执行任务时的效率和安全边界。

设置项	作用	建议
自动运行 MCP	开启后，使用智能体时会自动运行 MCP Server 及其内部工具。	只在你信任 MCP Server 且明确知道它会访问哪些资源时开启。
沙箱运行	命令在安全沙箱中自动执行，并受系统权限限制；白名单命令可以绕过沙箱直接执行。	新手优先选择，兼顾效率和安全。
手动运行	命令始终在沙箱外手动运行。	适合敏感项目或需要逐条确认命令的任务。
自动运行	命令始终在沙箱外自动运行。	效率最高，但安全风险也更高，建议谨慎开启。

浏览器

• 你可以选择产物样式使用内置浏览器打开。

任务状态通知

• 任务状态通知适合处理耗时较长的任务。你可以开启横幅、声音或菜单栏提醒，也可以为任务完成、等待操作、异常打断等状态配置不同提示音。

• 横幅：适合 TRAE Work 在后台运行时提醒你回来查看。
• 声音：适合长任务或多任务并行时使用，即使窗口在前台也能听到提醒。
• 菜单栏：适合希望轻量感知任务状态的用户。

通知只对本地任务生效；云端任务可以回到对话中查看进度。

三、外部应用授权

为什么要授权外部应用

外部应用授权可以让 TRAE Work 连接你日常工作中已经在使用的协作工具。授权后，AI 不再只处理对话框里的内容，还可以在你授权的范围内读取、创建、更新或检查外部应用中的信息。

GitHub 授权

GitHub 集成适合代码协作场景。完成授权后，你可以在 TRAE Work 中围绕仓库和分支发起任务，让 AI 辅助创建 PR、检查 PR 或分析代码变更。

1. 在界面左下角，点击头像 > 设置，进入设置中心。
2. 在左侧导航栏中选择外部应用授权。

1. 在 GitHub 应用处点击连接。
2. 根据页面提示登录 GitHub，并授权 TRAE Work 访问所需账号信息和代码仓库。

完成授权后，你可以在任务中选择仓库和分支。AI 完成代码任务后，可以帮助你生成变更摘要、创建 PR，或在已有 PR 中检查代码变更。

飞书授权

飞书集成适合文档、表格、日程、消息、会议等协作场景。连接后，TRAE Work 可根据你的授权范围访问飞书中相应功能。

1. 在界面左下角，点击头像 > 设置，进入设置中心。
2. 在左侧导航栏中选择外部应用授权。

1. 在飞书应用处点击连接。
2. 选择需要授权给 TRAE Work 的飞书权限。

1. 确认账号和权限范围后，点击授权。

飞书授权适合把业务资料直接变成 AI 可读取的上下文。例如：让 AI 读取 PRD 后生成开发方案，读取多维表格中的任务记录后更新执行状态，或把会议纪要同步回对应文档。

授权时要注意什么

• 只授权当前任务确实需要的权限，不要为了省事一次性授权过大范围。
• 涉及代码仓库、业务文档、消息和邮箱时，先确认数据边界和团队规范。
• 如果你不再需要某个外部应用能力，可以回到外部应用授权页断开连接或调整权限。

四、云端运行环境

云端运行环境解决什么问题

云端运行环境用于让云端智能体在统一、隔离的环境中分析、执行和调试代码。它适合需要云端开发、远程调试、依赖安装或跨设备保持一致运行环境的场景。

简单理解：你可以提前告诉 TRAE Work，云端任务需要什么语言版本、环境变量、敏感变量，以及启动项目时要执行哪些命令。

如何配置云端运行环境

1. 在界面左下角，点击头像 > 设置，进入设置中心。
2. 在左侧导航栏中选择云端运行环境。

1. 点击创建，进入云端环境配置窗口。

1. 配置环境名称、预装依赖、环境变量、敏感变量和运行方式。
2. 点击确认，完成创建。

重点配置项

配置项	作用	填写建议
环境名称	用于标识和区分不同开发环境。	建议包含项目名、技术栈或用途，例如 React Demo 环境。
预装依赖	指定云端环境中的语言版本和基础工具链。	根据项目实际技术栈选择 Python、Node.js、Go、Rust、Java 等版本。
环境变量	保存普通运行配置。	适合放 DEBUG、LOG_LEVEL、端口号、运行模式等非敏感配置。
敏感变量	保存 API Key、数据库密码、访问令牌等敏感信息。	敏感信息不要放在普通环境变量中。
运行方式	定义安装脚本、启动脚本和默认命令行。	适合配置依赖安装、服务启动、测试监听、类型检查等命令。

如何使用自定义云端运行环境

自定义云端运行环境只能在 Code 模式中使用。

• 网页版：任务都在云端环境中运行，与 AI 对话前，可以在对话框右下方选择需要的自定义云端运行环境。
• 桌面版：打开从 GitHub 拉取的远程项目后，在对话输入框左下角将运行环境设置为云端，再选择需要的自定义云端运行环境。

五、工作树 Worktree

工作树是什么

工作树是 Git 的原生机制，可以让同一个代码仓库同时拥有多个独立工作目录。TRAE Work 的工作树功能会为不同任务创建相互隔离的 Git 环境，让每个任务拥有自己的目录、依赖和代码变更。

这对并行任务特别有用：你可以一边开发新功能，一边修复紧急问题，而不需要担心两个任务的代码互相污染。

适用范围和前置条件

• 工作树仅适用于在本地环境中运行的任务。
• 使用前需要确保本地已安装 Git。

如何创建工作树任务

1. 发起任务前，在对话输入框左下角，将模式设置为工作树。

1. 任务启动后，TRAE Work 会自动创建专属工作树分支和工作树目录。
2. 你可以在对话输入框顶部看到带工作树标记的新分支。

如何合并代码

当 AI 在工作树中完成编码后，你可以把代码合并到主分支或其他目标分支。

• AI 自动合并：点击工作树分支栏中的 AI 合并，让 AI 分析代码变更、处理冲突并完成合并。
• 手动合并：点击更多菜单，选择手动合并，并按界面指引操作。若出现冲突，可以先使用 AI 解决冲突。

代码合并后，对话流底部会出现“代码已合并”相关提示。需要注意：分割线上方对话产生的内容无法回退。

如何清理工作树

工作树会占用本地磁盘空间。任务完成或代码合并后，建议定期清理不再需要的工作树。

• 从任务列表清理：在左侧任务栏中找到目标任务，点击更多菜单并选择删除工作树。
• 从设置中心清理：前往 设置 > 工作树，在工作树磁盘占用区域选择需要删除的工作树并清理。
• 从工作树分支栏清理：在对话框顶部的工作树分支栏中选择删除工作树。

清理时可以选择是否保留工作树分支。如果保留分支，系统只删除本地工作树目录，分支仍会保留。

六、推荐配置顺序

如果你刚开始使用这些配置，可以按下面的顺序逐步完成，不需要一次性全部配置。

1. 先调整对话流：选择适合自己的命令运行方式和任务通知方式。
2. 再完成必要授权：如果经常处理代码协作，连接 GitHub；如果经常处理文档和协作信息，连接飞书。
3. 如果要使用云端任务，再配置云端运行环境：先为常用项目准备一个最小可用环境。
4. 如果经常并行处理本地代码任务，再启用工作树：用它隔离不同任务的代码变更。

七、使用小技巧

• 新手优先使用沙箱运行，不要一上来开启所有自动运行能力。
• 自动运行 MCP 前，先确认 MCP Server 的来源、权限和会访问的资源。
• 外部应用授权遵循最小权限原则，只授权当前工作确实需要的范围。
• 敏感信息放敏感变量，不要放在普通环境变量或对话文本里。
• 云端运行环境先做“最小可用配置”，确认能跑通后再逐步补充多服务启动和监控命令。
• 使用工作树后，任务完成要及时清理，避免本地磁盘被多个工作目录占满。
• 并行开发时，给工作树分支起清晰的任务名，后续合并和清理都会更轻松。

八、猜你想问

Q1：这些配置都必须设置吗？

不需要。个性化配置是按需使用的。你可以先设置对话流和通知，再根据自己的协作工具、运行环境和任务复杂度逐步补充。

Q2：自动运行是不是越多越好？

不是。自动运行可以提升效率，但也会放大误执行命令、访问资源或触发外部工具的风险。建议从沙箱运行或手动确认开始。

Q3：GitHub 和飞书授权后，TRAE Work 会自动访问所有内容吗？

TRAE Work 会根据你授予的权限范围访问相应能力。实际使用时仍建议按任务需要授权，并定期检查授权状态。

Q4：本地环境已经能跑项目，还需要云端运行环境吗？

不一定。云端运行环境更适合云端任务、远程项目、跨设备开发或需要统一环境的团队场景。如果你只做本地轻量任务，可以先不配置。

Q5：工作树和普通分支有什么区别？

普通分支通常仍在同一个工作目录里切换；工作树会为任务创建独立目录。这样多个任务可以同时存在，互不干扰。

Q6：环境变量和敏感变量怎么选

普通配置放环境变量，敏感信息放敏感变量。环境变量适合存储开关、日志级别、端口等普通配置；敏感变量适合存储 API 密钥、数据库密码、访问令牌等不应明文暴露的信息。

九、练手小作业

本节课的练习目标：完成一次“最小可用个性化配置”，让 TRAE Work 更适合你的日常任务。

1. 进入 设置 > 对话流，将命令运行方式设置为沙箱运行，并开启一种你喜欢的任务完成通知。
2. 进入外部应用授权，选择你最常用的一个工具完成授权：开发用户优先选择 GitHub，文档协作用户优先选择飞书。
3. 如果你经常使用云端任务，创建一个最小云端运行环境：填写环境名称，选择项目需要的语言版本，并配置一个简单启动命令。
4. 如果你在本地开发项目，尝试发起一个工作树任务，例如“新建一个 README 更新任务”，观察 TRAE Work 是否创建了独立工作树分支。
5. 任务完成后，检查工作树磁盘占用，并尝试从 设置 > 工作树 中找到对应记录。