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

TraeCode CLI 2.0 是运行在本地终端里的编码智能体。它可以理解当前代码仓库、读取和修改工作区文件、执行命令、生成和评审代码，也可以通过插件、技能和 MCP 扩展外部工具能力。

## 适用环境 {#hHQblR0aa}

TraeCode CLI 2.0 支持 macOS、Linux 和 Windows。Windows 用户建议优先使用 WSL2；如使用 Windows 原生版本，首次启动时按界面提示完成沙箱初始化。

使用前请确认本机已有：

* 可用的终端环境。
* 可用的 TRAE CLI 2.0 安装方式和账号权限。

## 安装 {#hhR5Y7SsE}

下载地址：

* Mac/Linux
   ```Bash
   sh -c "$(curl -fsSL https://trae.cn/trae-cli/install_v2.sh)"
   ```
* Windows
   ```PowerShell
   irm https://trae.cn/trae-cli/install_v2.ps1 | iex
   ```   


安装后在终端运行：

```Bash
traecli 
```

### 启动 {#hGinzm2dD}

```Bash
# 在当前目录启动交互式 TUI
traecli

# 指定工作目录
traecli --cd /path/to/project

# 启动交互式 TUI，并带入首条任务
traecli "解释这个仓库的主要模块"
```

首次进入项目目录时，CLI 可能会询问是否信任该目录。信任后，项目级配置、规则和 Hooks 才会生效。

## 登录 {#hayWGQh5G}

首次打开 CLI 会在 TUI 内自动引导登录，登录界面支持账号登录和自定义域登录。

查看和退出登录：

```Bash
traecli login status
traecli logout
```

自动化场景可使用 PAT 登录：

```Bash
export TRAECLI_PERSONAL_ACCESS_TOKEN="<your-token>"
traecli login --with-trae-pat
```

如果你的组织使用自定义 API 域名：

```Bash
export TRAECLI_HOST="https://api.example.com"
export TRAECLI_PERSONAL_ACCESS_TOKEN="<your-token>"
traecli login --with-trae-pat
```