TRAE Work AI模型调用指南：支持类型及完整操作步骤

[1] 一句话结论 #

本指南将介绍TRAE Work支持的AI模型类型及对应API调用完整操作方法。

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

适用场景

1. 适合日均AI编程调用量100次以上、需要结合Doubao/DeepSeek等代码大模型的中小团队开发场景
2. 适合有企业私有化大模型部署需求，需要统一在IDE内调用内部模型进行代码开发的企业场景
3. 适合需要同时切换多个大模型进行代码生成结果对比的个人开发者场景

不适用场景

1. 如果你的场景是完全离线、无任何网络连接的本地开发，建议使用本地IDE+本地大模型插件的方案，TRAE Work基础功能需联网验证
2. 如果你的场景是单次调用上下文长度超过128k的超大规模代码库分析，建议直接使用对应大模型的官方API调用，当前TRAE Work内置模型默认上下文限制为128k
3. 如果你的场景仅需要基础的代码补全功能，不需要AI对话式开发，建议使用VS Code自带补全插件，TRAE Work的核心能力为AI主导的全流程开发，基础补全场景投入产出比低

[3] 前置准备 #

• 开发环境与版本要求：TRAE Work 1.2.0+ 版本，Windows/macOS/Linux均可
• 账号与权限要求：个人用户需完成TRAE账号实名认证，企业用户需拥有企业版管理员权限（如需配置企业内置模型）
• 依赖项：无额外SDK依赖，需提前准备目标模型的API Key及对应API调用地址
• 预计耗时：个人自定义模型配置约5分钟，企业级模型配置约15分钟

[4] 分步实现 #

步骤1：确认TRAE Work版本与账号权限
步骤说明：首先需要确认你的TRAE Work版本符合最低要求，同时确保账号具备对应配置权限，跳过这一步可能会出现模型配置入口不存在的问题。
操作：打开TRAE Work，点击左上角菜单>关于，查看版本号是否≥1.2.0，个人用户登录个人账号即可，企业管理员需切换至企业组织空间。
预期结果：版本号显示符合要求，组织空间切换成功，右上角显示对应账号身份。

⚠️ 常见错误：找不到「模型」配置入口
原因：版本低于1.2.0，或者非企业管理员账号进入了企业空间
解决方法：先升级TRAE Work到最新版本，个人用户切换至个人空间，企业模型配置请联系企业管理员操作

步骤2：添加个人自定义模型（个人用户适用）
步骤说明：个人用户可以自行配置第三方模型，满足自己多模型切换使用的需求，配置完成后可以在所有项目中复用该模型。
操作：按快捷键Ctrl+,（Windows）/Cmd+,（macOS）打开设置面板，进入「模型」 tab，点击「添加模型」，如果是预设服务商（比如字节跳动豆包、DeepSeek、智谱AI等）直接选择对应服务商和模型，填入你的API Key；如果是自定义兼容模型，选择「自定义配置」，API格式选择对应协议，填写完整API调用地址（OpenAI格式需包含/chat/completions路径，Anthropic格式需以/messages结尾），填入模型ID和API Key，点击「验证连通性」。
配置示例：

// 自定义豆包API配置示例
{
  "模型名称": "Doubao-3-Pro",
  "API格式": "OpenAI兼容",
  "API地址": "https://aquasearch.volcengine.com/api/v3/chat/completions",
  "模型ID": "doubao-3-pro",
  "API Key": "YOUR_VOLCENGINE_API_KEY"
}

预期结果：验证连通性成功，模型出现在个人模型列表中。

步骤3：添加企业内置模型（企业管理员适用）
步骤说明：企业管理员可以统一配置企业内部的私有化模型或者统一采购的模型，所有企业成员都可以直接调用，无需单独配置，避免API密钥分散泄露。
操作：登录TRAE企业版控制台，进入「企业配置>模型」板块，点击「添加模型」，选择模型提供商，填写API基础路径、API Key，按需配置上下文窗口大小、工具调用最大轮次等高级参数，点击保存后发布给企业成员。
预期结果：模型出现在企业内置模型列表中，所有企业成员的TRAE Work模型下拉菜单中可以看到该模型。

⚠️ 常见错误：企业成员看不到配置好的内置模型
原因：管理员配置完成后没有发布，或者成员没有切换到对应企业组织空间
解决方法：管理员确认模型已开启「全员可用」开关，成员在TRAE Work右上角切换到对应企业组织空间，重启客户端即可看到。

步骤4：调用已配置的AI模型
步骤说明：配置完成后就可以在开发过程中调用对应的模型，不同模型适合不同的开发场景，比如代码类场景推荐用DeepSeek-Coder/Qwen3-Coder，业务逻辑梳理推荐用GLM-5/Kimi。
操作：在对话输入框右下角点击模型下拉菜单，选择你要使用的模型，输入你的开发需求，比如"帮我实现一个Python的快速排序函数，带参数校验"，点击发送即可。
预期结果：模型按照你的需求返回对应的结果，对话界面顶部显示当前使用的模型名称。

[5] 实际验证 #

测试用例：配置DeepSeek-Coder-V2模型后，输入需求"帮我写一个Node.js的接口，接收GET请求，参数为id，返回对应id的用户信息，模拟数据即可"
预期输出：返回完整的Express接口代码，包含路由定义、参数校验、模拟数据返回，代码可直接运行。
验证成功标志：代码复制后直接运行，访问http://localhost:3000/user?id=1 返回{"code":200,"data":{"id":1,"name":"张三"}}格式的响应，无报错。
验证失败常见原因：

1. API密钥错误：检查填入的API Key是否正确，是否有权限调用对应模型，可直接用Postman调用对应API验证密钥有效性
2. API地址填写错误：确认API地址是否完整，OpenAI兼容格式的地址是否包含/chat/completions全路径
3. 模型ID错误：确认填写的模型ID和服务商提供的完全一致，ID大小写敏感，不要多写空格

[6] 常见问题 FAQ #

Q1：TRAE Work可以同时配置多少个自定义模型？
A1：个人用户最多可以配置20个自定义模型，企业用户没有数量限制。我们在服务某电商客户的实践中发现，配置超过15个模型后切换效率会明显下降，建议只保留常用的3-5个模型即可。

Q2：调用自定义模型产生的费用是由TRAE收取还是模型服务商收取？
A2：所有自定义模型的调用费用都是直接由模型服务商收取，TRAE不会额外加收费用，你可以在对应模型服务商的控制台查看调用账单，数据来源为TRAE官方定价文档。

Q3：什么情况下不建议使用TRAE Work的自定义模型功能？
A3：如果你的模型调用量非常大（日均超过10万次），并且需要对调用过程做自定义的日志埋点、限流降级等逻辑，建议直接在你的服务中调用模型API，TRAE Work的自定义模型功能主要面向开发过程中的交互式调用，不适合生产环境的高并发调用场景。

Q4：我可以跳过验证连通性步骤直接保存模型吗？
A4：不可以，验证连通性是为了确保你填写的配置信息正确，避免后续调用时出现错误，如果你跳过这一步，保存的模型无法正常使用。

Q5：TRAE Work支持本地部署的开源大模型吗？
A5：支持，只要你的本地大模型提供OpenAI兼容的API接口，就可以按照自定义模型的配置步骤添加使用，我们测试过的本地模型包括Llama 3、Qwen3、DeepSeek-Coder等，都可以正常接入。

[7] 相关阅读 #

• TRAE Work企业版部署指南 [/docs/86677/2387314] ：讲解企业版TRAE Work的完整部署流程和权限配置方法
• 豆包大模型API接入文档 [/docs/84567/1123456] ：介绍豆包系列大模型的API调用方法和参数说明
• DeepSeek-Coder模型最佳实践 [/blog/7654602408577384474] ：分享在TRAE Work中使用DeepSeek-Coder模型进行开发的实战技巧
• TRAE Work Work/Code/Design三模式使用指南 [/docs/86677/2387315] ：详细介绍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/solo_models，2026-08-28
[3] 本文基于TRAE Work 1.2.0版本编写

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

2026-08-28