升级 TRAE CLI 1.0 至 2.0
复制页面
文档反馈
目前 TRAE CLI 1.0 已进入弱维护状态，请及时升级到 2.0。
安装 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
自动迁移配置
TRAE CLI 1.0 用户首次启动 TRAE CLI 2.0 时，如果检测到以下任一未迁移内容，会弹出迁移提示：
- 用户级主配置或兼容配置。
- 用户级资源目录中的可迁移资源（skills/agents/hooks/mcp/rules等）。
- 当前项目中的项目级资源目录。
- 可迁移的 TRAE CLI 1.0 session 历史。
提示会列出检测到的 legacy data，例如：
Legacy TraeCLI data or external agent config detected
Would you like to migrate detected data to the new Trae CLI storage?
Select what to import:
Home
[x] Migrate /Users/alex/.trae/traecli.yaml to /Users/alex/.trae/test/traecli.toml
[x] Migrate recent sessions from /Users/alex/.cache/coco/sessions to /Users/alex/…
[x] Migrate subagents from /Users/alex/.claude/agents to /Users/alex/.trae/agents
[x] Migrate recent sessions from /Users/alex/.claude/projects
Project: /workspace/project
[x] Migrate CLAUDE.md to AGENTS.md
Selected 5 of 5 item(s).
1. Proceed with selected
2. Skip for now
3. Don't ask again for the selected data
4. Don't ask again for any legacy TraeCLI data or external agent config for this user
Use ↑/↓ to move, space to toggle, 1/2/3/4 to choose, a/n for all/none
迁移是非破坏性的：
- 不删除原始文件。
- 用户级和项目级迁移都会写入对应的
traecli.toml。 - 不覆盖目标
traecli.toml中已经存在的配置项。 - 超过 50M 的单个 legacy session 默认会跳过，否则会造成 TUI 启动过程卡顿。如需迁移大 legacy session，使用以下手动迁移指令：
traecli migrate --force --no-legacy-session-size-limit
CLI 手动触发
如果错误过了自动迁移提示，可手动触发历史数据迁移
traecli migrate --force
traecli migrate --force --legacy-session-max-mib 1200
traecli migrate --force --no-legacy-session-size-limit
--force 会忽略已有迁移标记并重新执行迁移；迁移仍然是非破坏性的，不会覆盖目标 traecli.toml 中已经存在的配置键。
命令行参数兼容问题说明
| TRAE CLI 1.0 参数 | 替代方案 |
|---|---|
-p, --print |
对齐 --print，但短参 -p 被 --profile 占用，历史 -p 任务参数请改为 --print 或换 exec |
--output-format=json |
不支持，支持 JSONL，用 --output-format=stream-json替代，或者traecli exec --json |
--output-format=stream-json |
参数对齐；但事件流结构不同，映射到现有 traecli exec --json 的 JSONL 事件流能力 |
--query-timeout |
不支持，请直接使用外层 timeout 指令限制执行时间 |