核心内容摘要
突破Windows苹果设备限制：开源驱动解决方案全功能实现指南
官方下载国际版https://www.trae.ai/国内版https://www.trae.com.cn/摘要字节跳动推出的 AI 原生 IDE深度集成 GPT-
Gemini-
豆包等顶尖模型提供 Chat、Builder、SOLO 三种开发模式。
支持自定义智能体、MCP 工具扩展、Rules 规则控制国内版完全免费。
本文手把手教你安装配置、模型选择、实战技巧助你效率翻倍
Trae 是什么Trae发音 /treɪ/是字节跳动推出的AI 原生集成开发环境AI IDE于 2025 年 1 月正式发布。
与传统的 IDE AI 插件组合不同Trae 从底层架构上就将 AI 能力深度集成实现了真正意义上的AI 主导开发。
核心定位Trae 以“自主智能体Agent”为核心定位彻底重构了传统开发流程Chat 模式智能代码补全、问答、解释和优化Builder 模式自然语言一键生成完整项目框架SOLO 模式AI 自主规划并执行开发任务版本划分版本定位核心特色适用人群Trae 国际版面向全球开发者GPT-4o、Claude
3.
Gemini 等国际顶尖模型海外用户、国际化项目Trae 国内版面向国内开发者Doubao-
5-pro、DeepSeek-R1/V3 等国产模型国内用户、中文项目两种形态Trae 提供两种产品形态满足不同需求形态说明特点Trae IDE完整的独立 IDE功能最全AI 能力深度集成Trae 插件VS Code / JetBrains 插件轻量级在现有 IDE 中增强 AI 能力
安装 Trae
1 系统要求系统版本要求存储空间WindowsWindows 10/11建议 SSD预留 1GBmacOSmacOS
1
15建议 SSD预留 1GB提示安装包约 600MB建议使用 SSD 以获得最佳性能。
⚠️注意Linux 版本目前仍在开发中尚未正式发布。
请关注官方公告获取最新信息。
2 下载安装Windows 为例步骤 1选择版本国内用户访问https://www.trae.com.cn/海外用户访问https://www.trae.ai/步骤 2下载安装包点击首页的立即下载按钮选择对应系统的版本Windows 用户下载.exe安装包macOS 用户下载.dmg安装包步骤 3运行安装程序双击下载的安装包点击同意许可协议选择安装路径建议保持默认点击下一步完成安装步骤 4首次启动安装完成后桌面会出现 Trae 图标。
双击启动你会看到模式选择界面┌─────────────────────────────────────┐ │ Trae IDE │ │ │ │ [选择开发模式] │ │ │ │ ● Chat 模式 - 智能问答与代码补全 │ │ ○ Builder 模式 - 一键生成项目框架 │ │ ○ SOLO 模式 - AI 自主开发 │ │ │ └─────────────────────────────────────┘
Trae 的三种开发模式Trae 提供三种 AI 开发模式适应不同场景
1 Chat 模式智能问答适合场景日常编码辅助、代码解释、Bug 修复核心功能✅ 智能代码补全Tab 键一键接受✅ 代码解释选中代码右键解释✅ 智能问答侧边栏 Chat 功能✅ 代码优化建议✅ Bug 诊断与修复使用示例# 输入注释按 Tab 自动补全代码# 计算斐波那契数列的前 n 项deffibonacci(n):Trae 会自动补全这个函数的实现ifn0:return[]elifn1:return[0]elifn2:return[0,1]fib[0,1]foriinrange(2,n):fib.append(fib[i-1]fib[i-2])returnfib
2 Builder 模式项目生成适合场景快速搭建项目框架、原型开发核心功能️ 自然语言描述需求一键生成完整项目 自动创建项目结构和文件 自动配置技术栈和依赖 生成基础代码和注释使用示例在 Builder 模式的对话框中输入帮我创建一个 Python 爬虫项目爬取豆瓣电影 Top250 的电影信息 包括电影名、评分、导演、主演保存到 CSV 文件中。
使用 requests BeautifulSoup包含异常处理和日志记录。
Trae 会自动创建项目文件夹douban-spider/生成spider.py- 爬虫主程序生成requirements.txt- 依赖列表生成README.md- 项目说明生成config.py- 配置文件
3 SOLO 模式AI 自主开发适合场景自动化任务、快速原型、非专业程序员核心功能 AI 自主规划并执行开发任务 自动迭代优化代码 自动运行测试和调试 自动完成端到端开发使用示例创建一个待办事项 Web 应用使用 Flask 框架。
功能包括添加任务、标记完成、删除任务、显示所有任务。
前端使用简单的 HTML 和 CSS要求界面美观。
Trae 会自动完成从项目创建到运行测试的整个流程。
AI 模型选择与切换
1 国内版模型阵容国内版主打国产大模型联盟覆盖字节跳动、智谱AI、MiniMax、月之暗面等国内顶尖AI厂商模型厂商定位特色Doubao-Seed-Code字节跳动代码专用模型针对编程场景深度优化代码生成速度快GLM-
7智谱AI旗舰模型中文理解能力强逻辑推理优秀GLM-
6智谱AI高性能模型平衡性能与速度适合日常开发MiniMax-M
1MiniMax最新版本长文本处理能力突出MiniMax-M2MiniMax稳定版本通用能力强响应速度快Kimi-K
5月之暗面最新版本长上下文窗口适合大型项目分析Kimi-K
月之暗面稳定版本代码理解和生成能力均衡国内版优势✅ 国产模型针对中文编程场景深度优化✅ 对国内技术栈Vue、Ant Design、Element Plus等理解更深入✅ 网络访问零延迟响应速度快✅ 符合国内数据合规要求✅ 完全免费使用
2 国际版模型阵容国际版汇聚全球顶尖AI模型覆盖OpenAI、Google、DeepSeek、月之暗面等国际厂商模型厂商定位特色GPT-
2-CodexOpenAI代码专用模型最新编程模型代码生成质量顶尖GPT-
2OpenAI最新旗舰多模态能力强复杂逻辑处理优秀GPT-
1OpenAI稳定旗舰综合能力均衡适合大多数场景GPT-5-mediumOpenAI中端模型速度与质量平衡GPT-5-highOpenAI高端模型高质量输出适合复杂任务Gemini-3-Pro-PreviewGoogle专业预览版超长上下文大型项目分析利器Gemini-3-Pro-Preview (200k)Google超长上下文版支持20万token上下文适合代码库分析Gemini-
5-ProGoogle专业版推理能力强数学和算法表现优异Gemini-3-Flash-PreviewGoogle快速预览版响应速度快适合实时编码Gemini-
5-FlashGoogle快速版低延迟适合日常补全Kimi-K
月之暗面稳定版本长上下文支持代码理解深入DeepSeek-V
1DeepSeek代码专用开源模型中的佼佼者代码生成质量高国际版优势✅ GPT-5系列在代码生成质量上处于全球领先地位✅ Gemini-3系列支持超长上下文适合大型项目✅ 多语言支持能力强适合国际化开发✅ 在算法、数据结构等计算机科学基础领域表现卓越
3 模型切换方法切换步骤点击左下角模型名称如Doubao-
5-pro在弹出的模型列表中选择想要的模型新对话将使用选中的模型选择建议场景国内版推荐国际版推荐快速代码补全Doubao-Seed-CodeGPT-
2-Codex复杂逻辑推理GLM-
7GPT-
2 / Gemini-
5-Pro长文本分析Kimi-K
5Gemini-3-Pro-Preview (200k)通用开发MiniMax-M2GPT-5-medium / Gemini-
5-Flash算法实现GLM-
7GPT-5-high大型项目分析Kimi-K
5Gemini-3-Pro-Preview (200k)快速响应MiniMax-M2Gemini-
5-Flash开源项目-DeepSeek-V
1
实战案例案例 1用 Builder 模式创建项目需求创建一个 Vue 3 TypeScript 的电商后台管理系统步骤切换到 Builder 模式在对话框输入创建一个电商后台管理系统使用 Vue 3 TypeScript Element Plus 包含商品管理、订单管理、用户管理、数据统计四大模块 要求界面美观、响应式布局并包含登录页面。
等待 AI 自动生成项目按提示运行项目Trae 会自动生成src/components/- 组件目录src/views/- 页面目录src/router/- 路由配置src/store/- 状态管理package.json- 项目配置案例 2用 Chat 模式调试代码场景遇到一个 Bug不知道原因步骤选中报错的代码右键选择解释代码Trae 会分析代码并指出问题点击修复按钮自动修复 Bug示例# 有 Bug 的代码defdivide(a,b):returna/b# 没有处理 b0 的情况# Trae 会提示# 这段代码存在除零风险建议添加异常处理# 修复后的代码defdivide(a,b):try:returna/bexceptZeroDivisionError:return错误除数不能为零案例 3用 SOLO 模式完成自动化任务场景需要批量处理数据文件步骤切换到 SOLO 模式描述任务帮我写一个 Python 脚本批量处理当前文件夹下的所有 CSV 文件 将每个文件的第一列数据求和并将结果保存到新的 CSV 文件中。
Trae 自动编写、运行、验证代码
Trae 插件版使用
1 插件版 vs IDE 版对比项Trae IDETrae 插件安装方式独立安装包VS Code / JetBrains 插件市场功能完整性功能最全核心 AI 功能资源占用较高较低适用场景主力开发工具现有 IDE 增强
2 安装 Trae 插件VS Code打开 VS Code点击左侧扩展图标或按CtrlShiftX搜索 “Trae”点击安装安装完成后左侧会出现 Trae 图标
3 插件版功能插件版提供核心 AI 功能Chat 智能问答代码补全代码解释Bug 修复⚠️注意Builder 模式和 SOLO 模式仅在 Trae IDE 完整版中提供。
七、
常见问题与解决方案Q1国内版和国际版有什么区别对比项国内版国际版核心模型Doubao-Seed-Code / GLM / MiniMax / KimiGPT-5 / Gemini-3 / DeepSeek网络访问国内直接访问需国际网络环境中文支持深度优化一般代码质量优秀顶尖使用成本完全免费免费额度 付费订阅数据合规境内处理境外处理选择建议国内用户优先选择国内版网络稳定、中文支持好、完全免费海外用户或有国际网络环境的用户可选择国际版模型能力更强Q2Trae 会泄露我的代码吗Trae 官方承诺代码仅用于提供 AI 服务不会用于训练模型国内版数据处理在境内符合合规要求Q3可以导入 VS Code 的配置吗可以Trae IDE 基于 VS Code 开发支持导入 VS Code 的设置安装 VS Code 插件使用 VS Code 快捷键Q4免费版有使用限制吗国内版完全免费无使用限制国际版有免费额度限制重度使用需购买订阅Q5支持哪些编程语言Trae 支持主流编程语言Python、JavaScript/TypeScriptJava、Go、RustC/C、C#HTML/CSS、SQL以及更多…
自定义智能体打造专属 AI 助手Trae 最强大的功能之一是支持创建自定义智能体。
通过配置专属的提示词和工具集你可以打造面向特定开发场景的编程助手。
1 什么是自定义智能体自定义智能体是 Trae 中面向特定开发场景的编程助手。
与通用 Chat 不同自定义智能体专注特定领域如前端架构、后端开发、代码审查等️集成专属工具通过 MCP 连接数据库、API 等外部服务遵循团队规范封装代码风格、审查标准等团队规范支持分享导入一键分享给团队成员使用
2 创建自定义智能体步骤 1打开智能体管理点击左侧边栏的智能体图标点击创建智能体按钮步骤 2配置智能体┌─────────────────────────────────────┐ │ 创建自定义智能体 │ │ │ │ 名称前端架构师 │ │ 描述专注于 React/Vue 组件设计 │ │ │ │ 提示词Prompt │ │ ───────────────────────────────── │ │ 你是一位资深前端架构师精通 │ │ React、Vue、Angular 等主流框架。
│ │ │ │ 职责 │ │
设计可维护、可扩展的前端架构 │ │
提供性能优化方案 │ │
制定代码规范和最佳实践 │ │
指导组件设计和状态管理 │ │ │ │ 输出要求 │ │ - 提供具体的代码示例 │ │ - 解释设计决策的原因 │ │ - 指出潜在的风险和
注意事项 │ │ ───────────────────────────────── │ │ │ │ [添加 MCP 工具] [保存] [分享] │ └─────────────────────────────────────┘步骤 3添加 MCP 工具可选点击添加 MCP 工具从 MCP 市场选择需要的工具数据库操作工具API 调用工具文件系统工具代码分析工具
3 推荐的自定义智能体类型智能体名称适用场景核心能力前端架构师React/Vue 项目组件设计、状态管理、性能优化后端工程师API 开发接口设计、数据库建模、缓存策略代码审查员代码质量规范检查、Bug 识别、重构建议测试专家测试开发测试用例生成、覆盖率分析、自动化测试DevOps 助手运维部署CI/CD 配置、Docker 编写、云资源管理数据分析师数据处理SQL 优化、数据清洗、可视化建议安全顾问安全审计漏洞检测、安全编码规范、加密建议文档工程师技术文档API 文档生成、README 编写、注释规范
4 分享与导入智能体分享智能体创建完成后点击分享按钮生成分享链接trae://agent/import?agentxxxidxxx将链接分享给团队成员导入智能体点击他人分享的链接跟随指引一键导入在聊天窗口中选择该智能体即可使用
MCP无限扩展的工具生态
1 什么是 MCPMCPModel Context Protocol模型上下文协议是一种开放协议它允许大语言模型访问自定义的工具和服务。
通过 MCPAI 可以调用外部 API 获取实时数据操作文件系统和数据库与第三方服务集成执行特定的业务逻辑
2 MCP 架构┌─────────────────┐ ┌─────────────┐ ┌─────────────────┐ │ Trae 智能体 │────▶│ MCP 客户端 │────▶│ MCP Server │ │ (Agent/Builder)│ │ (内置) │ │ (外部工具服务) │ └─────────────────┘ └─────────────┘ └─────────────────┘ │ ▼ ┌─────────────┐ │ 第三方服务 │ │ - 数据库 │ │ - API │ │ - 文件系统 │ └─────────────┘
3 MCP 市场Trae内置了 MCP 市场提供了社区中上百个热门的 MCP Servers类别典型 MCP Servers数据库PostgreSQL、MySQL、MongoDB 等数据库操作工具文件操作文件系统管理、文档处理、图像处理等Web 服务HTTP 请求、API 调用、网页抓取等开发工具Git 操作、代码分析、测试工具等云服务AWS、Azure、GCP 等云平台操作添加 MCP Server 的方式从市场添加浏览 MCP 市场一键安装所需工具手动添加配置自定义 MCP Server 的地址和参数
4 MCP 使用示例场景连接数据库自动生成 CRUD 代码在智能体中添加 PostgreSQL MCP Server输入需求“根据 users 表结构生成 CRUD API”AI 自动查询表结构生成对应的代码
Rules让 AI 更听话的秘密
1
1 什么是 RulesRules是 Trae 中用于控制 AI 行为的规则系统。
通过 Rules你可以设定代码风格规范定义项目目录结构指定输出格式要求控制规则生效时机
1
2 Rules 的四种生效方式TRAE Rules 提供了 4 种生效方式用来控制适用范围与时机生效方式适用场景典型例子始终生效低冲突、强一致、任何任务都不应违背的规则输出语言、格式约定、通用代码风格指定文件生效边界清晰、与文件类型/目录强相关的规则SQL 迁移规范、前端组件规范、后端 API 设计智能生效偶尔使用但重要希望相关时自动出现的规则日志排查 SOP、性能优化指南、安全最佳实践手动触发生效仅在特定场景下需要避免自动干扰的规则特定业务流程、临时规范、实验性指导
1
3 多规则管理Trae 支持配置多条 Rule 文件把不同主题/职责拆到不同文件里规则文件结构示例.trae/ ├── frontend-general.md # 始终生效通用前端规范 ├── react-components.md # 指定文件生效React 组件规范 ├── css-styling.md # 指定文件生效CSS 样式规范 ├── performance-optimization.md # 智能生效性能优化指南 └── debugging-sop.md # 手动触发调试标准流程优势✅可维护性每条规则只管一类事情修改更集中✅可协作性团队可以按职责分工维护不同规则文件✅可组合性不同项目可以复用同一组模块
1
4 Rules 编写技巧规则编写原则保持简洁每条规则尽量控制在合理长度专注于核心内容明确边界清晰定义规则的适用范围和不适用场景提供示例为复杂规则提供具体的示例帮助模型理解定期更新建立规则的定期审查和更新机制示例 Rule 文件# 前端开发规范 ## 代码风格 - 使用 2 个空格缩进 - 使用单引号而非双引号 - 最大行长度 100 字符 ## React 组件规范 - 函数组件优先使用 Hooks - Props 必须定义类型TypeScript - 组件名使用 PascalCase ## 性能优化 - 图片使用 WebP 格式 - 大列表使用虚拟滚动 - 避免不必要的重渲染
进阶技巧
1
1 自定义快捷键Trae 支持自定义快捷键打开设置Ctrl,搜索快捷键自定义你喜欢的快捷键推荐设置CtrlShiftA- 打开 ChatCtrlShiftB- 打开 BuilderTab- 接受 AI 建议默认
1
2 提示词优化技巧明确技术栈在 Prompt 中明确指定框架和库版本提供示例给出期望的代码风格示例分步骤描述复杂需求拆分为多个步骤指定输出格式明确代码注释语言中文/英文示例请帮我写一个 Python 函数使用 pandas 读取 CSV 文件 要求
处理文件不存在的情况
处理编码错误
返回 DataFrame 对象
添加详细的中文注释
1
3 使用代码片段SnippetsTrae 支持代码片段打开用户代码片段CtrlShiftP→ “配置用户代码片段”创建自定义片段输入前缀快速插入代码示例 Python 片段{FastAPI Hello World:{prefix:fastapi-hello,body:[from fastapi import FastAPI,,app FastAPI(),,app.get(\/\),async def root():, return {\message\: \Hello World\}],description:FastAPI 基础模板}}
十二、
总结Trae 的核心优势✅AI 原生不是插件而是深度集成 AI 的 IDE✅三模式Chat、Builder、SOLO 适应不同场景✅双版本国内版免费稳定国际版模型顶尖✅自定义智能体打造专属 AI 助手提升专业领域效率✅MCP 生态无限扩展的工具集成能力✅Rules 体系精准控制 AI 行为确保输出质量✅易上手基于 VS Code学习成本低✅插件支持也可作为插件在现有 IDE 中使用适合谁使用程序员提升编码效率减少重复劳动学生学习编程快速理解代码企业统一开发工具提升团队效率AI 爱好者体验 AI 辅助编程的魅力写在最后Trae 代表了编程工具的未来方向——AI 与人类开发者深度协作。
它不会取代程序员而是让程序员从繁琐的重复劳动中解放出来专注于更有创造性的工作。
如果你还没尝试过 Trae现在就去官网下载体验吧官网国内版https://www.trae.com.cn/国际版https://www.trae.ai/