> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

本文档将带你完成 TRAE 的安装、基础配置与核心功能的快速上手。从启动 IDE、导入项目，到使用双重开发模式、智能体和 CUE 等关键能力，你将了解如何在 TRAE 中开启你的第一个开发任务。
## 支持的操作系统 {#784b4017}
<!-- @cols-width: 123,387,244 -->
| | | | \
|**操作系统** |**最低版本 / 发行版** |**架构** |
|---|---|---|
| | | | \
|macOS  |12.0 及以上 |Apple Silicon、Intel |
| | | | \
|Windows  |Windows 10、Windows 11 |64 位（x64） |
| | | | \
|Linux  |* Debian 格式（`.deb`）：Ubuntu 20.04、Debian 11 |\
| |* RPM 格式（`.rpm`）：Fedora 42、RHEL 9.x |64 位（x64）、64 位（ARM64） |

## 安装 TRAE 并完成初始设置 {#01c4b675}

1. 前往 [TRAE 官网](https://www.trae.com.cn)，点击右上角的 **下载 IDE** 按钮，将安装包下载到本地并完成安装。
   若你使用的 macOS 系统版本低于 12，直接通过以下链接下载低于 3.3.25 版本的 TRAE IDE：
   * [Apple Silicon 芯片](https://lf-cdn.trae.com.cn/obj/trae-com-cn/pkg/app/releases/stable/2.3.4283/darwin/Trae%20CN-darwin-arm64.dmg )
   * [Intel 芯片](https://lf-cdn.trae.com.cn/obj/trae-com-cn/pkg/app/releases/stable/2.3.4283/darwin/Trae%20CN-darwin-x64.dmg)
2. 启动 TRAE， 然后跟随界面指引完成初始设置，包括：
   * 选择主题和语言。
   * 从 VS Code 或 Cursor 导入已有配置。
   * 添加 TRAE 相关的命令行。
   * 使用手机号或稀土掘金账号登录 TRAE。

## 打开项目 {#5dd7a0fb}
你可以直接导入一个本地文件夹或克隆一个 Git 仓库。

:::: tabs
@tab 导入本地文件夹
1. 点击左侧面板中央的 **打开文件夹** 按钮，或在界面左上角点击 **选择项目** > **打开文件夹**。
2. 从本地选择一个文件夹并在 TRAE 中将其打开。

@tab 从 GitHub 克隆仓库
1. 点击左侧面板中央的 **克隆 Git 仓库** 按钮，或在界面左上角点击 **选择项目** > **克隆 Git 仓库**。
2. 在界面顶部中央弹出的面板中，点击 **从 GitHub 克隆**。
   ![Image=650x138](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a8dd0f17bf2142d1a5d38aa8f831e00c~tplv-goo7wpa0wc-image.image)
3. 跟随界面提示，完成 TRAE 与 GitHub 间的授权，然后将目标仓库克隆至本地，并在 TRAE 中将其打开。

@tab 从 URL 克隆仓库
1. 点击左侧面板中央的 **克隆 Git 仓库** 按钮，或在界面左上角点击 **选择项目** > **克隆 Git 仓库**。
2. 在界面顶部中央弹出的面板中，输入目标 Git 仓库的 URL，然后点击 **存储库 URL {URL}**。
   ![Image=650x162](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ee4043c20d1644ac8c922aeeb90c44e2~tplv-goo7wpa0wc-image.image)
3. 跟随界面提示，将目标仓库克隆至本地，然后在 TRAE 中将其打开。

::::

## 使用 IDE 或 SOLO 模式 {#8cbd3f26}
TRAE 提供双重开发模式。在界面左上角，你可根据任务需求自由切换模式。

* **IDE 模式**：保留传统的开发方式，开发者可全程自主控制流程，获得更强的掌控感。
* **SOLO 模式**：以 AI 为主导，自动规划任务并完成从需求理解、代码生成、测试，到成果预览的全流程。详情参阅 [SOLO 模式概览](/ide/solo-mode)。


::::cols
@col 50
![Image=3024x1892](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/6b36edcffc1644218868ce19827f6274~tplv-goo7wpa0wc-image.image)


@col 50
![Image=3024x1892](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/b6fd780a9a274f66aa80307bf803056c~tplv-goo7wpa0wc-image.image)

::::

## 与智能体协作 {#037b0f4f}
智能体是你面向不同开发场景的编程助手。TRAE 提供内置智能体。同时，你还可以创建自定义智能体，通过灵活配置提示词和工具集，使其更高效地帮你完成复杂任务。详情参阅[创建并管理智能体](/ide/agent)。
## 开启智能编程助手：CUE {#f7686f6a}
CUE 是一款旨在提升开发效率的智能编程工具，支持代码补全、多行修改、修改点预测、修改点跳转、智能导入和智能重命名功能。详情参阅 [超级代码补全：CUE](/ide/cue)。
![Image=700x330](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3ccae78833dc4270921c77c5a57f1885~tplv-goo7wpa0wc-image.image)
## 使用 MCP Server {#f757a072}
Model Context Protocol (MCP) 是一种协议，它允许大型语言模型（LLMs）访问自定义的工具和服务。TRAE 中的智能体作为 MCP 客户端，可以向 MCP Server 发起请求，以调用其提供的工具。你可以自行添加 MCP Server，并添加到自定义的智能体中使用。详情参阅 [MCP 概览](/ide/model-context-protocol)。