Trae 完整教程:从入门、Rules 到 Solo 与 Skills

整理 Trae 的安装、Rules、MCP、上下文、Solo、Plan、SubAgents 和 Skills 使用方法。

本文将公开教程中关于 Trae、Trae Solo、Plan、SubAgents 和 Skills 的重复内容合并成一条上手路径。套餐、模型和地区可用性会变化,涉及账号和服务权限的内容请以 Trae 官方页面为准。

原始知识库入口:AI编程快乐屋

最简单的AI编程工具Trae,保姆级入门与实战

本期视频:

AI编程工具Trae,保姆级入门与实战_哔哩哔哩_bilibili

Trae是字节海外团队出品,Trae 分为国际版和国内版,我们这里讲的是国际版。下载之后进行安装,账号登陆和注册需要开魔法,平时使用不用开界面介绍Rules与MCP安装上下文浏览器SOLO模式整体评价00:00 介绍与计费02:23 界面06:11 上下文15:40 rule与MCP19:02 Agent22:37 实战28:54 总结便宜、简单、大模型齐全Todolist, Memory 这些都

本视频中用的通用Rules


alwaysApply: true


通用软件开发规范与行为准则

核心身份定位

你是一位拥有15年经验的软件架构师和资深开发者,具备严谨、健壮的代码风格,始终以生产环境标准要求自己。你的首要任务是编写高质量、完整且可维护的代码。

1. 核心开发原则

1.1 完整性要求
  • 严格遵守需求:必须完整实现所有功能点和逻辑要求,无论复杂程度如何
  • 拒绝占位符逻辑:禁止使用 TODO、占位符或返回模拟数据等方式应付复杂功能
  • 端到端实现:多步骤流程必须提供所有步骤的完整代码,不得仅实现部分步骤
1.2 问题解决态度
  • 主动解决难题:正面分析技术难题、兼容性问题、性能瓶颈和复杂算法
  • 禁止简化规避:不得通过创建简化版本来绕过实现挑战
  • 技术决策透明:明确说明技术选型、实现思路及权衡考量
1.3 质量与安全保障
  • 全面错误处理:为所有可能失败的操作添加错误处理、异常捕获和重试逻辑
  • 日志与监控:在关键业务逻辑节点主动添加适当的日志输出
  • 安全优先:始终考虑代码安全性,防范常见安全漏洞
  • 边界情况处理:代码必须能够处理各种边界情况和异常场景

2. 项目架构规范

2.1 项目结构原则
  • 分层组织:按功能或领域划分目录,遵循关注点分离原则
  • 命名一致性:使用描述性的目录和文件命名,准确反映用途和内容
  • 模块化设计:相关功能归类到同一模块,最小化跨模块依赖
  • 合理嵌套:避免过深的目录嵌套,一般不超过3-4层
  • 资源分类:明确区分代码、资源、配置和测试文件
  • 依赖管理:集中管理依赖,避免重复声明
  • 约定优先:遵循语言或框架的标准项目结构约定
2.2 架构设计考量
  • 可维护性:设计易于理解、修改和扩展的代码结构
  • 可扩展性:预留合理的扩展点,支持未来功能演进
  • 性能需求:在设计阶段考虑性能要求和优化策略
  • 技术选型:优先使用成熟的库和工具,避免不必要的自定义实现

3. 代码编写规范

3.1 代码质量标准
  • 单一职责:每个组件保持单一职责,提升可测试性
  • DRY 原则:避免重复代码,提取共用逻辑到独立函数或类
  • KISS 原则:保持代码简洁明了,每个方法行数不超过300行
  • 代码可读性:编写自解释的代码,减少理解成本
3.2 命名与文档规范
  • 描述性命名:使用能够准确反映用途和含义的变量、函数和类名
  • 注释文档:所有方法必须添加注释,说明功能、参数、返回值和用法
  • 风格一致性:遵循项目或语言的官方风格指南和代码约定
  • 文档同步:保持代码与文档的同步更新
3.3 异常处理与日志
  • 异常处理:正确处理边缘情况和错误,提供有用的错误信息
  • 日志记录:在关键节点记录必要的运行时信息
  • 监控集成:考虑与监控系统的集成,便于问题排查

4. 工作流程规范

4.1 版本控制
  • 提交规范:编写有意义的提交信息,保持逻辑相关的更改在同一提交中
  • 分支管理:遵循项目的分支管理策略
  • 代码审查:积极参与代码审查,保证代码质量
4.2 任务执行规范
  • 专注核心任务:专注于明确要求的功能实现
  • 避免额外动作:除非明确要求,否则不创建测试文件、文档或其他额外内容
  • 直接响应:任务完成后直接提供所要求的代码和必要说明

5. 交流与响应规范

5.1 语言要求
  • 中文回复:始终使用中文进行回复和交流
  • 技术准确性:确保技术术语使用准确,表达清晰
  • 简洁有效:避免冗余信息,直击要点
5.2 问题分析
  • 需求理解:准确理解用户需求,必要时主动确认细节
  • 方案设计:提供完整、可行的技术方案
  • 风险评估:识别潜在风险并提供相应的解决策略

核心准则:绝对禁止简化。所有实现必须完整、健壮、符合生产环境标准。

安装

Trae是字节海外团队出品,Trae 分为国际版和国内版,我们这里讲的是国际版

TRAE - Collaborate with Intelligence

TRAE IDE integrates seamlessly into your workflow, collaborating with you to maximize performance and efficiency.

下载之后进行安装,账号登陆和注册需要开魔法,平时使用不用开

套餐&计费

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

官方核验与版本边界

Trae 当前官网同时区分 TraeWork 与 TraeCode,下载平台和入口以 Trae 官网下载中心 为准。本文保留的 Builder、SOLO、Plan、Rules 和 Skills 说明来自知识库中的历史教程,界面名称、地区可用性、模型列表和额度可能已经变化;不要把旧教程中的套餐或功能承诺当作当前事实。

新用户首月 $3、支持支付宝

免费版 Pro 版
目标用户 个人 个人
定价 免费 10 美金/月
折扣 - 首次订阅(即新订阅用户)享受优惠价。<br>按年订阅可享受折扣。
订阅类型 - 连续包月:当月订阅到期前,自动续费。<br>包年:一次性支付一年的订阅费用。
付款政策 - 每次仅能发起一次订阅。
退款政策 - 如果在订阅后的 24 小时内且未使用过 Pro 套餐的权益,可将你的 Trae 账号发送至 feedback@mail.trae.ai 申请退款,Trae 的客服团队将尽快处理你的诉求。不符合政策的,不支持退款。
代码自动补全 5000 次/月 无限次
超级模型问答 快速队列:每月 10 次<br>慢速队列:每月 50 次<br>提示:<br>快速队列的最长排队时间为 15 秒;<br>Beta 模型也可能需要排队等待。 快速队列:每月 600 次<br>慢速队列:无限次<br>提示:<br>快速队列的最长排队时间为 15 秒;<br>Beta 模型也可能需要排队等待。
高级模型问答 每月 1000 次(不限队列) 无限次(不限队列)

界面介绍

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

Rules与MCP安装

Rules

  • User 级别:全部项目都是通用的,只要是用Trae IDE打开的项目都有效,只允许一个

  • Project 级别: 只对当前运行的项目有效

规则类型 说明
个人规则 个人规则是基于个人使用习惯和需求为 AI 定制的规则,旨在让 AI 的输出更符合用户的个性化要求。个人规则在所有项目中生效。例如:<br>语言风格:偏好简洁/严谨/幽默等表达方式。<br>操作系统:提供针对 Windows 或 macOS 操作系统的回答。<br>内容深度:是否需要详细解释、示例或仅需结论。<br>交互方式:如倾向于直接答案,还是引导式提问。
项目规则 项目规则是针对当前项目 AI 需要遵循的规则,仅在所配置的项目中生效。例如:<br>代码风格:缩进(空格/制表符)、命名规范(驼峰式/snake_case)等。<br>语言与框架:优先使用的编程语言(如 Python/JavaScript)或框架(如 React/Django)。<br>API 限定:勿使用某些 API。

MCP安装

  • 直接从市场安装

  • 复制JSON地址

上下文

  • 指定文件

  • 指定代码

  • 指定终端

  • 图片

  • #号

浏览器

SOLO模式

整体评价

  • 便宜、简单、大模型齐全

  • Todolist, Memory 这些都会有

  • 适合做单项目,比如只做前端或者后端,项目上难度之后需要更细化的提示词

  • 项目大了之后,编辑器运行比较卡

Trae 已经被停止使用 Claude 模型,有哪些可以代替?

原因

Claude公司把中国视为敌对国家

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

Trae 现有的模型

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

Trae 的补偿措施

Pro 用户到年底,每个月再增加 300 积分

代替选择

  • 如果是不喜欢 CLI(使用命令行) 模式,可以选择以下工具进行替换
AI 编程工具 套餐 支持模型 特点
$15/500次 Claude 所有系列(2x 次数)<br>自己的 SWE1.5 模型非常不错<br>GPT-5-Codex 操作非常简单,<br>支持工作流/command,<br>rules& memories&wiki<br>内置浏览器<br>https://windsurf.com/
$20/1000积分 Claude 4.5<br>Claude 4.0 spec 规范驱动<br>亚马逊背书<br>https://kiro.dev/
按使用 token计费<br>省钱的做法是使用 composer1 Claude所有系列<br>GPT 所有系列<br>自己的 composer1 还行 操作非常简单,<br>Plan模式<br>支持工作流/command,<br>rules& memories&wiki<br>内置浏览器<br>多 Agent 同时运行<br>https://cursor.com/
$10/2000积分<br>不是每次对话一个积分,根据token 消耗转换为积分数量 模型隐藏<br>三种类型选择<br>极致性能 1积分<br>经济高效 0.3积分<br>基础轻量 免费 操作非常简单 <br>Quest 模式<br>超强的记忆和上下文能力<br>rules& memories&wiki<br>https://qoder.com/
等等 可接入 API 建议使用 GLM4.6<br>MiniMax-m2<br>Kimi-k2<br>等有代码套餐的模型 不用魔法<br>rules,memories 都支持<br>速度非常快<br>Visual code 搜索插件
$20/1500 积分 所有主流模型 https://www.warp.dev/
  • CLI(命令行模式)
AI 编程工具 套餐 支持模型 特点
能搞定Claude账号的就用 Claude<br>否则选择<br>Claude Code +GLM 4.6 套餐 超级强大的 Agent 工具<br>https://claude.ai/&lt;br&gt;可以使用 visual code 插件
$20 套餐<br>有日/周调用限制 GPT-5-Codex 所有型号 紧随 Claude code,可以使用 visual code 插件<br>https://openai.com/codex/
$20 套餐<br>20M token Claude所有系列<br>GPT 所有系列 明星产品<br>国外比较多人用 旗下droid<br>https://docs.factory.ai/welcome

Trae Solo 实测,无编程基础福音,有想法就能做产品

官网介绍

Solo | TRAE - Collaborate with Intelligence

SOLO: Your All-in-One Context Engineer. SOLO brings context engineering to life. With editor, terminal, docs, browser, and tools unified in a single workspace, it reasons and acts using exactly the in

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

人群

无编程、设计师、产品经理、任何有具体想法的人

优点

一步到位,不用关心细节,更加的关注需求而不是编码、上下文、规则这些。

非常适合快速做一个动态的原型、小系统、MVP产品

缺点

  • 只适合做Web+国外部署,暂时不支持小程序、APP 直接部署到国内云平台

Trae的这个强大功能,你可能不知道

Trae Agent 介绍

你可以理解为在Trae里面可以定义各种专家,比如:

前端专家

vue专家

java专家

测试大师

等等...

Agent这种非常适合来定义特长类的角色

还可以让agent具备使用MCP的能力

如何定义

方法1:自定义

提示词格式如下

部分 功能
角色职责 说明Agent要做什么、擅长什么
目标 阐述最终输出应达到的视觉与技术标准
沟通风格 规范语言与呈现方式
思维流程 指定逻辑推理与产出步骤
规则 限定行为与质量边界
能力 明确技术栈与设计原则
代码示例 示范输出风格与代码格式
个性化 说明灵活应对与上下文自适应能力

你是一名专门从事界面设计、前端开发和用户体验(UX)的人工智能代理,工作环境是一个智能IDE。

角色职责: - 协助创建现代、响应式且易访问的界面。 -

提出视觉和可用性改进建议。 -

开发和审查前端代码(HTML、CSS、JavaScript、现代框架)。 -

确保视觉一致性并遵循UX/UI最佳实践。 - 清晰、实用地解释设计和前端概念。

目标: - 结合美感与功能性。 - 确保无障碍访问(WCAG、ARIA)。 -

优化性能与响应性。 - 保持视觉与技术一致性。 - 提出现代趋势和微交互建议。

沟通风格: - 使用清晰、简洁且富有启发性的语言。 -

用视觉或代码示例解释技术术语。 -

默认使用葡萄牙语回复,必要时可切换为英语。 -

用标题、列表、表格和代码块组织回答。 - 在可能时提供创意变体。

思维流程: 1. 理解上下文(目标用户、平台、期望风格、技术限制)。 2.

规划回答(概念性、实用性或混合型)。 3.

生成解决方案(代码、视觉指南或交互流程)。 4.

验证(无障碍性、响应性、美学一致性)。 5.

提出改进(动画、微交互、可用性测试等)。

规则: - 不编造不存在的CSS属性、JS方法或库。 -

不建议损害无障碍性或性能的做法。 -

说明解决方案是否为实验性或依赖特定支持。 -

避免视觉负担;优先考虑清晰度和层次结构。

能力: - 使用CSS Grid和Flexbox创建响应式布局。 -

实现流畅的动画与过渡。 - 使用React、Vue或Svelte构建动态界面。 -

提供一致的色彩、字体和间距建议。 - 应用设计系统与原子设计原则。 -

优化图片、字体和资源性能。 - 基于Nielsen启发式和A/B测试改进用户体验。

理想回答示例: 用户:"我需要创建一个漂亮的响应式产品卡片。"\

代理:"以下是一个以响应性与极简美学为重点的HTML和CSS示例:

后续步骤: - 为按钮添加微动画; - 与产品API集成; -

测试颜色对比以确保无障碍访问。

个性化: -

根据用户偏好调整示例与建议(如:极简风格、扁平化设计、Tailwind、Material

UI)。 - 在整个会话中保持视觉与技术一致性。

方法2:抄Claude Code subAgents

Claude Code Templates - Supercharge Your AI Development with Anthropic Claude

Professional templates for Anthropic's Claude Code. Deep coding at terminal velocity with Claude Opus 4.1. Install 100+ agents, commands, settings & hooks. Transform your AI-powered development workfl

github.com

方法3:模仿

输入一段你用的很好的Agent 提示词,让AI模仿一个写一个差不多

方法4: 别人分享

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

我用 TRAE 做了一个有意思的Agent 「FonteUXer」。 点击 https://s.trae.ai/a/156ea3 立即复刻,一起来玩吧!

我的Agent库

名称 链接
UI工程师 我用 TRAE 做了一个有意思的Agent 「FonteUXer」。 点击 https://s.trae.ai/a/156ea3 立即复刻,一起来玩吧!
文档生成 我用 TRAE 做了一个有意思的Agent 「DocGen Master」。 点击 https://s.trae.ai/a/ab42ae 立即复刻,一起来玩吧!
调试专家 我用 TRAE 做了一个有意思的Agent 「DegubMaster」。 点击 https://s.trae.ai/a/b2fab0 立即复刻,一起来玩吧!
WEB测试专家 我用 TRAE 做了一个有意思的Agent 「Web Testing Agent」。 点击 https://s.trae.ai/a/60baf3 立即复刻,一起来玩吧!
导师专家 我用 TRAE 做了一个有意思的Agent 「MentorExpert」。 点击 https://s.trae.ai/a/aa92b2 立即复刻,一起来玩吧!

Trae Solo 两大王牌:Plan与SubAgents全面解析

Plan模式

主要特点:先生成计划文档,你可以进一步的交流,确认最终的计划文档,然后执行代码的编写

使用场景

场景 是否适用 原因
从 0 到 1 完成一个完整的系统 ❌不适用 功能太多,上下文容易撑爆,效果打折
这个功能你写的比 AI 还快 ❌不适用 功能太小,浪费 token
这个功能你需要设计流程,跨表,跨服务等等 ✅适用 分析你的需求,列出具体的计划

总结:

能用就用

SubAgents(子代理)

subAgents 在 claude code 是非常流行的一个功能,目前Trae 只有在 Solo Coder 模式才支持调用子代理

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

SubAgents的作用是什么?

SubAgents 主要作用就是在流程中被合理的安排,用更专业的角色完成任务

SubAgents = 提示词

SubAgents 之间上下文是隔离的, 这就意味着,不同的 subAgents 一定是有非常明显的“职业”区别

为什么有时候subagents没被调用

为 SOLO Coder 配置好其他可调用的智能体后,SOLO Coder 作为主控智能体,可以在执行和处理上下文较长的复杂任务时,自动调用相应的智能体,将任务进行拆分与隔离。这样可以让不同的智能体在独立的上下文中专注处理各自的任务,提升整体的执行效率与结果质量。

此外,你也可以在提示词中明确指定需调用的智能体,SOLO Coder 会根据上下文在相应的时机调用该智能体。

AI 认为你的任务不够复杂,所以没调用,你可以明确的调用

如何在 Trae 中使用 Skills,手把手教学

版本说明

  • 必须是在 Solo 模式,不管是 coder 还是 builder

普通模式不会触发 skill-creator

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

solo 模式下

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

如何创建技能

  • 打开设置,点击规则和技能,点击创建

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

  • 创建的方式有以下几种:

1)手动创建

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

2)下载已有的技能,是 zip 或者 skill 后缀,点击导入

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

3)通过对话,让 AI 下载某个技能

帮我下载这个技能

https://github.com/OthmanAdi/planning-with-files/tree/master/skills/planning-with-files

4)通过 AI 创建技能

我需要创建一个用于下载小程序图标的技能,流程如下:

根据我提供的中文图标名称,比如(首页), 去 iconfont 进行搜索,找到第一个,然后下载下来,保存到 asserts 目录,并整理出一个 md 文档,记录图标的 iconfont地址

如何使用技能

Trae 中只能通过关键词触发

目前版本的skills缺陷

  • 没办法设置全局技能

  • 没办法自动共享 claude 技能

  • 手动通过界面创建,没办法创建 scripts等其他文件

原文此处包含图片,当前版本保留文字说明;请查看原始飞书页面中的图片。

相关标签
TraeTrae SoloRulesSkillsMCPAI编程