安装并配置 TRAE：从下载到用 AI 助手创建第一个项目

TRAE 是一款面向开发者的 AI 驱动集成开发环境，把智能问答、代码自动补全和基于 Agent 的自动编程能力直接做进了编辑器里。它支持简体中文界面，内置 Claude 与 GPT-4o 模型，适合希望在不更换工作习惯的前提下把 AI 编码能力引入日常开发的人，也适合原本使用 VS Code 或 Cursor、想尝试另一种 AI IDE 的开发者。本文按实际操作顺序，把安装、首次配置、配置迁移、命令行安装、账号登录和第一个项目的创建串成一条完整路径。如果你还想了解这款工具的整体定位与能力边界，可以先看 TRAE 的工具页，再回到本文动手。

需要提前说明的是：TRAE 的可用模型、是否收费、各平台安装包形态等信息会随时间变化，本文只描述流程本身，具体价格、配额与版本请以官网当前信息为准。

准备工作

在动手之前，先确认下面几件事，可以避免安装到一半卡住。

一台可正常联网的电脑：下载安装包、首次登录以及后续调用 AI 服务都需要网络连接。
可用的手机号：TRAE 使用手机号登录，登录完成后才能在编辑器内使用 AI 服务。没有登录时，编辑器本身可以打开，但 AI 相关功能不可用。
确认操作系统与芯片架构：安装包按平台区分，Windows 使用 .exe 安装包；macOS 需要区分 Intel 芯片与 Apple Silicon（ARM）两种版本，分别对应不同的 .dmg 安装包。选错架构的包在 macOS 上可能无法正常启动。
（可选）已有的 VS Code 或 Cursor 环境：如果本机已经装好并配置过这两个编辑器之一，可以在初始化阶段直接导入插件、IDE 设置和快捷键，省去重新配置的时间。
（可选）一个已有项目或 Git 仓库地址：用于验证安装完成后能否正常打开并开发项目。

操作步骤

第一步：下载安装包

访问 TRAE 官网。页面会自动识别当前操作系统，并推荐对应的下载版本，通常直接点击主下载按钮即可。如果自动识别不准确，或者你想为另一台机器准备安装包，可以手动选择：

操作系统	下载版本
Windows	.exe 安装包
macOS（Intel 芯片）	.dmg 安装包
macOS（Apple Silicon）	.dmg 安装包（ARM 版本）

下载完成后，双击安装包，按安装向导的提示逐步完成安装。安装过程没有额外的自定义选项需要填写，保持默认路径通常即可。

第二步：首次启动与基础配置

安装完成后启动 TRAE，首次启动会进入初始配置页面。点击「开始」按钮进入配置流程，随后需要做两个选择：

选择主题：可选暗色、亮色和深蓝三种，按个人习惯选择即可，后续一般也可以在设置中调整。
选择显示语言：可选简体中文和 English。选择你日常阅读习惯的语言，界面文案会随之切换。

完成主题与语言的选择后，点击「继续」按钮进入下一步。这一步只是外观与语言偏好，不影响后续功能，选错了也不必紧张。

第三步：从 VS Code 或 Cursor 导入配置（可选）

如果本机已经安装并配置过 VS Code 或 Cursor，这一步能显著减少迁移成本。在配置流程中会出现两个按钮：

从 VS Code 导入
从 Cursor 导入

点击对应按钮后，TRAE 会从该编辑器中读取插件、IDE 设置、快捷键设置等信息，并一键导入。导入完成后，原本熟悉的扩展和键位基本可以直接沿用，不需要逐项手动重建。

如果本机没有安装这两个编辑器，或者希望从干净状态开始，跳过这一步即可，不影响后续使用。

第四步：安装 trae 命令行

TRAE 提供命令行工具，安装后可以在终端里直接唤起编辑器或打开项目，比每次从图形界面点选更快。在配置流程中点击「安装 trae 命令」按钮，然后按提示完成授权流程。

安装完成后，可以在终端中使用以下命令：

trae

该命令用于快速唤起 TRAE。若要在 TRAE 中直接打开某个项目目录，把项目路径作为参数传入：

trae my-react-app

这里的 my-react-app 是项目目录名，实际使用时替换成你自己的项目路径即可。命令行安装属于可选项，即使跳过，也不影响通过图形界面打开项目。

第五步：登录账号

使用手机号登录 TRAE。登录是使用 AI 能力的前提——未登录状态下可以打开项目、浏览代码，但智能问答、代码补全、Agent 自动编程等 AI 服务无法使用。完成登录后，界面会进入可正常开发的状态。

第六步：打开项目或新建项目

登录成功后，有两条路径可以开始工作：

打开已有项目或克隆 Git 仓库：如果你已经有本地项目，直接打开对应目录；如果代码还在远端，先克隆仓库再打开。打开后即可使用 AI 助手辅助阅读和修改代码。
用 AI 助手从零创建新项目：如果还没有项目，可以让 AI 助手引导完成项目创建，它会带着你走完从零到一的过程，适合快速起一个原型或验证想法。

一个完整示例

下面把上述步骤串成一个从零开始的最小流程，假设你在一台全新的 macOS（Apple Silicon）机器上，本机已装过 VS Code 并配置了常用插件。

下载：打开 TRAE 官网，页面识别出 macOS 后给出推荐版本；确认下载的是 Apple Silicon 对应的 .dmg 安装包，而不是 Intel 版本。
安装：双击 .dmg，按提示把 TRAE 安装到电脑上。
首次启动：打开 TRAE，在初始配置页点击「开始」。
选主题与语言：主题选「暗色」，显示语言选「简体中文」，点击「继续」。
导入配置：点击「从 VS Code 导入」，等待插件、IDE 设置与快捷键导入完成。
安装命令行：点击「安装 trae 命令」，完成授权。随后打开终端验证：

trae

如果 TRAE 窗口被唤起，说明命令行已可用。接着准备一个项目目录，例如在终端中进入某个已有仓库的上级目录，然后执行：

trae my-react-app

该命令会在 TRAE 中打开 my-react-app 项目。

登录：在 TRAE 中使用手机号完成登录。登录前 AI 功能不可用，登录后即可调用。
开始开发：项目已在编辑器中打开，此时可以使用智能问答询问代码逻辑、依靠代码自动补全写新代码，或让 Agent 完成一段自动编程任务。

如果你手上没有任何项目，把第 6 步替换为「使用 AI 助手创建新项目」，由助手引导完成项目初始化，其余步骤不变。

注意事项

未登录无法使用 AI 服务：这是最容易忽略的一点。编辑器能打开、文件能编辑，但智能问答、补全和 Agent 能力都依赖登录状态。如果发现 AI 功能没有反应，先检查是否已完成手机号登录。
macOS 安装包要区分芯片架构：Intel 与 Apple Silicon 对应不同的 .dmg。下载前确认本机芯片类型，装错版本可能导致启动异常。
配置导入是一次性动作：从 VS Code 或 Cursor 导入发生在初始化流程中。如果当时跳过了，后续再想迁移插件和快捷键，需要自行在设置中处理。
命令行是可选项：不安装 trae 命令也能正常使用图形界面，只是少了从终端快速唤起和打开项目的便利。
模型与收费情况会变化：TRAE 集成的模型、是否免费、可用额度等属于易变信息，不要以任何教程中的描述为准，使用前请查阅官网当前说明。
主题与语言可后续调整：初始化时选择的主题和显示语言只是初始偏好，不必在这一步反复纠结。

走完以上流程，你已经具备了一个可用的 TRAE 环境：编辑器装好、配置迁移完成、命令行可用、账号已登录，并且能打开或新建项目。接下来要做的，就是在真实代码上逐步熟悉它的智能问答、代码补全与 Agent 自动编程这三类能力，看哪一类最契合你的日常开发节奏。