> ## 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 CLI 安装至你的本地环境，并使用 TRAE CLI 发起一个任务。
## 支持的操作系统 {#0eac8790}
TRAE CLI 支持在 Windows、macOS 和主流 Linux 发行版上运行。安装前，请确认你的设备满足以下系统和架构要求。
<!-- @cols-width: 156,360,342 -->
| | | | \
|**操作系统** |**最低版本 / 发行版** |**架构** |
|---|---|---|
| | | | \
|Windows |Windows 10 及以上 |x86_64、ARM64 |
| | | | \
|macOS |macOS 14.7.8 及以上 |x86_64 (Intel)、ARM64 (Apple Silicon) |
| | | | \
|Linux |Ubuntu 20.04 及以上、Debian 10 及以上 |x86_64、ARM64 |

## 安装 TRAE CLI {#f515d4d9}
根据你所使用的操作系统，执行相应的脚本来安装最新版本的 TRAE CLI。
### macOS & Linux {#f515d4d9}
在本地终端中，执行以下脚本，安装 TRAE CLI。
```Bash
sh -c "$(curl -L https://trae.cn/trae-cli/install.sh)" && export PATH=~/.local/bin:$PATH 
```

### Windows (PowerShell) {#f515d4d9}
在 PowerShell 中，执行以下脚本，安装 TRAE CLI。
```PowerShell
irm https://trae.cn/trae-cli/install.ps1 | iex 
```

如果 TRAE CLI 自带的 Ripgrep 不可用，还需安装 [Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-supported-redistributable-version)（VC 运行库）。
## 启动 TRAE CLI 并发起一次任务 {#6dbf73f6}

1. 执行 `cd` 命令，进入目标项目。
2. 执行以下命令，启动 TRAE CLI。
   ```Bash
   traecli
   ```

   启动完成后，你将进入以下界面：
   ![Image=600x361](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/cf5819113ae041198198ddbc7bafd00d~tplv-goo7wpa0wc-image.image)
3. 在对话框中输入一个指令或问题，然后发送给 TRAE CLI。例如：`解释这个项目的架构`。
   TRAE CLI 会唤起企业用户登录页面。
4. 登录你的企业账号并完成授权，然后返回 TRAE CLI。
   TRAE CLI 开始分析问题并生成答复。

## 升级 TRAE CLI {#4a9c3dab}
支持自动升级和手动升级两种方式。

* **自动升级**：启动 TRAE CLI 后，若当前版本非最新版本，TRAE CLI 会开始自动升级并在界面右下角提示状态。
* **手动升级**：使用 `traecli update` 命令手动升级。