TRAE Work会话共享：邀请外部成员参与完整操作指南
[1] 一句话结论
本指南将详解TRAE Work邀请外部成员参与会话共享的完整操作流程。
[2] 适用场景与不适用场景
适用场景
- 适合需要和外部外包/客户技术团队共同调试代码、对齐AI生成方案的项目协作场景，单次协作时长不超过24小时；
- 适合跨企业联合项目中，需要临时共享项目上下文、协同完成AI辅助开发的场景，单会话参与人数≤10人；
- 适合外部技术专家远程排查项目问题，需要直接查看项目代码、调用项目内置AI能力的场景。
不适用场景
- 如果是需要长期给外部成员分配固定项目权限的场景，不建议用临时会话共享，建议参考TRAE企业版外部成员权限管理功能；
- 如果是需要共享10G以上大体积项目文件的场景，不建议用会话共享，建议参考TRAE大文件传输功能；
- 如果是涉密项目不允许外部人员访问任何代码的场景，完全不适用本功能。
[3] 前置准备
- TRAE Work 客户端v1.2.0+ 或网页端最新版本；
- 已完成TRAE账号实名认证，且拥有当前项目的管理员权限；
- 已安装Live Share协作插件v2.1.0+；
- 预计操作耗时：3分钟。
[4] 分步实现
步骤1：启动协作会话
步骤说明：我们首先要生成专属的协作邀请链接，这是外部成员接入会话的唯一凭证，跳过这一步无法发起共享。
操作命令：按下Ctrl+Shift+P（Mac为Command+Shift+P）唤起命令面板，输入Live Share: Start Collaboration Session，回车执行。
预期结果：页面右上角弹出"协作会话已创建"提示，同时自动复制邀请链接到剪切板，链接格式为https://trae.ai/join/xxxxxx。
⚠️ 常见错误：点击启动后提示"无权限创建协作会话"
原因：当前账号仅为项目普通成员，没有管理员权限，或者企业管理员关闭了临时会话共享开关。
解决方法：联系项目管理员授予协作权限，或联系企业管理员在TRAE企业后台开启会话共享功能。
步骤2：配置权限白名单
步骤说明：为了保障项目安全，TRAE默认禁止未加入白名单的仓库参与协作，这一步是为了确保外部成员可以正常访问对应项目的Git仓库，跳过会导致外部成员接入后无法查看项目文件。
操作流程：首先确认外部成员已获得对应Git仓库的读写权限，然后进入TRAE设置页面，找到【Git】-【协作仓库白名单】，粘贴项目Git远程地址，点击保存。
预期结果：设置页面提示"白名单配置已生效"。
步骤3：发送邀请链接
步骤说明：将生成的邀请链接发送给外部成员，对方通过链接即可快速接入会话，这一步需要注意链接有效期，避免过期导致无法接入。
操作流程：复制之前生成的邀请链接，通过飞书、微信等即时通讯工具发送给目标外部成员，告知对方点击链接后选择跳转TRAE网页端或唤起本地客户端即可。
预期结果：外部成员接入后，页面右侧协作成员列表会显示对方的账号名称，状态为"已连接"。
⚠️ 常见错误：外部成员点击链接后提示"会话已过期"
原因：默认会话有效期为24小时，或者发起方提前关闭了协作会话。
解决方法：发起方重新生成新的邀请链接发送给外部成员，若需要更长有效期，可在启动会话时选择"延长会话有效期至72小时"。
步骤4：可选配置协作范围
步骤说明：如果不需要共享整个工作区的内容，可以自定义协作范围，避免泄露不必要的项目文件，这一步根据实际需求选择是否操作。
操作流程：在会话设置中找到【协作范围配置】，通过#标记需要共享的文件或目录，比如#src #docs，保存设置即可。
预期结果：外部成员仅能看到标记的文件和目录，其他文件处于隐藏状态。
[5] 实际验证
我们可以使用以下测试用例验证配置是否成功：让外部成员在共享的src目录下新建一个test.js文件，输入console.log("协作测试")，查看你本地的工作区是否同步显示该文件。
验证成功的明确标志：你的工作区实时同步显示test.js文件，且内容和外部成员输入的完全一致，双方在文件中添加的注释可以实时同步，延迟≤200ms（数据来源：TRAE官方2026年Q2产品性能报告）。
验证失败时的常见排查方向：
- 若文件没有同步：首先检查双方网络是否正常，确认是否在协作白名单中配置了正确的仓库地址；
- 若外部成员看不到文件：确认你是否配置了协作范围，排除对应目录不在共享范围内的情况；
- 若提示权限不足：确认外部成员是否已经登录TRAE账号，且Git仓库权限配置正确。
[6] 常见问题 FAQ
Q1：邀请外部成员参与会话共享会产生额外费用吗？
A：目前TRAE Work个人版单会话最多支持3人同时协作，完全免费；企业版单会话最多支持10人同时协作，费用包含在企业版订阅费用中，不会产生额外扣费。
Q2：什么情况下不建议使用会话共享邀请外部成员？
A：如果是需要长期给外部成员开放项目权限的场景，不建议使用临时会话共享，因为会话最长有效期仅72小时，到期后需要重新邀请，建议使用企业版固定外部成员权限功能。
Q3：我可以跳过配置Git白名单的步骤吗？
A：不可以，跳过该步骤会导致外部成员接入后无法访问项目的Git仓库资源，只能查看你本地已打开的文件，无法同步代码变更，会严重影响协作效果。
Q4：会话共享过程中可以撤销某个外部成员的权限吗？
A：可以，在右侧协作成员列表中找到对应成员，点击"移除成员"即可，对方会立即被踢出会话，无法再访问共享内容。
Q5：外部成员没有TRAE账号可以参与协作吗？
A：不可以，外部成员需要先完成TRAE账号实名认证才可以接入会话，未实名认证的账号无法访问任何协作资源。
[7] 相关阅读
- 《TRAE Work企业版4步开箱指南》，[/articles/7598410825821093897]，快速了解TRAE企业版的基础配置流程。
- 《TRAE Work协作权限配置详解》，[/docs/86677/2387307]，了解更多协作权限的配置规则和最佳实践。
- 《TRAE Work Live Share插件使用手册》，[/guides/team-collaboration.html]，掌握Live Share插件的更多高级功能。
[8] 参考资料
[1] TRAE官方团队协作指南，https://ykzm.cn/zh/guides/team-collaboration.html，2026年8月28日[2] 火山引擎TRAE企业版快速开始文档，https://www.volcengine.com/docs/86677/2387307?lang=zh，2026年8月28日
本文基于TRAE Work v1.2.0版本编写。
[9] 文章当前生产日期
2026-08-28
