接入 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:$PATHWindows PowerShell
powershell
irm https://trae.cn/trae-cli/install.ps1 | iex安装完成后验证:
bash
trae-cli --version2. 创建配置文件
在终端中运行以下命令,在用户目录下创建配置文件:
bash
mkdir -p ~/.local/share/trae-cli
touch ~/.local/share/trae-cli/trae_config.yaml3. 编辑 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 URL | https://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部分添加。
相关文档
- 管理 API Key - 创建和配置 API Key
- 模型列表与定价 - 浏览可用模型和定价信息
- API 参考 - 查看完整的 API 接口文档