Trae 如何添加自定义模型？第三方 API 接入完整教程（2026 最新版）

Trae 可以接入第三方模型，前提是服务商提供 OpenAI Chat Completions 或 Anthropic Messages 其中一种协议。接入需要三项信息：API Key、API Base URL、Model ID。三者分别来自服务商控制台和服务商文档，填错任何一项都会导致添加失败或调用失败。本文的协议与参数说明来自 OpenAI 和 Anthropic 的公开 API 文档。Trae 的菜单名称和按钮位置尚未在本文撰写时核对，文中标注"待核验"的部分请以你本机的 Trae 界面为准。

一、Trae 能添加自定义模型吗？

能。只要第三方服务提供的接口与 Trae 支持的协议一致，就可以作为自定义模型添加。用户通常有以下几类需求：

• 已经持有某个服务商的 API Key，希望直接使用，不再单独购买 Trae 内置额度。
• 希望在同一个 IDE 中切换 DeepSeek、Claude、GPT、GLM、Qwen、Kimi 等不同模型，按任务选模型。
• 团队使用统一的 API 网关管理多个模型，希望编辑器里的模型与网关保持一致。

接入前准备三项信息：

二、API Key、Base URL 和 Model ID 怎么填？

三个参数各管一件事，混用会直接报错。

API Key 是调用凭证，在服务商控制台创建。它与具体的服务商绑定，不能把 A 平台的 Key 填到 B 平台的地址上。Key 只在创建时完整显示一次，丢失后需要重新生成。不要把 Key 写进代码仓库或截图公开。

API Base URL 是服务地址，不是官网首页。Trae 会在它后面拼接具体的接口路径，例如 OpenAI 协议下的 /chat/completions，Anthropic 协议下的 /v1/messages。因此，Base URL 应填到接口路径之前的那一段。是否需要带 /v1，两种协议不同，以服务商文档为准。

OpenAI 协议示例：  https://服务商域名/v1
Anthropic 协议示例：https://服务商域名

以上两行只说明格式，服务商域名是占位符，不是真实地址。

Model ID 是 API 实际调用时使用的标识，不是营销名称。同一个模型在官网可能叫"某某 Pro"，在接口里却是另一串字符。填写前请从服务商的模型列表复制 ID，并确认你的账户有该模型的调用权限。

三、Trae 添加自定义模型的操作步骤

以下步骤按通用流程写。菜单名称以本机版本为准，待核验项目已标注。

1. 打开 Trae，进入模型设置页面（入口名称：待核验）。
2. 找到添加自定义模型的入口（按钮名称：待核验）。
3. 选择与服务商一致的 API 协议：OpenAI 兼容或 Anthropic（选项文字：待核验）。
4. 填写模型显示名称。这个名称只用于 Trae 里的展示，可以自定义，建议包含服务商和模型名，便于区分。
5. 粘贴 API Key。
6. 填写 API Base URL，注意不要重复拼接接口路径。
7. 填写 Model ID，与服务商模型列表逐字符一致。
8. 上下文窗口、工具调用等高级参数：如果界面提供，按服务商对该模型的说明填写；如果没有对应选项，跳过。
9. 保存后，使用界面中的测试或发送一条简单消息验证（测试入口：待核验）。

四、OpenAI 和 Anthropic 两种协议怎么选？

先看服务商文档写的是哪种协议，再在 Trae 中选同一种。协议选错，请求路径和鉴权头都会不匹配。

以上请求路径和请求头来自两家官方 API 文档的通用约定，本次未在线逐页核验。

协议兼容不等于所有功能都兼容。服务商支持某种协议，只说明基本的请求格式一致。具体模型是否支持工具调用、流式输出、图片输入，要查该模型的说明。两种协议都支持，也不代表同一个模型两种都能用。

五、用第三方 API 网关接入：以灵眸 AI 为例

如果你已经有可用的 OpenAI 兼容或 Anthropic 兼容服务，直接按它的文档配置即可。灵眸官方文档给出了 Trae 的接入说明。本次撰写时未能在线打开该页面，下面的参数需要以文档为准。

注意两点。第一，同一个网关的 OpenAI 地址和 Anthropic 地址不能混用。第二，文档列出的模型，不一定都对你的账户开放。模型是否可用，以你的控制台显示为准。

六、添加后怎么测试？

先确认能调用，再测 Agent 功能。能回答普通问题，不代表代码生成、工具调用和流式输出都正常。

1. 确认新模型出现在 Trae 的模型列表中。
2. 切换到该模型。
3. 发送一个代码解释任务，例如解释一段 Python 代码的作用。
4. 发送下面的代码生成任务：

请使用 Python 编写一个函数，读取 CSV 文件并统计每列的缺失值数量，附上运行示例和必要注释。

成功的标准：返回内容完整，代码可以运行，示例输出与代码逻辑一致。出现以下现象，说明配置或兼容性有问题：长时间无响应、返回中途断开、只输出错误信息。

七、添加失败怎么办？

先区分错误来自哪一端。Trae 客户端的界面提示与服务商返回的 HTTP 状态码是两回事，排查时要分开看。

几点说明：429 不一定是余额不足，也可能是并发超限。404 不一定是模型不存在，更常见的是 Base URL 填错。遇到 404 先检查路径，再检查模型名。

八、怎么选接入方式？

• 已有某个服务商的 API Key：按该服务商的协议配置自定义模型。
• 不同模型使用不同协议：分别添加，每个模型选对应的协议。
• 需要同时使用多个模型：可以添加多个自定义模型，Trae 中切换即可。是否支持同时添加多个，以你本机版本为准（待核验）。
• 出现错误：依次检查 API Key、Base URL、Model ID 和协议是否匹配。

常见问题

Trae 可以接入第三方 API 吗？

可以。只要第三方服务提供 OpenAI Chat Completions 或 Anthropic Messages 协议，就能按自定义模型的方式添加。

Trae 添加自定义模型需要 API Key 吗？

需要。API Key 是调用服务商接口的凭证，在服务商的控制台创建。

Trae 支持 OpenAI 兼容接口吗？

支持与 OpenAI Chat Completions 协议一致的接口。添加时选择 OpenAI 协议，Base URL 按服务商文档填写。

Trae 可以接入 Claude API 吗？

如果服务商提供 Anthropic Messages 协议，就可以选择 Anthropic 协议接入 Claude 模型。是否支持，以本机版本的协议选项为准（待核验）。

Trae 添加模型时 Base URL 应该怎么填？

填服务商文档中的服务地址，不要填官网首页，也不要重复拼接接口路径。OpenAI 与 Anthropic 协议的 Base URL 写法不同，以文档为准。

Trae 添加模型后为什么无法调用？

最常见的原因是 Key 错误、协议选错、Base URL 多拼或少拼路径，或 Model ID 写错。按第七节的表逐项排查。

Trae 可以同时配置多个自定义模型吗？

可以添加多个，并在对话中切换。具体数量限制和入口位置，以本机版本为准（待核验）。

参考资料

• OpenAI API 参考文档（Chat Completions），https://platform.openai.com/docs/api-reference/chat ，本次撰写时未能在线核验。
• Anthropic API 文档（Messages），https://docs.claude.com/en/api/messages ，本次撰写时未能在线核验。
• Trae 官方文档，https://docs.trae.ai/ ，本次撰写时未能在线核验，Trae 相关界面描述均待核验。