★ FEATURED ARTICLE 1. 为什么新手配 Trae 总卡在 MCP 和 Skill 这一步刚下载 Trae 的人十个里有八个会经历同一个流程装完软件打开界面然后愣住。左侧面板有个下拉框写着 Chat右上角有个齿轮图标设置里翻到「MCP」和「规则与技能」两个陌生词网上搜到的教程又全是「推荐装这几个 MCP」「这几个 Skill 必装」却没人从头讲清楚按钮在哪、配置粘到哪、装完怎么确认它真的生效了。这篇就是补上这一段。Trae 的 MCP 和 Skill 配置本质上是两件事MCP 是给 AI 接上外部工具的手让它能读 GitHub、查文档、操作文件Skill 是给 AI 装上领域大脑让它按你定义的规范干活。模式选择则是决定 AI 用多大的自主权去执行任务。三件事配齐Trae 才从「聊天玩具」变成能真正改代码的开发搭档。适合谁看刚接触 AI 编程、第一次用 Trae、之前只会在对话框里问问题、没碰过 MCP 配置文件和 Skill 目录结构的人。全程按步骤走每一步都带验证动作配完能自己确认状态不用猜。我试过把 MCP、Skill、模式三块拆开单独配结果发现顺序错了会互相干扰——比如先装一堆 Skill 再配 MCPAI 调用工具时会被 Skill 里的规则带偏。所以下面按「先模式认知 → 再 MCP → 再 Skill → 最后串起来验证」的顺序走这个顺序踩坑最少。在开始之前先把环境确认一遍这一步省掉后面全是报错。Trae 版本要 ≥ 3.3.21低于这个版本不支持 Skill 功能打开 Trae 左下角齿轮 → 关于看版本号。Node.js ≥ 16.0终端跑node -v确认Python ≥ 3.8跑python --version确认npx 跟着 Node.js 自动装好跑npx --version确认。这三个没装MCP 和 Skill 装了也跑不起来因为大部分 MCP Server 是靠 npx 启动的本地进程。安装路径和项目路径都别带中文和空格比如D:\DevTools\Trae可以D:\我的工具\Trae不行。这个坑很隐蔽MCP 启动时命令行解析路径会出错报错信息还看不出是路径问题。环境确认完下面进入正题。2. Trae 模式选择对照表与切换位置详解Trae 的模式不是一个按钮切来切去而是分成两个世界IDE 模式和 SOLO 模式。很多人找不到模式在哪切是因为把这两个世界混在一起找了。IDE 模式的入口在左侧 Chat 面板。按CtrlLmacOS 是CmdL打开 AI 面板面板顶部有个下拉菜单默认显示 Chat这就是模式选择器。点开它列表里会出现 IDE 模式下的三个智能体。SOLO 模式的入口不在左侧面板里在左侧导航栏的「SOLO」图标位置在 Chat 面板下方。点进去是独立的 SOLO 界面顶部有两个 TabSOLO Builder 和 SOLO Coder。把五个智能体放一张表里对照选起来就清楚了智能体所在位置一句话说明什么时候选ChatIDE 模式选择器只动嘴不动文件问问题、查概念、要思路BuilderIDE 模式选择器改代码 跑命令执行前问你确认日常写代码、改函数、加功能Builder with MCPIDE 模式选择器Builder 外部工具链需要连 GitHub、Figma、数据库时SOLO BuilderSOLO 界面 Tab从零做新项目全流程自动交付新项目、原型、MVPSOLO CoderSOLO 界面 Tab已有项目深度迭代改深层 Bug、跨模块重构操作路径统一是按CtrlL打开面板 → 点顶部模式下拉框 → 选模式 → 输入框打字回车。SOLO 则是点左侧 SOLO 图标 → 选 Tab → 输入需求。选模式有个简单口诀问问题用 Chat写代码用 Builder连外部服务用 Builder with MCP新项目用 SOLO Builder改老代码用 SOLO Coder。80% 的日常开发用 Builder 就够了别一上来就纠结。这里有个容易忽略的点模式决定的是 AI 的自主权边界不是模型能力。Chat 模式下 AI 再强也不会碰你的文件Builder 模式下 AI 会先给执行计划等你确认SOLO 模式下 AI 会连续执行多步操作。所以选模式本质是选「你愿意让 AI 自动做多少事」。验证模式是否切换成功切到 Builder 后输入「帮我在当前项目新建一个 hello.js 文件」如果 AI 回复里出现执行计划并等你确认说明 Builder 生效如果只是给你一段代码让你自己复制说明还在 Chat 模式。这个对比动作做完你对模式的理解就落地了。模式认知清楚后接下来配 MCP。因为 Builder with MCP 和 SOLO 模式要调用外部工具MCP 没配好这两个模式的能力是残缺的。3. Trae 安装 MCP 的三种方式与可复制配置片段MCP 全称 Model Context Protocol你可以把它理解成 Trae 的「外挂接口」。装了 MCPAI 能操作 GitHub 仓库、读 Figma 设计稿、查数据库、抓网页内容。没装 MCPAI 只能在你当前打开的文件里打转。进入 MCP 配置页的路径点右上角齿轮图标设置→ 左侧菜单找「MCP」或「模型上下文协议」→ 进去后看到两个 Tab「市场」和「手动配置」。方式一市场一键添加最适合新手。在市场 Tab 里浏览或搜索你要的 MCP比如输入 Figma找到后点右侧「 添加」部分 MCP 会弹窗要 API Token粘贴进去点保存看到「连接成功」提示就成了。热门 MCP 需要提前准备的凭证GitHub 需要 Personal Access Token在 GitHub Settings → Developer settings → Personal access tokens 生成Figma 需要 Personal Access TokenSettings → Account → Personal access tokens高德地图需要 Web 服务 API Key。方式二手动粘贴 JSON 配置适合市场里没有的 MCP。在 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仅当前项目生效且优先级更高。直接编辑这两个文件和在界面里粘贴效果一样团队协作时把项目级配置跟着 Git 走队友 pull 下来自动生效。方式三Schema 链接一键导入适合从博客或社区看到的配置。复制别人给的trae-cn://开头的链接在 Trae 里点击或粘贴到地址栏回车Trae 自动解析配置并弹确认框点「确认导入」即可。链接格式类似trae-cn://trae.ai-ide/mcp-import?typestdionamegithubconfig...。如果你用的是 Cline MCP 或 Codex 那套配置习惯迁移到 Trae 时记住三件套要写全Base URL、Key、Model ID。Trae 的 MCP 配置里远程服务对应 url 字段Base URLheaders 里的 Authorization 对应 Key具体模型 ID 在模型设置里单独配别混在 MCP 配置里。验证 MCP 是否生效在对话里切到 Builder with MCP输入「帮我用 GitHub MCP 创建一个新分支 feat/login」。如果 AI 正常调用 GitHub 功能说明 MCP 生效如果报「工具调用失败」往下看排错章节。装 MCP 别贪多。Context7实时拉最新文档、GitHub代码仓库操作、Memory跨会话记忆、File System读写项目文件这四个底座够用了装太多会互相打架AI 调用工具时容易错乱。4. Trae 安装 Skill 的四种方式与生效验证Skill 是 Trae 的「外挂大脑」把常用提示词、工作流、代码规范封装成技能包AI 从通用助手变成领域专家。装 Skill 之前先搞清装在哪三个层级优先级从高到低项目级.trae/skills/仅当前项目生效用户级~/.trae/skills/或~/.trae-cn/skills/所有项目共享全局.agents/skills/跨 IDE 所有 Agent 共享。建议统一装用户级除非某个项目有特殊规范才用项目级覆盖。方式一设置界面创建或上传最直观。点齿轮 → 「规则与技能」→ 切到「技能」Tab → 选「项目」或「全局」建议全局→ 点「创建」。从零创建时输入技能名称在编辑区写 Markdown 内容# 中文注释规范 ## 触发场景写 Python 代码时自动生效 ## 执行指令 1. 所有 Python 代码的注释必须使用中文 2. 每个函数上方要有中文说明 3. 复杂代码行旁边要有中文解释点保存自动生效。上传已有 Skill 包则点「上传」选.skill或.zip文件Trae 解析元数据后点「安装」。方式二命令行 npx 安装最快捷。按Ctrl打开内置终端执行# 头脑风暴 npx skills add obra/superpowers --skill brainstorming -g -y # 系统化调试 npx skills add obra/superpowers --skill systematic-debugging -g -y # Skill 创建器 npx skills add anthropics/skills --skill skill-creator -g -y # 搜索发现新 Skill npx skills add https://github.com/vercel-labs/add-skill --skill find-skills -g -y命令最后加-y跳过交互确认否则会卡在选择界面超时。-g表示装到全局。方式三手动部署最灵活。确认 Skill 文件夹里有SKILL.md文件核心没有它 Trae 识别不了把整个文件夹复制到~/.trae/skills/Windows 是C:\Users\你的用户名\.trae\skills\或项目根目录.trae/skills/重启 Trae 后在对话里测试调用。目录结构长这样~/.trae/skills/ ├── my-code-review/ │ ├── SKILL.md # 必须核心定义文件 │ ├── skill.yaml # 可选元数据配置 │ └── references/ # 可选参考文档 └── my-logging-skill/ └── SKILL.md方式四自然语言创建最省事。在对话输入框键入/skill接着描述功能比如/skill 一个能够将中文翻译成英文的翻译器Trae 自动生成 SKILL.md 并保存到当前项目技能目录。复杂 Skill 也可以直接对话让 Trae 创建把名称、规范、命名要求写清楚它会在.trae/skills/下建好文件。调用 Skill 有三种方式手动调用在对话里明确写「使用 code-reviewer 技能审查当前函数」AI 自动调用正常描述需求AI 根据 Skill 里定义的触发场景自动匹配命令面板按CtrlShiftP输入「技能」选择。验证 Skill 是否生效装完后在对话里输入「列出我当前可用的 MCP 工具和已安装的 Skill」AI 会返回当前配置状态。确认 Skill 显示启用再输入一个触发场景比如装了 systematic-debugging 后输入「帮我系统化排查这个报错」如果 AI 回复里出现「调用 skills」提示说明生效。管理 Skill设置 → 规则与技能 → 技能找到目标 Skill点「停用」是保留文件但不再生效点「卸载」是彻底删除。命令行装的也可以执行trae skill remove my-skill-name。Skill 别装太多3 到 5 个核心的就够。装多了 AI 输出会互相矛盾你不知道谁在管。而且 Skill 执行顺序有讲究靠后的会覆盖前面的设计类 Skill 放最后。5. Trae 配置常见报错排查对照配 MCP 和 Skill 时遇到的报错大部分集中在几个固定位置。下面按真实报错对照排查。401 报错MCP 之前能用突然报 401。这是 Token 过期了重新生成 Token 更新 MCP 配置即可。GitHub 的 Token 有有效期Figma 的也是别以为配一次就永久有效。local proxy failed本地 MCP Server 启动失败。先检查 Node.js 是否装了终端跑node -v再检查 MCP 配置里的 command 字段Windows 下 npx 有时要写成npx.cmd最后手动在终端跑一次配置里的命令比如npx -y modelcontextprotocol/server-filesystem D:\DevProjects看具体报什么错。reading choices 报错通常是 MCP 返回的数据格式和 Trae 预期不一致或者 MCP Server 版本太旧。更新 MCP Server 到最新版或者换用市场里官方维护的版本。OAuth 相关报错远程 MCP 服务需要 OAuth 授权时出现。检查 headers 里的 Authorization 格式Bearer 后面有没有多余空格Token 是不是复制完整了。command not foundMCP 装了但报这个。Node.js 没装或没加到 PATH重装 Node.js 并勾选「Add to PATH」。工具调用失败或 404MCP Server 没在运行。终端手动跑一次 npx 命令看是否卡住卡住说明网络或包下载有问题。Agent 不调用 MCP提示词里没写触发词。明确写「使用 MCP」「调用 GitHub 工具」AI 才知道要调。Skill 装了不生效检查 SKILL.md 是否存在路径是否在.trae/skills/下Trae 是否重启过。项目级 Skill 只在当前项目生效换项目就没了。两个 Skill 互相干扰比如 fix 和 code-reviewer 同时用给矛盾建议。先用 fix 修 Bug跑通后再用 code-reviewer 审质量别同时开。SOLO 模式乱跑改了 20 个文件SOLO 任务要分阶段每阶段确认git diff --stat看改了哪些文件别一次性放权。长对话 AI 失忆10 轮后 AI 忘掉之前的约束。每 10 轮开新对话把项目核心约束重新贴一遍。路径有中文导致 MCP 不生效安装路径和项目路径都别用中文改成纯英文路径。Skill 顺序不对被覆盖frontend-design 被后面的规则冲掉。把设计类 Skill 放最后执行顺序靠后的覆盖前面的。Windows 下 npx 报错手动配置 MCP 的 command 字段不对把 command 从npx改成npx.cmd。这些报错覆盖了 90% 的配置问题。遇到没列出来的先看 Trae 的输出面板有没有详细日志再对照 MCP 配置里的命令手动跑一遍大部分问题能定位到具体哪一行。6. 从裸机到满配的完整配置流程与后续接入把前面所有步骤串成一条线按这个顺序做20 分钟能从裸机到满配。第 1 步确认环境5 分钟。Node.js ≥ 16.0、Python ≥ 3.8、npx 可用、Trae 版本 ≥ 3.3.21四个都确认一遍。第 2 步装 MCP5 分钟。打开设置 → MCP → 市场一键添加 Context7、GitHub、Memory、File System 四个底座。没有特殊需求这四个就够别贪多。第 3 步装 Skill5 分钟。打开终端逐条执行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装完四个核心 Skill后面需要什么用 find-skills 搜索。第 4 步写项目规则5 分钟。在项目根目录创建.trae/rules/global.md写上项目铁律# 项目铁律 - 语言TypeScriptstrict mode ON - 命名变量用 camelCase常量用 UPPER_SNAKE - 所有 delete/update 操作必须有 where 条件 - 错误统一走 error util别裸 throw - 注释用中文规则跟着 Git 走队友 pull 下来自动生效。第 5 步验证配置。在对话里输入「列出我当前可用的 MCP 工具和已安装的 Skill」确认 MCP 显示 running、Skill 显示启用。配置完成后如果你需要更稳定的模型接入来跑 Coding Plan 或 Agent 类任务可以到 TaoToken 的 Coding Plan 页面看看长期编码方案模型对话入口适合验证单个模型效果API Keys 页面用来生成和管理接入凭证接入文档里有完整的 Base URL 和参数说明。Claude Code 相关的接入配置在文档里也有对应章节按三件套Base URL Key Model ID填全就能跑通。配好之后别急着装更多 MCP 和 Skill。先用这套配置跑一个真实的小项目感受一下 Builder 模式和 SOLO 模式的差别用顺了再按需加。少即是多配置到位实战才爽。
阅读完成 · 觉得有帮助？
