【Trae】Trae国内版｜国际版｜海外版下载｜Mac版｜Windows版｜Linux下载配置教程（含Mermaid图）
前言
Trae（The 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/V3 | Claude 4 Opus/Sonnet、GPT-4o、DeepSeek-R1 |
| 登录方式 | 手机号、掘金账号 | 邮箱、Google、GitHub |
| MCP支持 | 国内合规模型/工具 | 全开放（含第三方API/数据库/浏览器） |
| 价格 | 基础版永久免费 | 基础版免费，Pro版付费（银联支持） |
| 数据存储 | 国内合规服务器 | 海外节点（用户数据属地化） |
3. Trae整体架构（Mermaid图）
二、全平台下载（Windows/macOS/Linux，含国内/国际入口）
1. 系统环境要求（最低配置）
- Windows：10/11（64位），内存≥8GB，硬盘≥1GB可用空间
- macOS：10.15+（支持Apple Silicon/Intel），内存≥8GB
- Linux：Ubuntu 20.04+/CentOS 8+，内存≥8GB，需图形界面
2. 国内版（CN）下载（推荐国内用户）
Windows版
- 访问官网：
https://www.trae.com.cn/或www.trae.cn - 首页点击「Download Trae」，选择Windows，下载Trae CN-Setup-x64.exe（约350MB）
macOS版
- 同国内版官网，选择macOS，下载Trae-xxx.dmg（适配Apple Silicon/Intel）
- 下载后拖入「应用程序」文件夹。
Linux版
- 官网选择Linux，下载
.deb（Ubuntu）或.rpm（CentOS）包。 - 终端安装：
# Ubuntu/Debiansudodpkg-itrae_xxx_amd64.deb# 依赖修复sudoapt-finstall3. 国际版/海外版下载
- 访问官网：
www.trae.ai - 点击「Download」，选择对应系统（Windows/macOS/Linux），下载安装包
- 激活：首次启动需海外网络，邮箱/Google账号登录。
4. 下载与安装流程（Mermaid流程图）
三、分平台安装与初始配置（详细步骤）
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++ Redistributable（2015-2022） - macOS启动崩溃：更新系统至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 YaHei"2. 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. MCP+Agent协作流程（Mermaid时序图）
五、版本切换与数据迁移
1. 国内版↔国际版切换
- 国内版→国际版：卸载国内版，访问
trae.ai下载国际版，海外网络激活，重新登录。 - 国际版→国内版：卸载国际版，访问
trae.cn下载国内版，手机号登录，重新配置MCP/Agent。
2. 数据迁移（配置/项目/缓存）
- 导出配置：Trae→设置→偏好设置→导出（保存
.json） - 迁移项目：复制本地项目文件夹到新系统
- 导入配置：新Trae→设置→导入，选择保存的
.json，重启生效。
六、总结
Trae作为字节跳动的AI原生IDE，国内版免费合规、国际版功能全面，覆盖全平台与全开发流程。本文从版本区别、下载安装、初始配置、Mermaid图表、MCP协议到Agent智能体，提供了完整的真实可复现教程，附Mermaid架构图、流程图与时序图，帮助开发者快速上手Trae，提升AI开发效率。