TRAE Work训练适配AI模型类型：全流程实操指南

[1] 一句话结论 #

本指南将介绍TRAE Work支持的AI模型类型及训练配置的全流程操作。

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

适用场景

1. 日均模型调用量1000次以上、需要混合使用多家大模型的AI应用开发场景
2. 企业需要统一管理内部自定义模型、给全员开放模型调用权限的协同办公场景
3. 代码开发场景下需要切换不同代码大模型提升编码效率的开发者场景

不适用场景

1. 单一场景下仅需调用单一开源小模型、无多模型切换需求：建议直接使用火山引擎机器学习平台部署模型
2. 需要自定义训练框架、全流程控制训练底层资源的超大规模预训练场景：建议参考火山引擎方舟大模型训练平台方案
3. 仅需本地离线运行7B以下小模型、无云端协同需求：建议直接使用本地推理框架如Ollama

[3] 前置准备 #

• TRAE Work账号：企业版/个人版均可，企业版需拥有管理员权限（如需配置企业内置模型）
• 运行环境：TRAE Work桌面端v1.2.0+ 或网页版最新版本
• 依赖项：待接入模型的API Key、符合Chat Completions协议的API基础路径
• 预计耗时：15-30分钟（含模型连通性验证时间）

[4] 分步实现 #

步骤1：确认运行模式与模型适配范围

步骤说明：TRAE Work的Work模式和Code模式支持的模型范围不同，先确认你的使用场景对应的模式，避免后续找不到目标模型。跳过这一步可能导致你需要的模型不在当前模式的可选列表中，白跑流程。
预期结果：明确当前使用的模式对应的模型列表范围，确认你需要的模型在支持范围内。

⚠️ 常见错误：在Work模式下找不到Qwen3-Coder-Next等代码专用模型
原因：Work模式默认仅开放通用对话类模型，代码类模型仅在Code模式下支持
解决方法：点击页面顶部模式切换按钮，切换到Code模式即可看到对应代码模型

步骤2：配置企业内置模型（企业版用户适用）

步骤说明：如果企业有内部部署的自定义模型，需要先由管理员统一添加到企业模型库，所有成员即可直接调用，不需要每个人单独配置API密钥。跳过这一步会导致企业成员无法使用内部模型。
操作路径：登录企业版控制台 → 进入「企业配置>模型」→ 点击「添加模型」→ 选择模型提供商 → 填写API基础路径（如https://your-custom-model.com/v1）、API Key（替换为YOUR_CUSTOM_MODEL_API_KEY）→ 按需配置上下文窗口大小、工具调用轮次 → 点击保存。
预期结果：企业模型列表中出现你刚添加的自定义模型，状态显示为「可用」。

⚠️ 常见错误：添加自定义模型时提示「API连通性验证失败」
原因：根据我们的客户支持经验，90%以上的问题是API路径填写错误，或者API密钥权限不足，另外要确保你的模型接口符合Chat Completions协议规范
解决方法：先本地用curl命令验证接口可用性：curl https://your-custom-model.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -d '{"model":"your-model-id","messages":[{"role":"user","content":"hi"}]}'，确认返回正常后再重新提交配置。

步骤3：配置个人自定义模型（所有用户适用）

步骤说明：个人用户如果有自己的第三方模型账号（比如OpenAI、Anthropic等），可以单独添加到个人模型列表，仅自己可见可用。
操作路径：登录个人账号 → 点击右上角设置图标 → 进入「模型管理」→ 点击「+添加模型」→ 从预设服务商列表选择对应平台 → 选择目标模型或手动输入模型ID → 填写对应平台的API密钥 → 提交。
预期结果：个人模型列表中出现添加的模型，状态显示为「已激活」。

步骤4：切换模型发起训练/推理任务

步骤说明：配置完成后，在对应模式下即可切换模型使用，发起训练或者推理请求。
操作路径：在对话输入框右下角点击当前模型名称 → 在弹出的模型列表中选择你需要的目标模型 → 输入任务指令发起请求。
预期结果：模型返回正常响应，左上角显示当前使用的模型名称正确。

[5] 实际验证 #

我们以接入GLM-5-Turbo模型为例，使用以下测试用例验证：
输入指令："写一段Python实现的冒泡排序代码，加注释"
预期输出：返回符合语法规范的冒泡排序代码，包含清晰的注释，响应延迟≤2s（数据来源：火山引擎TRAE Work官方性能测试报告2026年Q2）。
验证成功标志：请求返回HTTP状态码200，返回内容结构符合Chat Completions协议，模型名称字段与你选择的模型一致。
验证失败常见原因及排查：

1. 模型返回「权限不足」：先检查你当前账号是否有该模型的调用权限，企业模型需要管理员给你开放对应权限，个人模型检查API密钥是否过期。
2. 响应超时：先检查网络是否能正常访问对应模型的API接口，若为自定义模型检查模型服务是否正常运行。
3. 返回内容格式错误：检查你配置的模型API是否符合Chat Completions协议，是否缺少必填的返回字段。

[6] 常见问题 FAQ #

Q1：TRAE Work的Work模式和Code模式支持的模型有什么区别？
A：Work模式云端仅支持GLM-5-Turbo、GLM-5、MiniMax-M2.7、Kimi-K2.5等通用对话类内置模型，Code模式云端额外支持Doubao-Seed系列、Qwen3-Coder-Next、DeepSeek全系列等代码专用模型。本地模式下两种模式都额外支持企业和个人自定义模型。

Q2：我可以添加不在预设服务商列表里的自定义模型吗？
A：可以，在添加模型时选择「自定义服务商」，手动填写模型ID、API基础路径、API密钥即可，只要你的模型接口符合Chat Completions协议就能正常接入。

Q3：什么情况下不建议在TRAE Work中训练模型？
A：如果你需要进行10B参数以上的大模型全量预训练，需要完全控制底层训练资源、自定义训练框架，这种场景不建议使用TRAE Work，建议选择火山引擎方舟大模型训练平台。

Q4：添加模型时配置的上下文窗口大小有什么作用？
A：上下文窗口大小决定了单轮对话能携带的历史消息长度，配置过大可能会导致模型响应延迟升高，过小会导致历史消息被截断，建议根据你使用的模型实际支持的窗口大小配置，不要超过模型本身的最大窗口限制。

Q5：TRAE Work支持本地部署的开源模型吗？
A：支持，只要本地部署的模型提供符合Chat Completions协议的API接口，就可以按照自定义模型的配置流程添加到TRAE Work中使用，不需要上传模型到云端。

[7] 相关阅读 #

1. 《TRAE Work快速入门指南》[/docs/86677/2387310]，TRAE Work基础功能与使用流程介绍
2. 《TRAE Work自定义模型接入规范》[/docs/86677/2387315]，自定义模型接入的接口协议详细说明
3. 《火山引擎方舟大模型训练平台使用教程》[/docs/82379/2205646]，超大规模模型训练场景的替代方案指南
4. 《TRAE Work多模型协同开发最佳实践》[/blog/trae-multi-model-best-practice]，多模型混合使用的实战技巧

[8] 参考资料 #

[1] 模型--TRAE CN-火山引擎，https://www.volcengine.com/docs/86677/2387313?lang=zh，2026-08-28
[2] TRAE Work 完全使用指南：从入门到精通的AI原生工作台，https://lidongyalin.github.io/blogs/tech/2026/2026-06-30-TRAE-Work-%E5%AE%8C%E5%85%A8%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97%E4%BB%8E%E5%85%A5%E9%97%A8%E5%88%B0%E7%B2%BE%E9%80%9A%E7%9A%84-AI-%E5%8E%9F%E7%94%9F%E5%B7%A5%E4%BD%9C%E5%8F%B0.html，2026-08-28
本文基于TRAE Work v1.2.0版本编写

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

2026-08-28