Skip to content

接入 Trae CLI

功能概述

Trae CLI 是字节跳动推出的终端 AI 编程 Agent(GitHub),支持在命令行中进行代码编写、文件编辑和 Bash 操作。通过 trae_config.yaml 配置文件,可将无量AI开放平台作为模型后端,使用平台上的多种大模型。

前提条件

  • macOS 或 Linux 系统
  • 已在无量AI开放平台创建 API Key(前往创建

配置步骤

1. 安装 Trae CLI

macOS / Linux

bash
sh -c "$(curl -L https://trae.cn/trae-cli/install.sh)" && export PATH=~/.local/bin:$PATH

Windows PowerShell

powershell
irm https://trae.cn/trae-cli/install.ps1 | iex

安装完成后验证:

bash
trae-cli --version

2. 创建配置文件

在终端中运行以下命令,在用户目录下创建配置文件:

bash
mkdir -p ~/.local/share/trae-cli
touch ~/.local/share/trae-cli/trae_config.yaml

3. 编辑 trae_config.yaml

打开 ~/.local/share/trae-cli/trae_config.yaml,写入以下内容。将 your-api-key 替换为您的无量AI开放平台 API Key:

yaml
model_providers:
  wuliang:
    api_key: your-api-key
    provider: openai
    base_url: https://open.dieyuyun.com/v1

models:
  trae_agent_model:
    model_provider: wuliang
    model: gpt-5.5
    max_tokens: 4096
    temperature: 0.5
    top_p: 1
    top_k: 0
    max_retries: 10
    parallel_tool_calls: true

agents:
  trae_agent:
    model: trae_agent_model
    max_steps: 200
    tools:
      - bash
      - str_replace_based_edit_tool
      - sequentialthinking
      - task_done
配置项说明
model_providers.wuliang.api_key您的无量AI开放平台 API Key
model_providers.wuliang.provider固定为 openai(OpenAI 兼容协议)
model_providers.wuliang.base_url无量AI开放平台的 API 地址
models.trae_agent_model.model模型代码,如 gpt-5.5,可在 模型列表与定价 页面查看
models.trae_agent_model.model_provider对应上方 model_providers 中的名称
agents.trae_agent.model引用 models 中定义的模型名称

WARNING

YAML 文件中不允许使用 Tab 缩进,请确保全部使用空格。

4. 启动 Trae CLI

bash
# 执行单次任务
trae-cli run "创建一个 hello world Python 脚本"

# 进入交互模式
trae-cli interactive

# 查看当前配置
trae-cli show-config

平台接口说明

无量AI开放平台的 OpenAI 协议接入信息如下:

配置项
Base URLhttps://open.dieyuyun.com/v1
认证请求头Authorization: Bearer your-api-key
数据格式JSON

完整请求示例:

bash
curl --request POST 'https://open.dieyuyun.com/v1/chat/completions' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手"},
      {"role": "user", "content": "你好,请介绍一下你自己"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

注意事项

  • 模型代码model 字段需与平台提供的模型代码完全一致,可在 模型列表与定价 页面查看所有可用模型。
  • 配置文件路径:配置文件默认位于 ~/.local/share/trae-cli/trae_config.yaml,可通过 trae-cli show-config 查看当前生效的配置。
  • MCP 工具:Trae CLI 支持 MCP(Model Context Protocol)工具扩展,可在配置文件的 mcp_servers 部分添加。

相关文档