Trae IDE 使用指南

平台背景与定位

Trae IDE 是由字节跳动推出的，基于 VS‑Code深度改造的 AI 原生IDE。该编辑器旨在通过 Agent 式 AI 编程辅助开发者。国内网页版地址为 https://www.trae.cn/ide；另有桌面客户端版本提供下载。

在架构上，平台内置了 豆包、DeepSeek系列模型。针对网络连接策略进行了区分：

• 国内体系：trae.cn / trae.cn/ide（国内直连可用）。
• 国际体系：trae.ai（两套定价独立）。

1. 主要功能特性

平台提供了多种模式以适应不同开发场景，核心能力如下：

1. IDE普通模式：保留完整 VS‑Code能力；支持插件扩展、终端操作、代码调试及 Git版本控制。侧边栏集成AI对话，选中代码即可解释语义、重构逻辑、查询 Bug 或生成单元测试，配合智能多行代码补全（Tab确认）。
2. SOLO智能体模式（核心）：用户输入完整自然语言需求后，AI自动拆解任务、读写多文件、安装依赖、运行并预览；适合从零搭建新项目或对旧工程进行重构。支持查看任务看板，关键节点可人工介入确认。
3. Builder快速原型：通过一句话描述直接生成完整的Web项目；内置预览窗口用于快速跑通 MVP 原型；还支持图转代码功能，上传 UI草图即可生成前端代码。
4. 代码审查与 Git辅助：自动对比 Diff、总结改动内容并发现潜在问题；AI可自动生成规范的 git commit注释。
5. 自定义编码规则：通过.trae/rules配置文件定义团队规范，确保 AI 生成的代码自动遵循既定风格标准。
6. 多语言支持：覆盖 Python/JS/TS/Java/Go/C++等主流开发语言生态。

2. 适用人群建议

✅适合群体

1. 个人开发者与独立创作者。
2. 学生用户，需要辅助学习、代码解释和排错功能。
3. 前端或后端工程师，用于快速编写脚手架、原型验证及脚本工具的开发场景。
4. 小团队项目组，需要进行快速的 MVP（最小可行性产品）原型搭建与测试。

❌不太适合群体

1. 对安全性要求极高的企业生产环境：国内版为云端服务，不支持完全私有化部署。
2. Linux系统用户：官方暂未提供原生 Linux客户端，Wine运行可能存在卡顿或异常风险。
3. 依赖特定第三方插件生态且无法接受不兼容的场景。

3. 免费与付费体系说明

1. 国内版（trae.cn / trae.cn/ide）：面向个人用户开放全部 AI功能免费，无 Token 计数限制；仅在高峰时段可能出现排队等待情况。企业私有化部署方案需商务联系接入。注意区分国内与国际定价。
2. 国际版（trae.ai）：采用订阅制收费模式；包含 Lite ($3/月)、Pro ($10/月)、Pro+ ($30/月) 及 Ultra ($100/月)。高级套餐包含SOLO智能体、更高并发额度及优先队列服务。定价页面参考 https://www.trae.ai/pricing/。
3. 账户隔离：国内版与国际版的账号体系与付费套餐互不通用，建议用户根据区域需求正确访问对应域名。

4. 使用流程指南

1. 登录环境：打开网页 https://www.trae.cn/ide 并使用手机号登录；或下载 Trae国内桌面客户端。
2. 注意：只有登录后AI能力才生效，未登录状态下仅作为普通编辑器。
3. 创建项目：在平台上新建项目，或直接导入本地现有文件夹。
4. 模式切换与操作：

• IDE模式：按传统方式编写代码，打开右侧 AI 对话框；选中代码片段右键「AI操作」进行重构/解释/修复。
• SOLO模式：切换至SOLO页面，输入完整中文需求后由AI自动执行，任务看板中可追踪进度并人工确认关键节点。

1. 原型生成（Builder）：在 Builder界面直接输入需求描述，系统自动生成项目结构并使用内置预览窗口查看效果。
2. 运行与调试：利用内置终端执行 npm、pip等命令进行依赖管理和程序启动。

5. 注意事项

1. 高峰排队机制：国内版在白天高峰期大任务（SOLO）会进入队列等待，此为正常现象；若需降低延迟可考虑国际版付费套餐以获取优先队列。非系统 Bug。
2. 代码安全审查：务必人工审查 AI 生成的代码，严禁直接上传至生产环境；需严格校验逻辑正确性、潜在安全漏洞及依赖版本兼容性。
3. 数据备份策略：网页版 IDE的云端存储存在流失风险，重要项目建议定期本地导出备份；桌面客户端文件默认存储在本地路径。切勿完全替代本地管理。
4. Linux系统兼容：官方无原生 Linux包，Wine运行极易出现卡顿或异常，不建议用于生产环境。
5. 账号体系混淆：国内版与国际版数据不互通。访问 trae.ai（国际站）可能会导致跳转至付费体系并影响已购权益。国内用户请勿随意使用 traee.ai 域名。
6. 资源消耗管理：SOLO模式对算力及内存占用较高，建议避免一次性导入超大存量项目；推荐分模块、分批执行指令。
7. 插件兼容性排查：部分第三方VS‑Code插件可能与AI引擎冲突导致异常。遇到运行时错误或侧边栏失效时，请优先禁用所有第三方插件进行定位。先排除外部干扰再反馈。
8. 浏览器环境建议：推荐使用 Chrome、Edge等主流浏览器；其他非标准内核的浏览器可能出现终端渲染失败或预览组件无法加载的情况。