Trae Agent
面向通用软件工程任务的、基于大语言模型（LLM）的智能体，提供强大的 CLI 界面。
- Star 数
- ★ 12k
- 最近更新
- 8 个月前
- License
- MIT
- 主语言
- Python
- FA 评分
- 45/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 开发者快速修复代码库中的 bug，例如运行
trae-cli run "Fix the bug in main.py"。 - 不适合
- 不愿配置 API 密钥与 YAML 的用户：必须自备密钥并编辑配置文件
- 追求稳定版本的生产团队：项目仍在积极开发，稳定性可能变化
这个 Agent 能做什么，适合哪些场景？
Trae Agent 是一个基于 LLM 的智能体，用于处理通用软件工程任务。它通过命令行界面（CLI）理解自然语言指令并执行复杂工作流，支持多种 LLM 提供商（如 OpenAI、Anthropic、Doubao 等）和丰富的工具集（文件编辑、bash 执行等）。项目提供透明、模块化的架构，便于研究和扩展，并支持轨迹记录和 Docker 模式。详细技术细节可见技术报告。
Trae Agent 通过 CLI 接收用户自然语言任务，解析后调用配置的 LLM（如 Claude、GPT）进行决策，并使用内置工具（如 bash、文件编辑工具）执行操作。它支持交互模式、轨迹记录（JSON 格式）、多模型提供商切换、Docker 容器内运行任务，以及可选的 MCP 服务集成。工作流程包括：用户输入 → agent 规划 → 工具调用 → 输出结果或补丁。
- 开发者快速修复代码库中的 bug，例如运行
trae-cli run "Fix the bug in main.py"。 - 为现有项目自动生成单元测试或文档。
- 研究人员使用其模块化架构进行消融研究或开发新智能体能力。
- 在隔离的 Docker 环境中执行任务，避免影响本地环境。
- 需要记录完整执行轨迹以便调试和分析的复杂任务。
如何安装或部署这个 Agent？
克隆仓库并同步依赖：git clone https://github.com/bytedance/trae-agent.git && cd trae-agent && uv sync --all-extras && source .venv/bin/activate。需要 Python 3.12+、UV 以及所选 LLM 提供商的 API 密钥。
如何使用这个 Agent？
配置 YAML 文件（复制 trae_config.yaml.example 为 trae_config.yaml，填写 API 密钥等），然后运行 trae-cli run "你的任务" 执行任务。也可使用 --provider 和 --model 参数指定模型，或使用 interactive 模式进行交互。可用 trae-cli show-config 检查配置。
这个 Agent 有哪些优点和局限？
- 模块化、透明的架构便于研究和扩展。
- 支持多种 LLM 提供商（OpenAI、Anthropic、Gemini 等），降低供应商锁定。
- 提供详细的轨迹记录，便于调试和分析。
- 支持 Docker 模式，可在隔离环境中运行。
- 需要 Python 3.12+ 和 UV，对运行环境有要求。
- 配置相对复杂，需要手动设置 API 密钥和模型参数。
- 部分功能（如 Docker）依赖额外组件。
- 项目仍在积极开发中，可能不稳定。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Trae Agent 当前 | 45 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 12k | 8 个月前 | Python | OpenAI API · Claude API |
| Zeroshot 工程验证循环 | 63 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 2k | 今天 | Rust | Codex · Claude Code |
| 智坤代码 (ZhikunCode) | 56 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 525 | 1 天前 | Java | OpenAI API · Claude API |
| VibeKit — 编码 Agent 的安全层 | 42 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.9k | 11 个月前 | TypeScript | ChatGPT · Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：工具集包括bash执行，但未发现权限限制或用户确认机制；配置中API密钥以明文存储，但README提示git忽略配置文件；有轨迹记录功能，但未说明数据流向；依赖项固定版本较少，存在已知漏洞风险；外部效果包括Docker容器操作，但未提供回滚机制；来源归属有MIT许可证和版权声明。扣分原因：缺少最小权限原则、用户确认、数据流透明、敏感数据处理、依赖安全、外部效果控制、回滚机制。
证据显示：代码结构一致，测试覆盖基本功能；依赖项版本范围较宽，可能不稳定；错误消息在CLI测试中有明确提示。扣分原因：依赖可用性未充分验证，失败消息在部分场景下可能不清晰。
证据显示：面向研究者和开发者，提供多种LLM提供商支持；能力边界在README中有工具列表，但未明确限制；触发精度通过CLI命令和配置文件控制；环境适配包括Docker和多种操作系统。扣分原因：能力边界描述不详细，触发精度依赖用户配置。
证据显示：README结构清晰，安装说明详细；命名稳定，有版本号；提供示例和FAQ；已知限制在roadmap中提及；MIT许可证明确；版本变更记录缺失；维护责任由ByteDance承担。扣分原因：缺少版本变更日志，已知限制描述不充分。
证据显示：输出包括轨迹文件和补丁，可用性高；边际价值在于研究友好架构；成本效益未明确说明。扣分原因：成本效益分析缺失。
证据显示：README引用arXiv技术报告，可追溯；测试和CI提供部分验证；事实与推断未明确分离。扣分原因：跨来源验证不足，事实与推断分离不清晰。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- API密钥以明文存储，需确保配置文件不被泄露。
- bash工具可执行任意命令，需在受控环境中使用。
- 依赖版本范围较宽，可能存在安全漏洞，建议锁定版本。