Skip to main content
Trae Work 支持通过“自定义配置”接入兼容 OpenAI 或 Anthropic 协议的模型服务。对 HaiToken 来说,最稳妥的接入方式是使用 OpenAI Chat Completions 格式。
Trae Work 这份文档以图形界面配置为主,Windows、macOS、Linux 的核心步骤一般一致。不同系统下若菜单层级、按钮位置或弹窗样式略有不同,请以当前版本实际界面为准,但协议格式、请求地址、模型 ID 和 API Key 的填写逻辑不变。

先准备好这些信息

  • HaiToken API Key
  • 至少一个可用模型 ID,例如 gpt-5.4
  • HaiToken OpenAI 兼容地址:https://api.haitoken.ai/v1
  • HaiToken Claude / Anthropic 兼容地址:https://api.haitoken.ai

先选哪种 API 格式

Trae Work 官方支持两种常见协议格式:
  • OpenAI Chat Completions:推荐优先使用,配置最直接,也最适合大多数 HaiToken 接入场景
  • Anthropic Messages:也很常用,适合你明确要走 Claude / Anthropic 生态时使用
如果你没有明确理由,建议优先选前者。

接入步骤

步骤 1:打开模型设置

在 Trae Work 中进入 设置 > 模型,打开模型管理面板。 如果当前页面有 添加模型 按钮,点击它进入新增模型窗口。

步骤 2:选择 自定义配置

在“添加模型”窗口中,不要选择预设服务商,而是切换到 自定义配置 这一步的目的是让 Trae Work 直接按你填写的协议、地址和模型 ID 调用 HaiToken。

步骤 3:选择 API 格式

在 API 格式中选择 OpenAI Chat Completions 这是因为 HaiToken 提供了 OpenAI 兼容聊天接口 POST /v1/chat/completions,Trae Work 走这条路径最容易配置,也最适合大多数模型接入场景。 如果你明确想按 Claude / Anthropic 模式接入,也可以在这里改选 Anthropic Messages。这种情况下,后面的请求地址要改填 https://api.haitoken.ai,不要再使用带 /v1 的 OpenAI 地址。

步骤 4:填写请求地址、模型 ID 和 API Key

按下面的方式填写核心字段: 如果当前界面提供 完整 URL 开关,推荐先保持关闭,并把请求地址填为基础地址 https://api.haitoken.ai/v1 如果你已经打开 完整 URL,就把请求地址改成完整接口:https://api.haitoken.ai/v1/chat/completions 如果你选择的是 Anthropic Messages,通常应保持基础地址思路,填写 https://api.haitoken.ai,由客户端请求 /v1/messages 如果界面还提供下面这些可选项,可以按模型实际能力调整:
  • 多模态:只有模型支持图片输入时再开启
  • 模型展示名称:可自定义为 HaiToken GPT-5.4
  • 上下文窗口、最大输出:没有把握时先保留默认值

步骤 5:添加模型并启用

填写完成后点击 添加模型 如果 Trae Work 提示连接成功,这个模型就会出现在模型列表里。请确认它已经处于启用状态,并在聊天界面里切换到这个模型。

验证步骤

  1. 打开 Trae Work 聊天面板。
  2. 在模型选择器中切换到刚刚添加的 HaiToken 模型。
  3. 发送一条简单测试消息,例如 hi请解释当前文件作用
  4. 如果可以正常返回内容,说明接入成功。

补充说明

如果你在 Trae Work 里使用的是“基础地址”模式,请填写 https://api.haitoken.ai/v1;如果你使用的是“完整 URL”模式,请填写 https://api.haitoken.ai/v1/chat/completions。两种方式不要混填。
这里要填的是 HaiToken 首页或模型列表中的模型编号(model ID),不是前台展示名称。请直接复制像 gpt-5.4 这样的编号,避免因为填了模型名称而报 model not found
Trae Work 官方文档说明其“自定义配置”支持 OpenAI Chat CompletionsAnthropic Messages 两种协议格式;对于 HaiToken,优先使用前者会更直接。官方模型文档

常见问题

下一步