快速开始

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

适用环境

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

使用前请确认本机已有：

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

安装

下载地址：

• Mac/Linux

  sh -c "$(curl -fsSL https://trae.cn/trae-cli/install_v2.sh)"
  

• Windows

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

安装后在终端运行：

traecli 

启动

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

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

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

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

登录

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

查看和退出登录：

traecli login status
traecli logout

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

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

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

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