目录前言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模型 IDAPI 支持的模型标识符gpt-4o、qwen-max等API 密钥用于身份验证的 Keysk-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模型 IDAPI 支持的模型名称填入 API 文档中列出的模型标识符需与接口文档中的模型名完全一致模型展示名称自定义可选给模型起一个好记的显示名方便在对话模型选择时区分。如不填则默认显示模型 IDAPI 密钥你的 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 服务拥有合法的使用权限。如有问题欢迎在评论区交流。