Trae 安装入门：做出第一张网页
📍 国产 AI 工具 · Trae 教程
这一篇你会学到
Section titled “这一篇你会学到”这次做一张 “我的 AI 学习卡”网页：有标题、三条练习计划和一个能展开提示的按钮。最后，你会把它保存成电脑上的文件，用浏览器打开，再让 AI 修改一次。
只需要电脑、浏览器，以及能登录并有可用额度的 TraeCode 账号。不用先学终端，不用安装 Python 或网页开发框架，也不用购买订阅。 如果账号没有可用免费额度，先停在查看额度这一步，按页面规则领取或等待；本练习不要求付费解锁。
本文依据 2026 年 9 月 26 日核对过的官方文档整理，未以新免费账号完成安装和生成实测。下面的提示与验收标准供你自己尝试，配图为示意，不是当前版本的按钮位置截图。下载、登录和生成的用时因设备与网络而异，不设“五分钟必成”的目标。
1. 下载安装包
Section titled “1. 下载安装包”
大陆读者从中国版官网进入。海外中文读者先看国际版的官方可用地区列表（北美目前只列了美国和墨西哥）：所在地在列表里，再从国际版官网进入；不在列表里，就先不用花时间安装，改用浏览器里的聊天工具。选择 TraeCode，也就是原来教程中说的 Trae IDE。 TraeWork 是另一款工作台，界面和操作不同，本篇不混用它的步骤。（2026-10-12 补：合并之后下载页上不用再选，只有一个 TRAE。）
下载前核对系统和处理器。中国版官方快速开始当前列出的要求是：
| 电脑系统 | 官方当前支持范围 | 下载时看什么 |
|---|---|---|
| macOS | 12.0 及以上，Apple Silicon 或 Intel | 在“关于本机”核对芯片，选择对应安装包 |
| Windows | Windows 10、11，x64 | 核对系统类型为 64 位；不要把 ARM 版本支持当成已有保证 |
| Linux | Ubuntu 20.04+、Debian 10+；Fedora 42、RHEL 9.x；x64 或 ARM64 | 核对发行版、架构，再选 .deb 或 .rpm |
这张表来自中国版文档。国际版读者应以国际版官网实际提供的下载项与系统要求为准。没有适合自己设备的安装包，就先回新手路线使用浏览器工具，不需要为了练习勉强换系统。
Windows
Section titled “Windows”运行从官网取得的安装程序，按系统提示安装，通常保留默认位置即可。
如果系统报告文件风险、发布者异常或阻止启动，先核对下载来源、系统版本和报错全文，再查官方帮助。不要把关闭防护当作安装的常规步骤。
打开官网提供的安装包，按其中的指引安装；如果是磁盘映像，通常将应用拖到“应用程序”后再打开。
遇到“无法验证”“文件已损坏”等提示，先重新核对来源与系统要求，必要时重新下载，再按系统或官方帮助处理。
使用发行版的软件安装器或包管理器打开对应的官方 .deb、.rpm 包。出现依赖错误时，先记录发行版、版本、处理器架构和完整错误，再查对应说明；不要把不同发行版的修复命令混着执行。
3. 首次启动：先用最少的配置
Section titled “3. 首次启动：先用最少的配置”按向导选择你看着舒服的主题和语言。第一次使用编辑器，可以跳过配置迁移和命令行入口；本练习只用图形界面打开文件夹。已在用 VS Code 或 Cursor 的读者，可以按向导选择导入已有配置，不必为了入门先迁移所有插件。官方初始设置说明
这一步不需要安装扩展、接入外部服务或创建 API 密钥。打开工具后，先完成登录与额度核对，再开始生成。
4. 登录账号
Section titled “4. 登录账号”
使用当前版本实际展示的登录方式。中国版与国际版的入口可能不同，不要在界面没有邮箱登录时反复寻找旧教程中的按钮，也不要默认一个版本的账号权益能直接用于另一个版本。
登录后查看账号或用量页面，确认三件事：
- 当前是哪个版本、哪个账号。
- 是否有可用的免费额度，以及何时到期或恢复。
- 当前使用的功能是否需要订阅或额外付费。
中国版看账号里的积分：只有调用内置模型才扣积分，免费用户每月登录送 500 积分，新用户另有一次性赠送（截至 2026-09-26）。国际版 Free 档的模型选择和功能也有限制。本次保持免费路径；不要为了一次练习开启按量付费。中国版计费规则、国际版计费规则
登录收不到验证码时，核对自己选择的账号入口，按页面间隔重试或走官方支持。只有界面提供另一种登录方式时，才切换尝试。
5. 选模型
Section titled “5. 选模型”先用账号当前可选、额度能覆盖的默认模型或 Auto 自动选择，不需要追逐旧教程里的指定版本。中国版的官方模型表会更新；国际版 Free 档当前按官方说明使用 Auto。中国版模型说明
本次目标只是一个静态网页，用完一轮后看文件、看结果、看剩余额度，再决定要不要继续。模型选项显示不可用或要求升级时，就换到当前允许的选项。
6. 第一个项目：我的学习卡
Section titled “6. 第一个项目：我的学习卡”步骤 1：新建一个空文件夹
Section titled “步骤 1：新建一个空文件夹”在你方便找到的地方，新建文件夹 hello-trae。通过 TraeCode 的“打开文件夹”入口打开它。只放本次练习文件，先不要打开整个“文档”或工作项目目录。
这份练习使用虚构计划，没有个人或客户资料。想了解数据设置，可以看上一篇的数据说明和官方隐私模式说明。
步骤 2：告诉 AI 具体要做什么
Section titled “步骤 2：告诉 AI 具体要做什么”打开侧边对话，使用 IDE 模式下可用的文件编辑智能体。侧边对话面板默认打开；关掉了，按 Cmd+U（Windows 用 Ctrl+U）重新打开。界面如果处在 SOLO 模式，先用左上角的模式开关切回 IDE 模式。当前中国版和国际版文档都把内置编程智能体称为 Agent，可从对话输入框的 @ 菜单选择；旧教程中的 Builder 已合并进 Agent。其他版本的入口请按其当前界面选择。对话文档、内置智能体说明
把下面这段需求复制进去：
我第一次用 AI 做网页，请在当前 hello-trae 文件夹里制作一张学习卡。
只创建一个 index.html，把样式和脚本都写在这个文件里。不要安装依赖、不要调用外部服务、不要使用外部字体或图片。不需要启动服务器，不需要发布到网上。
页面内容：- 标题：我的 AI 学习卡- 三条计划：问清一个问题；核对一条事实；完成一个小练习。- 一个“显示学习提示”按钮，点击后显示：每次只做一件小事，做完亲手检查。- 适合电脑和手机宽度阅读。
完成后告诉我文件保存在哪里，如何用浏览器打开，以及需要检查的三件事。如果当前模式不能创建文件，请明确告诉我，不要说已经保存。Agent 一般会先给出一份计划（PRD，也就是需求说明，加上技术方案）。先核对计划是不是只做一个 index.html、不装依赖，再点确认，它才会开始写文件；确认后的执行也会消耗额度。文件会直接写进文件夹，编辑器里会出现「保留」「撤销」按钮，看过没问题就点「保留」。
写完后看它是否真的创建了 index.html。如果只有一段代码出现在对话里，可以让它解释如何保存，或使用编辑器新建同名文件后粘贴完整代码，再保存。
如果它开始建议安装框架、连接账号或部署网站，就补一句：“请回到单个 HTML 文件，直接用浏览器打开的方案。”HTML 是浏览器能读取的网页文件格式，这个练习没有必要引入额外环境。
步骤 3：亲手打开并检查
Section titled “步骤 3：亲手打开并检查”在文件管理器中找到 index.html，用浏览器打开；也可以把文件拖进浏览器窗口。文件扩展名应为 .html，不要误存成 index.html.txt。
| 检查什么 | 怎样才算这一项完成 |
|---|---|
| 内容 | 标题和三条计划完整，文字没有被 AI 擅自替换 |
| 按钮 | 点击后出现指定提示；刷新页面后仍可再次使用 |
| 窄屏 | 缩窄窗口后，正文和按钮仍能阅读、点击，没有内容挤出画面 |
| 文件 | 关闭后能从同一个 index.html 再次打开 |
这些是你要亲自确认的结果，不是对生成成功率的保证。页面只在本地打开，尚未发布到互联网上。
步骤 4：只修改一处，再复查
Section titled “步骤 4：只修改一处，再复查”页面基本可用后，给 AI 一次小修订：
保留现有内容和按钮功能，只在标题下增加“今天我完成了第一张网页”。告诉我修改的位置，其他地方不要动。
保存后刷新浏览器，确认新句子出现，原来的按钮仍能用。需求、生成、检查、修订，这一轮就是你以后与 AI 做更大项目的基础。
可选进阶：再试一个 Python 脚本
Section titled “可选进阶：再试一个 Python 脚本”如果电脑本来已安装 Python 3，可以另外请 AI 创建 hello.py，打印五次“你好，Trae！”。运行前先确认文件内容；在该文件夹的终端中，macOS 或 Linux 通常用 python3 hello.py，Windows 安装了 Python Launcher 时可用 py hello.py。
找不到命令表示 Python 环境还没有就绪，不是前面的网页练习失败。先完成网页即可，不需要让 AI 自动改系统环境。
7. 常见坑速查
Section titled “7. 常见坑速查”| 遇到的情况 | 接下来做什么 |
|---|---|
| 页面和教程不一样 | 先确认自己在 IDE 窗口（2026 年 10 月合并后，TraeCode 是 TRAE 里的 IDE 窗口；不在就点右上角的「IDE」），查看客户端版本，再查当前官方文档 |
| 国际版登录后提示所在地区不可用 | 这是服务地区限制，不是网络问题；所在地不在官方可用地区列表里，先改用浏览器里的聊天工具 |
| AI 说完成，但文件夹里没有文件 | 让它说明是否有文件写入能力，并给出实际文件名；只有回复文本不算保存成功 |
| 网页显示成一整页代码 | 检查后缀为 .html，并确认是在浏览器打开，不是在编辑器里看源码 |
| 按钮没有反应 | 告诉 AI 你点击了什么、实际发生什么，请它只检查该按钮，不要重做整个项目 |
| 回复慢、排队或中断 | 看页面是否显示限流或额度不足；保存现有成果，按提示稍后再试 |
| 弹出安装软件或付费提示 | 本练习不依赖这些步骤，先停止该操作，重新说明单文件与免费要求 |
反馈问题时，可以告诉 AI 操作系统、当前版本、步骤和报错原文。截图先裁掉账号信息；不要为了排查把整个私人目录交给它。
这次练习的完成标准
Section titled “这次练习的完成标准”你能找到并重新打开 index.html，检查按钮和文字，说明自己让 AI 改过哪一处，就已经完成了本次练习。记下“卡在哪里、怎么解决”，比记录用了几分钟更有助于下一次进步。
下一步可以把卡片改成自己的阅读计划，或者继续看 Trae 实战：改简历、整理数据、做网站。涉及新软件、命令或外部服务时，先补齐相应条件，再继续扩大任务。