> ## 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.

:::tip 提示
TraeCode CLI 2.0 已上线！

TraeCode CLI 2.0 是运行在本地终端里的编码 Agent。你可以在项目目录中直接向它描述任务，让它理解当前代码仓库、读取和修改工作区文件、执行命令、生成和评审代码。它支持通过插件、技能和 MCP 扩展外部工具能力，也支持 Agent Client Protocol（ACP），可作为智能体服务端接入支持 ACP 的编辑器或客户端。

TraeCode CLI 2.0 适合希望在终端中完成研发工作的开发者和团队。它既支持交互式 TUI 对话，也支持非交互式命令，可用于日常编码、测试修复、代码评审、变更整理和自动化脚本等场景。

关于 TraeCode CLI 2.0 的详细使用说明，参考 [TraeCode CLI 2.0 使用指南](/cli_about-trae-code-cli-2)。
:::

本文介绍如何将 TraeCode CLI 安装至你的本地环境，并使用 TraeCode CLI 发起一个任务。

## 支持的操作系统 {#0eac8790}

TraeCode 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  |

## 安装 TraeCode CLI {#f515d4d9}

根据你所使用的操作系统，执行相应的脚本来安装最新版本的 TraeCode CLI。

### macOS & Linux {#f515d4d9_1}

在本地终端中，执行以下脚本，安装 TraeCode CLI。

```Bash
sh -c "$(curl -L https://trae.cn/trae-cli/install.sh)" && export PATH=~/.local/bin:$PATH 
```

### Windows (PowerShell) {#f515d4d9_2}

在 PowerShell 中，执行以下脚本，安装 TraeCode CLI。

```PowerShell
irm https://trae.cn/trae-cli/install.ps1 | iex 
```

如果 TraeCode 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 运行库）。

## 启动 TraeCode CLI 并发起一次任务 {#6dbf73f6}

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


## 升级 TraeCode CLI {#4a9c3dab}

支持自动升级和手动升级两种方式。

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