【Trae】Trae国内版｜国际版｜海外版下载｜Mac版｜Windows版｜Linux下载配置教程（含Mermaid图）

前言TraeThe Real AI Engineer是字节跳动推出的AI原生IDE主打自然语言驱动开发、全链路智能体Agent、MCP协议原生支持覆盖需求拆解→代码生成→调试→部署全流程。本文详细拆解国内版/国际版/海外版区别、全平台Windows/macOS/Linux下载安装、环境配置、Mermaid支持、MCP与Agent部署全程真实可复现附Mermaid架构图与流程图。一、Trae版本体系国内版国际版海外版核心区别1. 版本定位与官网国内版Trae CN官网www.trae.cn/www.trae.com.cn特点直连国内服务器、免翻墙、中文界面、内置豆包1.5 Pro/DeepSeek-R1、免费无限量、合规数据存储面向国内开发者手机号登录即可。国际版Trae International官网www.trae.ai特点全球节点、支持银联支付Pro订阅、多语言、内置Claude 4/OpenAI GPT-4o/DeepSeek、MCP全开放适合海外开发/跨境团队。海外版Trae Overseas国际版的海外加速分支与国际版功能一致仅优化欧美/亚太访问延迟无独立官网同国际版下载入口。2. 核心差异对比表对比项国内版CN国际版/海外版网络环境国内直连无需翻墙需海外网络激活/使用内置模型豆包1.5 Pro、DeepSeek-R1/V3Claude 4 Opus/Sonnet、GPT-4o、DeepSeek-R1登录方式手机号、掘金账号邮箱、Google、GitHubMCP支持国内合规模型/工具全开放含第三方API/数据库/浏览器价格基础版永久免费基础版免费Pro版付费银联支持数据存储国内合规服务器海外节点用户数据属地化3. Trae整体架构Mermaid图Windows/macOS/Linux国内版国际版/海外版用户端Trae IDE版本选择国内服务器集群豆包/DeepSeek全球分布式节点Claude 4/GPT-4o核心能力层AI代码生成/补全SOLO智能体AgentMCP协议连接外部工具Mermaid图表渲染代码调试/重构/部署本地项目/远程仓库数据库/浏览器/API/文件系统二、全平台下载Windows/macOS/Linux含国内/国际入口1. 系统环境要求最低配置Windows10/1164位内存≥8GB硬盘≥1GB可用空间macOS10.15支持Apple Silicon/Intel内存≥8GBLinuxUbuntu 20.04/CentOS 8内存≥8GB需图形界面2. 国内版CN下载推荐国内用户Windows版访问官网https://www.trae.com.cn/或www.trae.cn首页点击「Download Trae」选择Windows下载Trae CN-Setup-x64.exe约350MBmacOS版同国内版官网选择macOS下载Trae-xxx.dmg适配Apple Silicon/Intel下载后拖入「应用程序」文件夹。Linux版官网选择Linux下载.debUbuntu或.rpmCentOS包。终端安装# Ubuntu/Debiansudodpkg-itrae_xxx_amd64.deb# 依赖修复sudoapt-finstall3. 国际版/海外版下载访问官网www.trae.ai点击「Download」选择对应系统Windows/macOS/Linux下载安装包激活首次启动需海外网络邮箱/Google账号登录。4. 下载与安装流程Mermaid流程图国内用户海外/跨境WindowsmacOSLinux选择版本国内官网trae.cn国际官网trae.ai下载对应系统安装包系统类型管理员运行exe→安装路径→完成打开dmg→拖入应用程序→安全允许终端dpkg/rpm安装→依赖修复启动Trae→手机号登录初始配置→主题/语言/模型→开始使用三、分平台安装与初始配置详细步骤1. Windows版安装国内版示例右键安装包Trae CN-Setup-x64.exe→「以管理员身份运行」避免权限问题同意用户协议安装路径建议非中文无空格如D:\DevTools\Trae勾选「创建桌面快捷方式」「添加到环境变量」→点击「安装」安装完成后启动首次初始化约5分钟下载依赖/模型缓存初始设置语言简体中文主题深色/DeepBlue护眼导入配置可选从VS Code/Cursor导入插件/快捷键命令行工具可选安装全局调用trae命令登录手机号获取验证码登录国内版2. macOS版安装含安全限制处理打开下载的.dmg将Trae图标拖入「应用程序」文件夹。首次启动提示「无法验证开发者」打开「系统设置→安全性与隐私→通用」点击「仍要打开」需管理员密码终端解除隔离可选彻底解决权限sudoxattr-rdcom.apple.quarantine /Applications/Trae.app启动后同Windows初始配置手机号登录。3. Linux版安装Ubuntu示例终端执行安装命令见上文修复依赖。启动应用菜单搜索「Trae」或终端输入trae。初始配置同前手机号登录。4. 常见安装错误解决Windows提示MSVCP140.dll缺失安装VC Redistributable2015-2022macOS启动崩溃更新系统至10.15重新下载安装包Linux依赖报错执行sudo apt -f install修复依赖链四、核心配置Mermaid图表支持MCP协议Agent智能体1. Mermaid图表配置Trae原生支持无需插件Trae内置Mermaid渲染引擎Markdown文件直接编写Mermaid代码实时预览/导出SVG。启用与使用步骤新建.md文件输入Mermaid代码如流程图/架构图编辑区右上角点击「预览」实时渲染图表右键图表→「导出SVG/PNG」直接保存示例项目开发流程Mermaid代码需求分析技术选型环境搭建模块开发单元测试联调测试部署上线运维迭代配置优化可选自定义主题设置→外观→Mermaid主题默认/深色/森林字体设置编辑settings.json添加mermaid.fontFamily:Consolas, Microsoft YaHei2. MCP协议配置Model Context Protocol连接外部工具Trae原生支持MCP无需插件一键连接数据库/浏览器/API/文件系统。国内版MCP配置以本地文件系统为例打开Trae→顶部搜索框输入「MCP」→选择「MCP配置」点击「手动添加」输入配置JSON{name:本地文件系统,type:filesystem,config:{rootPath:D:\\DevProjects,readOnly:false}}点击「保存」→「验证连接」提示「连接成功」即可。国际版MCP配置以Claude 4为例同步骤1手动添加输入{name:Claude 4 Opus,type:api,config:{provider:anthropic,apiKey:你的Claude API Key,model:claude-4-opus-20260515}}验证连接后在智能体中绑定该MCP即可调用。3. SOLO智能体Agent配置自动执行复杂任务Trae SOLO模式内置Coding Agent可拆解目标、规划任务、调用MCP工具自动完成全流程开发。启用与配置步骤启动Trae→左侧导航栏点击「SOLO」→「创建智能体」配置智能体参数名称自定义如「全栈开发助手」角色提示词定义能力如「全栈工程师精通Python/前端/数据库能独立完成项目」工具绑定勾选已配置的MCP工具文件系统/数据库/API保存后在SOLO对话框输入需求如「用FastAPI写一个用户管理系统含CRUD接口」Agent自动拆解任务、生成代码、调试运行。4. MCPAgent协作流程Mermaid时序图代码生成模块MCP数据库MCP文件系统Trae Agent用户代码生成模块MCP数据库MCP文件系统Trae Agent用户需求开发用户管理系统创建项目目录/初始化文件目录创建完成连接MySQL/创建用户表表创建完成生成FastAPI CRUD代码代码生成完成写入代码文件写入完成任务完成项目可运行五、版本切换与数据迁移1. 国内版↔国际版切换国内版→国际版卸载国内版访问trae.ai下载国际版海外网络激活重新登录。国际版→国内版卸载国际版访问trae.cn下载国内版手机号登录重新配置MCP/Agent。2. 数据迁移配置/项目/缓存导出配置Trae→设置→偏好设置→导出保存.json迁移项目复制本地项目文件夹到新系统导入配置新Trae→设置→导入选择保存的.json重启生效。六、总结Trae作为字节跳动的AI原生IDE国内版免费合规、国际版功能全面覆盖全平台与全开发流程。本文从版本区别、下载安装、初始配置、Mermaid图表、MCP协议到Agent智能体提供了完整的真实可复现教程附Mermaid架构图、流程图与时序图帮助开发者快速上手Trae提升AI开发效率。