> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hairoute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Trae Work

> 通过 HaiRoute 网关接入 Trae Work

Trae Work 支持通过“自定义配置”接入兼容 OpenAI 或 Anthropic 协议的模型服务。对 HaiRoute 来说，最稳妥的接入方式是使用 `OpenAI Chat Completions` 格式。

<Note>
  Trae Work 这份文档以图形界面配置为主，Windows、macOS、Linux 的核心步骤一般一致。不同系统下若菜单层级、按钮位置或弹窗样式略有不同，请以当前版本实际界面为准，但协议格式、请求地址、模型 ID 和 API Key 的填写逻辑不变。
</Note>

## 先准备好这些信息

* HaiRoute API Key
* 至少一个可用模型 ID，例如 `gpt-5.4`
* HaiRoute OpenAI 兼容地址：`https://api.hairoute.ai/v1`
* HaiRoute Claude / Anthropic 兼容地址：`https://api.hairoute.ai`

## 先选哪种 API 格式

Trae Work 官方支持两种常见协议格式：

* `OpenAI Chat Completions`：推荐优先使用，配置最直接，也最适合大多数 HaiRoute 接入场景
* `Anthropic Messages`：也很常用，适合你明确要走 Claude / Anthropic 生态时使用

如果你没有明确理由，建议优先选前者。

## 接入步骤

### 步骤 1：打开模型设置

在 Trae Work 中进入 **设置** > **模型**，打开模型管理面板。

如果当前页面有 **添加模型** 按钮，点击它进入新增模型窗口。

<img src="https://mintcdn.com/hai-token/VEsEJoBleYGPGfir/images/trae/PixPin_2026-07-08_18-09-44.png?fit=max&auto=format&n=VEsEJoBleYGPGfir&q=85&s=45c5dfd8a1ffb72ef843eb2da88c1788" alt="打开 Trae Work 模型设置" width="1323" height="774" data-path="images/trae/PixPin_2026-07-08_18-09-44.png" />

### 步骤 2：选择 `自定义配置`

在“添加模型”窗口中，不要选择预设服务商，而是切换到 **自定义配置**。

这一步的目的是让 Trae Work 直接按你填写的协议、地址和模型 ID 调用 HaiRoute。

<img src="https://mintcdn.com/hai-token/VEsEJoBleYGPGfir/images/trae/PixPin_2026-07-08_18-10-20.png?fit=max&auto=format&n=VEsEJoBleYGPGfir&q=85&s=9efd99134631ffcdd995b83e9766e852" alt="选择自定义配置" width="1204" height="580" data-path="images/trae/PixPin_2026-07-08_18-10-20.png" />

### 步骤 3：选择 API 格式

在 API 格式中选择 **OpenAI Chat Completions**。

这是因为 HaiRoute 提供了 OpenAI 兼容聊天接口 `POST /v1/chat/completions`，Trae Work 走这条路径最容易配置，也最适合大多数模型接入场景。

如果你明确想按 Claude / Anthropic 模式接入，也可以在这里改选 **Anthropic Messages**。这种情况下，后面的请求地址要改填 `https://api.hairoute.ai`，不要再使用带 `/v1` 的 OpenAI 地址。

<img src="https://mintcdn.com/hai-token/VEsEJoBleYGPGfir/images/trae/PixPin_2026-07-08_18-10-39.png?fit=max&auto=format&n=VEsEJoBleYGPGfir&q=85&s=7e80096083373cb09517816354f67542" alt="选择 OpenAI Chat Completions 格式" width="1182" height="854" data-path="images/trae/PixPin_2026-07-08_18-10-39.png" />

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

按下面的方式填写核心字段：

| 字段      | 推荐填写值                                                                                 |
| ------- | ------------------------------------------------------------------------------------- |
| API 格式  | 推荐 `OpenAI Chat Completions`；如需 Claude 生态可选 `Anthropic Messages`                      |
| 模型 ID   | HaiRoute 实际支持的模型 ID，例如 `gpt-5.4`                                                      |
| API Key | 你的 HaiRoute API Key                                                                   |
| 请求地址    | `OpenAI` 模式推荐 `https://api.hairoute.ai/v1`；`Anthropic` 模式填写 `https://api.hairoute.ai` |

如果当前界面提供 **完整 URL** 开关，推荐先保持关闭，并把请求地址填为基础地址 `https://api.hairoute.ai/v1`。

如果你已经打开 **完整 URL**，就把请求地址改成完整接口：`https://api.hairoute.ai/v1/chat/completions`。

如果你选择的是 **Anthropic Messages**，通常应保持基础地址思路，填写 `https://api.hairoute.ai`，由客户端请求 `/v1/messages`。

如果界面还提供下面这些可选项，可以按模型实际能力调整：

* 多模态：只有模型支持图片输入时再开启
* 模型展示名称：可自定义为 `HaiRoute GPT-5.4`
* 上下文窗口、最大输出：没有把握时先保留默认值

<img src="https://mintcdn.com/hai-token/VEsEJoBleYGPGfir/images/trae/PixPin_2026-07-08_18-11-40.png?fit=max&auto=format&n=VEsEJoBleYGPGfir&q=85&s=04c522c1cdb0db28ebf69cfa8544cc80" alt="填写 Trae Work 自定义模型信息" width="1175" height="827" data-path="images/trae/PixPin_2026-07-08_18-11-40.png" />

### 步骤 5：添加模型并启用

填写完成后点击 **添加模型**。

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

## 验证步骤

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

## 补充说明

<Note>
  如果你在 Trae Work 里使用的是“基础地址”模式，请填写 `https://api.hairoute.ai/v1`；如果你使用的是“完整 URL”模式，请填写 `https://api.hairoute.ai/v1/chat/completions`。两种方式不要混填。
</Note>

| 项目               | 对应关系                                 |
| ---------------- | ------------------------------------ |
| Trae Work API 格式 | `OpenAI Chat Completions`            |
| HaiRoute 实际接口    | `POST /v1/chat/completions`          |
| Anthropic 兼容接口   | `POST /v1/messages`                  |
| 鉴权方式             | `Authorization: Bearer YOUR_API_KEY` |
| 模型来源             | 你在 Trae Work 中手动添加的模型 ID             |

<Tip>
  这里要填的是 HaiRoute 首页或模型列表中的**模型编号（model ID）**，不是前台展示名称。请直接复制像 `gpt-5.4` 这样的编号，避免因为填了模型名称而报 `model not found`。
</Tip>

Trae Work 官方文档说明其“自定义配置”支持 `OpenAI Chat Completions` 和 `Anthropic Messages` 两种协议格式；对于 HaiRoute，优先使用前者会更直接。[官方模型文档](https://docs.trae.ai/ide/models)

## 常见问题

| 问题                         | 解决方案                                                                                                                                                                   |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 添加模型时提示地址错误                | 先确认你当前使用的是哪一种填写方式：如果 **完整 URL** 关闭，请填写 `https://api.hairoute.ai/v1`；如果 **完整 URL** 打开，请填写 `https://api.hairoute.ai/v1/chat/completions`。最常见的问题是把基础地址模式和完整 URL 模式混在一起填写。 |
| 我想改走 Claude / Anthropic 模式 | 在 API 格式里改选 `Anthropic Messages`，并把请求地址改成 `https://api.hairoute.ai`。不要继续使用 `https://api.hairoute.ai/v1` 这条 OpenAI 风格地址。                                                |
| 提示 `401` 或鉴权失败             | 请确认填入的是有效的 HaiRoute API Key。HaiRoute 的 OpenAI 兼容接口使用 Bearer 鉴权，即 `Authorization: Bearer YOUR_API_KEY`。                                                                 |
| 提示 `model not found`       | 请确认你在 Trae Work 中填写的模型 ID 与 HaiRoute 模型列表中的模型 ID 完全一致。模型名区分大小写，也不要自行加前缀或别名。                                                                                            |
| 模型已经添加，但聊天界面里看不到           | 先回到模型管理页，确认该模型已经添加成功并处于启用状态；如果仍然没有出现，重新打开模型列表或重启一次 Trae Work 再查看。                                                                                                      |

## 下一步

* 查看 [获取 API Key](/docs/zh/quickstart/get-api-key)
* 查看 [OpenAI 格式 API 文档](/docs/zh/api-reference/chat/openai-format)
* 查看 [模型列表](/docs/zh/api-reference/models/list-models)