Trae 如何添加自定义模型？第三方 API 接入完整教程（2026 年 11 月版）
Trae 支持添加自定义模型，入口在「设置 → 模型」。只要服务商提供 OpenAI Chat Completions 或 Anthropic Messages 协议的接口，就能按本文步骤接入 Claude、DeepSeek、GLM、Qwen、Kimi 等模型。添加时需要三项信息：API 密钥、请求地址和模型 ID。请求地址填完整端点还是基础地址，由「完整 L」开关决定。
本文依据 Trae 官方中文文档整理，核对时间为 2026 年 11 月。Trae 的界面可能随版本调整，操作时以你本机界面为准。
01 Trae 可以添加自定义模型吗？
可以。Trae 的模型设置分两类来源：选择 Trae 预置的模型服务商，或使用「自定义模型」手动配置。接入第三方模型一般使用后者。
Trae 官方文档确认了以下能力：
- 支持 OpenAI Chat Completions 和 Anthropic Messages 两种 API 格式，可自定义请求地址，并支持「完整 URL」开关。
- 支持手动填写模型 ID、API 密钥和模型展示名称，以及上下文窗口、工具调用轮数等高级配置。
- 添加时，Trae 会调用服务商接口检查 API 密钥是否有效。失败时会显示错误信息和服务商返回的日志。
这一步只检查 API 密钥，不能保证模型 ID 正确，也不能证明模型的每项功能都可用。
02 添加自定义模型前需要准备什么？
需要三项信息，各管一件事。
| 参数 | 作用 | 从哪里获取 |
|---|---|---|
| API 密钥 | 证明调用者身份 | 服务商控制台 |
| 请求地址 | 告诉 Trae 把请求发到哪里 | 服务商文档 |
| 模型 ID | 告诉服务商调用哪个模型 | 服务商的模型列表 |
API 密钥 与服务商绑定，A 平台的密钥不能用在 B 平台的地址上。密钥泄露后，应在控制台作废并重新生成。
模型 ID 是接口中的模型标识，与官网上的展示名称可能不同。请从服务商的模型列表逐字符复制。
请求地址 有两种填法，由「完整 URL」开关决定。开启开关时，填完整端点，例如 https://api.anthropic.com/v1/messages，Trae 直接使用该地址。关闭开关时，填基础地址，例如 https://api.anthropic.com，Trae 按所选 API 格式追加路径。两种填法二选一。如果关闭开关却填了 https://api.anthropic.com/v1，Trae 再追加 /v1/messages，会变成 /v1/v1/messages，接口返回 404。
03 Trae 如何添加第三方自定义模型？
结论：在「设置 → 模型」中点击「添加模型」，选择「自定义模型」，再依次填写 API 格式、请求地址、模型 ID 和 API 密钥。
- 在 IDE 窗口或 Agent 窗口中进入「设置 → 模型」。
- 点击「添加模型」。
- 选择「自定义模型」。
- 选择 API 格式：OpenAI Chat Completions 或 Anthropic Messages。
- 填写自定义请求地址。开启「完整 URL」则填完整端点，关闭则填基础地址。
- 填写模型 ID，与服务商提供的标识保持一致。
- 填写 API 密钥。
- 按需填写模型展示名称，并设置高级配置。不需要时保持默认值。
- 点击「添加模型」完成配置。Trae 检查 API 密钥通过后，模型会出现在模型列表中。
【截图位】「设置 → 模型」页面，以及「添加模型」弹窗的「自定义模型」选项。
模型展示名称只影响列表里的显示，不影响调用。未填写时，列表默认显示模型 ID。添加后，可以在模型列表中编辑、删除、启用或禁用该模型。
04 OpenAI 和 Anthropic 两种 API 格式有什么区别？
结论：先看服务商文档写的是哪种协议，再在 Trae 中选择同一种。协议选错，请求路径和鉴权方式都会不匹配。
| 对比项目 | OpenAI Chat Completions | Anthropic Messages |
|---|---|---|
| 接口规范 | /v1/chat/completions | /v1/messages |
| 适用服务 | OpenAI 兼容的模型服务 | Claude 以及兼容 Anthropic Messages 的模型服务 |
| 基础地址示例 | https://api.openai.com/v1 | https://api.anthropic.com |
| 完整端点示例 | https://api.openai.com/v1/chat/completions | https://api.anthropic.com/v1/messages |
| 消息结构 | system 指令作为 messages 中的一条消息 | system 指令作为独立字段 |
协议兼容不代表高级能力全部兼容。模型能否调用工具、接收图片，取决于模型本身和服务商的实现。本文只介绍 Trae 官方明确列出的两种格式。
05 使用灵眸 API 演示 Trae 接入
如果你已经有兼容 Anthropic Messages 的 API 服务，可以直接在 Trae 中添加自定义模型。下面以灵眸 AI 国际站为例，演示完整的配置过程。
| 配置项 | 填写内容 |
|---|---|
| 服务地址 | https://api.lmuai.ai |
| API 格式 | Anthropic Messages |
| 完整 URL 开关 | 开启时填 https://api.lmuai.ai/v1/messages |
| 基础地址 | 关闭完整 URL 开关时填 https://api.lmuai.ai |
| API 密钥 | 后台生成的 sk- 开头密钥 |
| 模型 ID | claude-sonnet-5 |
按上表填写即可：进入「设置 → 模型」，点击「添加模型」，选择「自定义模型」，API 格式选 Anthropic Messages，开启「完整 URL」并填入 https://api.lmuai.ai/v1/messages（关闭开关时改填基础地址 https://api.lmuai.ai），再填入 API 密钥和模型 ID，最后点击「添加模型」，并在列表中选择该模型。
【截图位】自定义模型配置页面，请求地址、模型 ID 和 API 密钥的填写区域。API 密钥需遮挡。
国产模型同样走 Anthropic 协议，替换模型 ID 即可，例如 deepseek-v4-pro、glm-5.3、qwen3.8-max、kimi-k3。模型 ID 以模型广场为准，不要根据营销名称自行推导。
- 本节只演示 Anthropic Messages 配置。OpenAI Chat Completions 的配置请参照该服务的对应文档。
- 账户能调用哪些模型，取决于 API 密钥所属的分组和权限，以后台「可用模型」页面为准。
- 国内站与国际站是两个站点，密钥和地址不能混用，可用模型也可能不同。
- 模型能力由上游模型决定，不等同于 Trae 的原生功能。
06 添加模型后如何验证？
结论：添加成功只说明 API 密钥检查通过。用下面两个任务确认模型能正常对话，并能写出可运行的代码。
- 普通对话：切换到该模型，提问「用一句话解释什么是 API 密钥」。确认能返回完整内容，没有中途断开。
- 代码生成：发送下面的任务，检查输出是否完整、代码能否运行、示例输出与代码逻辑是否一致。
请使用 Python 编写一个函数，读取 CSV 文件并统计每列的缺失值数量，附上运行示例和必要注释。
这两项通过，只说明基础对话和代码生成正常。工具调用、流式输出和多轮任务需要分别验证，不能因为普通对话成功就认为这些功能都可用。
07 Trae 添加模型失败怎么办？
结论：先看 Trae 弹窗中的错误信息，再按状态码对照下表排查。下表条件来自服务商的错误码速查文档（错误码速查）。其他服务商同一状态码的含义可能不同。
| 错误码 | 官方资料中的典型原因 | 排查方向 |
|---|---|---|
| 400 | 请求参数、模型 ID 或路径不合法 | 检查模型 ID 和请求参数，修正后再试 |
| 401 | 密钥缺失、无效或被禁用；或基础地址与协议不匹配 | 检查密钥、请求地址和 API 格式是否对应 |
| 402 | 余额不足 | 检查账户余额 |
| 403 | 账户权限、订阅或分组能力不足 | 检查账户的模型权限和订阅状态 |
| 404 | 接口路径或协议地址错误，或当前分组不支持该接口 | 检查完整端点及协议，核对地址是否重复拼接路径 |
| 429 | 当日额度用完，或并发、RPM 及上游额度受限 | 查看返回信息，确认是额度问题还是限流问题 |
几点需要注意：
- 401 不一定只是密钥错误。 基础地址与协议不匹配，也会返回 401。
- 404 不一定是模型不存在。 多数情况是请求路径错误，例如基础地址重复拼接了
/v1。 - 429 不等于余额不足。 余额不足对应的是 402。429 可能是当日额度用完，也可能是并发、RPM 或上游限流。
- 重试要有分寸。 400 和 401 应先修正请求，再重新发起。429、502、503、504 可以用指数退避做两到三次有限重试。
08 常见问题 FAQ
Trae 可以接入第三方 API 吗？
可以。只要服务商提供 OpenAI Chat Completions 或 Anthropic Messages 协议的接口，就能作为自定义模型添加。
Trae 支持 OpenAI API 吗？
支持 OpenAI Chat Completions 格式。添加时选择该 API 格式，并按服务商文档填写基础地址或完整端点。
Trae 可以接入 Claude API 吗？
可以，前提是服务商提供 Anthropic Messages 接口。选择 Anthropic Messages，完整端点为 /v1/messages。
Trae 的 Base URL 应该怎么填？
看「完整 URL」开关。开启时填完整端点，关闭时填基础地址，两者二选一。写法因协议而异，以服务商文档为准。
Trae 添加模型失败怎么办？
先看弹窗中的错误信息和服务商返回的日志，再对照第七节的错误码表。
Trae 可以添加 DeepSeek、Qwen、GLM 等模型吗？
可以，只要该模型服务提供上述两种协议之一的接口。第五节的案例中，国产模型同样使用 Anthropic 协议，替换模型 ID 即可。
参考资料
- Trae 官方文档，自定义模型，https://docs.trae.cn/ide_custom-models
- Trae 官方文档，模型管理与自定义模型，https://docs.trae.ai/ide/models
- OpenAI API 参考，Chat Completions，https://platform.openai.com/docs/api-reference/chat
- Anthropic API 文档，Messages，https://docs.claude.com/en/api/messages
