Trae
Trae 是字节跳动推出的 AI 原生 IDE，支持通过 OpenAI 兼容协议接入第三方模型。本文覆盖国际版（trae.ai）与国内版（trae.com.cn）两个版本的接入步骤。
TIP
两个版本的核心配置项完全一致，只是菜单文案不同。如果你只用其中一个，直接跳到对应章节即可。
准备工作
| 字段 | 值 | 备注 |
|---|---|---|
| Base URL | https://api.tokone.ai | OpenAI 兼容路径，注意结尾的 /v1 |
| API Key | sk-xxx | 在控制台「API Key」页生成 |
| 默认模型 ID | gpt-5.5 或 gpt-5.4 | 完整列表见模型清单 |
Trae 国际版（trae.ai）
1. 打开模型设置
- macOS：
Cmd + ,打开设置，或点左下角齿轮图标 →「Settings」 - Windows / Linux：
Ctrl + ,打开设置
在设置侧栏找到「Models」（部分版本叫「AI Providers」/「Model Providers」，意思一致）。
2. 添加自定义模型
点「Add Model」/「Add Custom Model」，Provider 选 OpenAI Compatible，按下表填入：
| 字段 | 填入值 |
|---|---|
| Display Name / Name | TokOne GPT-5.5 |
| Base URL / Endpoint | https://api.tokone.ai |
| API Key | 你的 sk-xxx |
| Model ID / Model Name | gpt-5.5 |
点「Save」。界面如果有「Verify」/「Test」按钮，建议点一下确认连通。
3. 选用模型
回到对话窗口，模型下拉里选中「TokOne GPT-5.5」即可。想同时挂多个模型（比如 gpt-5.5 与 gpt-5.4 各加一条），重复步骤 2 即可。
Trae 国内版（trae.com.cn）
国内版界面是中文，流程与国际版完全一致，仅菜单文案不同。
- 打开模型设置：
Cmd + ,（macOS）/Ctrl + ,（Windows / Linux），在侧栏找到「模型设置」/「AI 模型」。 - 点「添加模型」/「新增自定义模型」，模型供应商选「OpenAI 兼容」。
- 填入：API 地址
https://api.tokone.ai、API 密钥 你的sk-xxx、模型 IDgpt-5.5，点「保存」。 - 在对话窗口的模型下拉里选中「TokOne GPT-5.5」即可。
验证
新建对话窗口，在模型下拉里选中你添加的模型，发送 回复 OK，应能看到流式返回的回复。也可以在 TokOne 控制台「使用记录」页确认请求落地——如果 Trae 显示有回复但控制台查不到记录，说明请求没走到 TokOne（多半是 Base URL 写错）。
常见问题
连不上 / 长时间无响应
90% 是 Base URL 写错：
| 错误写法 | 报错现象 | 原因 |
|---|---|---|
https://api.tokone.ai | 404 Not Found | 漏了 /v1 |
https://api.tokone.ai/v1/v1 | 404 Not Found | 重复了 /v1 |
http://api.tokone.ai/v1 | SSL / 连接拒绝 | 协议写成了 http |
https://api.tokone.ai/v1/ | 部分版本 404 | 结尾多了 / |
正确写法只有一个：https://api.tokone.ai/v1。
模型下拉里看不到刚添加的模型
检查 Provider 是否选成了「OpenAI Compatible」/「OpenAI 兼容」。部分版本添加模型后需要重启 Trae 才能刷新下拉列表。
返回 401 / 403
回控制台「API Key」页确认 Key 仍处于启用状态；复制 Key 时不要带前后空格或换行——Trae 不会自动 trim。
返回「模型不存在」/「模型不支持」
Model ID 写错。Model ID 是模型的 API 名称，不是「显示名称」。可用清单见模型清单，常用的是 gpt-5.5 与 gpt-5.4。