TRAE 国际版接入 AI Gateway

本文面向第一次使用 TRAE、第一次配置自定义模型的用户。请从第一步开始按顺序操作。每一步都会说明在哪里操作、填写什么、正常现象、下一步和异常处理。

本文以 macOS 和 TRAE 国际版为例。示例 AI Gateway Base URL：

<https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1>

如果你的 AI Gateway 不同，只需要替换 Base URL、API Key 和模型 ID。不要把真实 API Key 发到聊天、工单、截图、Git 仓库或公开网页。

官方入口：

• TRAE 国际版下载：https://www.trae.ai/download
• TRAE 更新记录：https://www.trae.ai/changelog

0. 最终要完成什么

完整流程：

确认安装的是 TRAE 国际版 ↓ 准备 Base URL、API Key 和模型 ID ↓ 按协议查询实时模型目录 ↓ 用标准 curl 验证模型 ↓ 在 TRAE 中添加自定义模型 ↓ 通过 TRAE 连通性测试 ↓ 打开项目并用 Agent 实际发送消息

真正成功必须同时满足：

1. 当前协议的模型目录能看到模型；
2. 同协议标准

   curl

   curl
   返回 HTTP 200；

3. curl

   curl
   响应中有最终模型文本；
4. TRAE 的连通性测试成功；
5. TRAE Agent 选择该自定义模型后返回实际文本。

只看到模型名称、模型出现在设置列表或者配置保存成功，都不能单独说明模型可用。

本文当前实测基线：

TRAE 国际版：3.5.87 系统：macOS，Apple Silicon arm64 OpenAI Chat 实际验证模型：openai/gpt-5.5 TRAE 实际返回：TRAE relay 正常

1. 先确认使用的是 TRAE 国际版

TRAE 中国版和国际版是两个不同的应用。界面语言不能用来判断版本，因为国际版也可以显示简体中文。

Trae CN.app

Trae.app

cn.trae.app

com.trae.app

trae.com.cn

trae.ai

1.1 在 Terminal 检查国际版

按

Command + Space

Terminal

如果 TRAE 安装在当前用户的 Applications 目录，执行：

TRAE_APP="$HOME/Applications/Trae.app" if [ -d "$TRAE_APP" ]; then defaults read "$TRAE_APP/Contents/Info" CFBundleIdentifier defaults read "$TRAE_APP/Contents/Info" CFBundleShortVersionString else echo '没有在 ~/Applications 找到 Trae.app' fi

国际版的第一行必须是：

com.trae.app

如果应用安装在系统

/Applications

defaults read "/Applications/Trae.app/Contents/Info" CFBundleIdentifier defaults read "/Applications/Trae.app/Contents/Info" CFBundleShortVersionString

1.2 如果当前是中国版

先退出中国版 TRAE，再从国际版官网下载。不要直接删除用户数据目录，避免丢失配置或项目状态。

国际版下载地址：

<https://www.trae.ai/download>

安装完成后重新执行第 1.1 节，确认 Bundle ID 是

com.trae.app

官方当前要求 TRAE IDE 使用 macOS 12 或更高版本。Apple Silicon 设备选择

macOS (Apple Silicon)

1.3 登录国际版 TRAE

启动

Trae.app

登录后建议先确认：

1. TRAE 主界面可以正常打开；
2. 左下角账号菜单能显示当前账号；
3. 设置中可以进入

   Models

   Models
   或“模型”页面；
4. 页面中存在

   Add Custom Model

   Add Custom Model
   、

   Custom Models

   Custom Models
   或对应的中文入口。

TRAE 内置模型会受账号、地区、套餐和灰度发布影响。不同用户看到的内置模型数量不一致是正常现象，不代表自定义模型配置失败。

1.4 检查 Terminal 工具

后续排查会使用

curl

jq

执行：

command -v curl command -v jq

正常情况下会分别输出命令路径，例如：

/usr/bin/curl /opt/homebrew/bin/jq

macOS 默认带有

curl

jq

brew install jq

如果没有 Homebrew，也可以先访问 https://brew.sh 按官网说明安装，或者在后续命令中暂时删除管道末尾的

| jq

1.5 是否需要 VPN 或代理

本文实测环境中，TRAE 国际版官网、中转站 Base URL 和模型接口均可直接访问，不需要 VPN。

只有在以下情况出现时，才需要检查本地网络、公司代理或 VPN：

• trae.ai

  trae.ai
  下载页面长时间无法打开；

• curl

  curl
  报

  Could not resolve host

  Could not resolve host
  ；

• curl

  curl
  报连接超时，但同一 API Key 在其他网络正常；
• TRAE 可以启动，但登录页面或账号服务无法加载。

是否需要 VPN 取决于用户所在网络，不取决于 OpenAI 或 Anthropic 协议。不要把 HTTP 401、403、404、422、429 或 502 误判成 VPN 问题；这些状态码通常表示鉴权、路径、参数、限流或上游模型问题。

**下一步：**确认国际版可以启动和登录，且

curl

2. 准备中转站信息

2.1 Base URL

本文示例 Base URL：

<https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1>

这个地址已经包含

/v1

/v1/v1

TRAE 的 Anthropic 配置有独立的路径拼接规则，不能直接照抄 OpenAI 配置。第 8 节会给出正确写法。

2.2 API Key

请到 AI Gateway 后台创建 API Key，并确认：

• API Key 没有过期；
• API Key 有目标模型调用权限；
• API Key 与 Base URL 属于同一个环境；
• 复制时没有多余空格或换行；
• 没有把 API Key 发送到公开聊天或截图中。

2.3 模型 ID

模型 ID 必须从当前协议的

/models

正确示例：

openai/gpt-5.5 anthropic/claude-opus-5 anthropic/claude-sonnet-4.6

错误示例：

gpt-5.5 anthropic/claude-opus-4-8 anthropic/claude-sonnet-4-6

模型 ID 是路由键。不要省略前缀，不要自行修改点号、连字符或版本号。

3. 先理解 TRAE 支持哪些协议

TRAE 国际版

3.5.87

/chat/completions

Authorization: Bearer API_KEY

/v1/messages

x-api-key

anthropic-version

/responses

Authorization: Bearer API_KEY

3.1 模型名称不会自动选择协议

以下模型 ID 中的前缀只是名称的一部分：

openai/ anthropic/ deepseek/ qwen/

TRAE 不会因为看到

anthropic/

例如：

anthropic/claude-opus-5 + OpenAI Chat Completions = 协议错误，当前没有 OpenAI Chat 上游 anthropic/claude-opus-5 + Anthropic Messages = 正确组合

3.2 TRAE 不支持 OpenAI Responses 自定义协议

一个模型在

/responses

因此：

• Chat Completions 成功的模型可以按 OpenAI 格式添加；
• Anthropic Messages 成功的模型可以按 Anthropic 格式添加；
• 只支持 Responses、不支持 Chat Completions 的模型不能直接接入 TRAE 自定义模型；
• Codex CLI 的 Responses 配置不能直接复制到 TRAE。

3.3 TRAE 会自动追加请求路径

关闭“完整 URL”时，TRAE 会自动拼接：

OpenAI Chat Completions → 追加 /chat/completions Anthropic Messages → 追加 /v1/messages

这是整个配置中最容易出错的地方。

4. 在当前 Terminal 安全输入 API Key

不要把 API Key 直接写进命令历史。在同一个 Terminal 执行：

export RELAY_BASE_URL='https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1' read -s "RELAY_API_KEY?请粘贴 AI Gateway API Key，然后按回车：" echo

粘贴 API Key 时屏幕不显示字符是正常的。

只检查是否已经载入，不显示 API Key：

if [ -n "$RELAY_API_KEY" ]; then echo 'API Key 已载入当前 Terminal' else echo 'API Key 为空，请重新输入' fi

正常返回：

API Key 已载入当前 Terminal

关闭 Terminal 后变量会消失，所以完成测试前不要关闭当前窗口。

**下一步：**进入第 5 节检查网络和实时模型目录。

5. 检查网络和实时模型目录

TRAE 自定义配置不会自动导入中转站的全部模型。必须先在 Terminal 查询目录，再逐个添加模型 ID。

5.1 检查 OpenAI 目录

执行：

curl -sS -o /tmp/trae-relay-openai-models.json \ -w 'HTTP %{http_code}\n' \ "$RELAY_BASE_URL/models" \ -H "Authorization: Bearer $RELAY_API_KEY" jq -r '.data[]?.id' /tmp/trae-relay-openai-models.json

当前示例中转站在 2026-08-18 返回 11 个模型：

qwen/qwen3.6-flash deepseek/deepseek-v4-flash deepseek/deepseek-v4-pro openai/gpt-5.4 openai/gpt-5.5 openai/codex-auto-review openai/gpt-5.5-openai-compact openai/gpt-5.4-mini openai/gpt-5.6-sol openai/gpt-5.6-terra openai/gpt-5.6-luna

以客户 Terminal 实际返回为准。目录可能随账号、权限和上游状态变化。

5.2 检查 Anthropic 目录

执行：

curl -sS -o /tmp/trae-relay-anthropic-models.json \ -w 'HTTP %{http_code}\n' \ "$RELAY_BASE_URL/models" \ -H "x-api-key: $RELAY_API_KEY" \ -H 'anthropic-version: 2023-06-01' jq -r '.data[]?.id' /tmp/trae-relay-anthropic-models.json

当前示例中转站在 2026-08-18 返回 8 个模型：

qwen/qwen3.6-flash deepseek/deepseek-v4-flash deepseek/deepseek-v4-pro anthropic/claude-sonnet-4.6 anthropic/claude-haiku-4.5 anthropic/claude-sonnet-5 anthropic/claude-opus-4.8 anthropic/claude-opus-5

5.3 为什么同一个

/models

/models

返回两份列表

中转站会根据请求头识别协议视图：

Authorization: Bearer → OpenAI 目录 x-api-key + anthropic-version → Anthropic 目录

当前两份目录是：

OpenAI：11 个 Anthropic：8 个 重叠：Qwen 1 个 + DeepSeek 2 个 唯一模型 ID：16 个

目录可见只表示当前 Token 在该协议视图中能看到模型，不代表实际调用一定成功。

5.4 网络和状态码判断

/gateway/v1

如果能返回 200、401 或 403，说明请求已经到达服务器，通常不需要 VPN。只有出现 DNS 解析失败、连接超时或无法连接时，再检查代理或 VPN。

6. 用标准 curl 验证模型

不要直接把整个目录全部添加到 TRAE。先选择一个模型做基线验证。

6.1 验证 OpenAI Chat Completions

选择模型：

export RELAY_MODEL='openai/gpt-5.5'

执行：

curl -sS -o /tmp/trae-openai-test.json \ -w 'HTTP %{http_code}\n' \ "$RELAY_BASE_URL/chat/completions" \ -H "Authorization: Bearer $RELAY_API_KEY" \ -H 'Content-Type: application/json' \ -d "$(jq -cn \ --arg model "$RELAY_MODEL" \ '{model:$model,max_tokens:256,messages:[{role:"user",content:"请只回复：OpenAI 测试成功"}]}')" jq -r '.choices[0].message.content // .error.message // "未找到最终文本，请查看完整响应"' \ /tmp/trae-openai-test.json

成功时看到：

HTTP 200 OpenAI 测试成功

6.2 验证 Anthropic Messages

选择模型：

export RELAY_MODEL='anthropic/claude-opus-5'

执行：

curl -sS -o /tmp/trae-anthropic-test.json \ -w 'HTTP %{http_code}\n' \ "$RELAY_BASE_URL/messages" \ -H "x-api-key: $RELAY_API_KEY" \ -H 'anthropic-version: 2023-06-01' \ -H 'Content-Type: application/json' \ -d "$(jq -cn \ --arg model "$RELAY_MODEL" \ '{model:$model,max_tokens:256,messages:[{role:"user",content:"请只回复：Anthropic 测试成功"}]}')" jq -r '([.content[]? | select(.type=="text") | .text] | join("\n")) as $text | if ($text | length) > 0 then $text else (.error.message // "未找到最终文本，请查看完整响应") end' \ /tmp/trae-anthropic-test.json

成功时看到：

HTTP 200 Anthropic 测试成功

6.3 HTTP 200 但没有最终文字

部分推理模型会先输出 thinking 或 reasoning。如果输出预算太小，可能只有思考内容，没有最终文本。

把：

max_tokens: 256

提高为：

max_tokens: 1024

或：

max_tokens: 4096

成功标准必须同时包括 HTTP 200、正常结束状态和最终文本。

**下一步：**标准

curl

7. 在 TRAE 配置 OpenAI Chat 模型

本文第一次建议配置：

openai/gpt-5.5

7.1 打开模型设置

在 TRAE 国际版中：

右上角设置 → 模型 → 添加模型 → 自定义模型

不要选择 TRAE 内置的 OpenAI 服务商预设。接入自有中转站时选择“自定义模型”，才能填写自己的请求地址。

7.2 填写 OpenAI 配置

填写：

OpenAI Chat Completions 格式

https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1

openai/gpt-5.5

关闭“完整 URL”时，TRAE 会自动追加：

/chat/completions

最终请求地址是：

<https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/chat/completions>

不要把请求地址写成：

<https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/chat/completions/chat/completions>

7.3 使用“完整 URL”的替代写法

也可以打开“完整 URL”，直接填写：

<https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/chat/completions>

打开后 TRAE 不再自动追加路径。

两种写法只能选一种，不要同时手动填写完整端点又让 TRAE 自动追加。

7.4 点击“添加模型”

点击后 TRAE 会发起一次真实连通性请求，消耗少量 Token。

成功时：

• 弹窗关闭；
• 自定义模型出现在模型列表；
• 模型开关可以启用；
• 日志中记录连接测试成功。

这一步只表示连通性测试成功，还需要第 9 节的 Agent 实际消息验证。

8. 在 TRAE 配置 Anthropic Messages 模型

本文示例模型：

anthropic/claude-opus-5

8.1 推荐方式：使用完整 URL

在 TRAE 中：

设置 → 模型 → 添加模型 → 自定义模型

填写：

Anthropic Messages 格式

https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/messages

anthropic/claude-opus-5

推荐使用完整 URL，是为了避免

/v1

8.2 关闭“完整 URL”时的正确写法

如果关闭“完整 URL”，TRAE 会自动追加：

/v1/messages

因此基础地址只能填写到：

<https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway>

最终地址才会是：

<https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/messages>

8.3 最常见的错误写法

关闭“完整 URL”，但仍填写：

<https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1>

TRAE 会自动拼成：

<https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/v1/messages>

这个地址是错误的，通常会返回 404 或连接测试失败。

8.4 Anthropic 模型 ID 必须保留完整前缀

正确：

anthropic/claude-opus-5 anthropic/claude-opus-4.8 anthropic/claude-sonnet-4.6

错误：

claude-opus-5 anthropic/claude-opus-4-8 anthropic/claude-sonnet-4-6

连通性测试成功后，继续第 9 节做 Agent 实际验证。

9. 用 TRAE Agent 实际发送消息

连通性测试成功不等于 Agent 可用。必须发送真实消息。

9.1 打开项目文件夹

TRAE Agent 需要项目上下文。点击：

打开文件夹

可以打开已有代码项目，也可以新建一个空文件夹进行测试。

如果没有打开项目，TRAE 可能只提示：

请先打开文件夹以保存项目中的文件

这不是模型连接失败。打开文件夹后再发送消息。

9.2 关闭 Auto Mode

如果模型选择器显示

Auto

9.3 选择自定义模型

在 Agent 输入框底部打开模型选择器，选择：

openai/gpt-5.5

或你刚刚添加的 Anthropic 模型。

确认输入框底部显示的是自定义模型名称，而不是

Auto

GPT-5.4

9.4 发送最小测试消息

OpenAI 测试：

请只回复：TRAE relay 正常

Anthropic 测试：

请只回复：TRAE Claude 正常

成功标准：

1. 用户消息出现在会话中；
2. Agent 结束分析状态；
3. Agent 返回预期文本；
4. 没有 401、403、404、502 或上游错误；
5. 当前模型选择器仍显示目标自定义模型。

当前已完成的 TRAE 实测：

协议：OpenAI Chat Completions 模型：openai/gpt-5.5 连通性测试：成功 Agent 实际请求：成功 返回文本：TRAE relay 正常 日志状态：Success，hasText=true

10. 当前模型清单和验证状态

以下结论来自 2026-08-17 至 2026-08-18 同一中转站和同一测试账号。模型目录和上游状态可能变化，官网应显示最近检测时间。

qwen/qwen3.6-flash

deepseek/deepseek-v4-flash

deepseek/deepseek-v4-pro

openai/gpt-5.4

openai/gpt-5.5

openai/codex-auto-review

openai/gpt-5.4-mini

openai/gpt-5.6-sol

openai/gpt-5.6-terra

openai/gpt-5.6-luna

openai/gpt-5.5-openai-compact

anthropic/claude-haiku-4.5

anthropic/claude-opus-4.8

anthropic/claude-opus-5

anthropic/claude-sonnet-4.6

anthropic/claude-sonnet-5

“无上游”表示该协议没有对应路由，不代表模型在正确协议下不可用。

“待逐项验证”表示标准

curl

11. TRAE 内置模型和服务商预设

本机 TRAE 国际版

3.5.87

GPT-5.4 GPT-5.2 Seed-2.1-Turbo MiniMax-M3 MiniMax-M2.7 Kimi-K2.5 Gemini-3.1-Pro-Preview Gemini-3-Flash-Preview

内置模型由 TRAE 账号、地区、套餐和灰度配置决定，可能随服务端更新变化。

“添加模型”页面还会显示 OpenAI、Anthropic、Google、DeepSeek、xAI、OpenRouter、AWS、Azure OpenAI、Vercel AI Gateway、阿里云、火山引擎、腾讯云、硅基流动等服务商预设。

必须区分：

内置模型 → TRAE 提供和计费 服务商预设 → 按该服务商官方接口配置 自定义模型 → 填写客户自己的中转站地址和 API Key

服务商名称出现在 TRAE 中，不代表该服务商的全部模型都可以通过当前中转站使用。

12. TRAE 的功能限制

12.1 不会自动导入完整 Model List

TRAE 自定义模型需要逐个添加模型 ID。一个目录返回 11 个模型，不会自动生成 11 条配置。

建议第一次只添加一个已验证模型，完成 Agent 实际调用后再逐步增加。

12.2 同一个模型走不同协议时要分别配置

Qwen 和 DeepSeek 同时支持 OpenAI Chat 与 Anthropic Messages，但两种配置不是同一条记录。

例如：

qwen/qwen3.6-flash + OpenAI Chat qwen/qwen3.6-flash + Anthropic Messages

必须分别配置和验证，不能假设其中一个成功后另一个也成功。

12.3 Agent 成功不代表所有 TRAE 功能都使用该模型

自定义模型在 Agent/SOLO 会话中成功，不代表以下功能一定使用同一个模型：

• CUE 或代码补全；
• Code Review；
• Git 提交信息生成；
• 搜索、索引或嵌入；
• 其他内置 Agent；
• Auto Mode 自动路由。

每个功能是否支持自定义模型，应以该功能的模型选择器和实际请求为准。

12.4 文本成功不代表高级能力全部成功

本文主要验证非流式文本回复。以下能力不能由文本成功直接推断：

• 流式 SSE；
• 工具调用和多轮工具结果；
• 图片、PDF、音频等多模态输入；
• JSON Schema 或结构化输出；
• Prompt Cache；
• Extended Thinking；
• 超长上下文；
• 并行 Agent 和 Max Mode。

官网应分别标记“文本已验证”“工具调用已验证”“流式已验证”和“多模态已验证”。

12.5 Auto Mode 不能用于验收指定模型

Auto Mode 可能选择 TRAE 内置模型。验收中转站时必须关闭 Auto Mode，并明确选择自定义模型。

12.6 配置成功不等于上游稳定

模型可能在目录中可见，也可能通过一次连通性测试，但上游仍可能发生：

• 限流；
• 额度不足；
• 临时 502/503；
• 供应商资源不足；
• 特定参数不兼容；
• 长上下文或工具调用失败。

运营方应定期重新检测，不应永久标记一次测试结果。

13. 常见问题排查

13.1 找不到“Anthropic Messages 格式”

先确认：

1. 使用的是 TRAE 国际版；
2. Bundle ID 是

   com.trae.app

   com.trae.app
   ；
3. TRAE 已更新到支持该选项的版本；
4. 进入的是“添加模型 → 自定义模型”，不是服务商预设。

旧版本可能只有 OpenAI Chat Completions。更新后重新打开 TRAE。

13.2 连通性测试返回 404

优先检查 URL 是否被重复拼接。

OpenAI 错误示例：

/gateway/v1/chat/completions/chat/completions

Anthropic 错误示例：

/gateway/v1/v1/messages

处理方式：

• OpenAI：关闭完整 URL，填写到

  /gateway/v1

  /gateway/v1
  ；
• Anthropic：推荐打开完整 URL，填写完整

  /gateway/v1/messages

  /gateway/v1/messages
  。

13.3 HTTP 401 或 403

可能原因：

• API Key 粘贴错误；
• API Key 已过期；
• Token 没有目标模型权限；
• API Key 与 Base URL 不属于同一环境；
• 使用了错误协议的鉴权方式。

先重新执行第 5 节和第 6 节的标准

curl

13.4 No upstream candidates

常见原因：

• 模型 ID 写错；
• 协议选择错误；
• 当前 Token 没有上游权限；
• 当前协议没有该模型路由。

典型错误组合：

Claude + OpenAI Chat OpenAI 模型 + Anthropic Messages DeepSeek + OpenAI Responses

处理顺序：

1. 重新查询对应协议

   /models

   /models
   ；
2. 原样复制模型 ID；
3. 用同协议标准

   curl

   curl
   ；
4. 检查 TRAE 的 API 格式；
5. 检查完整 URL 和自动拼接路径。

13.5 HTTP 502

[G2] Upstream failed

[G2] Upstream failed

说明网关已经识别模型，但上游供应商调用失败。

当前已知：

openai/gpt-5.5-openai-compact → OpenAI Chat 返回 502 → 不应配置为客户可用模型

持续失败时，向管理员提供：

• 模型 ID；
• 请求协议；
• HTTP 状态；
• 错误 JSON；
• 发生时间；
• request ID 或 trace ID。

发送前删除 API Key。

13.6 模型已添加，但 Agent 不回复

按顺序检查：

1. 是否打开了项目文件夹；
2. 是否关闭 Auto Mode；
3. 输入框底部是否选中自定义模型；
4. 自定义模型开关是否启用；
5. 是否点击发送按钮，而不是只在输入框中换行；
6. 标准

   curl

   curl
   是否仍然成功；
7. 是否出现 401、404、429、502 等错误。

13.7 TRAE 提示先打开文件夹

这是项目上下文要求，不是中转站连接错误。打开一个现有项目或空文件夹后重试。

13.8 模型出现在列表，但实际使用了 GPT-5.4

可能仍处于 Auto Mode，或者当前会话没有切换到自定义模型。

关闭 Auto Mode，在输入框底部明确选择目标模型，再新建会话测试。

13.9 HTTP 200 但界面没有最终文本

可能原因：

• 输出预算被 thinking/reasoning 用完；
• 网关返回结构与协议不匹配；
• 流式事件不兼容；
• TRAE 选择了错误的 API 格式。

先提高

max_tokens

curl

13.10 日志里有 fallback 或 extra_config 警告

TRAE 内部可能记录模型同步或空高级配置警告。不能只看单条 warning 判断失败。

验收应同时检查：

请求使用的自定义模型 最终状态为 Success hasText=true 界面返回预期文本

如果最终请求成功，这类内部同步警告不应被单独判定为连接失败。

14. API Key 和日志安全

请遵守：

• 不要把 API Key 写进文档；
• 不要把完整配置弹窗截图发到公开渠道；
• 不要在 Terminal 执行

  echo "$RELAY_API_KEY"

  echo "$RELAY_API_KEY"
  ；
• 不要把带鉴权头的调试命令截图；
• 日志发送给客服前删除 Token、Authorization、x-api-key 和环境变量；
• API Key 泄露后立即撤销并重新生成；
• 不同客户、项目和环境使用不同 API Key。

完成 Terminal 测试后清理变量：

unset RELAY_API_KEY unset RELAY_BASE_URL unset RELAY_MODEL

如果使用剪贴板粘贴过 API Key，可以清空 macOS 剪贴板：

pbcopy </dev/null

15. 运营方发布模型的规则

官网不要只写“TRAE 支持 Claude”或“TRAE 支持 OpenAI”。应发布精确组合：

TRAE 版本 + API 格式 + 完整模型 ID + URL 填写方式 + 标准 curl 状态 + TRAE 连通性测试 + Agent 实际消息 + 最近检测时间

建议字段：

openai/gpt-5.5

推荐状态标签：

目录可见 curl 已验证 TRAE 连通性已验证 TRAE Agent 已验证 暂不可用 高级能力未验证

不要把“目录可见”直接写成“TRAE 可用”。

16. 最终成功清单

安装和账号

[ ] 使用 TRAE 国际版 [ ] Bundle ID 是 com.trae.app [ ] TRAE 可以正常启动 [ ] 已登录个人或企业账号

中转站基线

[ ] Base URL 正确 [ ] API Key 未过期且未泄露 [ ] 按目标协议查询 /models [ ] 模型 ID 从目录原样复制 [ ] 同协议 curl 返回 HTTP 200 [ ] curl 响应有最终文本

TRAE 配置

[ ] API 格式选择正确 [ ] OpenAI URL 没有重复 /chat/completions [ ] Anthropic URL 没有重复 /v1 [ ] 模型 ID 保留完整前缀和版本号 [ ] TRAE 连通性测试成功 [ ] 自定义模型开关已启用

实际使用

[ ] 已打开项目文件夹 [ ] 已关闭 Auto Mode [ ] 当前会话明确选择自定义模型 [ ] Agent 返回实际模型文本 [ ] 没有 401、403、404、429 或 5xx [ ] 最近检测时间已记录

全部完成后，才可以称为：

TRAE 国际版已经通过 AI Gateway 接入指定模型，并完成实际调用验证。

如果只有目录和

curl