Trae 的上手速度非常快——下载安装不到 5 分钟，打开就能用 AI 写代码。如果你用过 VS Code，界面几乎零学习成本。
下载安装
- 打开 trae.ai（海外版）或 trae.cn（国内版）
- 下载对应系统的安装包（macOS / Windows，Linux 版计划中）
- 安装后首次启动，选择界面主题（深色 / 浅色 / 深蓝）和语言
- 用 Google、GitHub 或邮箱注册账号
- 进入主界面，直接开始
海外版 vs 国内版：海外版（trae.ai）能用 Claude Sonnet 和 GPT-4o；国内版（trae.cn）接入的是豆包等国产模型，功能有差异。JR Academy 的同学建议用海外版。
迁移 VS Code 设置
如果你已经在用 VS Code，Trae 可以一键导入：
# Trae 首次启动时会提示导入
# 也可以手动操作：
# 1. 打开 Trae 设置
# 2. 搜索 "Import"
# 3. 选择 "Import VS Code Settings & Extensions"
# 导入内容包括：主题、快捷键、已装插件、用户设置
大部分 VS Code 插件（.vsix 格式）都能直接在 Trae 里用——GitLens、Prettier、ESLint 这些常用的都没问题。
界面布局
Trae 的界面分四个核心区域：
- 左侧文件树：项目文件和文件夹，和 VS Code 一样
- 中间编辑器：写代码的主区域，支持多标签页
- 右侧 AI 面板：Chat / Builder / SOLO 三个模式的切换入口
- 底部终端：内置终端，可以跑任何命令
常用快捷键：
| 操作 | macOS | Windows |
|---|---|---|
| 打开 AI 面板 | Cmd + I |
Ctrl + I |
| 内联补全接受 | Tab |
Tab |
| 命令面板 | Cmd + Shift + P |
Ctrl + Shift + P |
用 Builder Mode 生成第一个项目
这是 Trae 最有冲击力的功能——用一段话描述需求，AI 给你搭出整个项目。
- 新建一个空文件夹，用 Trae 打开（
File > Open Folder） - 右侧 AI 面板切到 Builder Mode
- 输入项目描述，比如：
用 React + Vite + Tailwind CSS 做一个 Pomodoro 番茄时钟应用。
需要：
- 25 分钟倒计时，可以暂停和重置
- 休息时间 5 分钟
- 完成次数统计
- 深色主题
- 响应式布局，手机端也能用
- AI 开始分析需求、创建文件、写代码。你能实时看到文件树在变化
- 点击 Preview 按钮，Webview 窗口弹出，应用已经在跑了
- 觉得哪里不对，直接在 Builder 里追加修改："把计时器数字改大一点，用等宽字体"
整个过程不需要手动 npm init、不需要配 Tailwind、不需要写 vite.config.ts——AI 全帮你搞定。
版本回滚
Builder Mode 有个救命功能：版本历史。
点右上角 Show History 按钮，能看到每一轮 AI 修改的快照。觉得改坏了？直接回滚到任意一个历史版本。比手动 git stash 方便得多，特别是 AI 一次改了十几个文件的时候。
第一天就能做到的事
装好 Trae 后，你马上可以做这些事来熟悉它：
- 用 Builder Mode 生成一个 Todo App（经典练手项目）
- 用 Chat Mode 让 AI 解释一段你看不懂的开源代码
- 把现有项目打开，试试
Cmd+I问 AI 任何关于项目的问题 - 截一张 UI 设计图丢给 AI，让它生成对应的 React 组件
