引言​

TRAE是字节跳动推出的AI原生集成开发环境，基于VS Code内核深度构建。其核心价值在于三种渐进的协作模式（Chat/Builder/SOLO），完整覆盖从即时问答到全流程自主交付的研发链路。其中SOLO模式尤其引人注目——开发者仅需用自然语言描述需求，AI便能自主完成从需求理解、代码实现、测试验证到部署的全流程。目前国内版本可免费使用，已积累超600万开发者。

三种协作模式：定位分明的人机协作阶梯​

TRAE并非单一的代码补全工具，而是三种不同人机协作范式的集合。理解其定位，方能将效率最大化。

模式	定位	典型场景
Chat​	对话式助手，AI提供建议，人工决策确认	代码片段解释、局部优化、技术答疑
Builder​	项目构建者，基于自然语言快速搭建框架	快速初始化项目结构、原型开发、模块脚手架生成
SOLO​	全流程AI工程师，自主执行完整开发任务	复杂功能开发、Bug系统性修复、从零到一构建应用

三种模式可通过IDE左上角按钮随时切换，无需重启。

核心选用原则：

• 你明确知道需要修改的具体位置 → 使用 Chat模式，实现精准、快速的局部优化。

• 你仅有一个初步想法，需要快速产出可运行原型 → 使用 Builder模式。

• 你有一个完整、明确的需求，希望AI独立完成全流程 → 使用 SOLO模式。

SOLO模式深度解析：双智能体架构​

SOLO模式内置两个智能体，应对不同性质的任务：

SOLO Coder​

面向复杂项目开发的智能体。其核心能力在于理解整个项目上下文——包括各模块间的关联、技术栈选型、既有代码风格——使生成的代码能够无缝融入现有工程，而非孤立、生硬的“AI代码块”。

典型任务（Bug修复）示例：

• 用户输入：“用户反馈登录后页面白屏，控制台报错Cannot read properties of undefined，问题可能在src/components/Dashboard.jsx第42行附近。”

• SOLO Coder自动执行流程：

  1. 读取相关文件及依赖。

  2. 分析错误上下文，定位user对象可能为undefined。

  3. 回溯数据流（API调用→状态更新→组件渲染）。

  4. 发现因API响应延迟，状态未初始化即被渲染。

  5. 添加条件渲染与加载状态。

  6. 自动打开浏览器验证修复效果。

  7. 提交修复后的代码。

SOLO Builder​

面向快速原型构建的智能体。擅长从零开始搭建新模块或进行大范围框架迁移，重点在于快速交付可运行的完整结构，而非精细修改。

快速上手指南（5步完成配置）

1. 下载安装：访问TRAE官网，获取对应系统（macOS/Windows）的安装包。国内用户建议选择国内版以获得更佳网络体验。

2. 首次启动配置：选择主题语言、一键迁移原有VS Code或Cursor配置、并通过手机验证码登录激活AI功能。

3. 模型选择：

   • 国内版：默认使用“豆包”系列模型，可切换至DeepSeek最新版本等。

   • 国际版：为Pro用户提供Claude 4.7 Sonnet等前沿模型，也可切换至GPT-5.5等。

4. 切换至SOLO模式：点击左上角切换按钮。界面分为三栏：左侧任务管理与进度追踪、中部AI对话与过程确认、右侧文件树与终端预览。

5. 输入首个需求：支持文字描述、语音输入或上传PRD文档/设计稿，AI将自动解析并开始执行。

TRAE SOLO 与 Cursor 3 选型指南​

这是当前开发者的高频选型问题。两者定位互补，而非互斥。

维度	TRAE SOLO	Cursor 3
核心机制​	AI主导的自主闭环交付​	人机流式协同，强调精准控制
重构能力​	擅长从零构建、大范围迁移	擅长局部精确重构​
终端集成​	通过Chat中介生成命令，更安全	⌘+K将自然语言直接转为终端命令
规则系统​	.trae/rules项目级全局配置	.cursorrules文件级细粒度约束
价格策略​	国内版免费 / 国际版需订阅	提供Pro与Ultra等多档订阅

选型速查：

• 追求从需求到部署的全流程自动化、希望最小化人工干预 → TRAE SOLO

• 核心业务代码需要极高精度的局部重构、已深度使用Cursor → Cursor 3

• 初创团队快速验证：可使用 TRAE SOLO 构建原型，再以 Cursor 进行核心代码精修

第三方API接入与MCP配置​

TRAE支持通过自定义API端点接入其他模型，也支持通过MCP协议扩展工具能力。

接入第三方模型API​

在设置 → AI配置中，可填入兼容OpenAI API格式的端点，轻松接入其他模型服务，为开发者提供灵活的模型选择。例如，通过配置兼容性良好的星链4SAPI等服务，开发者可以在TRAE中稳定调用包括Claude、DeepSeek、Kimi在内的多种前沿模型，获得统一的开发体验。

配置MCP Server扩展能力​

在项目根目录创建.trae/mcp.json文件，可配置GitHub、数据库等外部工具的MCP服务器。配置重启后，AI在SOLO模式下便能自动调用这些工具，极大地扩展了自动化能力边界。

配置项目级规则（.trae/rules）​

在项目根目录创建.trae/rules文件，可定义团队开发规范，SOLO模式将严格遵守。

- 所有API响应统一使用 `{ code, data, message }` 结构
- 优先使用TypeScript，避免`any`类型
- 数据库操作必须使用事务，禁止裸SQL
- 提交代码前必须通过全部测试

高效操作：常用快捷键速查

操作	macOS	Windows
唤起AI侧边对话	Cmd+U	Ctrl+U
内联代码对话	Cmd+I	Ctrl+I
接受代码补全建议	Tab	Tab
打开命令面板	Cmd+Shift+P	Ctrl+Shift+P
跳转到定义	Cmd+F12	Ctrl+F12
全局搜索	Cmd+Shift+F	Ctrl+Shift+F

常见问题解答（FAQ）

• Q：TRAE SOLO 与 GitHub Copilot 有何本质区别？​

  A：Copilot是“结对编程助手”，在你编码时实时建议补全；TRAE SOLO是“全栈AI工程师”，你给出需求，它独立完成包括读代码、写代码、运行测试、调试在内的完整开发任务。

• Q：SOLO模式遇到“思考次数用尽”怎么办？​

  A：这表明任务过于复杂。解决方案是：将需求拆解为更小的、闭合的子任务。例如，将“开发一个电商后端”拆解为“实现用户模块”→“实现商品模块”→“实现订单模块”，分批交付。

• Q：国内版与国际版功能一致吗？​

  A：核心功能相同。主要区别在于默认可用模型：国内版优先集成国产主流模型，访问流畅且免费；国际版Pro订阅可选用Claude 4.7、GPT-5.5等国际前沿模型。

• Q：TRAE的.trae/rules能与Cursor的.cursorrules互换吗？​

  A：语法风格相似，但不能直接互换。两者执行引擎不同，部分Cursor特有的模式匹配语法在TRAE中无效。迁移时建议基于团队规范重新整理逻辑。

• Q：TRAE SOLO适合编写生产环境代码吗？​

  A：非常适合中低复杂度的ToC应用、内部工具及原型开发。对于高并发、高安全或金融核心系统，建议采用“SOLO出初稿 + Chat模式或人工逐行审查”的组合策略。据实践反馈，在中低复杂度CRUD开发等场景中，效率提升显著。