> ## 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 支持的命令行参数及用法。

## 基本用法 {#habuWd8sV}

```Plain Text
traecli [选项] [PROMPT]              # 启动交互式 TUI（可直接带初始提示）
traecli [选项] <子命令> [参数]        # 运行某个子命令
```

* `traecli` — 启动交互式界面
* `traecli "帮我修复登录的 bug"` — 启动界面并发送一条初始提示
* `traecli exec "..."` — 非交互式（脚本 / CI）运行
* 大多数接受 `PROMPT` 的命令，当 `PROMPT` 省略或为 `-` 时会从标准输入读取

## 通用选项（交互式与 exec 共用） {#hal7bh5dv}

<!-- @cols-width: 368,546 -->
| | | \
|**选项** |**描述** |
|---|---|
|`-m, --model <MODEL>` |指定使用的模型。 |
|`-i, --image <FILE>` |给初始提示附加图片（可逗号分隔多个）。 |
|`-p, --profile <NAME>` |使用 `traecli.toml` 里的某个配置 profile。 |
|`-s, --sandbox <MODE>` |沙箱策略：`read-only` / `workspace-write` / `danger-full-access`。 |
|`--permission-mode <MODE>` |权限模式预设（`exec` 下仅支持 `plan`/`bypass_permissions`/`custom`）。 |
|`-C, --cd <DIR>` |把指定目录作为工作根目录。 |
|`--add-dir <DIR>` |额外的可写目录（可多次指定）。 |
|`-y, --dangerously-bypass-approvals-and-sandbox` |跳过所有确认且不沙箱（别名 `--yolo`），极度危险，仅用于已被外部隔离的环境。 |

## 全局开关 {#hcEHn2EXM}

<!-- @cols-width: 398,466 -->
| | | \
|**选项** |**描述** |
|---|---|
|`-c, --config <key=value>` |覆盖任意配置项，支持点号路径（如 `-c model="o3"`），可多次指定。 |
|`--enable <FEATURE>` / `--disable <FEATURE>` |开/关功能 flag，可多次。 |
|`-V, --version` |打印版本号。 |
|`-h, --help` |显示帮助。 |

## 交互模式专属选项 {#hQSWcY1ti}

<!-- @cols-width: 252,486 -->
| | | \
|**选项** |**描述** |
|---|---|
|`-a, --ask-for-approval <POLICY>` |审批策略：`untrusted` / `on-failure` / `on-request` / `never`。 |
|`--search` |启用实时联网搜索（开启原生 web_search 工具，无需逐次审批）。 |
|`--no-alt-screen` |内联模式运行 TUI，保留终端滚动历史（不切到备用屏）。 |
|`--allowed-tool <TOOL>` |本会话允许某工具（可多次指定）。 |
|`--disallowed-tool <TOOL>` |本会话禁止某工具（可多次指定）。 |
|`-w, --worktree[=NAME]` |在全新 git worktree 中隔离运行。 |
|`--resume[=SESSION_ID]` |恢复本地会话；不带 ID 则自动恢复最近一次。 |
|`--remote <ADDR>` |连接远端 app server，如 `ws://host:port`。 |

## exec — 非交互式 {#hju3jNlEP}

```Plain Text
traecli exec [选项] [PROMPT]
```

除通用选项外，exec 还支持：

<!-- @cols-width: 328,328 -->
| | | \
|**选项** |**描述** |
|---|---|
|`--json` |把事件以 JSONL 流式打印到 stdout。 |
|`-o, --output-last-message <FILE>` |把智能体最后一条消息写入文件。 |
|`--output-schema <FILE>` |用 JSON Schema 约束最终响应的结构。 |
|`--color <always|never|auto>` |输出着色。 |
|`--skip-git-repo-check` |允许在非 git 仓库中运行。 |
|`--ephemeral` |不把会话文件写入磁盘。 |
|`--ignore-user-config` |不加载用户的 traecli.toml。 |
|`--allowed-tool` / `--disallowed-tool` |同交互模式的工具允许/禁止。 |

示例：

```Bash
# 在 CI 里跑一次性任务，结果以 JSONL 输出
traecli exec --json --sandbox workspace-write "运行测试并修复失败用例"

# 从管道读取提示，并把最终答复写到文件
echo "总结这个仓库的架构" | traecli exec -o out.md
```

## review — 代码评审 {#hBlPDPSMl}

```Bash
traecli review --uncommitted
traecli review --base main
traecli review --commit <commit-sha>
```

<!-- @cols-width: 240,328 -->
| | | \
|**选项** |**描述** |
|---|---|
|`--uncommitted` |评审已暂存 + 未暂存 + 未跟踪的改动。 |
|`--base <BRANCH>` |与某基线分支对比评审。 |
|`--commit <SHA>` |评审某次提交引入的改动。 |
|`[PROMPT]` |自定义评审指令（`-` 从 stdin 读取）。 |

## resume / fork — 恢复与复刻会话 {#hZll9cWDV}

```Bash
traecli resume [SESSION_ID] [--last] [--all]
traecli fork   [SESSION_ID] [--last] [--all]
```

* 不带 SESSION_ID 时默认弹出会话选择器；`--last` 直接恢复最近一次。
* `--all` 显示所有会话（关闭按当前目录过滤）。

## login / logout — 登录管理 {#hD09klQt1}

```Bash
traecli login            # 默认登录
traecli login --with-trae-pat  # PAT 登录
traecli login status     # 查看登录状态
traecli logout           # 退出登录
```

## update — 更新 {#hqDAtnbgj}

```Bash
traecli update                  # 安装最新版本
traecli update --version X.Y.Z  # 安装指定版本
traecli update check            # 仅检查是否有新版本
```

## 子命令总览 {#hxIbyZt8L}

<!-- @cols-width: 160,531 -->
| | | \
|**子命令** |**描述** |
|---|---|
|`exec` |非交互式运行。 |
|`review` |非交互式代码评审。 |
|`resume` |恢复历史会话。 |
|`fork` |复刻历史会话。 |
|`login` / `logout` |登录管理。 |
|`update` |检查并安装更新。 |
|`mcp` |管理 MCP 服务器。 |
|`mcp-server` |以 MCP server（stdio）方式启动 CLI，供外部工具调用。 |
|`plugin` |管理插件。 |
|`acp` |以 ACP（Agent Client Protocol）server 运行，供外部客户端接入。 |
|`app-server` |运行 app server（远程连接）。 |
|`apply` |把最近生成的 diff 以 git apply 应用到工作区。 |
|`sandbox` |在沙箱里运行命令。 |
|`completion <shell>` |生成 shell 补全脚本。 |
|`doctor` |收集诊断信息。 |
|`features` |查看或开关功能 flag。 |