Trae工具使用
# 1. Trae介绍
字节跳动发布的AI原生编程工具,TRAE 深度融合 AI 能力,是一名能够理解需求、调用工具并独立完成各类开发任务的“AI 开发工程师”,帮助你高效推进每一个项目。
# 1.1 全开发场景覆盖
TRAE 覆盖从编码、调试到测试、重构、部署等多类开发任务。提供智能体编程工具 CUE,支持代码补全、多行修改、智能导入和智能重命名等功能,适配多种日常开发场景,帮助你减少重复操作,专注核心创新。
# 1.2 内置 AI Coding 智能体
TRAE 内置的 SOLO 模式,配备专属 Coding Agent - SOLO Coder。SOLO Coder 是面向复杂项目开发的智能体。SOLO Coder 能够助力你高效完成从需求迭代到架构重构的全流程开发工作。。从自然语言输入到可执行产出,帮助你高效完成开发任务。
# 1.3 双重开发模式
TRAE 不仅将 AI 集成进 IDE,也让 Al 使用更多开发工具。TRAE 目前拥有双重开发模式:
IDE 模式:保留原有流程,控制感更强;
SOLO 模式:让 AI 主导任务,自动推进开发任务。 你可根据任务需求自由切换,让高效与灵活并存。
# 1.4 开放的智能生态
TRAE 推出全新可自由配置的智能体体系,打造开放的智能体生态。你可以根据需求独立创建智能体并分享到市场,像插件一样灵活组合智能体,适配不同开发需求。
# 2. Trae安装
https://www.trae.cn/ (opens new window)
- 前往 TRAE 官网,点击右上角的 下载 IDE 按钮,将安装包下载到本地并完成安装。
- 启动 TRAE, 然后跟随界面指引完成初始设置,包括:
- 选择主题和语言。
- 从 VS Code 或 Cursor 导入已有配置。
- 添加 TRAE 相关的命令行。
- 使用手机号或稀土掘金账号登录 TRAE。
# 3. 使用
# 3.1 界面

# 3.1.1 IDE模式
保留传统的开发方式,开发者可全程自主控制流程,获得更强的掌控感。

# 3.1.2 SOLO模式
以 AI 为主导,自动规划任务并完成从需求理解、代码生成、测试,到成果预览的全流程
使用界面左上角的模式切换按钮,将 TRAE 的模式切换至 SOLO。SOLO 模式的界面如下,从左到右依次为任务管理面板、AI 对话面板、工具面板:

# 3.1.3 内置模型
TRAE CN 提供以下内置模型:
- Doubao-Seed-Code
- Kimi-K2-0905
- GLM-4.6
- MiniMax-M2
- DeepSeek-V3.1-Terminus
- Qwen-3-Coder
# 3.1.4上下文设置
针对文件数量小于等于 5000 的项目,Trae 将在打开项目时自动构建代码索引

# 3.2 使用操作
# 3.2.1 添加到对话
拖拽或者快捷键、右键将代码添加到对话中。(代码,终端)
内嵌模式
在代码编辑区域选择代码行,快捷键:ctrl + i,唤起对话框
对话模式 在代码编辑区域选择代码行,快捷键:ctrl + u,添加到对话框
另外也可以通过 # 符号添加多种类的上下文,包括代码、文件、文件夹、代码仓库、文档集和网页
1. #符号
- #File:添加指定文件中的所有内容作为与 AI 助手对话的上下文
- #Folder:添加指定文件夹中的所有内容作为与 AI 助手对话的上下文
- #Doc:添加指定文档中的所有内容作为与 AI 助手对话的上下文
- #Code:添加函数或类的相关代码作为与 AI 助手对话的上下文
- #Workspace:整个工作空间作为与 AI 助手对话的上下文
- #Problems: 将问题页签中问题作为上下文,AI报告的所有问题并提供解决方案
- #Web:将线上网站的内容作为 AI 对话的上下文
2. @符号
使用智能体进行对话
# 3.2.2 生成并处理代码
- 处理多文件内的所有代码变更:点击输入框上方待审查文件列表中的 全部接受 或 全部拒绝 按钮,批量接受或拒绝当前项目中的所有代码变更。

处理单文件内的所有代码变更:在编辑器内打开文件,点击上方提示条中的 接受 按钮
处理单处代码变更:在编辑器内,将鼠标悬浮至某个代码变更处,然后点击右上角的 ^Y 按钮

- 回退版本

# 3.2.3 常用快捷键
- 调出命令面板 :Ctrl+Shift+P
- 智能补全确认 :Tab
- 智能补全下一行 : Shift + Tab
- 添加到对话 :Ctrl+U
- 内嵌模式 :Ctrl+I
- 复制行 :Shift + Alt + Down
- 移动行 :Alt + Up/Down
- 方法位置跳转 :Ctrl + Shift + O
- 格式化文档 :Shift + Alt + F
# 3.2.4 技巧
确保CUE正常开启

# 1. 代码补全
续写:理解当前文件中的已有代码,自动续写相关代码。

多行修改:通过感知上下文,AI 能够同时提供多个代码行的建议修改点。

修改点预测 :通过分析最近的代码修改、浏览记录、Linter 错误等信息,并结合当前仓库的内容,自动预测未来可能的修改点。
修改点跳转:当你修改代码(如函数或字段名称等)后,AI 会自动引导你跳转到与该修改相关的其他位置。

智能重命名

# 2. 代码优化
将复杂代码位置添加到对话,让 SOLO Coder 分析并优化代码。
# 3. 代码帮写
- 触发方式:在代码编辑区域输入代码注释时,功能描述,触发代码帮写功能。
- 功能描述:根据当前上下文,智能推荐可能的代码片段,帮助开发者快速编写代码。
- 示例:输入
// 拆分List为多个List,每个List的大小为n后,触发代码帮写功能,推荐function function_name() { }等代码片段。
# 4. 解决错误
将报错信息添加到对话,@代码审查智能体,让智能体分析并解决错误。
# 5. 代码审核
将复杂代码位置添加到对话,@代码审查智能体,让智能体分析并优化代码。案例详见后续章节。
# 4 智能体
智能体的能力
- 自主运行 - 独立探索你的代码库,识别相关文件并进行必要修改。
- 完整的工具访问权限 - 使用所有可用工具进行搜索、编辑、创建文件及运行终端命令。
- 上下文理解 - 建立对你项目的结构和依赖关系的全面理解。
- 多步骤规划 - 将复杂任务拆分为可执行的步骤,并按顺序逐一处理。
# 4.1 内置智能体
TRAE IDE 提供以下内置智能体:
Chat:用于对话。你可以让 Chat 智能体聊聊你的代码库或编写代码。
Builder:Builder 可以帮助你从 0 到 1 开发一个完整的项目。根据你的需求,Builder 会调用不同的工具,包括分析代码文件的工具、编辑代码文件的工具、运行命令的工具等等,从而更加精确且有效地处理你的需求。
Builder with MCP:在 Builder 的基础上,你配置的所有 MCP Server 都会默认添加至 Builder with MCP,且不可编辑。
# 4.2 创建自定义智能体

可以分享智能体给其他人,也可以从其他人分享的智能体中导入。
另外支持一键导入的自定义智能体,以下是一些自定义智能体示例:
https://docs.trae.cn/ide/custom-agents-ready-for-one-click-import (opens new window)
UI 设计师:https://s.trae.com.cn/a/8fdcb7 (opens new window)
前端架构师:https://s.trae.com.cn/a/3fbe5a (opens new window)
后端架构师:https://s.trae.com.cn/a/441a24 (opens new window)
# 4.3 使用智能体
在 AI 对话输入框中,输入 @ 或者点击 @智能体,然后在智能体列表中选择你想用的智能体。

# 5 SOLO
SOLO 模式以 AI 为主导,自动规划并执行从需求理解、代码生成、测试,到成果预览的全流程。 在 SOLO 模式下,你可通过自然语言描述、语音交互或上传本地文件等多种方式输入需求,AI 会自主拆解任务并高效执行,实现开发过程的极大简化和智能化。
# 5.1 SOLO Coder
1. 能力
可以自主编排多个智能体,组建属于你的 AI 团队,实现多角色协同工作
SOLO Coder 作为主控智能体,可以在执行和处理上下文较长的复杂任务时,自动调用相应的智能体,将任务进行拆分与隔离,也可以在提示词中明确指定需调用的智能体,SOLO Coder 会根据上下文在相应的时机调用该智能体。
2. 配置
编辑 SOLO Coder,你可以为 SOLO Coder 配置其可调用的自定义智能体、MCP Server 和内置工具。

3. PLAN模式
若生成的计划不符合你的预期,你可以通过以下两种方式进行修改:
- 直接手动编辑内容,编辑完成后再点击 执行 按钮。
- 向 SOLO Coder 发送修改需求,让它根据指令自动调整内容。
# 5.2 任务管理
支持在一个项目中同时管理多个任务,提升整体开发效率
你可在同一项目下创建多个独立任务,分别用于不同功能模块的开发(如前端与后端),实现多任务并行推进。
# 6 后端项目开发
# 6.1 环境配置
# 6.1.1 jdk和maven配置

json配置
ctrl + shift + p打开用户首选json

{
"files.autoSave": "afterDelay",
"files.autoSaveDelay": 100,
"[vue]": {
"editor.defaultFormatter": "octref.vetur"
},
"diffEditor.ignoreTrimWhitespace": false,
"editor.stickyScroll.enabled": false,
"trae.preview.permission": {
"www.baidu.com": {
"geolocation": "denied"
}
},
"java.configuration.runtimes": [
{
"name": "JavaSE-17",
"path": "C:\\Users\\lumf\\software\\jdk-17.0.6",
"default": true
},
{
"name": "JavaSE-21",
"path": "C:\\Users\\lumf\\software\\jdk-8u321",
"default": false
}
],
"java.configuration.maven.globalSettings": "C:/Users/lumf/software/apache-maven-3.9.1/conf/settings-hs.xml",
"editor.fontSize": 15,
"maven.view": "hierarchical",
"workbench.settings.applyToAllProfiles": [
"java.configuration.maven.globalSettings",
"maven.executable.path"
],
"maven.executable.path": "C:/Users/lumf/software/apache-maven-3.9.1/bin/mvn.cmd",
"workbench.panel.showLabels": false,
"maven.terminal.customEnv": [
],
// 可通过以下配置指定本地仓库位置
"maven.localRepository": "E:/maven-repository",
"maven.terminal.useJavaHome": true,
"maven.dependency.enableConflictDiagnostics": false,
"editor.mouseWheelZoom": true,
}
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
# 6.1.2 安装插件
Extension Pack for Java

Spring Boot Extension Pack

# 6.2 创建项目
创建项目
选择对应项目类型

# 6.3 构建项目

# 6.4 运行项目

# 7. 案例
# 7.1 SOLO案例Demo
SOLO模式下,你可以通过自然语言描述需求,AI 会根据描述自动规划并执行任务。
例如开发一个简单的小游戏
提示词
## 开发一个单页面小游戏
游戏为解压游戏,内容创意帮我想一下
## 技术栈
Vue
## 要求
1. 界面美观
2. 能起到解压作用
3. 输出设计文档
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 7.2 代码优化案例Demo
提示词
这个代码太长了,优化一下结构, 可以拆分为多个文件
# 7.3 文档生成案例
提示词
给这个数据回流服务生成一篇设计文档
# 7.4 代码审查案例
提示词
#Doc 阿里巴巴开发规范 ExportExecutor.java 按规范审核一下这个接口定义是否符合规范
# 7.5 MCP工具使用
MCP 是一个基于 Python 的命令行工具,用于管理和执行 Trae 项目中的任务。添加CMP需要安装uvx和npx。
npx:依赖于 Node.js,版本需大于等于 18。
uvx:基于 Python 的快速执行工具,需手动安装。
安装uvx
pip install uv 或
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
2
3
# 7.5.1 MCP添加
设置->MCP->添加CMP
# 一、从市场添加

# 二、手动添加
比如添加 chrome-devtools-mcp
1. 下载
npm install --no-lockfile chrome-devtools-mcp@latest
2
2. 配置

# 7.5.2 MCP使用

提示词
使用mcp查看一下现在有多少表,每个表数据量是多少
# 文档
官网:https://www.trae.cn/ (opens new window) 文档:https://docs.trae.cn/ide (opens new window)