TRAE
TRAE
TraeCodeTraeWorkTraeCode PluginTraeCode CLI企业版
AI 助手
TRAE 智能问答助手
你好，我是 TRAE 文档问答助手 🎉 你在阅读当前文档的过程中，无论对文档概念的解释，还是文档内容方面的疑问，都可以随时向我提问，我会全力为你解答
推荐问题
TRAE IDE 里最热门的 Skill 是哪些？
如何创建自定义智能体？
如何配置 Rules？
文档反馈
入门
最佳实践
协作方式
Agent 配置
模型上下文协议(MCP)
Design 模式
任务执行
网页与电脑操作
产物管理
外部应用授权
内置资源
开发环境
系统设置
官方活动
相关协议
TraeWork/Agent 配置/模型

模型

复制页面

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

内置模型

TraeWork 提供以下内置模型：

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

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

Design 模式：

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

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

企业版内置模型参考系统内置模型列表。

添加自定义模型

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

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

相关限制

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

操作步骤

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

  1. 前往 设置 > 模型，进入模型管理面板。
  2. 点击 添加模型 按钮。
    界面中出现 添加模型 窗口。
    Image
  3. 选择 TraeWork 预设的模型服务商或选择 自定义模型 选项。
  4. 完成基础模型配置。
    • 若你选择了预设的模型服务商，则需配置以下参数：
      参数 描述
      服务商 已默认设置为你在上一步中选择的模型服务商。你可以按需切换。

      配置方式

      部分模型服务商要求选择计费或资源使用方式。可选项以界面展示为准，常见选项包括：

      • 按量计费：按实际 Token 消耗量计费。
      • Coding Plan：使用该服务商面向编码场景提供的套餐额度。
      • Agent Plan：使用该服务商面向 Agent 场景提供的套餐额度。
      模型 从列表中选择 TraeWork 为该服务商预置的模型（均为默认版本）。如需使用其他模型或指定版本，点击 使用其他模型，并填写对应的模型 ID。
      API 密钥 填写调用该模型所需的 API 密钥，用于鉴权。你可以点击输入框右上方的 获取 API 密钥，前往模型服务商平台获取。
    • 若你选择了 自定义模型 选项，则需配置以下参数：
      参数 描述

      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. (可选) 展开 高级配置 表单，按需设置以下参数：

    提示

    对于上下文窗口、是否支持图片输入、Temperature、Top P 和 Top K，用户的自定义设置优先级最高。

参数 描述

模型系列

TraeWork 为特定模型系列优化了 Prompt、超参配置等，详情参考模型系列选项详解。

以下选项 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 将使用模型服务商内置的默认值（一般为默认最优配置）。
  1. 点击 添加模型 按钮。
    TraeWork 将调用服务商的接口来检测 API 密钥是否有效：
    • 若连接成功，该模型将被添加到模型列表。
    • 若连接失败，窗口中将展示错误信息和服务商返回的日志，你可以根据这些信息排查问题。

了解更多

模型系列选项详解

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

选项 描述

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 优化了计划生成、任务拆解、子智能体协作、后台任务管理以及检索工具契约。

常用模型推荐配置速查

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

模型 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 系列
上一篇
语音讨论
下一篇
技能（Skills）
内置模型
添加自定义模型
相关限制
操作步骤
了解更多
模型系列选项详解
常用模型推荐配置速查