Trae 装好 + 第一次跑通(5 分钟手把手)

📍 Trae 完整教程 2/4 · 上一篇:← Trae 是什么:字节出的免费 AI IDE

这一篇你会学到

5 分钟把 Trae 从「0」装到「第一个 Hello World 跑起来」。

具体步骤:

1. 下载安装包
2. 安装(三端分别讲)
3. 首次启动配置(主题 / 语言 / 配置迁移)
4. 登录(手机号 / 邮箱)
5. 选模型(豆包 / DeepSeek-V3 / DeepSeek-R1)
6. 写第一个 Python Hello World
7. 常见坑速查

---

1. 下载安装包

打开浏览器,访问 www.trae.cn(国内版,直连不翻墙)。

海外用户访问 www.trae.ai,模型换成 Claude / GPT。

主页中间有一个 「下载 IDE」 按钮,会自动识别你的操作系统给对应安装包:

系统	安装包格式	大小(v3.3.x)
Windows 10/11(x64)	.exe	约 206MB
macOS 11+(Intel / Apple Silicon)	.dmg	约 206MB
Linux(Ubuntu / Debian / Fedora 等)	.deb / .rpm	国内版已支持,见 trae.cn/ide/download

💡 海外版 trae.ai 目前只支持 macOS / Windows,Linux 即将上线(官方公告”Linux soon”)。国内版 trae.cn 已经能下载 Linux 包。

---

2. 安装

Windows

双击 .exe,按提示下一步。注意:

• 安装路径不要包含中文或空格,否则启动可能报错
• Windows Defender 可能提示「未识别的应用」→ 点「仍要运行」

约 1-2 分钟装完。

macOS

双击 .dmg,把 Trae 图标拖到「应用程序」文件夹。

首次启动可能弹「打不开,因为开发者无法验证」:

• 打开「系统偏好设置」→「安全性与隐私」
• 点「仍要打开」

或者在终端跑一行命令解锁:

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

Linux

# Debian / Ubuntu(.deb 包)
sudo dpkg -i trae_*.deb

# Fedora / RHEL(.rpm 包)
sudo rpm -i trae-*.rpm

# 或者用通用 AppImage(不需要 root)
chmod +x Trae-*.AppImage
./Trae-*.AppImage

---

3. 首次启动:4 步配置

启动 Trae,看到「欢迎来到 Trae」界面。点「开始」进入配置向导:

步骤 1:选主题

三选一:

• 暗色:程序员标配,夜间舒服
• 亮色:白天用,跟 Word 一个感觉
• 深蓝:介于中间,有人喜欢

选错了不要紧,设置里随时改。

步骤 2:选语言

「简体中文」 / 「English」二选一。中文开发者直接选简体中文,界面完全本地化。

步骤 3:迁移现有配置(可选但推荐)

如果你之前用过 VS Code 或 Cursor,这一步强烈推荐做:

• 点「从 VS Code 导入」 或 「从 Cursor 导入」
• Trae 自动同步:已装的插件 + IDE 设置 + 快捷键

这一步省你至少半小时重新配置时间。

步骤 4:安装命令行工具(推荐)

点「安装 trae 命令」并授权。装完之后,你可以在终端这样用:

# 用 Trae 打开当前目录
trae .

# 用 Trae 打开某个项目
trae ~/my-project

跟 code .(VS Code 命令)一样的用法。

---

4. 登录账号

Trae 必须登录才能用 AI 功能(代码生成、聊天、SOLO 模式)。国内版完全免费,不需要订阅。

两种登录方式:

手机号登录(国内推荐)

1. 输入手机号
2. 点「获取验证码」
3. 输入收到的短信验证码
4. 点「登录」

首次登录不用注册,系统自动建账号。

邮箱登录

适合海外用户或不想绑手机号的人。流程类似:邮箱 → 验证码 → 登录。

登录后回到主界面,右下角会看到你的头像 —— 表示已就绪。

---

5. 选模型

打开右上角设置(齿轮图标)→「模型」,国内版默认有这三个:

模型	特点	用在哪
豆包 1.6 系列	字节自家,中文好,速度快	日常聊天、代码补全
DeepSeek V4-Pro	1.6T MoE 新旗舰(2026-04 上线 Trae 国内版,Beta 免费)	写代码、改 bug 主力
DeepSeek V4-Flash	轻量快速版	简单任务 / 速度优先
DeepSeek R1	推理模型,会「思考」	复杂逻辑题、算法、架构设计

新手推荐:默认 DeepSeek V4-Pro(综合最强,Beta 期免费但有时排队)。需要复杂思考切 R1,需要速度切 V4-Flash。

💡 切模型不需要重启,对话里随时切换。模型版本字节官方会持续更新,具体看设置面板的实时列表。

---

6. 第一个项目:Hello World

接下来让 Trae 真的帮你干活。

步骤 1:新建文件夹

随便在桌面新建一个空文件夹叫 hello-trae。

步骤 2:用 Trae 打开

终端跑:

trae ~/Desktop/hello-trae

或者在 Trae 里:文件 → 打开文件夹 → 选 hello-trae。

步骤 3:让 AI 帮你写代码

按 Cmd + U(Mac)或 Ctrl + U(Windows / Linux),打开 Side Chat 侧边对话(左上角下拉切到 Builder 模式,这样 AI 能直接改文件)。

💡 快捷键备忘:Cmd+I = Inline Chat(在编辑器里行内对话)/ Cmd+U = Side Chat / Builder 入口。两个用途不同别搞混。

输入:

帮我写一个 Python 程序,打印 “你好,Trae!” 5 次,每次中间停 1 秒

AI 会直接生成一个 hello.py 文件,内容大概是:

import time

for i in range(5):
    print("你好,Trae!")
    time.sleep(1)

按「接受」(或快捷键 Cmd + Enter),代码就保存到文件了。

步骤 4:跑代码

打开终端(Trae 内置终端在底部),跑:

python hello.py

如果你没装 Python,问 Trae:

我没装 python,你帮我装一下

AI 会告诉你装包命令,部分情况它能直接帮你跑(参见 让 Claude 跑命令:三种权限模式,Trae 也有类似机制)。

跑通之后,你会看到终端打印 5 次「你好,Trae!」—— 恭喜,你跟 Trae 完成了第一次合作。

---

7. 常见坑速查

Windows:打不开 / 闪退

• 安装路径不能有中文或空格 → 卸载重装到 C:\Trae
• Windows 老版本(7/8)不支持 → 升级到 10/11

macOS:提示「无法验证开发者」

• 系统偏好设置 → 安全性 → 点「仍要打开」
• 或者跑 sudo xattr -rd com.apple.quarantine /Applications/Trae.app

Linux:安装包提示「缺少依赖」

• Ubuntu/Debian:sudo apt install -f 自动补依赖
• Fedora:sudo dnf install glibc-langpack-zh fontconfig

登录拿不到验证码

• 检查手机号是不是被屏蔽运营商短信
• 切换到邮箱登录

模型回复很慢 / 失败

• 国内版偶尔抽风(豆包 / DeepSeek 限流)
• 切个模型再试,或稍等几分钟

---

一句话总结

Trae 装好 + 第一个项目跑通,真的就是 5-10 分钟的事。

跟 Cursor 比,主要好处:

• 不用翻墙
• 不用付月费
• 中文界面 + 国内模型

下一篇 Trae 实战 3 个场景,咱用 Trae 做三件真实活儿:改简历 / 整理数据 / 部署网站。

---

牛学板块导航

• 上一篇:← Trae 是什么:字节出的免费 AI IDE
• 本板块:Trae 完整教程
  • 1/4 Trae 是什么
  • 2/4 Trae 装好 + 第一次跑通(就是这一篇)
  • 3/4 Trae 实战 3 个场景
  • 4/4 Trae vs Claude Code:选哪个
• 下一篇:Trae 实战 3 个场景 →