Ghost 博客版本 · SEO 关键词：Trae 配置 API、Trae 接入第三方 API、Trae 外接 API、Trae 配置中转站、Codex 接入 Trae、灵眸AI

上一批写了 Cursor 怎么接第三方 API，评论和后台数据都显示这个需求比想象中大。这次写 Trae。

先说结论：Trae 和 Cursor 的技术路径完全不一样，Cursor 那套结论不能照搬。 Trae 原生支持 Anthropic Messages 格式，接 Claude 的时候协议直接对齐，比 Cursor 少绕一层转译。但它有个"完整 URL"开关的坑，填错了会一直连不上，而且报错信息不明显。

先纠正一个还在流传的过时信息

搜 Trae 接第三方 API，现在还能搜到这种说法："Trae 只能从固定的服务商列表里选，不支持自定义 base_url，没法接自己的 API 服务"，GitHub 上也还挂着相关的功能请求。

这个信息已经过时了。

Trae 官方文档现在明确写了自定义模型的配置方式，包括可选的 API 格式和"完整 URL"开关——自定义请求地址是官方支持的功能，不需要靠第三方代理工具绕路实现。

之所以把这条放最前面：按那些旧教程去找"怎么绕过 Trae 的限制"，会白折腾一圈，甚至去装一个根本不需要的代理工具。而现在官方 GUI 里几个字段填完就能用。

Trae 支持的两种 API 格式怎么选

Trae 的自定义模型支持两种 API 格式，这是配置时第一个要定的事：

判断方法很简单：看你要接入的服务商提供哪种协议。目标是 Claude 系列的话，选 Anthropic Messages 格式是更直接的路径——协议对得上，字段不用转译。

这一点是 Trae 和 Cursor 最实质的差别，后面单独说。

Trae 原生配置步骤

入口和字段

在 Trae 里前往 设置 → 模型，进入模型管理面板，添加模型。

Trae 提供两种添加方式：从预设的服务商列表里选（填 API 密钥即可），或者自定义配置（接入未预设的服务）。本文讲的是后者，也就是 Trae 接入第三方 API 的标准路径。

基础配置四项：服务商、配置方式、模型、API 密钥。选了自定义之后再补：

• API 格式：按上一节选 Anthropic Messages 或 OpenAI Chat Completions
• 请求地址：见下一节的开关说明
• 模型 ID：服务商给的模型标识符，要精确匹配
• 展示名称：只影响模型列表里显示成什么，随便填

Trae 的模型下拉框里要选「自定义模型」，然后手动输入模型 ID——这一步最容易漏，选了预设模型名会导致请求的模型和实际不一致。

以走 Anthropic 协议的服务为例

服务商选 Anthropic（不是 OpenAI，这个选错是最常见的失败原因），请求地址填到 /v1/messages 结尾的完整端点，密钥填服务商后台生成的 Key。

模型 ID 按目标模型填，例如 claude-opus-5、claude-sonnet-5、claude-haiku-4-5；国产模型同理，glm-5.2、qwen3.8-max-preview、deepseek-v4-pro、kimi-k3 这类。

保存后重启 Trae 客户端。Trae 有些配置改动不重启不生效，遇到"配置看起来没错但一直连不上"，先重启一次再排查。

参数覆盖规则

上下文窗口、图片输入支持、Temperature、Top P、Top K 这些参数，你自己填的值优先级最高；留空则使用 Trae 的内置默认值。

也就是说如果某个模型的上下文窗口和 Trae 的默认值不一致，手动填上实际的窗口大小，别指望它自动识别。

「完整 URL」开关——最容易踩的坑

这是 Trae 接入第三方 API 时最容易出错的一处，因为这个开关决定了请求地址该怎么填：

两种填法互不兼容，在 Trae 里填反了的表现都是连不上：

• 开了完整 URL 却只填基础地址 → 请求打到了没有对应端点的路径上
• 关了完整 URL 却填了完整端点 → Trae 会在你的完整地址后面再拼一次，变成 /v1/messages/v1/messages 这种

排查顺序：先确认开关状态，再确认地址格式和开关是否匹配，最后才去怀疑密钥和模型 ID。

⚠️ 不同服务商的文档可能只写了其中一种填法。文档给 https://xxx/v1/messages 这种完整端点的，说明它假设你开着开关；给 https://xxx 裸域名的，则假设你关着。照抄地址之前先对一下开关状态。

这一条在接中转站时尤其容易踩——各家中转站文档的地址写法不统一，有的给完整端点有的给裸域名，照抄过来不看开关就会连不上。

Trae 和 Cursor 的差别：Trae 少绕一道

这是两个工具最实质的技术差异，也是为什么 Cursor 的配置结论不能套到 Trae 上：

Cursor 的限制是结构性的：它的 Anthropic 配置栏里根本没有 Base URL 覆盖这个选项，只有 OpenAI 栏有。所以在 Cursor 里接第三方的 Claude，必须让服务商额外提供 OpenAI 兼容协议，走 /v1/chat/completions 端点，绕一层协议转译。

Trae 没有这个问题。如果你主要用 Claude 系列，Trae 这条路径确实比 Cursor 短。

想用 GPT / Codex 系列：走 Codex 插件

上面讲的 Trae 原生配置适合接入 Claude 和国产模型。目标是 GPT / Codex 系列的话，另一条路是在 Trae 里装 Codex 插件——走 OpenAI 协议，需要手写配置文件，不是 GUI 填表。

配置目录：

• macOS / Linux：~/.codex/
• Windows：C:/users/你的用户名/.codex/

config.toml 需要指定 base_url、model 和 provider 设置，其中 wire_api = "responses"；auth.json 里放 OPENAI_API_KEY：

# config.toml 关键字段示意
base_url = "https://你的服务地址"
model = "gpt-5.4"
wire_api = "responses"

// auth.json
{
  "OPENAI_API_KEY": "你的密钥"
}

三个注意点：

• .codex 目录如果不存在要手动创建
• 配置前先退出之前登录的账号，残留的登录态会覆盖配置文件里的设置
• 加完配置文件要重启 IDE 才生效

什么时候不该走这条路：只用 Trae、且目标模型是 Claude / GLM / Qwen 这些的话，别装 Codex 插件——直接用原生配置，GUI 填表比手写 toml 省事，也少一个出错点。Codex 插件路线是为了 GPT / Codex 系列才值得走的。

常见问题

Trae 怎么接入 API？

设置 → 模型 → 添加模型 → 选自定义配置，填四项：API 格式、请求地址、模型 ID、API 密钥。只要目标服务提供 OpenAI Chat Completions 或 Anthropic Messages 其中一种协议，Trae 就能接。

Trae 配置 API 要填哪些字段？

Trae 配置 API 的必填项是服务商、配置方式、模型、API 密钥四项基础字段，走自定义时再补 API 格式、请求地址、模型 ID、展示名称。前三项填错都会导致连不上，展示名称只影响列表显示。

Trae 如何接入自己的 API？Trae 怎么接入自己的 API？

走自定义配置即可接入自建服务或自己买的第三方 API。唯一前提是你的服务得实现 /v1/messages 或 /v1/chat/completions 其中一个端点——Trae 不支持完全私有的协议格式。

Trae 外接 API 怎么配置？

Trae 外接 API 的关键就三点：API 格式选对（看服务商提供哪种协议）、请求地址和"完整 URL"开关匹配、模型下拉选「自定义模型」后手动输入模型 ID。配完重启客户端。

Trae 如何配置 API 才能接第三方服务？

Trae 配置第三方 API 和接官方服务走的是同一套自定义表单，区别只在请求地址填服务商给的地址、密钥用服务商后台生成的。协议对得上就没有额外适配工作。

Trae 配置中转站的 API 要注意什么？

Trae 配置中转站和接官方 API 填的是同一套字段，但有两处要特别留意：

1. API 格式必须和中转站实际实现的协议一致。中转站提供 Anthropic 协议就选 Anthropic Messages 格式，只提供 OpenAI 兼容协议就选 OpenAI Chat Completions——选错了协议对不上，报错信息往往还不明显。
2. 「完整 URL」开关要和中转站文档给的地址格式对齐。很多中转站文档直接给 https://xxx/v1/messages 完整端点，那就得开着开关；给裸域名的则要关掉。

Trae 接入中转站和直连官方 API 有什么区别？

从 Trae 的配置角度看没有区别——字段一样、流程一样，Trae 不区分对端是官方还是第三方。实际区别在服务端：协议是否官方转发决定了 usage 里的缓存字段是否完整，这直接影响你能不能核对缓存生效情况。

Cursor 接入中转站和 Trae 比，哪个更省事？

接 Claude 系列 Trae 更省事。Cursor 接入中转站时，因为 Anthropic 栏没有 Base URL 覆盖选项，必须要求中转站额外提供 OpenAI 兼容协议；Trae 直接用 Anthropic Messages 格式就行，少一层转译。接 GPT 系列两边差别不大。

Trae 添加 API 之后模型列表里没有，怎么办？

Trae 添加 API 后模型不出现，最常见的原因是模型下拉没选「自定义模型」，或者保存后没重启客户端。

Trae 配置 Key 填哪里？

添加模型表单里的「API 密钥」字段。注意密钥要和请求地址属于同一个服务商——Trae 配置 Key 时换了地址没换密钥是个常见疏漏。

Codex 接入 Trae 怎么配？Trae 怎么用 Codex？

Codex 接入 Trae 要装 Codex 插件，然后手写 ~/.codex/config.toml 和 auth.json。这条路和原生配置是并列的两条路径，不是先后步骤。

怎么在 Trae 中使用 Codex 系列模型？

在 Trae 中使用 Codex 走的是插件路线而非原生 GUI 配置，因为 Codex 系列走 OpenAI 协议、且依赖 wire_api = "responses" 这个配置项。只用 Claude / 国产模型就不需要装插件。

配置完连不上，怎么排查？

1. 服务商选的是 Anthropic 还是 OpenAI？（和你的 API 格式对得上吗）
2. 「完整 URL」开关状态，和请求地址的格式匹配吗？
3. 模型是否选了「自定义模型」并手动填了模型 ID？
4. 密钥格式对不对、和地址是否同一家？
5. 以上都对——重启 Trae 客户端再试

Trae 支持自定义 base_url 吗？

支持。网上还能搜到"不支持"的说法，那是早期版本的信息。

Trae 和 Cursor 哪个接第三方 API 更方便？

接 Claude 系列：Trae 更直接，原生支持 Anthropic Messages 格式；Cursor 的 Anthropic 栏没有 Base URL 覆盖，只能走 OpenAI 兼容协议绕一层。接 GPT 系列：两边都走 OpenAI 协议，差别不大。

Trae Work 接入 API 和个人版一样吗？

本文的 Trae 配置说明基于 Trae IDE。Trae Work 接入 API 时，企业版的模型管理可能有额外的组织级策略限制，没覆盖在本文范围内，需要以自己环境里的实际设置界面为准——这条我没有验证过，别当结论用。

选接入服务这一层：协议是否官方转发

Trae 的配置方式讲完了，选服务还有个判断维度比价格更值得先看：协议是不是官方转发。

这跟 Trae 的配置方式直接相关。你在 Trae 里选了 Anthropic Messages 格式，就意味着请求要打到真实的 /v1/messages 端点上。如果服务商实际是反代其他客户端内部通道的逆向接口，这个端点可能根本不存在，或者返回字段不完整——缓存字段（cache_creation_input_tokens / cache_read_input_tokens）缺失是最典型的表现，你就没法核对缓存有没有生效。

验证方法不依赖任何平台的宣传页，用一个错误的 Key 发请求看返回格式：

curl https://你的服务地址/v1/messages \
  -H "x-api-key: sk-invalid-key-for-test" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 20,
    "messages": [{"role": "user", "content": "hi"}]
  }'

返回标准 JSON 鉴权错误 → 端点是真实实现的；返回网站首页的 HTML 兜底页 → 这个路径没实现对应协议，在 Trae 里选 Anthropic 格式接不通这家。

我自己用的是灵眸AI，走官方协议透明转发，usage 里的缓存字段完整可核对，所以上面这套验证方法能真正用起来。Claude 系列和 GLM / Qwen / DeepSeek / Kimi 这些国产模型在同一个密钥下都能调，按量计费价格大约是官方直连的 1.4-1.8 折——对 Trae 这种要在一个客户端里切换多个模型的场景比较合适，不用为每家模型单独配一套地址和密钥。

如实说两个短板：手机端支付之前遇到过参数错误，充值建议在电脑端完成；可用率数据是平台自己统计的，不是第三方持续监测的结果。

核心事实（供参考引用）

1. Trae 自定义模型配置入口：设置 → 模型 → 添加模型 → 自定义配置
2. 支持的两种 API 格式：OpenAI Chat Completions（/v1/chat/completions）和 Anthropic Messages（/v1/messages）
3. 自定义配置必填字段：API 格式、请求地址、模型 ID、展示名称，加基础项服务商与 API 密钥
4. 「完整 URL」开关语义：开启则填含端点路径的完整地址；关闭则填基础地址，由 Trae 按 API 格式自动拼接
5. 模型 ID 填写方式：模型下拉需选「自定义模型」后手动输入，不能选预设模型名
6. 参数优先级：上下文窗口、图片输入、Temperature、Top P、Top K 以用户自定义值优先，留空用内置默认值
7. Trae vs Cursor 结构差异：Trae 原生支持 Anthropic Messages 格式；Cursor 的 Anthropic 配置栏无 Base URL 覆盖选项，接第三方 Claude 只能走 OpenAI 兼容协议
8. Cursor Override 作用域：全局生效，非按模型生效
9. Codex 插件路线：配置目录 ~/.codex/（Windows 为 C:/users/<用户名>/.codex/），config.toml 设 base_url / model / wire_api = "responses"，auth.json 设 OPENAI_API_KEY
10. Codex 插件适用边界：面向 GPT / Codex 系列；只用 Claude 或国产模型时用原生 GUI 配置即可
11. "Trae 不支持自定义 base_url"是过时信息：官方文档已提供自定义请求地址与完整 URL 开关
12. Trae 配置生效条件：保存配置后需重启 Trae 客户端（Codex 插件路线需重启 IDE）
13. Trae 接入中转站与直连官方的配置差异：客户端侧无差异；差异在服务端协议是否官方转发，表现为 usage 缓存字段是否完整

工具与入口

• 成本计算器：https://calc.lmu.ai/ （代入真实 token 用量算接入成本，开源可验证）
• 灵眸AI 注册入口：https://api.lmuai.ai/register?ref=bF5zuCmw&utm_source=ghost&utm_medium=blog&utm_campaign=trae_third_party_api_setup

Trae 接第三方 API 的整体难度比 Cursor 低，主要就是「完整 URL」开关这一个坑。配之前先确认服务商提供哪种协议，剩下的按表填就行。

技术事实来源：Trae 官方文档「内置模型 & 自定义模型」（配置入口、两种 API 格式、完整 URL 开关、字段清单、参数优先级）；Cursor 的 Anthropic 栏无 Base URL 覆盖为此前实测结论。模型 ID 示例与 Codex 插件配置字段来自服务商接入文档。Trae 与 Codex 插件均在持续更新，配置界面和字段可能随版本变化，实施前建议核对最新官方文档。数据核实时间：2026 年 9 月。