TraeWork 自定义模型配置教程 — 模型管理功能详解
目录
- 前言：TraeWork 模型体系
- 准备工作
- 操作步骤
- 第一步：打开设置
- 第二步：进入模型管理
- 第三步：点击添加模型
- 第四步：填写模型配置
- 第五步：确认添加成功
- 在对话中使用
- 配置参数说明
- 常见问题
前言：TraeWork 模型体系
TraeWork 是一款 AI 智能工作台，它提供了内置模型和自定义模型两套模型体系：
- 内置模型：TraeWork 官方预置的模型，包括 Kimi K2.6、MiniMax-M3、Qwen3.8-Max、Qwen3.7-Plus 等主流国产大模型，开箱即用，按积分倍率消耗。
- 自定义模型：用户通过填写 API 地址和密钥，接入自己拥有的 OpenAI 兼容格式 API，适用于接入企业内部模型服务、本地部署的模型或自己有权限使用的 API 接口。
当内置模型无法满足需求时，就可以通过自定义模型功能来扩展。下面这张截图展示了模型选择菜单，可以清楚看到内置模型和自定义模型两个分组：
图1：模型选择菜单。上方为 TraeWork 内置模型（Kimi、MiniMax、Qwen 等），下方为用户添加的自定义模型
说明：本文截图中的配置信息仅作操作演示。实际使用时，请填入你自己拥有合法使用权限的 API 地址和密钥。
准备工作
在开始操作之前，你需要准备好以下信息：
| 参数 | 说明 | 格式示例 |
|---|---|---|
| API 请求地址 | 你拥有使用权限的 OpenAI 兼容 API 的 Base URL，通常以/v1结尾 | https://your-api-domain/v1 |
| 模型 ID | API 支持的模型标识符 | gpt-4o、qwen-max等 |
| API 密钥 | 用于身份验证的 Key | sk-xxxx |
前提条件：确保你拥有对应 API 的合法使用权限，且接口兼容 OpenAI Chat Completions 格式（即
/v1/chat/completions接口）。
操作步骤
1打开设置
首先打开 TraeWork 客户端，在左侧边栏底部找到设置入口，点击进入设置面板。
图2：在左侧边栏底部找到「设置」并点击
2进入模型管理
进入设置面板后，在左侧设置菜单中找到模型选项，点击进入模型管理页面。该页面会展示当前已配置的所有模型。
图3：在设置菜单中点击「模型」进入模型管理
3点击添加模型
在模型管理页面，可以看到已添加的自定义模型列表。点击页面上方的+ 添加模型按钮，开始添加新的自定义模型。
图4：点击「+ 添加模型」按钮，弹出自定义模型配置弹窗
如图所示，页面中已有一个之前添加的模型（服务商显示为"自定义(OpenAI Compatible)"），右侧有编辑、删除和启用/禁用的开关。点击「+ 添加模型」后会弹出配置弹窗。
4填写模型配置
在弹出的「自定义模型」配置弹窗中，依次填写以下字段：
图5：填写自定义模型配置信息（图中为演示数据，请替换为你自己的 API 信息）
各字段填写说明如下：
| 字段 | 填写内容 | 说明 |
|---|---|---|
| API 格式 | OpenAI Chat Completions 格式 | 通常默认即可，适用于 OpenAI 兼容的 API 接口 |
| 请求地址 | 你的 API Base URL | 填入 API 服务的 Base URL。如果开关「完整 URL」关闭，系统会自动在末尾拼接/chat/completions |
| 模型 ID | API 支持的模型名称 | 填入 API 文档中列出的模型标识符，需与接口文档中的模型名完全一致 |
| 模型展示名称 | 自定义（可选） | 给模型起一个好记的显示名，方便在对话模型选择时区分。如不填则默认显示模型 ID |
| API 密钥 | 你的 API Key | 填入你的 API 密钥，格式通常为sk-xxxx。内容会自动加密存储 |
提示：弹窗底部有「连通性测试」功能，会发起一次真实请求验证配置是否正确（会消耗少量 Token）。建议在点击「添加模型」前先测试连通性。
填写完成后，点击底部的添加模型按钮保存配置。
5确认添加成功
保存后返回模型管理页面，此时在模型列表中应该能看到新添加的模型，右侧的开关默认为开启状态（绿色），表示该模型已可使用。
图6：添加成功，模型列表中显示两个自定义模型
如图所示，模型列表中现在有两个自定义模型，均显示为「自定义(OpenAI Compatible)」且已启用。
在对话中使用自定义模型
添加完成后，回到 TraeWork 主界面的对话框，点击Auto Mode下拉菜单，就能看到模型选择列表。列表分为两组：
- 内置模型：Kimi K2.6、MiniMax-M3、Qwen3.8-Max、Qwen3.7-Plus 等，这些是 TraeWork 官方预置的，直接可用
- 自定义模型：你刚才添加的模型会显示在这里，旁边还有一个「+ 添加模型」入口可以快速跳转到配置页面
直接点击你添加的自定义模型名称即可切换使用。内置模型和自定义模型之间可以随时切换，无需额外操作。
配置参数说明
为了帮助大家更好地理解各配置项，这里做一个详细说明：
API 格式
TraeWork 自定义模型目前支持OpenAI Chat Completions 格式。这意味着任何兼容该格式的 API 接口都可以接入，包括但不限于：
- OpenAI 官方 API
- 企业内部部署的模型服务（如 vLLM、Ollama 等开启了 OpenAI 兼宾模式）
- 其他提供 OpenAI 兼容接口的模型服务
请求地址
请求地址填写 API 的 Base URL。有两个模式：
- 非完整 URL 模式（开关关闭）：只需填到
/v1，系统自动拼接/chat/completions - 完整 URL 模式（开关开启）：需要填写完整的接口路径，如
https://your-domain/v1/chat/completions
大多数情况下使用非完整 URL 模式即可，填到/v1结尾。
模型 ID
模型 ID 必须与 API 文档中的模型名称完全一致，包括大小写和连字符。填错会导致调用时返回模型不存在的错误。
模型展示名称
纯展示用途，方便在模型切换列表中识别。建议填写有意义的名称。如留空则显示模型 ID。
常见问题
Q：内置模型和自定义模型有什么区别？
内置模型是 TraeWork 官方预置的国产大模型（如 Kimi、MiniMax、Qwen 等），开箱即用，按积分倍率消耗平台积分。自定义模型是你自己配置的 API 接口，调用费用由对应 API 服务商结算，与 TraeWork 平台无关。两者在对话界面中可以自由切换。
Q：添加后模型无法使用 / 调用报错？
排查以下几点：
- 检查请求地址是否正确，确保以
/v1结尾（非完整 URL 模式下） - 检查模型 ID 是否拼写正确，与 API 文档一致
- 检查 API 密钥是否有效、是否过期
- 点击「连通性测试」验证配置是否正确
- 确认 API 接口确实兼容 OpenAI Chat Completions 格式
Q：可以添加多少个自定义模型？
TraeWork 支持添加多个自定义模型，可以在模型管理页面中通过开关来启用/禁用特定模型。不需要的模型可以关闭开关或删除。
Q：自定义模型的费用怎么算？
自定义模型的调用费用由你接入的 API 服务商决定，与 TraeWork 本身无关。TraeWork 只是作为调用客户端，费用的结算在 API 服务商那边进行。内置模型则消耗 TraeWork 平台积分。
Q：支持 Anthropic / Claude 格式吗？
目前自定义模型功能支持的是 OpenAI Chat Completions 格式。如果你的 API 服务商同时提供 OpenAI 兼容接口，则可以通过该接口接入。
以上内容基于 TraeWork 实际操作截图整理，如有界面变动请以最新版本为准。请确保你使用的 API 服务拥有合法的使用权限。如有问题欢迎在评论区交流。