命令行参数

本文介绍 TraeCode CLI 2.0 支持的命令行参数及用法。

基本用法

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

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

通用选项（交互式与 exec 共用）

选项	描述
`-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`），极度危险，仅用于已被外部隔离的环境。

全局开关

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

交互模式专属选项

选项	描述
`-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 — 非交互式

traecli exec [选项] [PROMPT]

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

选项	描述
`--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`	同交互模式的工具允许/禁止。

示例：

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

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

review — 代码评审

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

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

resume / fork — 恢复与复刻会话

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

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

login / logout — 登录管理

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

update — 更新

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

子命令总览

子命令	描述
`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。

文档对您有帮助吗?

resume / fork — 恢复与复刻会话

update — 更新

子命令总览