下载了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:\我的工具\Trae1.2 首次启动3件事启动后依次做这3步选中文界面首次启动会问语言直接选中文导入VSCode配置如果你之前用VSCode安装过程选「导入配置」——插件、快捷键、主题一键迁移过来确认版本号打开Trae → 左下角齿轮 → 关于确认版本 ≥ 3.3.21低于这个版本不支持Skill1.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面板如果没看到按CtrlL/CmdL打开。面板顶部有个下拉菜单默认显示Chat——这就是模式选择器。点击它下拉列表里会出现所有可选模式。2.2 IDE模式下的3个智能体表格智能体位置一句话说明你需要做什么Chat模式选择器 → Chat只动嘴不动文件问它问题它给答案不碰你的代码Builder模式选择器 → Builder改代码跑命令先问你确认说需求确认执行计划它干活Builder with MCP模式选择器 → Builder with MCPBuilder外部工具链需要连GitHub/Figma等外部服务时选这个操作步骤按CtrlL/CmdL打开左侧AI面板点击面板顶部的模式下拉框选择你要的模式在输入框打字回车发送就这么简单。80%的日常开发用Builder就够了。2.3 SOLO模式下的2个智能体SOLO模式不在左侧面板里需要单独进入。操作步骤点击Trae左侧导航栏的「SOLO」图标在Chat面板下方进入SOLO界面后顶部有两个TabSOLO Builder和SOLO Coder点选你要的那个表格智能体什么时候选SOLO Builder从0开始做一个新项目/原型/MVP——你说需求它全流程自动交付SOLO Coder已有项目要深度迭代——改深层Bug、跨模块重构、复杂业务逻辑2.4 阿Lee的模式选择口诀问问题用Chat写代码用Builder连外网用MCP新项目用SOLO Builder改老代码用SOLO Coder。别纠结。先用Builder不够了再升级模式。三、MCP安装实操——3种方式从简到难MCPModel Context Protocol是Trae的外挂接口。装了MCPAI能操作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你要提前准备什么GitHubGitHub Personal Access TokenSettings → Developer settings → Personal access tokensFigmaFigma Personal Access TokenSettings → 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?typestdionamegithubconfigeyJjb21tYW5kIjoibnB4Ii...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链接响应太慢优先用本地MCPlocalhost避免网络延迟大的云服务批量管理多个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官方的Skillnpx 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# 搜索发现新Skillnpx skills add https://github.com/vercel-labs/add-skill --skill find-skills -g -y4.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.md4.5 方式四自然语言创建最省事适合简单的提示词型Skill操作步骤在Trae的AI对话输入框中键入/skill接着描述你想要的功能比如/skill 一个能够将中文翻译成英文的翻译器Trae自动生成SKILL.md文件并保存到当前项目的技能目录直接就能用了进阶玩法直接对话让Trae帮你创建复杂Skill帮我创建一个Skill要求- 名称嵌入式代码规范- 所有C代码必须使用英文注释- 函数命名使用下划线分隔- 每个头文件必须有include guardTrae会自动在.trae/skills/下创建对应文件。4.6 怎么调用已安装的Skill方式一手动调用在对话中明确指定使用 code-reviewer 技能审查当前函数调用 frontend-design 技能重新设计这个页面方式二AI自动调用AI会根据Skill里定义的触发场景自动匹配。你只需要正常描述需求帮我审查这段代码的安全性如果code-reviewer Skill的触发条件包含代码审查AI会自动调用它。方式三通过命令面板按CtrlShiftP/CmdShiftP输入技能选择你要的Skill4.7 Skill管理——启用/禁用/卸载进入⚙️ 设置 → 规则与技能 → 技能找到目标Skill停用点击右侧「停用」按钮Skill还在但不再生效卸载点击「卸载」按钮彻底删除文件和注册信息如果是命令行安装的也可以终端执行trae skill remove my-skill-name五、模型切换实操——不同任务换不同模型模型选择不在模式切换里而在对话界面里。5.1 在哪切换模型打开AI对话面板CtrlL/CmdL在输入框上方有一个模型名称比如Doubao-Seed-2.0-Code点击模型名称弹出模型列表选择你要的模型就这么简单。一条对话里可以随时切换模型不用重新开对话。5.2 添加自定义模型如果内置模型不够用可以添加兼容OpenAI API格式的自定义模型打开设置Ctrl,/Cmd,搜索AI模型或导航到AI设置点击「添加自定义模型」填写配置表格参数填什么示例模型名称显示名DeepSeek-CoderAPI端点模型服务URLhttps://api.deepseek.com/v1API密钥你的Keysk-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步装MCP5分钟打开⚙️ 设置 → MCP → 市场一键添加Context7实时拉最新文档GitHub代码仓库操作MemoryAI跨会话记忆File SystemAI读写项目文件没有特殊需求的这4个底座就够。别贪多。第3步装Skill5分钟打开终端逐条执行npx skills add obra/superpowers --skill brainstorming -g -ynpx skills add obra/superpowers --skill systematic-debugging -g -ynpx skills add anthropics/skills --skill skill-creator -g -ynpx skills add https://github.com/vercel-labs/add-skill --skill find-skills -g -y装完4个核心Skill够用了。后面需要什么再用find-skills搜索。第4步写项目规则5分钟在项目根目录创建.trae/rules/global.md写上你的项目铁律# 项目铁律- 语言TypeScriptstrict mode ON- 命名变量用camelCase常量用UPPER_SNAKE- 所有delete/update操作必须有where条件- 错误统一走error util别裸throw- 注释用中文规则跟着Git走队友pull下来自动生效。第5步验证配置在Trae对话里输入列出我当前可用的MCP工具和已安装的SkillAI会告诉你当前配置状态。确认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 --statToken过期之前能用的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专栏
