阅读进度21%

模型

2026-06-17·西山懒懒翁·4 次浏览

TRAE Work 提供灵活的模型管理功能，你既可以使用预置模型，也可以添加自定义模型，以满足使用特定模型版本或接入私有模型等个性化需求。本文将指导您如何在 TRAE Work 中管理模型。

预置模型

TRAE Work 网页版和桌面版都预置了 TRAE Auto Model。使用 TRAE Auto Model 时，系统会综合考虑问答速度、性能与资源占用情况，智能调用合适的模型，提供更流畅的 AI 问答体验。

此外，Code 模式还提供以下预置模型：

Gemini-3.1-Pro-Preview
Gemini-3-Flash-Preview
MiniMax-M3
MiniMax-M2.7
Kimi-K2.5
GPT-5.4
GPT-5.2

添加自定义模型

如果内置模型无法满足需求，你可以添加自定义模型。可用的模型来源如下：

模型服务商：从 TRAE Work 预设的模型服务商和模型列表中选择，按界面提示填写 API 密钥即可添加。
自定义配置：通过配置 API 格式、请求地址、模型 ID 和鉴权信息，接入TRAE Work 未预设的模型。

使用限制

仅 TRAE Work 桌面版支持添加自定义模型。
添加的自定义模型仅支持在本地环境中使用。

添加预设模型服务商的模型

前往设置 > 模型，进入模型管理面板。
点击按钮，打开窗口。

在预设服务商列表中，选择服务商。

TRAE Work 预设的模型服务商：Google、OpenAI、DeepSeek、Anthropic、xAI、Z.ai、MiniMax Global、Kimi Global、BytePlus、OpenRouter、Novita、无问芯穹 Global、无问芯穹 CN、AWS、Azure OpenAI、Vercel AI Gateway、Ollama Cloud、Bigmodel、MiniMax-CN、Kimi-CN、火山引擎、阿里云、腾讯云、硅基流动、模力方舟、PPIO。

(部分模型) 选择计费方式：

按量计费：根据实际消耗的 Token 数量和模型刊例价计费。
Coding Plan：订阅式大模型服务套餐包，专注于编码场景。
Agent Plan：订阅式大模型服务套餐包，与 Coding Plan 相比，此套餐提供更全面的能力。

详情参考模型服务商的官方文档。

选择模型，支持以下方式：

直接从列表中选择 TRAE Work 为每个服务商预置的模型（均为默认版本）。
若你希望使用其他模型或使用特定版本的模型，点击列表中的，然后在输入框中填写模型 ID。

填写该模型鉴权所需的 API 密钥。
(可选) 展开表单，按需设置以下参数：

参数	描述
	设置模型在列表中的展示名称。若不设置，将默认展示模型 ID。
	设置该模型单次请求可接收的最大 Token 数。
	设置该模型单次响应可生成的最大 Token 数。
	设置该模型在单次任务中可调用工具的最大次数。
	设置选择该模型时，是否允许用户提供图片作为输入。若选择，对话输入框左下角将不再显示图标，使用该模型时将无法上传图片作为输入。

点击按钮。

TRAE Work 将调用服务商的接口来检测 API 密钥是否有效：

若连接成功，该模型将被添加到模型列表。
若连接失败，窗口中将展示错误信息和服务商返回的日志，你可以根据这些信息排查问题。

通过自定义配置添加模型

前往设置 > 模型，进入模型管理面板。
点击按钮，打开窗口。
滚动至列表底部，然后选择。

设置模型的 API 格式。可选格式如下：

格式	描述
	兼容 OpenAI /v1/chat/completions 接口规范，适用于大多数 OpenAI 兼容模型服务。常见兼容服务包括 OpenAI、DeepSeek、OpenRouter、部分 Ollama/OpenAI 兼容代理等。
	兼容 Anthropic /v1/messages 接口规范，适用于 Claude 系列及兼容 Anthropic Messages API 的模型服务。常见兼容服务包括 Anthropic Claude、部分 Claude API 代理服务等。

填写自定义请求地址。你可以根据请求地址格式选择以下方式：

方式一：打开开关，然后填写完整地址，例如 https://api.openai.com/v1/chat/completions 或 https://api.anthropic.com/v1/messages。
方式二：关闭开关，然后填写基础地址，例如 https://api.openai.com/v1 或 https://api.anthropic.com。

输入模型 ID。
设置开关。该开关默认开启；关闭后，对话输入框左下角将不再显示图标，使用该模型时将无法上传图片作为输入。
填写该模型鉴权所需的 API 密钥。
(可选) 展开列表，按需设置以下参数：

参数	描述
	TRAE Work 为特定模型系列优化了 Prompt 和超参，未选择时使用默认配置。可选项如下： • GPT-5 系列：适用于接入 GPT-5 系列模型。适用于接入 GPT-5 系列模型。相较于默认配置，该选项提供协议自动适配、推荐超参数预置、更大的上下文窗口以及专属 Prompt 优化，从而提升整体稳定性与生成效果。 • Gemini-3 系列：适用于接入 Gemini-3 系列模型。相较于默认配置，该选项支持 Reasoning 协议自动适配，并预置推荐超参数，提供更大的上下文窗口，从而更好发挥模型的推理能力与长文本处理能力。 • Deepseek-4 系列：适用于接入 Deepseek-4 系列模型。相较于默认配置，该选项默认开启 Thinking 模式，并预置推荐超参数与更大的上下文窗口，有助于提升复杂任务的思考深度与输出质量。提示：该系列不支持多模态输入（如图片），如需多模态能力请勿选择此项。 • 默认：不针对特定模型系列做任何调优，使用 TRAE Work 通用的 Prompt 模板与超参配置。关于各个模型系列的优势详情，参考模型系列选项优势详解。
	设置模型在列表中的展示名称。若不设置，将默认展示模型 ID。
	设置单次请求可接收的最大 Token 数，以及单次响应可生成的最大 Token 数。
	设置模型在单次任务中可调用工具的最大次数。

点击按钮。

TRAE SOLO 将调用服务商的接口来检测 API 密钥是否有效：

若连接成功，该模型将被添加到模型列表。
若连接失败，窗口中将展示错误信息和服务商返回的日志，你可以根据这些信息排查问题。

模型系列选项优势详解

通过自定义配置添加特定系列的模型时，你可以选择 TRAE SOLO 预设的模型系列选项。