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

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

关于 TraeCode CLI 2.0 的详细使用说明，参考 TraeCode CLI 2.0 使用指南。

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

支持的操作系统

TraeCode CLI 支持在 Windows、macOS 和主流 Linux 发行版上运行。安装前，请确认你的设备满足以下系统和架构要求。

操作系统	最低版本 / 发行版	架构
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

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

macOS & Linux

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

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

Windows (PowerShell)

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

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

如果 TraeCode CLI 自带的 Ripgrep 不可用，还需安装 Visual C++ Redistributable（VC 运行库）。

启动 TraeCode CLI 并发起一次任务

执行 cd 命令，进入目标项目。
执行以下命令，启动 TraeCode CLI。
```
traecli
```
启动完成后，你将进入以下界面：
在对话框中输入一个指令或问题，然后发送给 TraeCode CLI。例如：解释这个项目的架构。
TraeCode CLI 会唤起企业用户登录页面。
登录你的企业账号并完成授权，然后返回 TraeCode CLI。
TraeCode CLI 开始分析问题并生成答复。

升级 TraeCode CLI

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

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

文档对您有帮助吗?