字节跳动出品 · 2025年发布

Trae AI IDE
保姆级安装使用教程

从设备选型、环境搭建到核心功能实战,零基础也能快速掌握这款AI原生编程利器。免费使用,深度中文支持。

100%
核心功能免费
3
大模型支持
2
开发模式
中文
原生支持
广告

什么是 Trae AI IDE?

Trae 是字节跳动推出的 AI 原生集成开发环境,定位为"智能协作AI搭档"。它不是在传统IDE上加一个AI插件,而是从底层设计就与AI深度融合,支持从需求理解到代码生成、测试、部署的全流程自动化。

🤖

SOLO 模式

AI主导全流程开发,从需求理解到代码生成、测试、部署,一条龙完成

💡

IDE 模式

保留传统开发方式,开发者自主控制流程,AI作为智能助手辅助编码

🇨🇳

深度中文支持

原生中文界面,精准理解中文技术术语,无需中英文切换

🎨

多模态交互

支持文本、语音、截图、设计稿等多种输入方式,交互更自然

CUE 智能补全

代码补全、多行修改、修改点预测、智能导入与重命名

🔧

MCP 协议

支持模型上下文协议,可扩展自定义工具和服务,增强智能体能力

与同类工具对比

特性 Trae Cursor GitHub Copilot
核心定位AI原生IDE,全流程自动化AI增强型IDE代码补全专家
中文支持✅ 原生深度支持⚠️ 有限支持⚠️ 有限支持
定价🆓 完全免费💰 $20/月起💰 $10/月
端到端项目生成✅ SOLO模式✅ Builder模式❌ 不支持
模型支持豆包/DeepSeek-R1/V3GPT-4o/Claude 3.5OpenAI技术
广告

Trae 适合谁?

Trae 的设计理念是让AI编程普惠化,从编程新手到资深开发者都能找到适合自己的使用方式。

🎓 编程新手 💻 前端开发者 🐍 Python开发者 📊 数据分析师 🇨🇳 中文开发者 🏗️ 全栈工程师 📱 产品经理 🎓 在校学生
🧑‍💻

新手 / 产品经理 → SOLO 模式

零代码基础也能用自然语言描述需求,让AI自动生成完整项目。特别适合快速验证创意原型,从想法到可运行程序只需几分钟。

开发者 → IDE 模式

保留完整开发控制权,AI作为智能助手辅助补全代码、修复Bug、重构代码。全链路上下文感知,理解整个项目结构。

设备与环境要求

Trae 对硬件要求不高,主流电脑即可流畅运行。以下是详细的设备选型建议。

最低配置 vs 推荐配置

操作系统
macOS 10.15+ / Windows 10+ / Linux
macOS低于12.0需下载旧版本(3.5.25以下)
内存
最低8GB / 推荐16GB+
大项目或SOLO模式建议16GB以上
磁盘空间
最低10GB / 推荐20GB+
需预留项目依赖和缓存空间
网络
稳定互联网连接
AI功能依赖云端模型,需联网使用

设备选型建议

使用场景 推荐设备 配置建议 预算参考
日常学习/轻量开发 MacBook Air M2/M3 16GB + 256GB ¥8,000-10,000
专业开发/全栈项目 MacBook Pro M3 Pro 18GB + 512GB ¥15,000-18,000
Windows高性价比 联想小新Pro / ThinkPad 16GB + 512GB SSD ¥5,000-8,000
Linux开发环境 任意兼容PC + Ubuntu 16GB + 256GB SSD ¥3,000-6,000
💡 省钱小贴士

Trae 对硬件要求远低于本地运行大模型,因为AI计算在云端完成。即使是几年前的旧电脑,只要内存达到8GB就能流畅使用。无需购买昂贵显卡!

保姆级安装流程

跟着步骤一步步来,5分钟内即可完成安装。Windows、macOS、Linux全平台覆盖。

1

下载安装包

前往 Trae 官方网站下载对应平台的安装包:

URL # 国内版官网(推荐国内用户) https://www.trae.cn/ # 国际版官网(海外用户) https://www.trae.ai/
平台安装包说明
WindowsTrae-CN-Setup-x64.exe支持Win10/11 64位,约100MB
macOS (Apple Silicon).dmg (M系列芯片)要求macOS 12.0+
macOS (Intel).dmg (Intel芯片)要求macOS 12.0+
Linux.deb / .rpmUbuntu 20.04+/Fedora 42+
⚠️ 重要提醒

国内用户务必使用 trae.cn 域名下载国内版。海外版需要海外网络环境,国内访问可能不稳定。如果 macOS 版本低于 12.0,可在官网下载低于 3.5.25 版本的 Trae。

2

安装 Trae(Windows 为例)

1
双击安装包
2
允许安全提示
3
选择安装路径
4
勾选PATH
5
等待完成
PowerShell # Windows 建议勾选以下选项: 创建桌面快捷方式 将 Trae 添加到系统 PATH 环境变量 # 安装路径建议保持默认: C:\Users\<用户名>\AppData\Local\Programs\Trae
📦
Windows 安装向导界面 - 选择安装路径与选项
3

安装 Trae(macOS)

Terminal # 方法一:官网下载 .dmg 安装 1. 打开下载的 .dmg 文件 2. 将 Trae 拖入 Applications 文件夹 3. 首次打开时,右键点击 → 打开(绕过安全检查) # 方法二:命令行安装(如支持 Homebrew Cask) brew install --cask trae
4

安装 Trae(Linux)

Bash # Ubuntu / Debian 用户 sudo dpkg -i trae_xxx_amd64.deb sudo apt-get install -f # 安装依赖 # Fedora / RHEL 用户 sudo rpm -i trae_xxx_x86_64.rpm # 也可通过命令行工具启动 trae # 如果已添加到 PATH

首次启动与初始配置

安装完成后,跟随引导完成初始设置,2分钟搞定。

1

选择主题与语言

首次启动 Trae,会显示欢迎引导界面:

Guide # 推荐配置: 主题:Dark+ 深色主题(护眼) 语言:简体中文(默认)
2

导入已有配置(可选)

如果你之前使用 VS Code 或 Cursor,可以一键导入配置:

💡 一键迁移

Trae 支持从 VS Code / Cursor 导入:插件、IDE 设置、快捷键绑定。省去重复配置的烦恼,迁移过程通常只需10秒。

⚙️
配置导入界面 - 从 VS Code 或 Cursor 一键导入
3

登录激活 AI 功能

点击右上角"登录",选择以下方式之一完成登录:

Auth # 国内版登录方式: 方式1:📱 中国大陆手机号(验证码登录) 方式2:📮 稀土掘金账号 方式3:🔑 GitHub 账号 # ⚠️ 必须登录才能使用AI功能,此步骤不可跳过
4

选择 AI 模型

登录后,在右侧 Chat 面板顶部的下拉菜单切换模型:

模型特点适用场景
豆包-1.5-pro默认模型,中文能力强日常开发、中文交互
DeepSeek-R1深度推理,逻辑分析强复杂算法、逻辑推理
DeepSeek-V3快速响应,高效生成日常编码、快速补全

开发环境配置

Trae 支持在设置中配置开发环境,以下是常见语言环境配置示例:

Guide # Java 环境配置 设置 → 开发环境 → JDK → 选择 JDK 版本和路径 设置 → 开发环境 → Maven → 配置 Maven 路径 # Node.js 环境配置 设置 → 开发环境 → Node.js → 选择 Node 版本和路径 # Python 环境配置 设置 → 开发环境 → Python → 选择 Python 解释器路径 # 💡 提示:Trae 也可自动检测已安装的环境

核心功能使用指南

掌握这6大核心功能,让 Trae 成为你最高效的编程搭档。

1

代码自动补全(CUE)

Trae 内置 CUE 智能编程助手,无需手动开启。编写代码时,AI 自动理解上下文,实时续写代码:

Python # 当你输入以下内容时: def calculate_average(data): """计算列表平均值""" # CUE 会自动补全: def calculate_average(data): """计算列表平均值""" if not data: return 0 return sum(data) / len(data)
💡 补全技巧

Tab 接受补全建议,按 Esc 拒绝。CUE 支持多行补全、修改点预测、智能导入等多种高级功能。

2

Chat 模式 - 对话式编程

在右侧 Chat 面板中用自然语言描述需求,AI 即时响应:

Chat # 你可以这样提问: 👤 帮我写一个读取CSV文件并计算列平均值的函数 👤 这段代码有什么Bug?帮我修复 👤 将这个函数从Python翻译成TypeScript 👤 帮我添加错误处理和日志记录 # AI 会直接在编辑器中展示或应用修改
3

SOLO 模式 - AI 全流程开发

切换到 SOLO 模式后,AI 将自主完成从需求到部署的全流程:

1
输入需求
2
AI拆解任务
3
生成代码
4
安装依赖
5
测试运行
6
预览部署
SOLO # SOLO 模式示例需求: 👤 帮我做一个健康提醒工具,包含喝水提醒、久坐提醒、每日名言展示 # AI 自动完成: 需求分析与功能拆解 前端页面生成(HTML/CSS/JS) 通知提醒逻辑实现 名言API对接 依赖安装与项目构建 Webview 实时预览
🤖
SOLO 模式 - AI 自主完成全流程开发
4

多模态交互

Trae 支持上传图片让 AI 理解需求:

MultiModal # 多模态使用场景: 📷 上传设计稿 → AI生成对应前端代码 📷 上传错误截图 → AI定位问题并修复 📷 上传流程图 → AI理解业务逻辑并实现 📷 上传手绘草图 → AI生成原型页面 # 操作方式:在Chat面板点击附件按钮上传图片
5

自定义智能体

通过配置提示词和工具集,创建专属智能体:

Agent # 创建自定义智能体步骤: 1. 点击左侧智能体面板 → 新建智能体 2. 设置智能体名称和描述 3. 编写提示词(定义角色和能力) 4. 选择工具集(代码执行、文件读写等) 5. 配置 MCP Server(如需扩展能力) # 示例:创建"代码审查专家"智能体 名称:Code Review Expert 提示词:你是一位资深代码审查专家,专注于安全漏洞、性能优化和代码规范 工具:文件读取、终端执行、Git操作
6

规则引擎配置

.trae/rules 目录中配置团队规范,AI 生成代码自动遵守:

Rules # .trae/rules 示例配置 强制规则: - 所有 TypeScript 文件必须包含类型注解 - 禁止使用 eval() 函数 - API 接口必须有错误处理 - 变量命名使用驼峰式(camelCase) - 组件必须有 PropTypes 或 TypeScript 接口定义 # AI 生成代码时会自动遵守这些规则

实战案例详解

从零到一,手把手演示如何使用 Trae 完成真实项目。

🔥 新手友好

案例1:5分钟搭建个人博客网站

目标

使用 SOLO 模式,通过自然语言描述需求,让 AI 自动生成一个响应式个人博客。

操作步骤

Step by Step # 第一步:切换到 SOLO 模式 点击左上角模式切换按钮 → 选择 SOLO 模式 # 第二步:输入需求描述 👤 帮我创建一个个人博客网站,要求: - 响应式设计,适配手机和PC - 首页展示最新3篇文章 - 关于我页面 - 使用现代化的深色主题 - 纯前端实现,不需要后端 # 第三步:等待AI自动完成 AI 自动拆解任务 生成 HTML/CSS/JS 代码 自动安装依赖 Webview 实时预览 # 第四步:预览与调整 在内置浏览器中预览效果 如需修改,继续用自然语言描述调整需求

预期效果

一个包含首页、文章列表、关于我页面的响应式博客网站,深色主题,可在手机和PC上完美显示。

⚡ 进阶实战

案例2:Python 数据分析自动化

目标

使用 IDE 模式的 Chat 功能,让 AI 辅助完成 CSV 数据读取、清洗和分析。

操作步骤

Python # 第一步:创建 Python 文件 在 Trae 中新建 analysis.py 文件 # 第二步:在 Chat 面板描述需求 👤 帮我写一个Python脚本,读取data.csv文件, 计算每列的统计信息(均值、中位数、标准差), 并生成可视化图表保存为PNG # 第三步:AI 生成代码 import pandas as pd import matplotlib.pyplot as plt def analyze_csv(filepath): df = pd.read_csv(filepath) stats = df.describe() df.hist(figsize=(12, 8)) plt.tight_layout() plt.savefig('analysis_result.png') return stats # 第四步:点击"Apply"将代码应用到编辑器 # 第五步:在终端运行脚本
🚀 高级应用

案例3:设计稿转前端代码

目标

上传网页设计稿图片,让 AI 自动生成响应式前端代码。

操作步骤

MultiModal # 第一步:打开 Chat 面板 # 第二步:点击附件按钮,上传设计稿图片 # 第三步:描述需求 👤 请根据这张设计稿生成响应式HTML/CSS代码, 使用Tailwind CSS框架, 确保在移动端也能良好显示 # AI 会分析设计稿的布局、颜色、排版 # 并生成对应的HTML结构和CSS样式 # 第四步:在 Webview 中实时预览效果 # 第五步:如需微调,继续用自然语言描述修改

常见问题与使用技巧

Q:Trae 必须联网才能使用吗?

是的,Trae 的 AI 功能依赖云端模型,必须联网使用。但基础的代码编辑功能可以离线使用。

Q:国内版和国际版有什么区别?

国内版使用豆包模型和 DeepSeek 模型,面向中国大陆用户;国际版使用 GPT-4o 和 Claude 等模型,面向海外用户。两个版本账号不互通。

Q:Trae 真的完全免费吗?

是的,国内版核心功能完全免费,包括 AI 代码生成、Chat 对话、SOLO 模式等。暂无付费计划。

Q:SOLO 模式会完全替代人工吗?

不会。SOLO 模式适合快速构建原型和完成简单任务,但生成代码仍需人工审查优化,尤其在复杂业务逻辑场景中需要开发者主导完善。

Q:如何从 VS Code 迁移到 Trae?

首次启动时可一键导入 VS Code 配置(插件、主题、快捷键)。Python/Node 环境路径需单独配置。之后也可以在设置中随时导入。

Q:如何提高 AI 生成代码的质量?

① 需求描述尽量具体明确;② 善用上下文功能,将相关文件添加到对话;③ 在 .trae/rules 中配置团队规范;④ 选择合适的模型(推理任务用 DeepSeek-R1,日常用豆包)。

准备好开始AI编程了吗?

下载 Trae,5分钟完成安装,立刻体验 AI 编程的魔力

广告