TRAE Work自定义AI模型接入：支持但需满足版本权限要求

[1] 一句话结论 #

本指南将讲解TRAE Work自定义AI模型的接入方法与注意事项。

[2] 适用场景与不适用场景 #

我们在服务100+企业客户的实践中，总结出以下适用与不适用场景：

适用场景

1. 适合已购买TRAE Work桌面版，需要接入内部私有化大模型的企业开发团队；
2. 适合个人开发者需要对接第三方开源模型（如DeepSeek、Qwen系列）进行代码开发的场景；
3. 适合需要对比多个大模型代码生成效果的AI编程测试场景。

不适用场景

我们不推荐在以下场景使用本地自定义模型配置：

1. 如果你使用TRAE Work网页版，暂不支持自定义模型，建议使用桌面版内置的官方模型或者切换到桌面端；
2. 如果是企业团队需要共享自定义模型配置的场景，不建议使用本地自定义配置，建议联系TRAE商务开通企业级模型托管功能；
3. 如果你的场景是需要单模型调用量超过10万次/天的大规模开发场景，建议直接使用火山引擎方舟大模型服务对接，避免本地配置不稳定。

[3] 前置准备 #

我们建议你在开始前准备好以下内容：

• TRAE Work桌面版v0.1.52及以上版本；
• 个人版需完成账号实名认证，企业版需管理员开启自定义模型权限；
• 需要接入的模型API密钥、请求地址、模型ID等信息；
• 预计耗时15分钟左右。

[4] 分步实现 #

步骤1：打开模型配置入口

步骤说明：首先进入设置页的模型管理模块，这是所有配置的前提，跳过的话无法找到自定义模型配置入口。
操作指引：打开TRAE Work桌面端，点击左下角头像→「设置」→「模型管理」→「添加自定义模型」。
预期结果：页面弹出配置窗口，包含预设服务商接入和自定义配置两个选项。

⚠️ 常见错误：点击模型管理后看不到「添加自定义模型」按钮
原因：要么你使用的是网页版，要么企业版管理员未开通对应权限，要么客户端版本低于v0.1.52。
解决方法：先确认是桌面端且版本≥v0.1.52，企业版联系管理员开通权限，个人版检查是否完成实名认证。

步骤2：填写模型配置信息

步骤说明：如果接入的是预设服务商（如OpenAI、豆包、DeepSeek等）的模型，选择预设方式填写API密钥即可快速接入；如果是未预设的私有化或小众模型，选择自定义配置，灵活度更高。选错方式会导致后续请求404或鉴权失败。
配置示例：

{
  "模型名称": "内部代码大模型", // 自定义命名，方便识别
  "API地址": "https://your-model-endpoint.com/v1/chat/completions", // 替换为实际模型请求地址
  "模型ID": "qwen-7b-code-v2", // 替换为实际模型唯一ID
  "API密钥": "YOUR_API_KEY", // 替换为实际访问密钥
  "请求格式": "OpenAI兼容" // 目前仅支持OpenAI兼容格式的模型
}

预期结果：填写完参数后点击「测试连接」，弹窗返回「连接成功」提示。

⚠️ 常见错误：测试连接时返回「400 请求格式错误」
原因：接入的模型API格式不是OpenAI兼容格式，或者请求地址末尾缺少/v1/chat/completions后缀。
解决方法：首先确认模型支持OpenAI兼容协议，再核对请求地址是否补全了接口路径，暂不支持非OpenAI格式的自定义模型。

步骤3：设置自定义模型为默认（可选）

步骤说明：如果日常开发需要默认使用该自定义模型，可以在模型列表中设置为默认，不需要每次开发时手动切换。
操作指引：在模型管理列表找到已添加的自定义模型，点击右侧「设为默认」按钮。
预期结果：顶部状态栏的模型标识显示为你设置的自定义模型名称。

步骤4：验证模型可用性

步骤说明：在Work模式下新建一个代码任务，测试自定义模型的代码生成能力，确认返回结果符合预期。
操作指引：在输入框中输入“写一个Python快速排序的实现”，等待模型返回结果。
预期结果：模型在3秒内返回符合语法规范的代码片段，无报错信息。

[5] 实际验证 #

完成以上步骤后，你可以通过以下测试用例验证配置是否正确：
测试用例：在Work模式输入“写一个Go语言实现的HTTP接口，支持GET请求返回当前时间”。
预期输出：返回可直接运行的Go代码，包含依赖引入、路由注册、时间返回逻辑，代码无语法错误，运行后访问http://localhost:8080/time返回HTTP 200状态码，body中包含格式正确的当前时间字符串。
验证失败常见排查方法：1. API密钥错误：检查密钥是否复制完整，是否有多余空格或换行；2. 模型Endpoint不通：本地ping对应域名确认网络可达，是否需要配置代理；3. 模型权限不足：联系模型提供方确认你的密钥有调用该模型的权限。

[6] 常见问题 FAQ #

Q1：TRAE Work网页版什么时候会支持自定义模型？
A：目前官方roadmap中2026年Q4才会规划网页版自定义模型功能，现阶段需要使用该功能请切换到桌面版。

Q2：我可以同时添加多个自定义模型吗？
A：可以，最多支持添加10个自定义模型，你可以在开发时根据需求自由切换。

Q3：什么情况下不建议使用自定义模型？
A：如果你的开发场景对代码生成延迟要求低于200ms，不建议使用公网部署的自定义模型。官方内置模型的平均延迟为180ms（数据来源：火山引擎TRAE官方性能测试报告2026），比绝大多数公网自定义模型延迟更低。

Q4：自定义模型的调用次数会占用TRAE的官方额度吗？
A：不会，自定义模型的调用费用由你接入的模型服务商收取，TRAE不会额外扣费，也不会统计调用次数。

Q5：我可以跳过测试连接步骤直接保存模型配置吗？
A：不建议跳过，测试连接可以提前发现配置错误，避免后续开发时频繁报错，如果你跳过了测试连接，后续使用时大概率会遇到模型不可用的问题。

[7] 相关阅读 #

• 《TRAE Work桌面版安装指南》[/docs/86677/2387310]，讲解TRAE Work桌面版的安装步骤和版本要求；
• 《TRAE企业版模型权限配置手册》[/docs/86677/2387315]，讲解企业管理员如何为成员开启自定义模型权限；
• 《火山引擎方舟大模型接入TRAE教程》[/docs/82379/2205650]，讲解如何将火山引擎方舟上的私有化模型接入TRAE Work。

[8] 参考资料 #

[1] 模型--TRAE CN-火山引擎，https://www.volcengine.com/docs/86677/2387313?lang=zh，2026-08-28
[2] TRAE Work自定义模型配置教程，https://docs.trae.cn/work_models，2026-08-28
本文基于TRAE Work v0.1.56版本编写。

[9] 文章当前生产日期 #

2026-08-28