TraeWork 可以用哪些模型:官方文档写明的内置清单与切换方式
一、你真正想搞清楚的其实是三件事
大部分人打开「模型」这一页,不是想看厂商名单,而是带着三个很具体的疑问过来的:我现在这个模式下到底能选哪些模型;我自己在别处买的 API 额度能不能接进来用;接进来之后有没有什么用不了的地方。
这三个问题的答案,在 TraeWork 官方文档《模型》里写得比想象中细,但也留了不少空白。麻烦的是空白部分很容易被人默认成「应该可以吧」,等真去配的时候才发现卡住了。所以这篇不打算复述产品介绍,只做一件事:把那一页文档里能核到的每一条列出来,把核不到的地方明确标成核不到。
先说清楚立场:我们没有开通付费账号,也没有实际操作过 TraeWork。下面所有内容都是官方文档的文字口径,不是使用体验。这个产品仍在快速迭代,文档里的模型清单和计费口径随版本变动,看到本文时清单大概率已经变了,具体以官方最新公告和定价页为准。
二、文档写明的内置清单与切换方式
TraeWork 官方文档把内置模型按模式分成三份列表,而不是给一份总表。这是最容易被忽略的一点——同一个账号,切到不同模式,能选的模型是不一样的。
文档写明的三份清单如下:
| 模式 | 官方文档列出的内置模型 |
|---|---|
| Work 模式 | Seed-2.1-Pro、Seed-2.1-Turbo、GLM-5.3、GLM-5.2、GLM-5、DeepSeek-V4-Pro、DeepSeek-V4-Flash 正式版、DeepSeek-V4-Flash、Kimi-K3、Kimi-K2.7-Code、Kimi-K2.6、MiniMax-M3、Qwen3.8-Max、Qwen3.7-Plus |
| Code 模式 | 在 Work 模式那份的基础上,另有 Seed-Code 与 GLM-5.1 |
| Design 模式 | Seed-2.1-Pro、Seed-2.1-Turbo、GLM-5.2、DeepSeek-V4-Pro、Kimi-K2.7-Code |
按文档列出的条目数,Work 模式 14 项、Code 模式 16 项、Design 模式 5 项。Code 模式多出来的两项,一项是 Seed-Code、一项是 GLM-5.1;而 Design 模式的清单明显短一截,GLM-5.3、GLM-5、DeepSeek-V4-Flash 正式版、DeepSeek-V4-Flash、Kimi-K3、Kimi-K2.6、MiniMax-M3 以及 Qwen 系列的两项,都没有出现在 Design 模式的列表里。文档没有解释为什么这么切,我们也不替它解释——只提示一句:如果你的工作流是「在 Design 模式里做完再切到 Work 模式接着写文档」,那么你在两个模式里可选的模型不是同一套,这个差异是文档明写的。
清单里有一条带括号的限定值得单独拎出来:Kimi-K3 后面标着「仅限会员 Pro+、会员 Ultra、会员 Express 用户使用」,Work 和 Code 两份清单里都是这么写的。这是整页文档里唯一一处把模型可用性和会员档位绑死的地方。顺带记一个我们核到的口径差异:官方那篇关于积分计费上线的文档,套餐总览里列出的是会员 Lite、会员 Pro、会员 Pro+、会员 Ultra 四档,我们没有在那张套餐表里找到「会员 Express」这一档。两处文字就是这样,我们只陈述差异,不推断哪一处才是当前口径,也不去猜原因。
除了手动选,文档还写了一个 Auto Mode。原文的说法是:若你选择 Auto Mode,系统会综合考虑问答速度、性能与资源占用情况,智能调用合适的模型。注意这句话里没有任何可核的规则——它没写会在哪几个模型之间选、没写选择依据的优先级、也没写会不会选到需要会员档位才能用的模型。所以如果你需要「这次任务必须用某个特定模型」,Auto Mode 给不了这个保证,文档没有说明这一点。
企业版的情况文档单独指了一个方向,说企业版内置模型参考「系统内置模型列表」这一页。也就是说,上面那三份清单不能直接当成企业版的清单来用。
三、自定义模型:路径写得很细,限制也写得很硬
如果内置清单不够用,文档给了两条添加自定义模型的路径,入口是同一个:进入 设置 > 模型,打开模型管理面板,点击「添加模型」。
第一条是选预设的模型服务商。 从 TraeWork 预设的服务商和模型列表里选,按提示填 API 密钥。这条路径中间有一个容易被跳过的分叉——文档写的是「(部分模型) 选择计费方式」,可选项有三种:按量计费(根据实际消耗的 Token 数量和模型刊例价计费)、Coding Plan(订阅式大模型服务套餐包,专注于编码场景)、Agent Plan(订阅式套餐包,文档说与 Coding Plan 相比提供更全面的能力)。注意这三项是模型服务商那边的计费方式,文档明确让你参考模型服务商的官方文档,TraeWork 自己这一页没有展开。选完服务商,模型既可以从列表里直接选(文档说明这些均为默认版本),也可以点「使用其他模型」自己填模型 ID——想锁定某个特定版本,就得走后面这条。
第二条是自定义配置,在添加模型窗口的列表底部。这条要自己填的东西更多:API 格式、请求地址、模型 ID、鉴权信息。请求地址那里有个「完整 URL」开关,文档给了两种填法——打开开关填完整地址,关闭开关填基础地址。文档把这两种填法并列给出,但没有写什么情况下该选哪一种,也没有给出基础地址的拼接规则——这一点官方文档没有说明,接私有网关时得对着你自己那边的地址格式判断。
两条路径都有「高级配置」,但里面的参数不完全一样,这点文档表格里写得很清楚:
| 参数 | 预设服务商路径 | 自定义配置路径 |
|---|---|---|
| 模型系列 | 无 | 有(文档自述:TraeWork 为特定模型系列优化了 Prompt 和超参,未选择时使用默认配置) |
| 模型展示名称 | 有(不设置则默认展示模型 ID) | 有(同上) |
| 上下文窗口 | 拆成「输入」「输出」两项,分别设单次请求可接收、单次响应可生成的最大 Token 数 | 合成一项,同时设置这两个上限 |
| 工具调用轮次 | 有(模型在单次任务中可调用工具的最大次数) | 有(同上) |
| 多模态 | 在高级配置里,名为「支持多模态」 | 在主表单里,是一个默认开启的开关 |
这张表里最该记住的是「工具调用轮次」:它的定义是单次任务中可调用工具的最大次数。TraeWork 的很多能力都要靠模型连续调工具才能走完,这个值是你自己填的上限。文档只说明它是什么,没有说明不填时的默认值是多少,也没有说明触到上限后任务会怎么处置——这两点官方文档没有说明。
多模态那一项两条路径的表述一致:关闭之后,使用该模型时将无法上传图片作为输入。
两条路径的收尾几乎一样,只有最后那个按钮的名字不同:预设服务商路径点的是「提交」,自定义配置路径点的是「添加模型」。点完之后 TraeWork 都会调用服务商的接口检测 API 密钥是否有效;连接成功则模型进入列表,连接失败则展示错误信息和服务商返回的日志。这一条对排查很有用——文档写明失败时展示的是「错误信息和服务商返回的日志」,日志既然来自服务商那边,看到陌生错误码就该先去服务商自己的文档里查。
四、边界在哪:两条硬限制,和一批文档没写的东西
这一段是本篇的重点,因为前面那些步骤照着做就行,真正会让人白忙一场的是限制。
《模型》这一页在「使用限制」小节里只写了两句话,但两句都很硬:
- 仅 TraeWork 桌面版支持添加自定义模型。
- 添加的自定义模型仅支持在本地环境中使用。
第一句意味着:如果你平时只用网页版,那么「添加模型」这条路对你是关闭的,不是藏在哪个菜单里没找到。第二句要和另一份文档对着看才知道分量——官方《快速开始:TraeWork 网页版和桌面版》里写明,TraeWork 网页版仅支持云端运行环境,桌面版支持「本地」和「云端」两种运行环境。把这两处放在一起,结论是文档自己给出的:自定义模型只能在桌面版的本地运行环境里用;桌面版切到云端运行环境时,文档没有说自定义模型可用。同一份快速开始文档还写明,同一账号下在任一客户端「云端」模式发起的任务会自动同步到另一端——而自定义模型不在云端可用范围内,这两条约束是叠加的。
再往下,是一批我们没能在文档里核到的东西,如实列出来,免得你按「应该可以」去规划:
- 各个内置模型消耗多少积分、有没有倍率差异——《模型》这一页完全没提,全页只有 Kimi-K3 那一处会员档位限定与计费相关。
- 自定义模型是否能在 Design 模式里选用、三种模式对自定义模型是否有区别——文档没有说明。
- 已添加的自定义模型怎么编辑、怎么删除、能不能设为默认——文档没有说明。
- 移动端是否支持选择或添加模型——《模型》这一页只写了「仅 TraeWork 桌面版支持添加自定义模型」,除此之外没有对移动端的说明。
- 各内置模型之间的能力差异、擅长什么、上下文窗口多大——文档给的是名单,不是对比表,我们不做任何推断。
还有一点必须说明白:填 API 密钥这个动作,等于把你在第三方服务商的凭证交给一个桌面客户端保管。TraeWork 官方文档在这一页写明的只是「调用服务商接口检测密钥是否有效」,密钥怎么存、存在哪里、是否加密,这一页没有说明。凭证管理请按你自己组织的规范来评估,这属于通用做法,不是该产品官方文档的内容。
五、什么时候该折腾自定义模型,什么时候不必
按文档写明的边界倒推,判断其实很简单。
值得配的情况:你已经在某家服务商那里买了额度或订阅了套餐,希望在 TraeWork 里继续消耗那份额度而不是走平台积分;或者你要接的是内置清单里根本没有的模型,比如公司自建网关后面的私有部署;又或者你必须锁定某个特定版本,而内置列表给的是默认版本。这三种情况下,「使用其他模型」填模型 ID、或者走自定义配置填完整 URL,是文档写明的正规做法。
不必折腾的情况:你主要在网页版工作——那这条路本来就走不通;或者你的任务需要跑在云端运行环境里,比如要用到跨端同步的那套流程——自定义模型按文档只在本地环境可用;再或者你并没有特定的模型偏好,那么内置清单已经覆盖了几家主流服务商的多个型号,直接在模式内选就行,甚至可以交给 Auto Mode,只要你接受「具体选了哪个模型不受你控制、文档也没写选择规则」这个前提。
最后重复一遍开头那句限定:上面每一个模型名、每一个参数名、每一条限制,都来自官方文档某一天的文字。这个产品迭代很频繁,模型清单尤其容易变,会员档位与计费口径也可能调整。你要做决策的时候,请回到官方文档那一页对一遍当天的原文,别拿这篇当准绳。
本文依据 TraeWork 官方文档(docs.trae.cn)于 2026-08-17 的公开内容整理。
我们没有开通付费账号,也没有实际操作过该产品,因此不涉及界面外观、操作手感与生成质量的任何描述。
该产品仍在快速迭代,功能与计费口径随版本变动,文中涉及积分与套餐的表述均为复述官方文档原文,
请以官方最新公告与定价页为准。
安全与合规相关做法请结合自身环境评估,本文不构成安全方案建议。