使用指南
返回主页

外观

Trae 配置 ​

Trae 是一款 AI 编程编辑器。这里通过 OpenAI Chat Completions（兼容 OpenAI 聊天请求格式）连接 custom，并在 Trae 的“自定义”模型中完成验证。

配置时会看到几个新名词：Base URL 是 Trae 访问 custom 的接口地址，API Key 是验证调用权限的密钥，Model ID 是要使用的模型名称；连通性测试 是 Trae 自动发送一次请求，检查这三项能否正常工作。请直接复制页面提供的值，不要照着截图输入。

接入协议OpenAI Compatible / Chat Completions
打开安装说明

配置步骤

  1. 1

    打开 Trae，点击窗口右上角、头像左侧的设置齿轮。

  2. 2

    在设置左侧菜单点击“模型”。

  3. 3

    把模型列表滚动到底部，在“自定义”区域点击“在这里添加自定义模型”。

  4. 4

    在“添加模型”弹窗顶部点击“自定义模型”。

  5. 5

    API 格式选择“OpenAI Chat Completions 格式”；自定义请求地址、模型 ID 和 API 密钥按下方复制区填写，保持“完整 URL”关闭，模型展示名称可以留空，然后点击“添加模型”。

  6. 6

    按钮显示“连通性测试中”后耐心等待，不要重复点击或关闭窗口。

  7. 7

    测试通过后返回模型列表，确认新模型已出现在“自定义”分组，并且右侧开关为绿色开启状态；点击 Agent 输入框底部的“Auto”打开模型菜单，再关闭顶部的 Auto Mode 开关。

  8. 8

    在模型菜单中向下找到“自定义模型”，点击刚添加的 custom 模型；看到该行出现绿色对勾，并且输入框底部显示该模型名称，表示选择成功。

  9. 9

    在 Agent 输入框中输入“你好”并点击右下角发送按钮，确认对话区出现回复。

复制配置

Trae → 设置 → 模型 → 自定义模型

API 格式: OpenAI Chat Completions 格式
自定义请求地址（Base URL）: 
完整 URL: 关闭
模型 ID: gpt-5.6-sol
模型展示名称: 可留空
API 密钥: sk-your-api-key

填写后点击“添加模型”，等待连通性测试完成；模型自动启用后关闭 Auto Mode，再选择该自定义模型。

看图操作

Trae 配置流程图

按照 9 张真实界面截图完成配置：打开模型设置、添加自定义模型、填写动态配置，等待连通性测试后关闭 Auto Mode、选择模型并发送消息验证。

截图中的供应商名称是示例，仅用于定位操作入口。实际供应商名称或 ID 统一填写 custom；地址、密钥和模型请使用本页复制区的值。

界面可能随版本变化
  1. 第 1 步

    从 Trae 主界面打开设置

    1. 1

      点击窗口右上角、头像左侧的设置齿轮。

    打开 Trae 后，找到窗口右上角头像左侧的齿轮按钮，点击它进入设置。

    自行采集Trae 当前 macOS 中文界面
  2. 第 2 步

    打开模型设置

    1. 1

      点击左侧菜单中的“模型”。

    设置页面左侧菜单展开后，找到位于 CUE 下方、对话流上方的“模型”，点击进入模型管理。

    自行采集Trae 当前 macOS 中文界面
  3. 第 3 步

    从自定义分组添加模型

    1. 1

      点击“在这里添加自定义模型”链接。

    把模型列表滚动到底部，在“自定义”分组中点击带下划线的“在这里添加自定义模型”。

    自行采集Trae 当前 macOS 中文界面
  4. 第 4 步

    选择自定义模型类型

    1. 1

      点击第一行“自定义模型”。

    “添加模型”弹窗会列出多个供应商。点击最上方第一行的“自定义模型”，不要选择下面的预设供应商。

    自行采集Trae 当前 macOS 中文界面
  5. 第 5 步

    填写自定义模型配置

    1. 1

      API 格式选择“OpenAI Chat Completions 格式”。

    2. 2

      自定义请求地址粘贴页面复制区的 Base URL，并保持“完整 URL”关闭。

    3. 3

      模型 ID 粘贴页面复制区显示的模型名称。

    4. 4

      API 密钥粘贴自己的完整 API Key。

    5. 5

      检查各项无误后点击“添加模型”。

    API 格式选择“OpenAI Chat Completions 格式”；自定义请求地址、模型 ID 和 API 密钥分别粘贴页面复制区提供的值。保持“完整 URL”关闭，模型展示名称可以留空，最后点击“添加模型”。截图中的地址已遮盖，模型名只用于说明位置。

    自行采集Trae 当前 macOS 中文界面
  6. 第 6 步

    等待连通性测试

    1. 1

      看到“连通性测试中”后等待测试完成。

    点击“添加模型”后，按钮会变为“连通性测试中”。Trae 正在发送一次真实请求检查配置，请耐心等待，不要重复点击或关闭窗口。

    自行采集Trae 当前 macOS 中文界面
  7. 第 7 步

    确认模型启用并关闭 Auto Mode

    1. 1

      先确认自定义模型右侧开关为绿色开启状态。

    2. 2

      打开模型菜单后，点击绿色的 Auto Mode 开关将它关闭。

    测试通过后会自动返回模型列表。确认“自定义”分组中的新模型右侧开关为绿色；再点击 Agent 输入框底部的“Auto”打开模型菜单，点击顶部绿色的 Auto Mode 开关将它关闭。

    自行采集Trae 当前 macOS 中文界面
  8. 第 8 步

    选择刚添加的自定义模型

    1. 1

      确认 Auto Mode 开关已经变为灰色关闭状态。

    2. 2

      在“自定义模型”分组点击页面复制区显示的模型。

    确认 Auto Mode 开关已经变为灰色关闭状态。在模型菜单下方找到“自定义模型”，点击页面复制区显示的模型；该行出现绿色对勾、输入框底部显示模型名称，表示已经选中。截图中的模型名只用于说明位置。

    自行采集Trae 当前 macOS 中文界面
  9. 第 9 步

    发送消息确认模型可用

    1. 1

      发送消息后看到模型正常回复，即表示配置成功。

    在 Agent 输入框中输入“你好”，确认底部显示刚选择的 custom 模型，然后点击右下角发送按钮。对话区出现正常回复，就表示配置成功。截图中的模型名只用于说明位置。

    自行采集Trae 当前 macOS 中文界面

看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。

验证配置

选择页面复制区显示的模型，发送“你好”；能够正常返回内容，并且输入框底部仍显示该模型名称，即配置成功。

配置示例中如果出现 sk-your-api-key 必须替换为自己的完整密钥；不要把含密钥的配置提交到 Git。

常见错误 ​

  • 返回 404：自定义请求地址（Base URL）应以 /v1 结尾，不要追加 /chat/completions，也不要重复成 /v1/v1；“完整 URL”开关应保持关闭。
  • 返回 401：API Key 无效或不完整。重新粘贴后台创建的完整密钥，并删除首尾空格。
  • 提示模型不存在：Model ID 必须与页面复制区当前显示的模型名称完全一致，包括大小写、连字符和版本后缀。
  • 连通性测试一直失败：确认 API 格式为“OpenAI Chat Completions 格式”，再检查 Base URL、API Key、Model ID 和网络连接。
  • 找不到自定义模型：回到“设置 → 模型”，滚动到“自定义”分组，确认模型右侧开关为绿色开启状态。
  • 选择后仍在使用其他模型：点击 Agent 输入框底部的当前模型，先关闭 Auto Mode，再从“自定义模型”分组重新选择页面复制区显示的模型。
  • 配置被覆盖或更新后消失：切换账号或升级 Trae 后重新检查“设置 → 模型”；如模型已不存在，请按本页复制区重新添加。
  • 网络无法连接：确认 Trae 所在电脑能够访问页面复制区显示的 API 地址；如果在远程开发环境或容器中运行，还要检查该环境的 DNS、防火墙、代理和容器网络。

更多通用错误处理见常见问题。