Trae使用教程：从入门到精通

个人版：提供完整的 IDE 核心能力，支持多种主流编程语言与热门开发框架，集成代码编辑、智能补全、调试运行、版本控制等一体化工具链。适用于独立开发者、学生及自由职业者，用于项目开发、技术学习与实践探索。
企业版：在个人版完整 IDE 能力的基础上，进一步增强团队协作与管理能力，提供成员与权限管理、资源用量监控、企业级数据可视化看板等功能，同时支持企业内部 AI 模型的灵活接入。适配企业级开发流程规范，满足数据安全与合规要求。

TRAE IDE 覆盖从编码、调试到测试、重构、部署等多类开发任务。提供智能体编程工具 CUE，支持代码补全、多行修改、智能导入和智能重命名等功能，适配多种日常开发场景，帮助你减少重复操作，专注核心创新。

2.为什么选择Trae

全功能免费（国内版）

极致的中文适配，贴合国内开发者的编码逻辑

覆盖全开发流程，从需求到部署一站式解决

二、下载与安装

支持的操作系统：Windows 10/11、macOS 10.15及以上、Linux（.deb/.rpm格式）

下载地址：www.trae.cn官网，点击Download下载

双击安装包：

首次启动 Trae 国内版时，会进入初始配置页面，点击 "开始" 按钮，进入初始配置流程。选择主题，可选项为暗色、亮色和深蓝，根据个人喜好选择主题颜色；选择显示语言，可选项为简体中文和 English，选择你习惯使用的语言，推荐选择简体中文以便更好地使用。

导入配置： 若你的电脑中已安装并配置 VS Code 或 Cursor，你可以选择从 VS Code 或 Cursor 中导入配置或者直接跳过。点击 "从 VS Code 导入" 或 "从 Cursor 导入" 按钮，系统将会从对应的 IDE 中获取插件、IDE 设置、快捷键设置等信息并一键导入到 Trae 中，帮助你快速从其他 IDE 切换到 Trae

安装命令行： 添加 Trae 相关的命令行后，你可以在终端中使用命令行更快速地完成 Trae 相关的操作。点击 "安装 trae 命令" 按钮，然后完成授权流程。安装完成后，你可以在终端中使用以下命令：使用 trae 命令快速唤起 Trae；使用 trae my-react-app 命令在 Trae 中打开一个项目

登录账号： Trae 国内版可通过手机号或第三方社区账号（如掘金社区）注册并登录，与国际版的谷歌授权方式登录不同，国内版和国际版的账户是完全隔离开的

三、核心功能解析

1.IDE模式

保留传统的开发方式，开发者可全程自主控制流程，获得更强的掌控感

侧边对话

编码过程中，可以随时在侧边对话框中与 AI 助手对话，包括回答编码问题、讲解代码仓库、生成代码片段、修复错误等

启用 Chat 智能体

2.SOLO模式

SOLO 模式以 AI 为主导，自动规划并执行从需求理解、代码生成、测试，到成果预览的全流程。

在 SOLO 模式下，可通过自然语言描述、语音交互或上传本地文件等多种方式输入需求，AI 会自主拆解任务并高效执行，实现开发过程的极大简化和智能化。

使用界面左上角的模式切换按钮，将 TRAE 的模式切换至 SOLO。

SOLO 模式的界面如下，从左到右依次为任务管理面板、AI 对话面板、工具面板

SOLO Coder：是一个面向复杂项目开发的智能体。它能够助力你高效完成从需求迭代到架构重构的全流程开发工作。通过智能任务规划与精准执行机制，SOLO Coder 可在确认计划后自动推进开发进度。同时，你还可以自主编排多个智能体，组建属于你的 AI 团队，实现多角色协同工作，加速项目落地

进入 SOLO 模式后，点击 AI 对话输入框左下角的 @ 符号，然后在智能体菜单中选择 SOLO Coder

3.模型

TRAE 预置了一系列业内表现比较出色的模型，你可以直接切换不同的模型进行使用。此外，TRAE 还支持通过 API 密钥（API Key）接入自定义模型，从而满足个性化的需求

在 AI 对话输入框的右下角，点击当前模型名称，打开模型列表，然后选择你想使用的模型。各个模型的能力不同，你可以将鼠标悬浮至模型名称上，然后查看该模型支持的能力。

添加自定义模型

如果你希望使用预置模型之外的其它模型，或者想使用自己的模型资源，则可以通过 API 密钥连接你自己的模型资源或其他第三方模型服务商。

Auto 模式下，系统会综合考虑问答速度、性能与资源占用情况，智能调用合适的模型，提供更流畅的 AI 问答体验。

4.智能体

智能体（Agent）是你面向不同开发场景的编程助手。TRAE 提供内置智能体。同时，你还可以创建自定义智能体，通过灵活配置提示词和工具集，使其更高效地帮你完成复杂任务。

智能体的能力

自主运行 - 独立探索你的代码库，识别相关文件并进行必要修改。
完整的工具访问权限 - 使用所有可用工具进行搜索、编辑、创建文件及运行终端命令。
上下文理解 - 建立对你项目的结构和依赖关系的全面理解。
多步骤规划 - 将复杂任务拆分为可执行的步骤，并按顺序逐一处理。

智能体的工作流

需求分析：深入理解任务目标及代码库上下文，明确需求要点。
代码调研：检索代码库、文档及网络资源，定位相关文件并分析现有实现逻辑。
方案设计：根据分析结果拆解任务步骤，并动态优化调整修改策略。
实施变更：照计划在整个代码库中进行必要的代码变更，过程中可能涉及：

- 新增依赖库推荐
- 需执行的终端指令
- TRAE IDE 客户端外的手动操作指引

交付验收：完成验证后移交控制权，同步汇总所有修改内容。

内置智能体

TRAE IDE 提供以下内置智能体：

Chat：用于对话。你可以让 Chat 智能体聊聊你的代码库或编写代码。
Builder：Builder 可以帮助你从 0 到 1 开发一个完整的项目。根据你的需求，Builder 会调用不同的工具，包括分析代码文件的工具、编辑代码文件的工具、运行命令的工具等等，从而更加精确且有效地处理你的需求。
Builder with MCP：在 Builder 的基础上，你配置的所有 MCP Server 都会默认添加至 Builder with MCP，且不可编辑。