第二章 五分钟快速上手

一、动手前的 3 分钟准备

我们先确保你不会在动手之后才发现"哎呀少了什么东西"。

1.1 你需要这些东西

不需要的东西：

• 不需要装 Node.js、Python、Git。
• 不需要懂任何编程语言。
• 不需要会用终端（虽然装完后我们会教你打开它，但本章不需要）。
• 不需要梯子（trae.com.cn 在国内可以直接打开和下载）。
• 不需要付费——国内版完全免费。
• 不需要绑信用卡、不需要邮箱验证、不需要任何"高级账号"。

1.2 这一章你会得到什么

• 装好 Trae 国内版，能打开它。
• 用手机号登录账号。
• 在 Trae 里用一句话做出"你的个人简介网页"，文件就在你电脑上。
• 学会三个最基础的快捷键：Cmd+L（呼出 Chat）、Cmd+I（在编辑器里直接改代码）、Cmd+P（快速打开文件）。
• 知道遇到 5 大首次报错怎么办。

预计耗时：40 分钟（不算下载 350MB 安装包的时间）。

二、下载与安装

2.1 下载（两个版本，二选一）

打开浏览器，输入网址：

• 国内版（推荐新手）：trae.com.cn
• 国际版（需要科学上网 + 付费）：trae.ai

本章我们以国内版为例。

打开 trae.com.cn 后，首页中间会有一个大大的「立即下载」按钮。它会自动识别你的操作系统：

• Mac 用户会看到 "Download for macOS"，下面还会提示你的芯片是 Intel 还是 Apple Silicon（M1/M2/M3/M4），自动选对的那个。
• Windows 用户会看到 "Download for Windows"。

点下去，下载到的文件大概 350MB 左右。

如果首页没有自动识别你的系统（比如显示的是 Linux），可以在右上角的菜单里手动切换。

2.2 macOS 安装

步骤 1：下载完成后，在「下载」文件夹里找到 Trae.dmg 文件，双击打开。

步骤 2：在弹出的窗口里，把左边的「Trae」图标拖到右边的「Applications（应用程序）」文件夹里。等待几秒拷贝完成。

步骤 3：打开「访达」→「应用程序」，找到「Trae」，双击打开。

如果系统提示"无法打开 Trae，因为它来自身份不明的开发者"，请按以下步骤：

1. 打开「系统设置」→「隐私与安全性」。
2. 滚动到底部，找到一行红色提示"已阻止使用 Trae"。
3. 点旁边的「仍要打开」按钮。
4. 输入你的开机密码确认。

这是 macOS 对所有"非 App Store 来源"的应用的统一提示，不是 Trae 有问题。

步骤 4：第一次打开 Trae 会有几秒"应用初始化"的进度条，等它跑完。

2.3 Windows 安装

步骤 1：在「下载」文件夹里找到 Trae Setup x.x.x.exe，双击运行。

步骤 2：安装向导默认一路点「下一步」即可。

• 安装路径：建议默认（一般是 C:\Users\你的名字\AppData\Local\Programs\Trae）。
• 不要装在 C 盘根目录、不要装在中文路径下（这两个都可能引起后续报错）。
• 是否创建桌面快捷方式：建议勾选。

步骤 3：安装完成后，桌面会出现「Trae」图标，双击打开。

如果 Windows Defender 弹窗 "Windows 已保护你的电脑"：

1. 点弹窗左上角的小字「更多信息」。
2. 点出现的「仍要运行」按钮。

这是 Windows 对所有第三方应用的默认警告。

步骤 4：第一次打开 Trae 会自动安装一些必要的运行时（大约 1 分钟），等它跑完。

2.4 第一次打开你会看到什么

第一次打开 Trae，会有一个三步的"欢迎引导"：

1. 选择主题——深色 / 浅色 / 跟随系统。建议深色（眼睛舒服）。
2. 选择字体大小——小 / 中 / 大。建议中。
3. 选择 AI 默认对话方式——这一步先选「Builder 模式」（项目助手），后面我们随时能切换。

引导完之后，你就看到 Trae 的主界面了：

• 左边一列细长的图标栏（文件、搜索、Git、扩展、设置）。
• 中间是巨大的"欢迎页"，写着 "欢迎使用 Trae"，下面有几个按钮："新建项目""打开文件夹""从 Git 克隆""我的最近项目"。
• 右边是 AI 对话框（如果没出现，按一下 Cmd+L 或者在右上角的工具栏点对话图标）。

恭喜，你已经装好了。

三、登录账号

如果不登录，Trae 没办法调用 AI 模型，所以这一步必做。

3.1 找到登录入口

在 Trae 左下角（齿轮图标边上）有一个头像图标——它是灰色的小人，表示你还没登录。点它。

弹出登录窗口，里面有几个登录方式：

• 手机号登录（推荐）
• 掘金账号登录（如果你有掘金账号）
• 飞书账号登录（如果你公司用飞书）

新手就选手机号登录。

3.2 输入手机号收验证码

1. 输入你的中国大陆手机号（11 位）。
2. 勾选下面的"用户协议和隐私政策"（一定要勾，不勾的话获取验证码按钮是灰的）。
3. 点「获取验证码」。
4. 几秒后手机收到 6 位数字验证码，输入。
5. 点「登录」。

如果是新手机号，会自动注册账号；如果之前登录过，直接进。

没收到验证码？ 看下面的"常见报错 5"小节。

3.3 确认登录成功

登录成功后，左下角的头像会变成你的微信式昵称（默认是"Trae 用户 xxxx"），右上角会出现你的剩余调用额度——国内版一般写"无限制"或者一个很大的数字。

**至此，所有"装机配置"都完成了。**下一步开始动手做项目。

四、第一个项目：你的个人简介网页

我们来用一句话做出一个"个人简介网页"——你可以把它发给招聘方、客户、相亲对象，看起来比朋友圈截图专业 100 倍。

4.1 新建项目文件夹

步骤 1：在你电脑桌面上，新建一个文件夹，叫 我的简介页（中文也行，但建议英文：my-intro，避免后续兼容问题）。

建议把你以后所有 Trae 项目都放在一个统一的"工作目录"，比如 ~/Documents/trae-projects/，这样方便管理。

步骤 2：回到 Trae，点击左上角「文件」→「打开文件夹」（或者按 Cmd+O）。

步骤 3：在文件选择窗口里，找到刚才新建的 my-intro 文件夹，点它，再点「打开」。

步骤 4：Trae 会问你"是否信任此文件夹的作者？"，选「是的，我信任作者」。

这是 VS Code 体系的"工作区信任"机制，相当于"你确认这个文件夹的内容是你自己的、不会有恶意脚本"。你自己新建的文件夹，安心选"信任"。

现在你看到 Trae 左边的"文件树"是空的（因为你刚新建的文件夹里没文件），右边的 AI 对话框等你输入。

4.2 用一句话告诉 Trae 你想做什么

在右边的 AI 对话框上方，确认当前是 Builder 模式（如果不是，点一下右上角切到 Builder）。

在对话框里，完整复制下面这一段，把里面的"你的名字、专业、爱好"换成你自己的：

帮我做一个个人简介网页 index.html，要求：

1. 居中布局，深色背景（#1a1a1a），浅色文字。
2. 顶部是一个圆形头像（先用一个占位图，比如 https://api.dicebear.com/7.x/avataaars/svg?seed=Trae 这种），下面是我的名字大字号显示。
3. 名字下面一行小字写我的身份/title（比如"3年品牌运营 | 喜欢冲浪和做饭"）。
4. 中间一段约 100 字的自我介绍。
5. 下面是"擅长技能"，用 5 个圆形标签横向展示（比如：内容策划、用户增长、爆款文案、视频脚本、活动执行）。
6. 再下面是"作品集"，三个卡片横向展示（每个卡片有图、标题、一段说明）。
7. 底部有"联系方式"：邮箱、微信号、小红书。
8. 整体响应式，手机打开也好看。
9. 用 TailwindCSS 写样式（CDN 引入即可，不用 npm）。
10. 一个文件搞定，不需要拆分。

我的信息：
- 名字：李雨晴
- 身份：3 年品牌运营，喜欢冲浪和做饭
- 介绍：（自由发挥，约 100 字）
- 技能：内容策划、用户增长、爆款文案、视频脚本、活动执行
- 作品集：（自由发挥三个）
- 邮箱：liyuqing@example.com
- 微信：liyuqing_2026
- 小红书：@雨晴的运营笔记

按一下回车（或者点输入框右边的发送箭头）。

4.3 看 Trae 怎么动手

发送之后，你会看到右边的对话框开始流式输出。Trae 会做下面这些事（你不用做任何事，只要看着）：

1. 它先理解你的需求，可能会用一两段话回复你"我准备这样做……"。
2. 它生成 index.html 文件——你能在左边的文件树里看到这个文件出现。
3. 每写一段代码，它会暂停一下让你看——文件会被自动打开在中间编辑区，你能看到代码逐行出现。
4. 整个过程大概 30-60 秒。

写完之后，对话框底部会出现两个按钮：「全部接受」和「全部拒绝」。点「全部接受」——这样代码就正式保存到你电脑上了。

4.4 看效果

写好的 HTML 怎么看效果？最简单的方法：

方法 1（最简单）：在左边文件树里右键点 index.html，选「在文件夹中显示」（Mac 是 "Reveal in Finder"，Windows 是 "Reveal in File Explorer"）。系统的文件管理器会跳出来，你双击 index.html，电脑会用默认浏览器打开它。

方法 2：在 Trae 里安装一个免费扩展叫 "Live Preview"（左侧扩展图标搜索安装），装好后右键 index.html → "Show Preview"，会在 Trae 内置浏览器里打开。

方法 3：让 Trae 帮你跑——在对话框里说一句"帮我用浏览器打开 index.html 看效果"，Trae 会自己执行命令打开浏览器。

第一次打开你会看到一个居中、深色、带头像和卡片的网页。如果不是你想要的样子——别慌，下一步就是改。

4.5 让 Trae 帮你改细节

如果你看到效果之后想调整，比如：

• "颜色再亮一点"
• "头像改成正方形圆角"
• "增加一段我的旅行经历"
• "把字体换成更可爱的"

直接在对话框里说就行——不需要复杂语法，就用大白话：

头像改成正方形带圆角，技能那一行的标签颜色改成蓝色渐变，再加一段我的旅行经历放在自我介绍下面，约 80 字。

Trae 会理解你的意图，再次修改 index.html。修改完点「接受」，刷新浏览器看效果。

这就是 Trae 最神奇的地方——你不用懂 HTML 是什么，你只需要描述效果，它就会做。

4.6 把成品备份

如果你做出了一个满意的版本，记得给文件夹做个备份——比如压缩成 zip 存到云盘，或者按下一节的"Git 入门"用版本管理。

最简单的备份方式：

• Mac：在 Finder 里右键文件夹 → "压缩 my-intro" → 把生成的 zip 上传到夸克网盘 / 百度网盘。
• Windows：在文件资源管理器里右键文件夹 → "发送到" → "压缩 (zipped) 文件夹"。

五、三个最该立刻学会的快捷键

学完上面四步，你已经会"用 Trae 做出第一个东西"了。下面三个快捷键能让你后面所有操作都快 5 倍。

5.1 Cmd+L（Mac）/ Ctrl+L（Windows）—— 呼出 / 隐藏 AI 对话框

无论你在哪里，按一下就能呼出右边的 AI 对话框，再按一下就能隐藏它。这是你 80% 时间都会用的快捷键。

5.2 Cmd+I（Mac）/ Ctrl+I（Windows）—— 浮动输入框，在编辑器里直接改代码

这是 Trae 的"小招"。

把光标放在编辑器中间的某一行代码上，按 Cmd+I，会弹出一个浮动输入框。在里面用大白话写"把这一段改成蓝色"或者"在这里加一段循环"，AI 会直接修改你光标所在的代码段，不用切换到 Chat 也不用复制粘贴。

适合做"小幅度修改"——只想改一行、一段，不想改整个文件的时候。

5.3 Cmd+P（Mac）/ Ctrl+P（Windows）—— 快速打开文件

在一个有几十个文件的项目里，怎么快速找到 index.html？按 Cmd+P，输入 "index"，按回车，立刻打开。

这是从 VS Code 继承来的"码农一辈子最常用的快捷键"。

六、五大首次报错对照表

新手第一次用 Trae，最容易遇到下面这五种情况。每一个都给了"看到什么"和"怎么办"。

6.1 报错 1：登录页"获取验证码"按钮是灰色的

看到什么：输入了手机号，点「获取验证码」按钮没反应，按钮一直是灰色。

怎么办：往下滑动登录窗口，找到下面的"我已阅读并同意《用户协议》《隐私政策》"小字旁边的复选框，勾上它。勾完之后按钮就亮了。

6.2 报错 2：手机收不到验证码

看到什么：点了「获取验证码」按钮，倒计时开始 60 秒，但是手机一直收不到短信。

怎么办：

1. 检查手机短信是否被运营商拦截（中国移动叫"短信防火墙"，可以发短信 "0000" 到 10086 查看）。
2. 检查手机是否开了"骚扰拦截"功能（小米、华为、OPPO 的安全中心都有）。
3. 等到 60 秒倒计时结束，再点一次。
4. 换个手机号试试（可以用家人的，登完再退出）。
5. 切换到"掘金账号登录"或"飞书账号登录"。

6.3 报错 3：AI 对话框右上角显示"网络错误"

看到什么：你在对话框里输入了一句话，按了发送，AI 一直转圈或者直接红字提示"网络错误"。

怎么办：

1. 检查网络——能访问 trae.com.cn 就说明网络通。
2. 在右上角的"AI 功能管理"里，看一下当前模型是什么。如果是"DeepSeek-R1"，有时候会因为它太热门而排队，**切换到"豆包-1.5-pro"**试试，豆包不会排队。
3. 重启 Trae（关掉再打开）。
4. 如果你公司有内网代理，参考 12 章设置代理；个人电脑一般不需要。

6.4 报错 4：「打开文件夹」之后左边文件树空的

看到什么：你打开了一个文件夹，但左边的"资源管理器"显示空白。

怎么办：这通常是正常的——你新建的文件夹本来就是空的，等 AI 帮你生成第一个文件，就会出现。

如果是已有文件的文件夹但仍然空，可能是文件夹里的文件都是隐藏文件（以 . 开头）。在 Trae 的左侧资源管理器顶部点"…"菜单，勾选「Hidden Files: Show」。

6.5 报错 5：写出来的 HTML 在浏览器里打开是乱码或纯文字

看到什么：你双击 index.html，浏览器打开了，但是没有图片、没有样式，只是黑白文字。

怎么办：

1. 检查文件名后缀是不是 .html（不是 .htm、.html.txt）。Mac 的访达默认隐藏后缀，要在「访达」→「设置」→「高级」里勾选"显示所有文件扩展名"。
2. 检查 HTML 文件里是不是有 <link> 引入 CSS 但 CSS 文件不存在 —— 让 Trae "把所有样式都内联到 HTML 里，不要外部 CSS"。
3. 检查是不是用了需要联网的 CDN 而你正好断网了——让 Trae "换成不依赖 CDN 的纯 CSS"。

七、本章一图回顾（文字版）

今天你完成了什么？
    │
    ├─ 1. 下载安装 Trae 国内版（10 分钟，350MB 安装包）
    ├─ 2. 用手机号登录账号（1 分钟）
    ├─ 3. 新建文件夹 + 在 Trae 里打开它（1 分钟）
    ├─ 4. 在 Builder 模式里用一句话生成"个人简介网页"（2 分钟）
    ├─ 5. 让 Trae 帮你迭代调整（每次 30 秒）
    ├─ 6. 在浏览器里看到效果
    └─ 7. 学会了 Cmd+L / Cmd+I / Cmd+P 三个快捷键

下一步该做什么？
    │
    └─ 第三章：搞清楚 Chat / Builder / SOLO 三种模式的差别
       什么时候用哪个，决策一目了然

八、本章常见的疑问

Q1：我装的是国内版，但想试试国际版的 Claude，能直接切换吗？

不能。两个版本是两个独立的客户端，需要分别下载、分别登录。但好消息是它们可以装在同一台电脑上互不影响——一个用 trae.com.cn 注册，一个用 trae.ai 注册。

Q2：我做的项目文件保存在哪里？

就在你 打开文件夹 时选中的那个文件夹里。Trae 不会偷偷把文件保存到其他地方，所有变更都在你看得见的地方发生。

Q3：我能不能不打开文件夹，直接在 Trae 里聊天用？

可以，但强烈不推荐。不打开文件夹的时候，Trae 没办法保存它生成的代码，你做的所有努力都是"一次性的"。每次用 Trae，先打开一个文件夹是好习惯。

Q4：我做完一个项目，下次想接着做，怎么办？

打开 Trae → 在欢迎页选「我的最近项目」，里面有你之前打开过的所有文件夹，点一下就回到原来的状态。

Q5：我这个项目文件夹我以后不想要了，怎么删？

直接在你的文件管理器（Mac 的访达 / Windows 的资源管理器）里删除整个文件夹就行。Trae 不会"留印记"。

Q6：能在公司电脑装吗？

技术上能装。但请检查公司 IT 政策——很多公司禁止"会上传公司代码到第三方服务器"的工具。Trae 国内版会把你的对话发到字节服务器，不要在公司电脑上处理任何机密代码 / 客户数据。第十二章会有更详细的隐私指南。

下一章 第三章 三种工作模式（Chat、Builder、SOLO），我们搞清楚 Trae 的三种工作模式分别适合什么场景。