【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. 核心差异对比表

3. Trae整体架构（Mermaid图）

#mermaid-svg-Weg9oAcApVZ9zZ1c{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-Weg9oAcApVZ9zZ1c .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-Weg9oAcApVZ9zZ1c .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-Weg9oAcApVZ9zZ1c .error-icon{fill:#552222;}#mermaid-svg-Weg9oAcApVZ9zZ1c .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-Weg9oAcApVZ9zZ1c .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-Weg9oAcApVZ9zZ1c .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-Weg9oAcApVZ9zZ1c .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-Weg9oAcApVZ9zZ1c .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-Weg9oAcApVZ9zZ1c .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-Weg9oAcApVZ9zZ1c .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-Weg9oAcApVZ9zZ1c .marker{fill:#333333;stroke:#333333;}#mermaid-svg-Weg9oAcApVZ9zZ1c .marker.cross{stroke:#333333;}#mermaid-svg-Weg9oAcApVZ9zZ1c svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-Weg9oAcApVZ9zZ1c p{margin:0;}#mermaid-svg-Weg9oAcApVZ9zZ1c .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-Weg9oAcApVZ9zZ1c .cluster-label text{fill:#333;}#mermaid-svg-Weg9oAcApVZ9zZ1c .cluster-label span{color:#333;}#mermaid-svg-Weg9oAcApVZ9zZ1c .cluster-label span p{background-color:transparent;}#mermaid-svg-Weg9oAcApVZ9zZ1c .label text,#mermaid-svg-Weg9oAcApVZ9zZ1c span{fill:#333;color:#333;}#mermaid-svg-Weg9oAcApVZ9zZ1c .node rect,#mermaid-svg-Weg9oAcApVZ9zZ1c .node circle,#mermaid-svg-Weg9oAcApVZ9zZ1c .node ellipse,#mermaid-svg-Weg9oAcApVZ9zZ1c .node polygon,#mermaid-svg-Weg9oAcApVZ9zZ1c .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-Weg9oAcApVZ9zZ1c .rough-node .label text,#mermaid-svg-Weg9oAcApVZ9zZ1c .node .label text,#mermaid-svg-Weg9oAcApVZ9zZ1c .image-shape .label,#mermaid-svg-Weg9oAcApVZ9zZ1c .icon-shape .label{text-anchor:middle;}#mermaid-svg-Weg9oAcApVZ9zZ1c .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-Weg9oAcApVZ9zZ1c .rough-node .label,#mermaid-svg-Weg9oAcApVZ9zZ1c .node .label,#mermaid-svg-Weg9oAcApVZ9zZ1c .image-shape .label,#mermaid-svg-Weg9oAcApVZ9zZ1c .icon-shape .label{text-align:center;}#mermaid-svg-Weg9oAcApVZ9zZ1c .node.clickable{cursor:pointer;}#mermaid-svg-Weg9oAcApVZ9zZ1c .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-Weg9oAcApVZ9zZ1c .arrowheadPath{fill:#333333;}#mermaid-svg-Weg9oAcApVZ9zZ1c .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-Weg9oAcApVZ9zZ1c .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-Weg9oAcApVZ9zZ1c .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Weg9oAcApVZ9zZ1c .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-Weg9oAcApVZ9zZ1c .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Weg9oAcApVZ9zZ1c .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-Weg9oAcApVZ9zZ1c .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-Weg9oAcApVZ9zZ1c .cluster text{fill:#333;}#mermaid-svg-Weg9oAcApVZ9zZ1c .cluster span{color:#333;}#mermaid-svg-Weg9oAcApVZ9zZ1c div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-Weg9oAcApVZ9zZ1c .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-Weg9oAcApVZ9zZ1c rect.text{fill:none;stroke-width:0;}#mermaid-svg-Weg9oAcApVZ9zZ1c .icon-shape,#mermaid-svg-Weg9oAcApVZ9zZ1c .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Weg9oAcApVZ9zZ1c .icon-shape p,#mermaid-svg-Weg9oAcApVZ9zZ1c .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-Weg9oAcApVZ9zZ1c .icon-shape .label rect,#mermaid-svg-Weg9oAcApVZ9zZ1c .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Weg9oAcApVZ9zZ1c .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-Weg9oAcApVZ9zZ1c .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-Weg9oAcApVZ9zZ1c :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

Windows/macOS/Linux

国内版

国际版/海外版

用户端

Trae IDE

版本选择

国内服务器集群豆包/DeepSeek

全球分布式节点Claude 4/GPT-4o

核心能力层

AI代码生成/补全

SOLO智能体Agent

MCP协议连接外部工具

Mermaid图表渲染

代码调试/重构/部署

本地项目/远程仓库

数据库/浏览器/API/文件系统

二、全平台下载（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版

macOS版

Linux版

# Ubuntu/Debian
sudo dpkg -i trae_xxx_amd64.deb
# 依赖修复
sudo apt -f install

3. 国际版/海外版下载

4. 下载与安装流程（Mermaid流程图）

#mermaid-svg-zqDT8aaDiVPh1dDk{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-zqDT8aaDiVPh1dDk .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-zqDT8aaDiVPh1dDk .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-zqDT8aaDiVPh1dDk .error-icon{fill:#552222;}#mermaid-svg-zqDT8aaDiVPh1dDk .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-zqDT8aaDiVPh1dDk .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-zqDT8aaDiVPh1dDk .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-zqDT8aaDiVPh1dDk .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-zqDT8aaDiVPh1dDk .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-zqDT8aaDiVPh1dDk .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-zqDT8aaDiVPh1dDk .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-zqDT8aaDiVPh1dDk .marker{fill:#333333;stroke:#333333;}#mermaid-svg-zqDT8aaDiVPh1dDk .marker.cross{stroke:#333333;}#mermaid-svg-zqDT8aaDiVPh1dDk svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-zqDT8aaDiVPh1dDk p{margin:0;}#mermaid-svg-zqDT8aaDiVPh1dDk .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-zqDT8aaDiVPh1dDk .cluster-label text{fill:#333;}#mermaid-svg-zqDT8aaDiVPh1dDk .cluster-label span{color:#333;}#mermaid-svg-zqDT8aaDiVPh1dDk .cluster-label span p{background-color:transparent;}#mermaid-svg-zqDT8aaDiVPh1dDk .label text,#mermaid-svg-zqDT8aaDiVPh1dDk span{fill:#333;color:#333;}#mermaid-svg-zqDT8aaDiVPh1dDk .node rect,#mermaid-svg-zqDT8aaDiVPh1dDk .node circle,#mermaid-svg-zqDT8aaDiVPh1dDk .node ellipse,#mermaid-svg-zqDT8aaDiVPh1dDk .node polygon,#mermaid-svg-zqDT8aaDiVPh1dDk .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-zqDT8aaDiVPh1dDk .rough-node .label text,#mermaid-svg-zqDT8aaDiVPh1dDk .node .label text,#mermaid-svg-zqDT8aaDiVPh1dDk .image-shape .label,#mermaid-svg-zqDT8aaDiVPh1dDk .icon-shape .label{text-anchor:middle;}#mermaid-svg-zqDT8aaDiVPh1dDk .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-zqDT8aaDiVPh1dDk .rough-node .label,#mermaid-svg-zqDT8aaDiVPh1dDk .node .label,#mermaid-svg-zqDT8aaDiVPh1dDk .image-shape .label,#mermaid-svg-zqDT8aaDiVPh1dDk .icon-shape .label{text-align:center;}#mermaid-svg-zqDT8aaDiVPh1dDk .node.clickable{cursor:pointer;}#mermaid-svg-zqDT8aaDiVPh1dDk .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-zqDT8aaDiVPh1dDk .arrowheadPath{fill:#333333;}#mermaid-svg-zqDT8aaDiVPh1dDk .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-zqDT8aaDiVPh1dDk .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-zqDT8aaDiVPh1dDk .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-zqDT8aaDiVPh1dDk .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-zqDT8aaDiVPh1dDk .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-zqDT8aaDiVPh1dDk .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-zqDT8aaDiVPh1dDk .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-zqDT8aaDiVPh1dDk .cluster text{fill:#333;}#mermaid-svg-zqDT8aaDiVPh1dDk .cluster span{color:#333;}#mermaid-svg-zqDT8aaDiVPh1dDk div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-zqDT8aaDiVPh1dDk .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-zqDT8aaDiVPh1dDk rect.text{fill:none;stroke-width:0;}#mermaid-svg-zqDT8aaDiVPh1dDk .icon-shape,#mermaid-svg-zqDT8aaDiVPh1dDk .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-zqDT8aaDiVPh1dDk .icon-shape p,#mermaid-svg-zqDT8aaDiVPh1dDk .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-zqDT8aaDiVPh1dDk .icon-shape .label rect,#mermaid-svg-zqDT8aaDiVPh1dDk .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-zqDT8aaDiVPh1dDk .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-zqDT8aaDiVPh1dDk .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-zqDT8aaDiVPh1dDk :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

国内用户

海外/跨境

Windows

macOS

Linux

选择版本

国内官网trae.cn

国际官网trae.ai

下载对应系统安装包

系统类型

管理员运行exe→安装路径→完成

打开dmg→拖入应用程序→安全允许

终端dpkg/rpm安装→依赖修复

启动Trae→手机号登录

初始配置→主题/语言/模型→开始使用

三、分平台安装与初始配置（详细步骤）

1. Windows版安装（国内版示例）

2. macOS版安装（含安全限制处理）

sudo xattr -rd com.apple.quarantine /Applications/Trae.app

3. Linux版安装（Ubuntu示例）

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。

启用与使用步骤

示例：项目开发流程Mermaid代码

#mermaid-svg-Li2GxaGiOKfktPtc{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-Li2GxaGiOKfktPtc .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-Li2GxaGiOKfktPtc .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-Li2GxaGiOKfktPtc .error-icon{fill:#552222;}#mermaid-svg-Li2GxaGiOKfktPtc .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-Li2GxaGiOKfktPtc .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-Li2GxaGiOKfktPtc .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-Li2GxaGiOKfktPtc .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-Li2GxaGiOKfktPtc .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-Li2GxaGiOKfktPtc .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-Li2GxaGiOKfktPtc .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-Li2GxaGiOKfktPtc .marker{fill:#333333;stroke:#333333;}#mermaid-svg-Li2GxaGiOKfktPtc .marker.cross{stroke:#333333;}#mermaid-svg-Li2GxaGiOKfktPtc svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-Li2GxaGiOKfktPtc p{margin:0;}#mermaid-svg-Li2GxaGiOKfktPtc .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-Li2GxaGiOKfktPtc .cluster-label text{fill:#333;}#mermaid-svg-Li2GxaGiOKfktPtc .cluster-label span{color:#333;}#mermaid-svg-Li2GxaGiOKfktPtc .cluster-label span p{background-color:transparent;}#mermaid-svg-Li2GxaGiOKfktPtc .label text,#mermaid-svg-Li2GxaGiOKfktPtc span{fill:#333;color:#333;}#mermaid-svg-Li2GxaGiOKfktPtc .node rect,#mermaid-svg-Li2GxaGiOKfktPtc .node circle,#mermaid-svg-Li2GxaGiOKfktPtc .node ellipse,#mermaid-svg-Li2GxaGiOKfktPtc .node polygon,#mermaid-svg-Li2GxaGiOKfktPtc .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-Li2GxaGiOKfktPtc .rough-node .label text,#mermaid-svg-Li2GxaGiOKfktPtc .node .label text,#mermaid-svg-Li2GxaGiOKfktPtc .image-shape .label,#mermaid-svg-Li2GxaGiOKfktPtc .icon-shape .label{text-anchor:middle;}#mermaid-svg-Li2GxaGiOKfktPtc .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-Li2GxaGiOKfktPtc .rough-node .label,#mermaid-svg-Li2GxaGiOKfktPtc .node .label,#mermaid-svg-Li2GxaGiOKfktPtc .image-shape .label,#mermaid-svg-Li2GxaGiOKfktPtc .icon-shape .label{text-align:center;}#mermaid-svg-Li2GxaGiOKfktPtc .node.clickable{cursor:pointer;}#mermaid-svg-Li2GxaGiOKfktPtc .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-Li2GxaGiOKfktPtc .arrowheadPath{fill:#333333;}#mermaid-svg-Li2GxaGiOKfktPtc .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-Li2GxaGiOKfktPtc .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-Li2GxaGiOKfktPtc .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Li2GxaGiOKfktPtc .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-Li2GxaGiOKfktPtc .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Li2GxaGiOKfktPtc .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-Li2GxaGiOKfktPtc .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-Li2GxaGiOKfktPtc .cluster text{fill:#333;}#mermaid-svg-Li2GxaGiOKfktPtc .cluster span{color:#333;}#mermaid-svg-Li2GxaGiOKfktPtc div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-Li2GxaGiOKfktPtc .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-Li2GxaGiOKfktPtc rect.text{fill:none;stroke-width:0;}#mermaid-svg-Li2GxaGiOKfktPtc .icon-shape,#mermaid-svg-Li2GxaGiOKfktPtc .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Li2GxaGiOKfktPtc .icon-shape p,#mermaid-svg-Li2GxaGiOKfktPtc .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-Li2GxaGiOKfktPtc .icon-shape .label rect,#mermaid-svg-Li2GxaGiOKfktPtc .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Li2GxaGiOKfktPtc .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-Li2GxaGiOKfktPtc .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-Li2GxaGiOKfktPtc :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

需求分析

技术选型

环境搭建

模块开发

单元测试

联调测试

部署上线

运维迭代

配置优化（可选）

• 自定义主题：设置→外观→Mermaid主题（默认/深色/森林）
• 字体设置：编辑 settings.json，添加：

"mermaid.fontFamily": "Consolas, Microsoft YaHei"

2. MCP协议配置（Model Context Protocol，连接外部工具）

Trae原生支持MCP，无需插件，一键连接数据库/浏览器/API/文件系统。

国内版MCP配置（以本地文件系统为例）

{
"name": "本地文件系统",
"type": "filesystem",
"config": {
"rootPath": "D:\\\\DevProjects",
"readOnly": false
}
}

国际版MCP配置（以Claude 4为例）

{
"name": "Claude 4 Opus",
"type": "api",
"config": {
"provider": "anthropic",
"apiKey": "你的Claude API Key",
"model": "claude-4-opus-20260515"
}
}

3. SOLO智能体（Agent）配置（自动执行复杂任务）

Trae SOLO模式内置Coding Agent，可拆解目标、规划任务、调用MCP工具，自动完成全流程开发。

启用与配置步骤

4. MCP+Agent协作流程（Mermaid时序图）

代码生成模块MCP数据库MCP文件系统Trae Agent用户代码生成模块MCP数据库MCP文件系统Trae Agent用户#mermaid-svg-7ri01T8gLU4BLREM{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-7ri01T8gLU4BLREM .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-7ri01T8gLU4BLREM .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-7ri01T8gLU4BLREM .error-icon{fill:#552222;}#mermaid-svg-7ri01T8gLU4BLREM .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-7ri01T8gLU4BLREM .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-7ri01T8gLU4BLREM .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-7ri01T8gLU4BLREM .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-7ri01T8gLU4BLREM .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-7ri01T8gLU4BLREM .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-7ri01T8gLU4BLREM .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-7ri01T8gLU4BLREM .marker{fill:#333333;stroke:#333333;}#mermaid-svg-7ri01T8gLU4BLREM .marker.cross{stroke:#333333;}#mermaid-svg-7ri01T8gLU4BLREM svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-7ri01T8gLU4BLREM p{margin:0;}#mermaid-svg-7ri01T8gLU4BLREM .actor{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-7ri01T8gLU4BLREM text.actor>tspan{fill:black;stroke:none;}#mermaid-svg-7ri01T8gLU4BLREM .actor-line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-7ri01T8gLU4BLREM .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-svg-7ri01T8gLU4BLREM .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#mermaid-svg-7ri01T8gLU4BLREM .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#mermaid-svg-7ri01T8gLU4BLREM #arrowhead path{fill:#333;stroke:#333;}#mermaid-svg-7ri01T8gLU4BLREM .sequenceNumber{fill:white;}#mermaid-svg-7ri01T8gLU4BLREM #sequencenumber{fill:#333;}#mermaid-svg-7ri01T8gLU4BLREM #crosshead path{fill:#333;stroke:#333;}#mermaid-svg-7ri01T8gLU4BLREM .messageText{fill:#333;stroke:none;}#mermaid-svg-7ri01T8gLU4BLREM .labelBox{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-7ri01T8gLU4BLREM .labelText,#mermaid-svg-7ri01T8gLU4BLREM .labelText>tspan{fill:black;stroke:none;}#mermaid-svg-7ri01T8gLU4BLREM .loopText,#mermaid-svg-7ri01T8gLU4BLREM .loopText>tspan{fill:black;stroke:none;}#mermaid-svg-7ri01T8gLU4BLREM .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-7ri01T8gLU4BLREM .note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-7ri01T8gLU4BLREM .noteText,#mermaid-svg-7ri01T8gLU4BLREM .noteText>tspan{fill:black;stroke:none;}#mermaid-svg-7ri01T8gLU4BLREM .activation0{fill:#f4f4f4;stroke:#666;}#mermaid-svg-7ri01T8gLU4BLREM .activation1{fill:#f4f4f4;stroke:#666;}#mermaid-svg-7ri01T8gLU4BLREM .activation2{fill:#f4f4f4;stroke:#666;}#mermaid-svg-7ri01T8gLU4BLREM .actorPopupMenu{position:absolute;}#mermaid-svg-7ri01T8gLU4BLREM .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-7ri01T8gLU4BLREM .actor-man line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-7ri01T8gLU4BLREM .actor-man circle,#mermaid-svg-7ri01T8gLU4BLREM line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;stroke-width:2px;}#mermaid-svg-7ri01T8gLU4BLREM :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}需求：开发用户管理系统创建项目目录/初始化文件目录创建完成连接MySQL/创建用户表表创建完成生成FastAPI CRUD代码代码生成完成写入代码文件写入完成任务完成，项目可运行

五、版本切换与数据迁移

1. 国内版↔国际版切换

• 国内版→国际版：卸载国内版，访问 trae.ai 下载国际版，海外网络激活，重新登录。
• 国际版→国内版：卸载国际版，访问 trae.cn 下载国内版，手机号登录，重新配置MCP/Agent。

2. 数据迁移（配置/项目/缓存）

六、总结

Trae作为字节跳动的AI原生IDE，国内版免费合规、国际版功能全面，覆盖全平台与全开发流程。本文从版本区别、下载安装、初始配置、Mermaid图表、MCP协议到Agent智能体，提供了完整的真实可复现教程，附Mermaid架构图、流程图与时序图，帮助开发者快速上手Trae，提升AI开发效率。