Trae 现在已经支持通过 添加模型 的方式接入部分自定义模型服务商。要想配置成功,关键是先分清楚:
- Trae 当前原生支持什么
- 你的模型服务商走什么协议
- 是否能直接在 Trae 里填写
这篇按目前公开可验证的方式来写,尽量避免写成“理论能行”。
一、先说结论
如果你要在 Trae 里配置自定义 AI 模型,当前最现实的路径通常是:
1. 使用 Trae 已支持的服务商入口
目前公开资料里,Trae 已支持通过模型管理页面添加模型,并选择服务商,例如:
- OpenAI兼容接口
- 某些已接入的模型服务商
- 以及某些支持“自定义模型配置”的入口
2. 填入可用的 API Key 和模型名
如果 Trae 当前版本允许你在该服务商下自定义模型名,那么通常可以直接接入。
---
二、进入配置入口
常见入口通常是:
- 打开 Trae
- 点击头像或设置相关入口
- 进入 AI 功能管理 / 模型
- 点击 添加模型
在这里你一般能看到:
- 选择服务商
- 输入 API Key
- 选择或填写模型
---
三、最常用的方式:通过 OpenAI兼容接口 服务商接入
如果你的上游本身就是 兼容接口提供方,或者是 OpenAI兼容接口 兼容能力较好的平台,最常见的做法就是:
- 服务商选择 OpenAI兼容接口
- 填写你的 API Key
- 在模型位置选择官方模型,或者填写支持的自定义模型名
- 保存并验证
适合的场景
- 你直接用 OpenAI兼容接口
- 你用的平台被 Trae 当前版本识别为可兼容的 OpenAI兼容接口 入口
---
四、真实可用的配置思路
方案 A:兼容接口提供方模型
这是最稳的。
例如:
- 服务商:OpenAI兼容接口兼容接口
- API Key:你的 OpenAI兼容接口 Key
- 模型:
qwen-plus/qwen-max/ 你账号可用模型
这种通常保存后直接能用。
---
方案 B:模型服务商官方入口模型
如果你使用的是 自定义模型服务商,也可以按 Trae 支持的入口接。
例如:
- 服务商:自定义模型服务商
- API Key:你的 自定义模型服务商 Key
- 模型:对应 自定义模型服务商 模型
---
方案 C:服务商入口下的“自定义模型配置”
有些版本的 Trae 在添加模型时,支持:
- 选择服务商
- 再填写自定义模型名
这种情况下,你要注意两件事:
- 模型名必须是上游真实可调用的名字
- 该服务商入口必须真的兼容你的上游调用方式
如果只是名字能填,但底层并不兼容,保存后仍然会失败。
---
五、目前要特别注意的限制
这个很关键。
Trae 目前不一定提供“任意 Base URL 全局自定义”能力
也就是说,很多人想要这种:
- 自己填任意 OpenAI兼容接口 兼容 Base URL
- 自己填 Key
- 自己填模型
- Trae 原生直接走第三方中转
但从目前公开信息看,这类能力并不一定是完整开放、稳定可用的标准入口。
所以如果你打算接的是:
- 某个小众 OpenAI兼容接口 兼容平台
- 自建中转
- 任意第三方 Base URL
你要先确认当前 Trae 版本是否真的支持该入口,而不是只支持“兼容接口提供方 / 模型服务商官方入口 / 平台内可识别模型”。
---
六、配置成功后怎么验证
建议按这个顺序测:
1. 保存时看是否通过校验
Trae 添加模型时通常会校验:
- Key 是否有效
- 模型是否可识别
- 服务商返回是否正常
2. 切换到该模型做最小测试
例如:
请只回复:配置成功
3. 再做一条简短开发问题测试
例如:
请用三句话解释接口幂等
如果这两步都正常,基本就说明可用了。
---
七、常见失败原因
1. API Key 无效
这是最常见的。
2. 模型名写错
很多平台显示名称和实际接口模型 ID 不一样。
3. 你接的是“理论兼容”,但 Trae 当前版本并不原生支持
这也是很常见的误判。
也就是说:
- 平台本身兼容 OpenAI兼容接口
- 不代表 Trae 当前就支持你自定义这条 Base URL
---
八、最稳的建议
如果你要的是“真实可用、少踩坑”,建议优先级这样排:
最稳
- 兼容接口提供方
- 平台内明确支持的模型服务商
- Trae 当前模型管理页面里明确支持的模型
次稳
- Trae 服务商入口下允许填写的自定义模型名
最不稳
- 指望 Trae 直接无差别支持任意第三方 OpenAI兼容接口 兼容 Base URL
这个能力如果你本地版本没有明确入口,就不要默认它一定可用。
---
九、一句话总结
Trae 配置自定义 AI 模型,最稳的做法不是“硬接任何兼容接口”,而是:
- 先用 Trae 已明确支持的服务商入口
- 再填可验证的 Key 和模型名
- 最后用最小测试确认是否真的生效
这样成功率最高,也最接近真正可用。