下载了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步：
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等外部服务时选这个 |
操作步骤：
就这么简单。80%的日常开发用Builder就够了。
2.3 SOLO模式下的2个智能体
SOLO模式不在左侧面板里，需要单独进入。
操作步骤：
表格
| 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配置：
3.2 方式一：市场一键添加（最推荐新手）
适合： GitHub、Figma、Tavily Search等热门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
操作步骤：
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"
}
}
}
}
配置文件放哪？
- 全局配置：~/.trae-cn/mcp.json（所有项目共享）
- 项目级配置：项目根目录 .trae/mcp.json（仅当前项目生效，优先级更高）
直接编辑这些文件也行，效果和在界面里粘贴一样。
3.4 方式三：Schema链接一键导入
适合： 从博客/社区看到的MCP配置，别人分享的链接
操作步骤：
链接格式长这样：
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包
操作步骤：
此时有两种情况：
A. 从零创建：
# 中文注释规范
## 触发场景：写Python代码时自动生效
## 执行指令：
1. 所有Python代码的注释必须使用中文
2. 每个函数上方要有中文说明
3. 复杂代码行旁边要有中文解释
B. 上传已有Skill包：
4.3 方式二：命令行npx安装（最快捷）
适合： 安装开源社区Skill
操作步骤：
# 安装单个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
操作步骤：
- 全局共享：~/.trae/skills/（macOS/Linux）或 C:\\Users\\你的用户名\\.trae\\skills\\（Windows）
- 仅当前项目：项目根目录 .trae/skills/
目录结构示例：
~/.trae/skills/
├── my-code-review/
│ ├── SKILL.md # 必须！核心定义文件
│ ├── skill.yaml # 可选，元数据配置
│ └── references/ # 可选，参考文档
└── my-logging-skill/
└── SKILL.md
4.5 方式四：自然语言创建（最省事）
适合： 简单的提示词型Skill
操作步骤：
/skill 一个能够将中文翻译成英文的翻译器
进阶玩法： 直接对话让Trae帮你创建复杂Skill：
帮我创建一个Skill，要求：
– 名称：嵌入式代码规范
– 所有C代码必须使用英文注释
– 函数命名使用下划线分隔
– 每个头文件必须有include guard
Trae会自动在 .trae/skills/ 下创建对应文件。
4.6 怎么调用已安装的Skill
方式一：手动调用
在对话中明确指定：
使用 code-reviewer 技能审查当前函数
调用 frontend-design 技能，重新设计这个页面
方式二：AI自动调用
AI会根据Skill里定义的"触发场景"自动匹配。你只需要正常描述需求：
帮我审查这段代码的安全性
如果code-reviewer Skill的触发条件包含"代码审查"，AI会自动调用它。
方式三：通过命令面板
4.7 Skill管理——启用/禁用/卸载
trae skill remove my-skill-name
五、模型切换实操——不同任务换不同模型
模型选择不在模式切换里，而在对话界面里。
5.1 在哪切换模型
就这么简单。一条对话里可以随时切换模型，不用重新开对话。
5.2 添加自定义模型
如果内置模型不够用，可以添加兼容OpenAI API格式的自定义模型：
表格
| 模型名称 | 显示名 | 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专栏
