Trae-cli 命令行工具安装配置与使用指南

配置步骤

复制模板文件并重命名

cp trae_config.json.example trae_config.json

编辑配置文件，更换 API 密钥

{
 "api_keys": {
  "anthropic": "your_anthropic_api_key",
  "openai": "your_openai_api_key",
  "doubao": "your_doubao_api_key"
 },
 "default_provider": "anthropic",
 "default_model": "claude-sonnet-4-20250514"
}

支持的模型目录

4. 核心功能与基础使用

Trae-cli 的所有命令通过 trae-cli 执行，核心功能如下：

执行简单任务

# 直接输入自然语言指令，让 Agent 完成任务
trae-cli run "创建一个输出'Hello World'的 Python 脚本"
# 验证当前配置是否正确（API 密钥、模型参数等）
trae-cli show-config
# 进入对话式交互，支持多轮对话
trae-cli interactive

指定 LLM 提供商和模型（临时覆盖配置）

# 使用 Anthropic 的 Claude 模型
trae-cli run "优化这个排序算法" --provider anthropic --model claude-sonnet-4-20250514
# 使用本地 Ollama 模型（无需联网）
trae-cli run "注释这段 Python 代码" --provider ollama --model qwen3:7b

强制生成代码补丁

# 用于 patch 生成，确保任务结束时输出 Git 补丁
trae-cli run "更新用户认证 API 端点" --must-patch

高级用法技巧

# 方式 1：直接输入 prompt 命令
trae-cli run "编写一个 hello world 脚本，使用 Python 3.12 特性"
# 方式 2：读取文件中的文本命令（适合复杂任务描述）
trae-cli run --file task_description.txt
# 错误用法（会导致冲突）
# trae-cli run "任务描述" --file task.txt 

自定义模型配置（覆盖配置文件）

# 自定义 model、api-key、model-base-url
trae-cli run "编写一个 hello world 脚本" \
--model doubao-seed-code-preview-251028 \
--model-base-url https://ark.cn-beijing.volces.com/api/v3 \
--api-key "your_doubao_api_key"

Docker 模式与补丁输出

# 执行需要 Docker 环境的任务
trae-cli run "将当前项目打包为 Docker 镜像并导出为 tar 文件" \
--docker-keep true # 任务完成后保留 Docker 容器
# 强制生成 Git 补丁（用于代码审查和版本控制）
trae-cli run "修复用户登录功能的 bug" --must-patch

控制台与 Agent 类型配置

# 使用 rich 控制台（更美观的输出格式）
trae-cli run "分析这个 Python 项目的依赖关系" --console-type rich
# 指定 Agent 类型（当前仅支持 trae_agent）
trae-cli run "生成单元测试" --agent-type trae_agent

运行 trae-cli 后模型输出结果会在当前目录文件下，trace 轨迹文件也就是模型思考记录会在 trajectories 文件中