接入 Trae

Trae 是一款集成 AI 对话、代码补全和智能体功能的开发工具，支持添加自定义模型服务。通过 Trae 的“自定义配置”，可以使用 Better Gate 提供的 OpenAI Chat Completions 或 Anthropic Messages 兼容接口。

1 安装 Trae

前往 Trae 官网 下载并安装适合当前操作系统的版本。已安装 Trae 的用户建议先升级到最新版本，再进行后续配置。

2 准备 Better Gate 配置

1. 登录 Better Gate 控制台。
2. 确认账户有可用余额（组织成员需确认自己的成员额度够用）。
3. 打开“API Keys”，点击“创建 Key”。
4. 填写 Key 名称，路由方式保持默认的“智能路由”就行，它会自动挑可用渠道；只有需要固定渠道时才选“指定渠道分组”。组织管理员为成员创建 Key，记得勾选“分配给成员”。
5. 创建完成后点击“复制 Key”，保存完整的 API Key。
6. 打开“模型列表”，复制准备使用的模型 ID，并确认模型支持工具调用；需要识图时还要确认支持图片输入。

3 添加自定义模型

1. 打开 Trae，进入“设置 → 模型”。
2. 点击“添加模型”，在弹窗中选择“自定义配置”。
3. 根据需要使用的模型系列选择 API 格式和请求地址。

填写时请注意：

• 关闭“完整 URL”开关，表格中的地址是 Base URL，不是完整请求路径。
• 在“API 密钥”中粘贴 Better Gate API Key。
• 在“模型 ID”中填写 Better Gate 控制台“模型列表”里的真实模型 ID，大小写和标点必须完全一致。
• 其他配置可先保留默认值。

4. 点击底部的“添加模型”按钮保存。Trae 可能会发送请求校验 API Key；校验通过后，模型会出现在可用模型列表中。
5. 如需添加不同 API 格式的模型，请分别创建配置。例如 OpenAI 兼容模型和 Claude 模型不应共用同一项自定义配置。

4 开始使用

1. 返回 Trae 对话或智能体页面。
2. 在模型选择器中选择刚刚添加的模型。
3. 发送一条简短消息进行测试；需要使用编程智能体时，再测试读取文件或调用工具。
4. 前往 Better Gate 控制台的用量页面，确认是否出现对应的请求记录。

注意：Trae 可能会在智能体请求中附加客户端专用字段。部分第三方模型无法识别这些字段，可能出现参数不受支持、工具调用失败或其他兼容性错误。这类问题不一定由 API Key 或 Better Gate 网关导致；遇到问题时，可先使用普通对话测试，并尝试更换同一 API 格式下的其他模型。

如果模型无法添加或调用，请依次检查 API 格式是否与模型系列匹配、“完整 URL”是否已关闭、请求地址是否正确、目标模型是否可通过当前 Key 的路由模式调用。配置无误但仍未生效时，请完整退出并重新启动 Trae。