零基础实操:手把手教你Trae安装MCP+装Skill+选模式(AI编程从0到1)
下载了Trae不会配?打开界面一脸懵——模式在哪切?MCP怎么装?Skill从哪下?
网上攻略全是"装什么",没人告诉你"怎么装"。阿Lee踩了3天的坑,把每一步操作都截图级还原。跟着做,20分钟从裸机到满配。
一、前置准备:别急着配,先确认环境
1.1 下载安装Trae
国内用户直接去官网trae.com.cn下载国内版,别去trae.ai(那是国际版,需要翻墙)。
- Windows:下载
Trae CN-Setup-x64.exe,右键「以管理员身份运行」 - macOS:下载
.dmg,拖到应用程序文件夹 - 安装路径别有中文和空格(比如
D:\DevTools\Trae,不要D:\我的工具\Trae)
1.2 首次启动3件事
启动后,依次做这3步:
- 选中文界面:首次启动会问语言,直接选中文
- 导入VSCode配置:如果你之前用VSCode,安装过程选「导入配置」——插件、快捷键、主题一键迁移过来
- 确认版本号:打开Trae → 左下角齿轮 → 关于,确认版本 ≥ 3.3.21(低于这个版本不支持Skill)
1.3 确认环境依赖
MCP和Skill的运行依赖Node.js和Python,提前装好:
- Node.js:版本 ≥ 16.0,下载地址
nodejs.org。装完终端运行node -v确认 - Python:版本 ≥ 3.8,装完终端运行
python --version确认 - npx:跟着Node.js自动装好的,终端运行
npx --version确认
这3个没装,后面MCP和Skill装了也跑不起来。先确认,再往下走。
二、模式选择实操——5个模式怎么切
Trae的模式不是"一个按钮",而是分了两个世界:IDE模式和SOLO模式。
2.1 在哪切换模式
打开Trae后,左侧有个Chat面板(如果没看到,按Ctrl+L/Cmd+L打开)。
面板顶部有个下拉菜单,默认显示"Chat"——这就是模式选择器。点击它,下拉列表里会出现所有可选模式。
2.2 IDE模式下的3个智能体
表格
| 智能体 | 位置 | 一句话说明 | 你需要做什么 |
|---|---|---|---|
| Chat | 模式选择器 → Chat | 只动嘴不动文件 | 问它问题,它给答案,不碰你的代码 |
| Builder | 模式选择器 → Builder | 改代码+跑命令,先问你确认 | 说需求,确认执行计划,它干活 |
| Builder with MCP | 模式选择器 → Builder with MCP | Builder+外部工具链 | 需要连GitHub/Figma等外部服务时选这个 |
操作步骤:
- 按
Ctrl+L/Cmd+L打开左侧AI面板 - 点击面板顶部的模式下拉框
- 选择你要的模式
- 在输入框打字,回车发送
就这么简单。80%的日常开发用Builder就够了。
2.3 SOLO模式下的2个智能体
SOLO模式不在左侧面板里,需要单独进入。
操作步骤:
- 点击Trae左侧导航栏的「SOLO」图标(在Chat面板下方)
- 进入SOLO界面后,顶部有两个Tab:SOLO Builder和SOLO Coder
- 点选你要的那个
表格
| 智能体 | 什么时候选 |
|---|---|
| SOLO Builder | 从0开始做一个新项目/原型/MVP——你说需求,它全流程自动交付 |
| SOLO Coder | 已有项目要深度迭代——改深层Bug、跨模块重构、复杂业务逻辑 |
2.4 阿Lee的模式选择口诀
问问题用Chat,写代码用Builder,连外网用MCP,新项目用SOLO Builder,改老代码用SOLO Coder。
别纠结。先用Builder,不够了再升级模式。
三、MCP安装实操——3种方式,从简到难
MCP(Model Context Protocol)是Trae的"外挂接口"。装了MCP,AI能操作GitHub、读Figma、查数据库、抓网页。
3.1 进入MCP配置页面
不管用哪种方式,都要先进入MCP配置:
- 点击右上角⚙️ 齿轮图标(设置)
- 左侧菜单找到「MCP」或「模型上下文协议」
- 进入后看到两个Tab:「市场」和「手动配置」
3.2 方式一:市场一键添加(最推荐新手)
适合:GitHub、Figma、Tavily Search等热门MCP
操作步骤:
- 在MCP配置页,点击「市场」Tab
- 浏览或搜索你要的MCP(比如输入"Figma")
- 找到后点击右侧的「+ 添加」按钮
- 部分MCP会弹窗要求输入API Token/Key——按提示粘贴进去
- 点击「保存」
- 看到「连接成功」提示,搞定
常见MCP需要的凭证:
表格
| MCP | 你要提前准备什么 |
|---|---|
| GitHub | GitHub Personal Access Token(Settings → Developer settings → Personal access tokens) |
| Figma | Figma Personal Access Token(Settings → Account → Personal access tokens) |
| 高德地图 | 高德Web服务API Key(高德开放平台申请) |
3.3 方式二:手动粘贴JSON配置
适合:市场里没有的MCP,或自己开发的MCP Server
操作步骤:
- 在MCP配置页,点击「手动配置」或「添加更多工具」
- 会看到JSON输入框
- 粘贴你的配置,格式如下:
stdio类型(本地命令行启动,最常见)
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "D:\\DevProjects"],
"env": {}
}
}
}
http类型(远程HTTP服务):
{
"mcpServers": {
"my-remote-server": {
"url": "https://example.com/mcp",
"headers": {
"Authorization": "Bearer 你的Token"
}
}
}
}
- 点击「确定」保存
- 状态栏显示
xxx: running即成功
配置文件放哪?
- 全局配置:
~/.trae-cn/mcp.json(所有项目共享) - 项目级配置:项目根目录
.trae/mcp.json(仅当前项目生效,优先级更高)
直接编辑这些文件也行,效果和在界面里粘贴一样。
3.4 方式三:Schema链接一键导入
适合:从博客/社区看到的MCP配置,别人分享的链接
操作步骤:
- 复制别人给的
trae-cn://开头的链接 - 在Trae中点击该链接,或粘贴到地址栏回车
- Trae自动解析配置,弹出确认弹窗
- 点击「确认导入」
链接格式长这样:
trae-cn://trae.ai-ide/mcp-import?type=stdio&name=github&config=eyJjb21tYW5kIjoibnB4Ii...
3.5 验证MCP是否生效
装完MCP后,在对话里直接用:
@Builder with MCP
帮我用GitHub MCP创建一个新分支feat/login
如果AI正常调用了GitHub功能,说明MCP生效。如果报"工具调用失败",看下面排错。
3.6 MCP安装常见问题
表格
| 问题 | 解决办法 |
|---|---|
| 添加后不生效 | 重启Trae / 检查Token是否过期 / 确认智能体已绑定该Server |
| "工具调用失败"或404 | 检查MCP Server是否正在运行(npx命令是否卡住),终端手动跑一次npx xxx看报错 |
| 市场里没有 | 用方式二手动JSON配置,或方式三Schema链接 |
| 响应太慢 | 优先用本地MCP(localhost),避免网络延迟大的云服务 |
| 批量管理多个Server | 直接编辑~/.trae-cn/mcp.json,粘贴多条配置 |
| Agent不调用MCP | 提示词里明确写"使用MCP""调用GitHub工具"等触发词 |
四、Skill安装实操——4种方式,从简到难
Skill是Trae的"外挂大脑"——把常用提示词、工作流、代码规范封装成技能包,AI从"通用助手"变成"领域专家"。
4.1 先搞清Skill装在哪
Skill有3个层级,优先级从高到低:
表格
| 层级 | 路径 | 作用范围 |
|---|---|---|
| 项目级 | .trae/skills/ | 仅当前项目生效 |
| 用户级 | ~/.trae/skills/或~/.trae-cn/skills/ | 所有Trae项目共享 |
| 全局 | .agents/skills/ | 所有Agent(跨IDE) |
阿Lee建议:统一装用户级(全局共享),除非某个项目有特殊规范才用项目级覆盖。
4.2 方式一:设置界面创建/上传(最直观)
适合:新手创建第一个Skill,或导入下载的Skill包
操作步骤:
- 点击右上角⚙️ 齿轮图标
- 左侧菜单选择「规则与技能」
- 右侧切换到「技能」Tab
- 选择「项目」或「全局」(建议选全局)
- 点击「创建」按钮
此时有两种情况:
A. 从零创建:
- 在弹出框输入技能名称(比如"中文注释规范")
- 在编辑区写技能内容(Markdown格式):
# 中文注释规范
## 触发场景:写Python代码时自动生效
## 执行指令:
1. 所有Python代码的注释必须使用中文
2. 每个函数上方要有中文说明
3. 复杂代码行旁边要有中文解释
- 点击「保存」,技能自动生效
B. 上传已有Skill包:
- 点击弹出框里的「上传」按钮
- 选择下载好的
.skill或.zip文件 - Trae自动解析元数据,显示预览
- 确认无误后点击「安装」
4.3 方式二:命令行npx安装(最快捷)
适合:安装开源社区Skill
操作步骤:
- 按
Ctrl+`/Cmd+``打开Trae内置终端 - 输入安装命令,格式:
# 安装单个Skill到全局
npx skills add obra/superpowers --skill brainstorming -g -y
# 安装另一个
npx skills add obra/superpowers --skill writing-plans -g -y
# 安装anthropic官方的Skill
npx skills add anthropics/skills --skill skill-creator -g -y
- 回车执行,等待下载完成
- 安装成功后在对话中直接使用
⚠️ 注意:命令最后加-y跳过交互确认,否则会卡在选择界面超时。
常用Skill安装命令速查:
# 头脑风暴
npx skills add obra/superpowers --skill brainstorming -g -y
# 计划编写
npx skills add obra/superpowers --skill writing-plans -g -y
# 系统化调试
npx skills add obra/superpowers --skill systematic-debugging -g -y
# Skill创建器
npx skills add anthropics/skills --skill skill-creator -g -y
# TDD开发
npx skills add obra/superpowers --skill test-driven-development -g -y
# 搜索发现新Skill
npx skills add https://github.com/vercel-labs/add-skill --skill find-skills -g -y
4.4 方式三:手动部署(最灵活)
适合:从社区下载的Skill文件夹、自定义Skill
操作步骤:
- 确认Skill文件夹里包含SKILL.md文件(这是核心,没有它Trae识别不了)
- 复制整个Skill文件夹
- 粘贴到对应目录:
- 全局共享:
~/.trae/skills/(macOS/Linux)或C:\Users\你的用户名\.trae\skills\(Windows) - 仅当前项目:项目根目录
.trae/skills/
- 全局共享:
- 重启Trae
- 在AI对话窗口测试调用,出现"调用skills"提示即成功
目录结构示例:
~/.trae/skills/
├── my-code-review/
│ ├── SKILL.md # 必须!核心定义文件
│ ├── skill.yaml # 可选,元数据配置
│ └── references/ # 可选,参考文档
└── my-logging-skill/
└── SKILL.md
4.5 方式四:自然语言创建(最省事)
适合:简单的提示词型Skill
操作步骤:
- 在Trae的AI对话输入框中,键入
/skill - 接着描述你想要的功能,比如:
/skill 一个能够将中文翻译成英文的翻译器
- Trae自动生成SKILL.md文件并保存到当前项目的技能目录
- 直接就能用了
进阶玩法:直接对话让Trae帮你创建复杂Skill:
帮我创建一个Skill,要求:
- 名称:嵌入式代码规范
- 所有C代码必须使用英文注释
- 函数命名使用下划线分隔
- 每个头文件必须有include guard
Trae会自动在.trae/skills/下创建对应文件。
4.6 怎么调用已安装的Skill
方式一:手动调用
在对话中明确指定:
使用 code-reviewer 技能审查当前函数
调用 frontend-design 技能,重新设计这个页面
方式二:AI自动调用
AI会根据Skill里定义的"触发场景"自动匹配。你只需要正常描述需求:
帮我审查这段代码的安全性
如果code-reviewer Skill的触发条件包含"代码审查",AI会自动调用它。
方式三:通过命令面板
- 按
Ctrl+Shift+P/Cmd+Shift+P - 输入"技能"
- 选择你要的Skill
4.7 Skill管理——启用/禁用/卸载
- 进入⚙️ 设置 → 规则与技能 → 技能
- 找到目标Skill
- 停用:点击右侧「停用」按钮(Skill还在,但不再生效)
- 卸载:点击「卸载」按钮(彻底删除文件和注册信息)
- 如果是命令行安装的,也可以终端执行:
trae skill remove my-skill-name
五、模型切换实操——不同任务换不同模型
模型选择不在模式切换里,而在对话界面里。
5.1 在哪切换模型
- 打开AI对话面板(
Ctrl+L/Cmd+L) - 在输入框上方,有一个模型名称(比如"Doubao-Seed-2.0-Code")
- 点击模型名称,弹出模型列表
- 选择你要的模型
就这么简单。一条对话里可以随时切换模型,不用重新开对话。
5.2 添加自定义模型
如果内置模型不够用,可以添加兼容OpenAI API格式的自定义模型:
- 打开设置(
Ctrl+,/Cmd+,) - 搜索"AI模型"或导航到AI设置
- 点击「添加自定义模型」
- 填写配置:
表格
| 参数 | 填什么 | 示例 |
|---|---|---|
| 模型名称 | 显示名 | DeepSeek-Coder |
| API端点 | 模型服务URL | https://api.deepseek.com/v1 |
| API密钥 | 你的Key | sk-xxxxxxxx |
- 保存后,模型列表里就能选了
5.3 阿Lee的模型切换习惯
日常打字用Flash(快),写核心逻辑切Claude(稳),做嵌入式换DeepSeek-V4-Pro(懂C),中文需求先让Doubao读一遍(准)。
别一个模型用到底。按任务复杂度换模型,效率差3倍。
六、一条龙配置——20分钟从裸机到满配
把前面所有步骤串起来,按这个顺序做:
第1步:确认环境(5分钟)
- Node.js ≥ 16.0 已安装
- Python ≥ 3.8 已安装
- npx 可用
- Trae版本 ≥ 3.3.21
第2步:装MCP(5分钟)
打开⚙️ 设置 → MCP → 市场,一键添加:
- Context7(实时拉最新文档)
- GitHub(代码仓库操作)
- Memory(AI跨会话记忆)
- File System(AI读写项目文件)
没有特殊需求的,这4个底座就够。别贪多。
第3步:装Skill(5分钟)
打开终端,逐条执行:
npx skills add obra/superpowers --skill brainstorming -g -y
npx skills add obra/superpowers --skill systematic-debugging -g -y
npx skills add anthropics/skills --skill skill-creator -g -y
npx skills add https://github.com/vercel-labs/add-skill --skill find-skills -g -y
装完4个核心Skill,够用了。后面需要什么再用find-skills搜索。
第4步:写项目规则(5分钟)
在项目根目录创建.trae/rules/global.md,写上你的项目铁律:
# 项目铁律
- 语言:TypeScript,strict mode ON
- 命名:变量用camelCase,常量用UPPER_SNAKE
- 所有delete/update操作必须有where条件
- 错误统一走error util,别裸throw
- 注释用中文
规则跟着Git走,队友pull下来自动生效。
第5步:验证配置
在Trae对话里输入:
列出我当前可用的MCP工具和已安装的Skill
AI会告诉你当前配置状态。确认MCP显示running、Skill显示启用,大功告成。
七、血泪踩坑清单
阿Lee踩过的坑,你别再踩:
表格
| 坑 | 症状 | 解法 |
|---|---|---|
| Node.js没装 | MCP装了但报"command not found" | 先装Node.js,终端跑node -v确认 |
| 路径有中文 | MCP/Skill不生效 | 安装路径、项目路径都别用中文 |
| Skill装太多 | AI输出互相矛盾,不知道谁在管 | 从3-5个核心Skill开始,别超5个 |
| MCP之间打架 | AI"工具错乱",调用了错的工具 | 只装4-5个核心MCP,不需要的别装 |
| SOLO模式乱跑 | 改了20个文件,项目炸了 | SOLO任务分阶段,每阶段确认git diff --stat |
| Token过期 | 之前能用的MCP突然报401 | 重新生成Token,更新MCP配置 |
| Windows下npx报错 | 手动配置MCP的command字段不对 | 把command从npx改成npx.cmd |
| 长对话AI失忆 | 10轮后AI忘掉之前的约束 | 每10轮开新对话,贴项目核心约束 |
| fix和code-reviewer同时用 | 两个Skill互相干扰,给矛盾建议 | 先用fix修bug,跑通后再用code-reviewer审质量 |
| Skill顺序不对 | frontend-design被后面规则冲掉 | 把设计类Skill放最后,执行顺序靠后的覆盖前面的 |
写在最后
Trae的配置不难,难的是网上没人把每一步讲清楚。
阿Lee这篇就是给"从来没配过"的人写的——照着做,20分钟从裸机到满配。配完后你会发现,Trae从"聊天玩具"变成了"开发搭档"。
别一上来就想装10个MCP、8个Skill。先装4个MCP底座 + 4个核心Skill,用顺了再加。少即是多。
下一篇阿Lee带大家用配置好的Trae,从0到1写一个真实项目——配置到位,实战才爽。
阿Lee | 10年嵌入式老兵转AI | 口述编程vibe-coding专栏
