> ## 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.

# DeepChat

> 通过 HaiRoute 网关接入 DeepChat

DeepChat 是一款开源的本地优先 AI 桌面客户端，支持通过自定义服务商接入兼容 `OpenAI`、`Gemini`、`Anthropic` 协议的模型服务。对 HaiRoute 来说，`OpenAI` 模式通常最稳、兼容性最好；如果你明确需要走 Claude / Anthropic 生态，也可以改用 `Anthropic` 模式。

## 先准备好这些信息

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

<Note>
  DeepChat 的配置全程通过图形界面完成，Windows、macOS、Linux 的操作步骤基本一致。不同系统下若菜单位置或窗口样式略有差异，请以实际 UI 为准，但 API Key、API 地址和模型 ID 的填写逻辑不变。
</Note>

## 接入步骤

### 先选哪种协议

在 DeepChat 中，常见有两种接法：

* `OpenAI` / `OpenAI Completions`：更推荐，兼容面更广，当前文档主流程也按这条路径来写
* `Anthropic` / `Claude`：也很常用，适合你希望按 Claude / Messages 生态去接入的场景

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

### 步骤 1：打开设置

在 DeepChat 主界面左侧边栏底部，点击 **`...`** 按钮展开菜单，选择 **设置**。

<img src="https://mintcdn.com/hai-token/ue5podwiJLlPGLB9/images/deepchat/PixPin_2026-07-09_11-41-40.png?fit=max&auto=format&n=ue5podwiJLlPGLB9&q=85&s=6cc37bd1a6251f04c4a48275c812c4d6" alt="打开 DeepChat 设置" width="1151" height="733" data-path="images/deepchat/PixPin_2026-07-09_11-41-40.png" />

### 步骤 2：进入服务商设置

在设置概览页面，找到 **Providers** 卡片，点击进入服务商设置页面。

<img src="https://mintcdn.com/hai-token/ue5podwiJLlPGLB9/images/deepchat/PixPin_2026-07-09_11-42-14.png?fit=max&auto=format&n=ue5podwiJLlPGLB9&q=85&s=cbafdc4e451d1521af93f5f10a29ebf0" alt="进入 DeepChat 服务商设置" width="1300" height="800" data-path="images/deepchat/PixPin_2026-07-09_11-42-14.png" />

### 步骤 3：添加自定义服务商

在服务商列表底部，点击 **+ 添加自定义服务商** 按钮。

<img src="https://mintcdn.com/hai-token/ue5podwiJLlPGLB9/images/deepchat/PixPin_2026-07-09_11-42-34.png?fit=max&auto=format&n=ue5podwiJLlPGLB9&q=85&s=d8eba6e9f6e32bfb83014bfb67131ab7" alt="添加自定义服务商" width="1300" height="800" data-path="images/deepchat/PixPin_2026-07-09_11-42-34.png" />

### 步骤 4：填写 HaiRoute 配置

在弹出的对话框中，按以下信息填写：

| 字段    | 填写值                                                                                 |
| ----- | ----------------------------------------------------------------------------------- |
| 名称    | `hairoute`（可自定义）                                                                    |
| API类型 | 推荐 `OpenAI`；如需 Claude 生态可选 `Anthropic`                                              |
| API密钥 | 你的 HaiRoute API Key                                                                 |
| API地址 | `OpenAI` 模式填 `https://api.hairoute.ai/v1`；`Anthropic` 模式填 `https://api.hairoute.ai` |

填写完成后，确认底部 **启用服务商** 开关已打开，点击 **确认** 保存。

<Warning>
  HaiRoute 同时支持 OpenAI Chat Completions 和 OpenAI Responses 协议。如果选择 OpenAI 后 API 地址下方显示 `/responses` 后缀，表示将通过 `POST /v1/responses` 请求；该路径现已支持，可直接使用。仅当你明确需要 Chat Completions 路径（`POST /v1/chat/completions`）时，再选择 `OpenAI Completions`。
</Warning>

<Note>
  如果你选择的是 `Anthropic` / `Claude` 模式，请不要把地址写成 `https://api.hairoute.ai/v1`。这一条路径应当填写 Anthropic 风格的网关前缀 `https://api.hairoute.ai`，由客户端去请求 `/v1/messages`。
</Note>

<img src="https://mintcdn.com/hai-token/ue5podwiJLlPGLB9/images/deepchat/PixPin_2026-07-09_11-43-22.png?fit=max&auto=format&n=ue5podwiJLlPGLB9&q=85&s=51e77f62287c61df3af0bb0c253c7802" alt="填写 HaiRoute 配置" width="1300" height="800" data-path="images/deepchat/PixPin_2026-07-09_11-43-22.png" />

### 步骤 5：刷新并启用模型

保存后，在服务商详情页切换到 **Models** 标签页，点击 **刷新模型** 拉取 HaiRoute 可用模型列表。拉取成功后，点击 **全部启用** 或按需开启特定模型。

<img src="https://mintcdn.com/hai-token/ue5podwiJLlPGLB9/images/deepchat/PixPin_2026-07-09_11-44-52.png?fit=max&auto=format&n=ue5podwiJLlPGLB9&q=85&s=0652c5aec5dcf3080045122f9d6f0d3e" alt="刷新并启用模型" width="1300" height="800" data-path="images/deepchat/PixPin_2026-07-09_11-44-52.png" />

### 步骤 6：返回对话界面测试

回到聊天界面，在底部模型选择器中切换到刚配置的 HaiRoute 模型，发送一条简单消息（如 `hello`）验证连通性。

## 补充说明

| 项目          | 说明                                   |
| ----------- | ------------------------------------ |
| 推荐协议        | OpenAI Chat Completions              |
| 常见请求路径      | `POST /v1/chat/completions`          |
| Claude 兼容路径 | `POST /v1/messages`                  |
| 鉴权头         | `Authorization: Bearer YOUR_API_KEY` |
| 模型切换        | 在 DeepChat 对话界面通过模型选择器切换             |

如果你还需要配置温度、最大输出长度、系统提示词等高级参数，第一次接入时建议先保留默认值，优先确认连通性。

<Tip>
  在 DeepChat 里填写模型时，请复制 HaiRoute 首页或模型列表里的**模型编号（model ID）**，不要复制展示名称。真正用于请求的是模型编号，例如 `gpt-5.4`。
</Tip>

## 常见问题

| 问题                        | 解决方案                                                                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| API 地址中显示 `/responses` 后缀 | 这是 `POST /v1/responses` 路径，HaiRoute 已支持。需要使用 Responses 兼容客户端时可保持该配置；如需 `POST /v1/chat/completions`，请选择 `OpenAI Completions`。                |
| 提示接口地址错误                  | 确认 API 地址填写的是 `https://api.hairoute.ai/v1`，不要多加 `/chat/completions` 后缀，DeepChat 会自动拼接路径。                                                    |
| 我想走 Claude / Anthropic 模式 | 把 API 类型切到 `Anthropic` 或对应的 Claude 模式，并把 API 地址改成 `https://api.hairoute.ai`，不要再带 `/v1`。这一条路径会按 Anthropic Messages 协议请求 `POST /v1/messages`。 |
| 提示 `401` 或鉴权失败            | 请确认 API Key 有效，并确认 DeepChat 当前使用的是 OpenAI 兼容 Bearer 鉴权。                                                                                     |
| 提示 `model not found`      | 请确认 DeepChat 中填写的模型 ID 与 HaiRoute 实际暴露的模型 ID 完全一致。                                                                                          |
| 刷新模型后列表为空                 | 检查 API Key 是否正确、服务商是否已启用，以及网络是否能访问 `https://api.hairoute.ai/v1`。                                                                            |

## 下一步

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