Trae + JoinGonka Gateway — AI-IDE 中的 Gonka 网络模型

版本与构建。 Trae 有两个分支：国际版（文档见 docs.trae.ai）和中国版（docs.trae.cn）。Custom Model 表单在两个版本中都有，且结构相同；区别在于内置模型和附加设置中的预设集。自定义模型的请求地址支持从 2026 年 4 月 14 日的 3.5.51 版本起提供——如果你的版本更旧，请先更新。国际版并非在所有国家都可用：安装前请核对支持的国家和地区列表。

系统要求。 macOS 12 及更新版本、Windows 10 或 11（x64）、Linux 的 .deb 和 .rpm 包。首次启动时，Trae 会提示你选择主题和语言、从 VS Code 或 Cursor 导入设置，并登录账号。

JoinGonka 密钥。在网关注册，在控制台打开"API 密钥"部分并点击"创建密钥"。密钥以 jg- 开头，且只显示一次——请立即保存。方便的做法是为 Trae 单独建一个密钥：在"用量"部分，它的消耗会单独成行显示。

Trae 套餐。自己的模型需要在模型列表中手动选择，而在 Trae 的套餐表格中，免费套餐的模型选择行里只有 Auto 模式——该模式下无法使用自己的模型。这一限制是否适用于用自己密钥添加的模型，文档并未明确说明。实用规则很简单：如果你套餐的模型列表里 Auto Mode 可以关闭，那就一切就绪；如果不行，就需要付费套餐。

1. 打开Settings → Models——模型管理面板。
2. 点击 Add Model。在弹出的窗口中选择 Custom Model，而不是列表中的现成服务商。
3. 按表格填写各字段。表格有两列——分别对应两种 API 格式；任选其一。
4. 点击 Add Model。Trae 会发起一次测试 API 调用并校验密钥：成功时模型会出现在列表中，失败时窗口会显示错误信息和提供商返回的日志。

其余字段与格式无关：

如何选择格式。先从 OpenAI Chat Completions 开始：这是网关的主要通道，大多数工具都基于它运行。如果你在其他工具中习惯了 Anthropic Messages 格式，或者想比较智能体在两种协议下的表现，那它就很实用——两者共用同一个密钥和余额。

Full URL 的工作方式。该开关决定由谁拼接路径。关闭时——你提供基础地址，Trae 按所选格式补全路径：OpenAI 会在带 /v1 的地址后加上 /chat/completions，Anthropic 会在根地址后加上 /v1/messages。开启时——地址按原样使用，必须包含完整路径。最常见的错误是混用模式：开关关闭时填了完整路径，或开关开启时只填了基础地址。

一条记录对应一个模型。对网络中的其他模型重复上述步骤，就能在它们之间自由切换，无需再回到设置：deepseek-ai/DeepSeek-V4-Flash-0731、MiniMaxAI/MiniMax-M2.7 和 zai-org/GLM-5.3-Flash。最新列表可通过 GET https://gate.joingonka.ai/v1/models 获取。添加后的模型之后可以编辑、停用（仍保留在面板中，但会从聊天列表中消失）或删除。

主字段下方有一个可折叠的 Advanced Settings 列表。您可以不去管它 — Trae 会使用默认值 — 但有两项设置值得仔细考虑：模型系列和上下文窗口。

网络中各模型的定价相同，因此选择取决于行为偏好。表格中的所有模型都支持原生 tool calling，这是 Trae 代理工作的基础。

关于推理预算的构建原理以及为什么不能限制推理模型输出上限的原因，请参考 GLM-5.3 Flash 综述；不同开发任务下的模型对比，请查看 最佳代码模型文章。

您自己的模型在总列表中：点击聊天输入框右下角当前模型的名称，然后选择您添加的模型。那里还有一个 Auto Mode 开关 — 它必须关闭：在 Auto 模式下，Trae 会自行从内置模型中选择，而不会使用您添加的模型。

给 Agent 一个需要工具的任务，例如：“读取 package.json 并列出构建脚本”。Agent 应该打开文件并给出实质性的回答——这意味着通过网关组装的“请求 — 调用工具 — 响应”循环正在运行。然后打开网关后台，进入“使用情况”部分：在“按密钥”板块中，Trae 密钥下将出现请求和最后访问时间，在“按模型”板块中将显示已选择的模型。

如果出现问题，请查看错误文本。Trae 不会隐藏您自己的模型的响应：它会按原样显示提供商错误，并带有其自己的代码 4028。

IDE 中的 Agent 消耗 token 的速度比聊天更快：每个请求都包含系统指令、工具描述、打开的文件和步骤历史。因此，每个 token 的价格决定了您是可以在处理每件小事时运行 Agent，还是必须精打细算。

通过 JoinGonka Gateway，token 价格为输入每百万 $0.0069，输出每百万 $0.021 — 所有网络模型价格一致，并从此页面的实时源获取。截至 2026 年 9 月的预估费用如下：

与 Trae 本身进行比较很直观，因为内置模型中也存在开放模型，且 Trae 公布了它们每百万 token 的价格列表。DeepSeek-V4-Flash 和 MiniMax-M2.7 在那里的输入价格为 $0.30，输出为 $1.20，而 GLM-5.3 Flash 根本不在国际版内置列表中。通过网关，相同模型的差异大约为输入 ×43，输出 ×58。

当模型列表可用时，您的自定义模型即可生效。 这适用于聊天和智能体（Agent）模式，包括 IDE 模式和 SOLO 模式（SOLO 自 3.3.0 版本起支持自定义模型）。自动补全和编辑预测由独立的 CUE 机制处理，并配有专门的设置面板：该面板不支持模型选择，其限制由 Trae 的套餐决定。

工具与 MCP。 Trae 智能体作为 MCP 客户端运行，您连接的服务器在您的自定义模型下依然可用：所有网络模型均支持原生工具调用。如果 Trae 提示工具参数方案与模型不兼容（代码 4027），请尝试切换到相邻的网络模型或更换其他 MCP 服务器。

TraeWork。 在独立的 TraeWork 应用程序中，添加自定义模型的表单是一样的，但根据文档，它仅适用于 TraeWork Desktop，且仅支持本地环境中的任务。

其他编辑器的插件。 TraeCode 的 VS Code 和 JetBrains 插件文档中没有关于自定义模型的章节——本指南仅针对桌面版 IDE。如果您继续使用 VS Code，可以通过代理扩展（例如 Cline）连接相同的网关。

隐私。 Privacy Mode 设置（Settings → Account）控制 Trae 对您的对话和代码片段的处理方式：开启后，这些内容不会被用于分析或训练。在网关端，对话不会被存储：提示词和响应在回复后不会保留，仪表板仅显示请求和 Token 的计数器。

如果您需要处理图像（例如设计稿、错误截图），请将此类任务交给内置的视觉模型处理，而代码、命令和文件则留给网络模型：在模型列表中点击一下即可切换。