Trae Agent

Trae Agent 是一个基于 LLM 的智能体，旨在完成通用软件工程任务。它提供了一个强大的 CLI 界面，能够理解自然语言指令，并利用各种工具和 LLM 提供商执行复杂的软件工程工作流。

有关技术细节，请参阅我们的技术报告。

项目状态： 该项目目前正处于活跃开发阶段。如果您有意帮助我们改进 Trae Agent，请参阅 docs/roadmap.md 和 CONTRIBUTING。

与其他 CLI Agent 的区别： Trae Agent 提供了透明的模块化架构，研究人员和开发人员可以轻松地对其进行修改、扩展和分析，使其成为研究 AI Agent 架构、进行消融实验以及开发新型 Agent 能力的理想平台。这种对研究友好（research-friendly）的设计使学术界和开源社区能够为基础 Agent 框架做出贡献并在此基础上进行构建，从而促进 AI Agent 这一快速发展领域的创新。

✨ 特性

🌊 Lakeview：为 Agent 的执行步骤提供简明扼要的摘要
🤖 支持多种 LLM：可与 OpenAI、Anthropic、豆包 (Doubao)、Azure、OpenRouter、Ollama 和 Google Gemini 的 API 协作
🛠️ 丰富的工具生态：支持文件编辑、Bash 执行、顺序思维（sequential thinking）等功能
🎯 交互模式：支持迭代式开发的对话界面
📊 轨迹记录：详细记录所有 Agent 的操作，便于调试和分析
⚙️ 灵活的配置：基于 YAML 的配置文件，并支持环境变量
🚀 易于安装：简单的 pip 安装方式

🚀 安装

系统要求

UV (https://docs.astral.sh/uv/)
您所选服务提供商（OpenAI、Anthropic、Google Gemini、OpenRouter 等）的 API Key

设置

git clone https://github.com/bytedance/trae-agent.git
cd trae-agent
uv sync --all-extras
source .venv/bin/activate

⚙️ 配置

YAML 配置（推荐）

复制示例配置文件：

cp trae_config.yaml.example trae_config.yaml

编辑 trae_config.yaml，填入您的 API 凭据和偏好设置：

agents:
  trae_agent:
    enable_lakeview: true
    model: trae_agent_model  # Trae Agent 的模型配置名称
    max_steps: 200  # Agent 执行的最大步数
    tools:  # Trae Agent 使用的工具
      - bash
      - str_replace_based_edit_tool
      - sequentialthinking
      - task_done

model_providers:  # 模型提供商配置
  anthropic:
    api_key: your_anthropic_api_key
    provider: anthropic
  openai:
    api_key: your_openai_api_key
    provider: openai

models:
  trae_agent_model:
    model_provider: anthropic
    model: claude-sonnet-4-20250514
    max_tokens: 4096
    temperature: 0.5

注意： trae_config.yaml 文件已被 Git 忽略，以保护您的 API Key 安全。

使用 Base URL

在某些情况下，我们需要为 API 使用自定义 URL。只需在 provider 字段后添加 base_url 字段，以下配置为例：

openai:
    api_key: your_openrouter_api_key
    provider: openai
    base_url: https://openrouter.ai/api/v1

注意： 字段格式仅限使用空格，禁止使用制表符（\t）。

环境变量（备选方案）

您也可以通过环境变量配置 API Key，并将其存储在 .env 文件中：

export OPENAI_API_KEY="your-openai-api-key"
export OPENAI_BASE_URL="your-openai-base-url"
export ANTHROPIC_API_KEY="your-anthropic-api-key"
export ANTHROPIC_BASE_URL="your-anthropic-base-url"
export GOOGLE_API_KEY="your-google-api-key"
export GOOGLE_BASE_URL="your-google-base-url"
export OPENROUTER_API_KEY="your-openrouter-api-key"
export OPENROUTER_BASE_URL="https://openrouter.ai/api/v1"
export DOUBAO_API_KEY="your-doubao-api-key"
export DOUBAO_BASE_URL="https://ark.cn-beijing.volces.com/api/v3/"

MCP 服务（可选）

如需启用 MCP (Model Context Protocol) 服务，请在配置文件中添加 mcp_servers 部分：

mcp_servers:
  playwright:
    command: npx
    args: