> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt?lang=zh
> Use this file to discover all available pages before exploring further.

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

## 内置模型 {#2fca0d56}

TraeWork 提供以下内置模型：

::::cols
@col 33
**Work 模式：**

* Seed-Evolving（仅限会员 Pro+、会员 Ultra、会员 Express 用户使用）
* Seed-2.1-Pro
* Seed-2.1-Turbo
* GLM-5.3
* GLM-5.2
* DeepSeek-V4-Flash 正式版
* DeepSeek-V4-Pro 正式版
* Kimi-K3
* Kimi-K2.7-Code
* Kimi-K2.6
* MiniMax-M3
* Qwen3.8-Max
* Qwen3.7-Plus

@col 33
**Code 模式：**

* Seed-Evolving（仅限会员 Pro+、会员 Ultra、会员 Express 用户使用）
* Seed-2.1-Pro
* Seed-2.1-Turbo
* Seed-Code
* GLM-5.3
* GLM-5.2
* DeepSeek-V4-Flash 正式版
* DeepSeek-V4-Pro 正式版
* Kimi-K3
* Kimi-K2.7-Code
* Kimi-K2.6
* MiniMax-M3
* Qwen3.8-Max
* Qwen3.7-Plus

@col 33
**Design 模式：**

* Seed-2.1-Pro
* Seed-2.1-Turbo
* GLM-5.2
* DeepSeek-V4-Pro
* Kimi-K2.7-Code
::::

此外，若你选择 Auto Mode，系统会综合考虑问答速度、性能与资源占用情况，智能调用合适的模型，提供更流畅的 AI 问答体验。

企业版内置模型参考[系统内置模型列表](/enterprise_model-settings-for-trae-enterprise#bac641d2)。

## 添加自定义模型 {#abcbcf9b}

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

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

### 相关限制 {#f97f5c7f}


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

### 操作步骤 {#hnDSvhIlT}

添加自定义模型的步骤如下：

1. 前往 **设置** > **模型**，进入模型管理面板。
2. 点击 **添加模型** 按钮。
   界面中出现 **添加模型** 窗口。
   ![Image=500x484](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f2d7930d44a54f42ba53ee3dd406cd59~tplv-goo7wpa0wc-topic.webp)
3. 选择 TraeWork 预设的模型服务商或选择 **自定义模型** 选项。
4. 完成基础模型配置。
   * 若你选择了预设的模型服务商，则需配置以下参数：
      <!-- @cols-width: 121,739 -->
      | **参数**  | **描述**  |
      | --- | --- |
      | 服务商  | 已默认设置为你在上一步中选择的模型服务商。你可以按需切换。  |
      | 配置方式  | 部分模型服务商要求选择计费或资源使用方式。可选项以界面展示为准，常见选项包括： | \
      | | | \
      | | * **按量计费**：按实际 Token 消耗量计费。 | \
      | | * **Coding Plan**：使用该服务商面向编码场景提供的套餐额度。 | \
      | | * **Agent Plan**：使用该服务商面向 Agent 场景提供的套餐额度。  |
      | 模型  | 从列表中选择 TraeWork 为该服务商预置的模型（均为默认版本）。如需使用其他模型或指定版本，点击 **使用其他模型**，并填写对应的模型 ID。  |
      | API 密钥  | 填写调用该模型所需的 API 密钥，用于鉴权。你可以点击输入框右上方的 **获取 API 密钥**，前往模型服务商平台获取。  |
   * 若你选择了 **自定义模型** 选项，则需配置以下参数：
      <!-- @cols-width: 129,733 -->
      | **参数**  | **描述**  |
      | --- | --- |
      | API 格式  | 设置模型服务使用的 API 格式。可选项如下： | \
      | | | \
      | | * **OpenAI Chat Completions 格式**：兼容 OpenAI `/v1/chat/completions` 接口规范，适用于大多数 OpenAI 兼容模型服务。常见兼容服务包括 OpenAI、DeepSeek、Kimi、GLM、OpenRouter、部分 Ollama/OpenAI 兼容代理等。 | \
      | | * **Anthropic Messages 格式**：兼容 Anthropic `/v1/messages` 接口规范，适用于 Claude 系列及兼容 Anthropic Messages API 的模型服务。常见兼容服务包括 Anthropic Claude、部分 Claude API 代理服务等。  |
      | 自定义请求地址  | 填写模型服务的请求地址。你可以根据服务商提供的地址格式选择以下方式： | \
      | | | \
      | | * ***方式一***：打开 **完整 URL** 开关，然后填写完整请求地址。 | \
      | | * ***方式二***：关闭 **完整 URL** 开关，然后填写基础地址，由 TraeWork 按所选 API 格式拼接请求路径。  |
      | 模型 ID  | 输入模型服务商提供的模型 ID。根据模型服务商提供的 ID 填写即可。  |
      | 模型展示名称  | 设置模型在列表中的展示名称。若不设置，将默认展示模型 ID。  |
      | API 密钥  | 填写调用该模型所需的 API 密钥，用于鉴权。  |
5. (可选) 展开 **高级配置** 表单，按需设置以下参数：
   :::tip 提示
   对于上下文窗口、是否支持图片输入、Temperature、Top P 和 Top K，用户的自定义设置优先级最高。
   :::   


<!-- @cols-width: 125,767 -->
| **参数**  | **描述**  |
| --- | --- |
| 模型系列  | TraeWork 为特定模型系列优化了 Prompt、超参配置等，详情参考[模型系列选项详解](#hgJM390Ke)。 | \
| | | \
| | 以下选项 TRAE 个人版和企业版均可用： | \
| | | \
| | * **GPT-5 系列**：推荐用于 GPT-5 系列模型。 | \
| | * **Gemini-3 系列**：推荐用于 Gemini-3 系列模型。 | \
| | * **DeepSeek-4 系列**：推荐用于 DeepSeek-4 系列模型。 | \
| | * **默认**：不针对特定模型系列做任何调优，使用 TraeWork 通用的 Prompt 模板与超参配置。 | \
| | | \
| | 以下选项仅 TRAE 企业版可用： | \
| | | \
| | * **Kimi 系列**：推荐用于 Kimi-K2、Kimi-K3 系列模型。 | \
| | * **GLM-5 系列**：推荐用于 GLM-5 系列模型。 | \
| | * **Claude-4 系列**：推荐用于 Claude-4 系列模型。  |
| 上下文窗口  | 设置该模型单次请求可接收的最大 Token 数，即 “输入”；以及单次响应可生成的最大 Token 数，即 “输出”。你可以从输入框右侧的预设上下文窗口中选择，也可以手动输入数值。 | \
| | | \
| | ***提示***：若留空，将使用 TraeWork 内置的默认最优值。  |
| 工具调用轮数  | 设置模型在单次任务中可调用工具的最大轮数。数值越高，模型可执行的连续工具操作越多，但耗时和 Token 消耗也可能增加。若留空，将使用 TraeWork 内置的默认最优值。  |
| 支持图片输入  | 设置该模型是否可接收图文混合输入。需所选模型本身具备视觉理解能力，否则无法正常识别图片内容。  |
| 思考模式  | 控制模型在回答前是否进行推理。开启后可提升复杂问题的处理质量，但可能增加响应耗时与 Token 消耗。若选择 **跟随模型默认配置**，则沿用模型服务商的默认设置。  |
| 采样参数  | 控制模型生成回答时的采样策略，影响输出的稳定性、多样性和随机性。 | \
| | | \
| | * **Temperature**：控制输出随机性。数值越高，回答越发散；数值越低，回答越稳定。取值范围：[0, 2]。 | \
| | * **Top P**：控制候选词的累计概率范围。数值越高，可选范围越大；数值越低，输出越收敛。取值范围：[0, 1]。 | \
| | * **Top K**：控制每一步生成时可参与采样的候选词数量。数值越高，输出越多样；数值越低，输出越集中。取值范围：[1, 100]。 | \
| | | \
| | ***提示***：若留空，TraeWork 将使用模型服务商内置的默认值（一般为默认最优配置）。  |

6. 点击 **添加模型** 按钮。
   TraeWork 将调用服务商的接口来检测 API 密钥是否有效：
   * 若连接成功，该模型将被添加到模型列表。
   * 若连接失败，窗口中将展示错误信息和服务商返回的日志，你可以根据这些信息排查问题。

## 了解更多 {#htlu3DY18}

### 模型系列选项详解 {#hgJM390Ke}

通过自定义配置添加特定系列的模型时，你可以选择 TraeWork 预设的模型系列选项。TraeWork 已为这些系列优化了 Prompt、超参等配置，以提升模型性能，详见下表。

<!-- @cols-width: 153,756 -->
| **选项**  | **描述**  |
| --- | --- |
| GPT-5 系列  | 选择该选项后，TraeWork 会按 GPT-5 的协议要求调整请求字段，并应用推荐超参和专属 Prompt 模板，具体包括： | \
| | | \
| | * **协议自动适配**：GPT-5 协议要求使用 `MaxCompletionTokens` 字段传递最大生成长度（默认配置使用 `MaxTokens`），选择该系列后 TraeWork 会自动完成协议字段转换，避免因协议不匹配导致的请求失败。 | \
| | * **超参预置为推荐值**：`Temperature` 固定为 `1`（GPT-5 仅支持该取值）。 | \
| | * **专属 Prompt 优化**：内置一套独立的 Prompt Engineering 模板，针对 GPT-5 的指令遵循特性做了调优，相比默认配置，在工具调用、代码生成等任务上效果更佳。  |
| Gemini-3 系列  | 选择该选项后，TraeWork 会按 Gemini-3 的推理协议解析推理内容，并应用推荐超参，具体包括： | \
| | | \
| | * **Reasoning 协议自动适配**：Gemini-3 系列模型的推理内容需通过 `thought_signature` 字段回传（默认配置通过 `reasoning_content` 字段回传）。选择该选项后，TraeWork 会自动按 Gemini-3 协议解析推理过程，确保推理链路被正确展示与利用。 | \
| | * **超参预置为推荐值**：`Temperature` 设为 `0.1`。  |
| DeepSeek-4 系列  | 选择该选项后，TraeWork 会为 DeepSeek-4 预设思考模式和推荐超参，具体包括： | \
| | | \
| | * **默认开启 Thinking 模式**：自动启用深度思考，无需额外配置即可获得更强的推理能力，适合复杂代码生成与逻辑分析。 | \
| | * **超参预置为推荐值**：`Temperature` 设为 `0.1`。  |
| Kimi 系列 | 选择该选项后，TraeWork 会自动为 Kimi 系列模型启用深度思考 Thinking 模式，无需额外配置即可获得更强的推理能力，适合复杂代码生成与逻辑分析。  | \
| | | \
| ***提示***：仅企业版可用  | |
| GLM-5 系列 | 选择该选项后，TraeWork 会自动为 GLM-5 系列模型启用深度思考 Thinking 模式，无需额外配置即可获得更强的推理能力，适合复杂代码生成与逻辑分析。  | \
| | | \
| ***提示***：仅企业版可用  | |
| Claude-4 系列 | 选择该选项后，TraeWork 会为 Claude-4 预设思考模式，并启用面向智能体任务的专项 Prompt Engineering，具体包括： | \
| | | \
| ***提示***：仅企业版可用  | * **默认开启 Thinking 模式**：自动启用深度思考，无需额外配置即可获得更强的推理能力，适合复杂代码生成与逻辑分析。 | \
| | * **使用专项 Agent PE**：针对 Claude 优化了计划生成、任务拆解、子智能体协作、后台任务管理以及检索工具契约。  |

### 常用模型推荐配置速查 {#hhnGCrl6R}

在添加自定义模型时，若你不选择 TRAE 预置的模型服务商，而是选择 “自定义模型” 选项，推荐为模型使用以下配置，以确保 TraeWork 能调用该模型。

<!-- @cols-width: 159,263,231 -->
| **模型**  | **API 格式**  | **高级配置：模型系列**  |
| --- | --- | --- |
| Claude-4 系列  | Anthropic Messages 格式  | Claude-4 系列  |
| GPT-5 系列  | OpenAI Chat Completions 格式  | GPT-5 系列  |
| GLM-5 系列  | OpenAI Chat Completions 格式  | GLM-5 系列  |
| DeepSeek-4 系列  | OpenAI Chat Completions 格式  | DeepSeek-4 系列  |
| Kimi-K2、K3 系列  | OpenAI Chat Completions 格式  | Kimi 系列  |