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 提示连接成功,这个模型就会出现在模型列表里。请确认它已经处于启用状态,并在聊天界面里切换到这个模型。验证步骤
- 打开 Trae Work 聊天面板。
- 在模型选择器中切换到刚刚添加的 HaiToken 模型。
- 发送一条简单测试消息,例如
hi或请解释当前文件作用。 - 如果可以正常返回内容,说明接入成功。
补充说明
如果你在 Trae Work 里使用的是“基础地址”模式,请填写
https://api.haitoken.ai/v1;如果你使用的是“完整 URL”模式,请填写 https://api.haitoken.ai/v1/chat/completions。两种方式不要混填。
Trae Work 官方文档说明其“自定义配置”支持
OpenAI Chat Completions 和 Anthropic Messages 两种协议格式;对于 HaiToken,优先使用前者会更直接。官方模型文档
常见问题
下一步
- 查看 获取 API Key
- 查看 OpenAI 格式 API 文档
- 查看 模型列表