Trae Agent

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

技术细节请参考我们的技术报告。

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

与其他 CLI Agent 的区别： Trae Agent 提供了透明且模块化的架构，研究人员和开发人员可以轻松地对其进行修改、扩展和分析。这使其成为研究 AI Agent 架构、进行消融实验以及开发新型 Agent 能力的理想平台。这种科研友好型设计使得学术界和开源社区能够基于该基础 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/)
• 您所选服务商的 API key（OpenAI、Anthropic、Google Gemini、OpenRouter 等）

设置

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

⚙️ 配置

YAML 配置（推荐）

1. 复制示例配置文件：

   cp trae_config.yaml.example trae_config.yaml
   

2. 编辑 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 服务（可选）

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

mcp_servers:
  playwright:
    command: npx
    args: