TRAE SOLO 完整使用教程：字节跳动免费 AI 全自动编程工具上手指南（2026）
TRAE 是字节跳动推出的 AI 原生集成开发环境（IDE），基于 VS Code 内核构建，三种协作模式（Chat / Builder / SOLO）覆盖从代码问答到全流程自主交付的完整开发链路。其中SOLO 模式以 AI 为主导，自动完成需求理解、代码生成、测试、预览到部署的全流程——用户只需用自然语言描述需求，AI 独立"干活"。目前国内版完全免费，已有超过 600 万开发者在用。
TRAE 的三种模式：从"问代码"到"让 AI 帮你交付"
TRAE 不是单一的代码补全工具，而是三种协作模式的集合。明确每种模式的定位，才能把效率真正用在刀刃上。
| 模式 | 定位 | 适用场景 |
|---|---|---|
| Chat | 对话助手，AI 建议 + 人工确认 | 代码解释、局部优化、技术问答 |
| Builder | 项目构建者，自然语言生成框架 | 快速搭建项目结构、原型开发 |
| SOLO | AI 工程师，全流程自主执行 | 复杂功能开发、Bug 修复、从零构建 |
三种模式可随时通过左上角模式切换按钮切换，无需重启。
核心判断原则：
- 你知道要改哪里 → Chat 模式，精准、快速
- 你只有一个想法，需要快速出原型 → Builder 模式
- 你有一个完整需求，不想逐步参与 → SOLO 模式
SOLO 模式详解：两个智能体的分工
SOLO 模式内置两个智能体，任务性质不同应选不同的执行者：
SOLO Coder
面向复杂项目开发的智能体。能够读取并理解整个项目——不只是当前文件，而是所有模块的关联关系、技术栈选型、代码风格——写出来的代码能无缝融入已有项目，而不是"一看就很 AI"的游离代码。
典型任务示例（Bug 修复）：
用户输入： "用户反馈登录后页面白屏，控制台报错 Cannot read properties of undefined， 问题可能在 src/components/Dashboard.jsx 第 42 行附近" SOLO Coder 自动执行： 1. 读取 Dashboard.jsx 及其依赖文件 2. 分析报错上下文，定位 user 对象可能为 undefined 3. 检查数据获取流程（API 调用 → state 更新 → 组件渲染） 4. 发现 API 响应延迟导致 state 未初始化就渲染了子组件 5. 添加条件渲染和 loading 状态 6. 打开浏览器验证修复效果 7. 提交修复代码SOLO Builder
面向快速原型开发的智能体。适合从零构建新模块或大范围框架迁移，重点不在精确修改，而在快速交付可跑通的完整结构。
安装与首次配置（5 步）
第一步：下载安装包
访问 TRAE 官网（trae.ai 或 trae.com.cn），点击中央下载按钮，自动匹配系统（macOS / Windows）。国内版（cn 版）和国际版分别对应不同模型，国内用户建议优先选国内版。
第二步：首次启动配置
启动后完成三件事：
- 选择主题和语言（推荐 Dark+，默认简体中文）
- 导入已有配置——如果之前用 VS Code 或 Cursor，可一键迁移插件、主题、快捷键
- 登录激活——国内版支持手机号验证码登录，登录后 AI 功能才可用
第三步：选择模型
# 国内版默认模型：豆包-1.5-pro# 可切换：DeepSeek-R1、DeepSeek-V3、豆包系列# 在右侧 Chat 面板顶部下拉菜单切换# 国际版默认模型：Claude 3.7（Pro 用户）# 可切换：GPT-4o、Gemini 等第四步：切换至 SOLO 模式
点击左上角模式切换按钮，从默认的 Chat/Builder 切换到SOLO。界面从左到右分为：
- 任务管理面板（任务列表、进度追踪）
- AI 对话面板（需求输入、过程确认）
- 工具面板（文件树、终端、预览）
第五步：输入第一个需求
SOLO 模式支持三种输入方式：
方式 1：文字描述（最常用） → "创建一个 FastAPI 后端，包含用户注册登录接口，使用 JWT 认证，数据存 SQLite" 方式 2：语音输入（点击麦克风图标） → 直接说出需求，AI 转录后执行 方式 3：上传文件（PRD 文档、截图、设计稿） → 上传 PDF 需求文档，AI 自动解析并开始执行TRAE SOLO vs Cursor 3：怎么选？
这是当前开发者最高频的选型问题。两者定位不同，不是非此即彼，而是互补。
| 维度 | TRAE SOLO | Cursor 3 |
|---|---|---|
| 核心机制 | AI 主导，自主闭环交付 | 人机流式协同，精准修改 |
| 重构能力 | 擅长从零构建、大范围迁移 | 擅长局部精确重构 |
| 终端集成 | Chat 中介生成命令，更安全 | ⌘+K直接转自然语言为终端命令 |
| 规则系统 | .trae/rules项目级全局配置 | .cursorrules细粒度文件模式约束 |
| 价格 | 国内版免费/ 国际版约 3-10 美元/月 | Pro $20/月，Ultra $200/月 |
| 适合人群 | 初学者、全流程自主开发、预算敏感 | 追求极致编码速度、精确控制的中高级开发者 |
选型速查：
- 追求从需求到部署全流程、不想逐步参与 →TRAE SOLO
- 核心代码需要精确局部重构、已付费 Cursor →Cursor 3
- 初创团队快速验证 →TRAE SOLO 做原型 + Cursor 精修核心模块
接入第三方 API 与 MCP 配置
TRAE 支持通过 MCP（Model Context Protocol）接入外部工具，也支持替换底层模型 API。
接入第三方模型 API
在 TRAE 设置 → AI 配置 → 自定义 API Endpoint，填入兼容 OpenAI 格式的接口即可接入国内模型或第三方推理服务：
{"provider":"custom","baseUrl":"https://api.your-provider.com/v1","apiKey":"your_api_key_here","model":"deepseek-v3"}开发者如需在 TRAE 中稳定调用 Claude Sonnet / DeepSeek / Kimi 等模型，可接入兼容 OpenAI/Anthropic 双格式的推理服务，填入对应 Base URL 和 API Key 即可，无需修改 TRAE 配置结构。
配置 MCP Server
在项目根目录创建.trae/mcp.json：
{"servers":[{"name":"github","url":"https://your-mcp-server/github","transport":"stdio","parameters":{"apiToken":"ghp_your_token"}},{"name":"database","url":"https://your-mcp-server/db","transport":"sse","parameters":{"connectionString":"postgresql://..."}}]}配置后重启 TRAE，在 AI 面板设置 → MCP 中可看到已接入的工具，SOLO 模式下 AI 会自动调用。
配置项目规则（.trae/rules）
# .trae/rules 示例 - 所有 API 响应统一使用 { code, data, message } 结构 - 优先使用 TypeScript，避免 any 类型 - 数据库操作必须加事务，不允许裸 SQL - 提交前必须运行 npm test，测试通过才能提交SOLO 模式会严格遵守 rules 文件中的约束，相当于给 AI 工程师写了一份团队规范。
常用快捷键速查
| 操作 | 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 |
常见问题
Q：TRAE SOLO 和普通 AI 代码补全工具（如 GitHub Copilot）有什么本质区别？
GitHub Copilot 是"助手"——你写代码，它实时补全。TRAE SOLO 是"工程师"——你给需求，它完成整个任务，包括读文件、分析依赖、执行终端命令、验证结果。前者提升你的打字效率，后者替代你完成整个开发任务。
Q：SOLO 模式执行时遇到"思考次数用尽"怎么办？
这是复杂任务的常见卡点。解法：把需求拆分成更小的子任务重新输入。例如"做一个完整电商后端"应拆为"做用户模块"→"做商品模块"→"做订单模块"，每次只让 SOLO 完成一个闭合功能。
Q：国内版和国际版功能一样吗？
核心功能相同，区别在模型：国内版默认豆包+DeepSeek，国际版 Pro 可用 Claude 3.7 和 GPT-4o。国内版访问流畅、完全免费；国际版模型能力更强，但需要网络条件。
Q：TRAE 的 .trae/rules 和 Cursor 的 .cursorrules 能互换吗？
语法格式相似（都是 Markdown 风格约束），但不能直接复用——两者的执行引擎不同，部分 Cursor 特有的文件模式匹配语法在 TRAE 中不生效。建议从 Cursor 迁移时重新整理规则逻辑，而不是直接拷贝文件。
Q：TRAE SOLO 适合写生产环境代码吗？
适合中低复杂度的 ToC 应用和内部工具开发。高并发系统、金融核心逻辑、安全敏感模块建议用 SOLO 快速出初稿，再用 Chat 模式或人工 Review 逐行核查。根据企业级实测，中低复杂度场景（如 CRUD 接口开发）效率可提升约 340%。
延伸资源
- 主流 AI 编程工具接入 IDE 完整配置指南（TRAE / Cursor / VS Code 全覆盖）：七牛云 AI 编程工具配置大全
- 多模型 API 统一接入（DeepSeek / Claude / Kimi，兼容 OpenAI 格式）：七牛云 AI 推理 API Key
- TRAE SOLO 官方文档：docs.trae.ai/ide/solo-mode
- TRAE 官网下载：trae.ai / 国内版 trae.com.cn
下一步建议先用 SOLO Builder 模式跑通一个 MVP 原型，再用 SOLO Coder +.trae/rules约束接入团队代码规范，完成从"能跑"到"能上线"的最后一步。
本文内容基于 2026 年 5 月 TRAE 官方文档及社区实测数据，产品功能以 TRAE 官网最新版本为准。
