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

本文档将带你完成 TraeCode 的安装、基础配置与核心功能的快速上手。从启动 TraeCode、导入项目，到使用双重开发模式、智能体和 CUE 等关键能力，你将了解如何在 TraeCode 中开启你的第一个开发任务。

## 支持的操作系统 {#784b4017}

<!-- @cols-width: 123,472,244 -->
| **操作系统**  | **最低版本 / 发行版**  | **架构**  |
| --- | --- | --- |
| macOS  | 12.0 及以上  | Apple Silicon、Intel  |
| Windows  | Windows 10、Windows 11  | 64 位（x64）  |
| Linux  | * Debian 格式（`.deb`）：Ubuntu 20.04 及以上、Debian 10 及以上 | 64 位（x64）、64 位（ARM64）  | \
| | * RPM 格式（`.rpm`）：Fedora 42、RHEL 9.x  | |

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

1. 前往 [TRAE 官网](https://www.trae.com.cn)，点击右上角的 **下载 IDE** 按钮，将安装包下载到本地并完成安装。
   若你使用的 macOS 系统版本低于 12，直接通过以下链接下载低于 3.3.25 版本的 TraeCode：
   * [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. 启动 TraeCode， 然后跟随界面指引完成初始设置，包括：
   * 选择主题和语言。
   * 从 VS Code 或 Cursor 导入已有配置。
   * 添加 TraeCode 相关的命令行。
   * 使用手机号、抖音账号、苹果账号、手机号或稀土掘金账号登录 TraeCode。

## 配置开发环境 {#hldBqeRjS}

前往 **设置** > **开发环境**，配置 TraeCode 的本地开发运行环境。

当前支持配置 Node.js 版本，用于指定 TraeCode 在运行项目、安装依赖、执行构建或测试命令时使用的 Node.js 环境。点击 **+** 后，你可以添加本地已安装的 Node.js SDK，也可以下载并使用 TraeCode 内置的 Node.js SDK 版本。

![Image=600x143](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8453ef08eed14af59b92adecb878f502~tplv-goo7wpa0wc-topic.webp)

## 打开项目 {#5dd7a0fb}

你可以直接导入一个本地文件夹或克隆一个 Git 仓库。

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

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

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

## 使用 IDE 或 SOLO 模式 {#8cbd3f26}

TraeCode 提供双重开发模式。在界面左上角，你可根据任务需求自由切换模式。

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

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

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

## 与智能体协作 {#037b0f4f}

智能体是你面向不同开发场景的编程助手。TraeCode 提供内置智能体。同时，你还可以创建自定义智能体，通过灵活配置提示词和工具集，使其更高效地帮你完成复杂任务。详情参阅[创建并管理智能体](/ide/agent)。

## 开启智能编程助手：CUE {#f7686f6a}

CUE 是一款旨在提升开发效率的智能编程工具，支持代码补全、多行修改、修改点预测、修改点跳转、智能导入和智能重命名功能。详情参阅 [超级代码补全：CUE](/ide/cue)。

![Image=700x330](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3ccae78833dc4270921c77c5a57f1885~tplv-goo7wpa0wc-topic.webp)

## 使用 MCP Server {#f757a072}

Model Context Protocol (MCP) 是一种协议，它允许大型语言模型（LLMs）访问自定义的工具和服务。TraeCode 中的智能体作为 MCP 客户端，可以向 MCP Server 发起请求，以调用其提供的工具。你可以自行添加 MCP Server，并添加到自定义的智能体中使用。详情参阅 [MCP 概览](/ide/model-context-protocol)。