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

# LibreChat

> 在 LibreChat 中接入 AIHubMix：通过 OpenAI 兼容接口统一调用多家厂商模型。

LibreChat 是一个开源的多模型对话客户端，支持 OpenAI 兼容接口。接入 AIHubMix 后，可以在 LibreChat 的 **OpenAI** 端点下使用 AIHubMix 支持的 OpenAI、Claude、Gemini、DeepSeek、GLM 等模型。

## 环境准备

接入前请先确认：

* 已部署并启动可用的 LibreChat 实例，推荐使用 v0.7.5 或更高版本。
* 已在 [AIHubMix 控制台](https://aihubmix.com/token) 创建 API Key，格式通常为 `sk-***`。
* 可以修改 LibreChat 部署目录中的 `.env` 文件。`.env` 位于 LibreChat 项目根目录，也就是与 `package.json`、`docker-compose.yml` 同级的位置。
* 配置文件位置通常是 `你的安装路径/LibreChat/.env`；如果该文件不存在，可以把同目录下的 `.env.example` 复制一份并重命名为 `.env`。
* 修改配置后需要重启 LibreChat。

## 配置 `.env`

LibreChat 接入 AIHubMix 的核心就是修改安装目录里的 `.env`：把 OpenAI 端点指向 AIHubMix 网关，并配置 API Key。

需要修改的文件位置是：

```text theme={null}
你的安装路径/LibreChat/.env
```

打开 LibreChat 项目根目录下的 `.env` 文件，找到 OpenAI 相关配置区；如果找不到，也可以直接把下面几行追加到 `.env` 文件末尾。

```env theme={null}
OPENAI_API_KEY=你的_AIHubMix_Key
OPENAI_REVERSE_PROXY=https://aihubmix.com/v1
```

如果不想把 Key 直接写进 `.env`，可以把 `OPENAI_API_KEY` 改成 LibreChat 的用户自填模式：

```env theme={null}
OPENAI_API_KEY=user_provided
OPENAI_REVERSE_PROXY=https://aihubmix.com/v1
```

这里的 `user_provided` 是 LibreChat 的特殊写法，表示不把 Key 写死在服务器配置里，而是在用户界面中由当前登录用户自己填写。两种写法只影响 Key 的保存位置，模型仍然都会出现在 LibreChat 的 **OpenAI** 端点下。

如遇当前 API 主地址不可用，可把 `OPENAI_REVERSE_PROXY` 改为备用地址：

```env theme={null}
OPENAI_REVERSE_PROXY=https://api.inferera.com/v1
```

模型列表默认由 AIHubMix 返回，通常不需要手动写 `OPENAI_MODELS`。如果你只想固定展示部分模型，可以在 `.env` 中补充 `OPENAI_MODELS`，多个模型用英文逗号分隔：

```env theme={null}
OPENAI_MODELS=gpt-4o-mini,gpt-5.5,claude-haiku-4-5,deepseek-chat,gemini-3.5-flash,glm-5.2
```

如果希望展示 AIHubMix 支持的完整模型列表，不要配置 `OPENAI_MODELS`，或保留 `.env` 中 `# OPENAI_MODELS=...` 的注释状态。保存后重启 LibreChat，在模型/端点选择区域选择 **OpenAI**，再选择要使用的模型即可。

## 重启 LibreChat

修改 `.env` 后必须重启服务，否则新配置不会生效：

* 使用本地脚本启动：重新运行你的 LibreChat 启动脚本。
* 使用源码或 npm 启动：进入 LibreChat 项目根目录，也就是 `.env` 所在目录，重新执行你原本的启动命令。
* 使用 Docker 部署：在 `docker-compose.yml` 所在目录执行 `docker compose restart`，或重新启动对应容器。

## 效果说明

配置完成后，模型都会出现在 LibreChat 的 **OpenAI** 端点下，模型列表由 AIHubMix 返回，涵盖 AIHubMix 当前支持的模型。只有在 `.env` 中手动启用了 `OPENAI_MODELS` 时，页面才会只显示你写入的那部分模型。

<img src="https://mintcdn.com/aihubmix/j4q_-ouc8NkeJVBQ/public/cn/LibreChat-new-01.png?fit=max&auto=format&n=j4q_-ouc8NkeJVBQ&q=85&s=c0d1e2c385d904659570e6ab9f8a8fbf" alt="LibreChat AIHubMix 模型选择效果" width="1910" height="925" data-path="public/cn/LibreChat-new-01.png" />

## 参考资源

* AIHubMix 官网：[aihubmix.com](https://aihubmix.com)
* LibreChat 官网：[librechat.ai](https://www.librechat.ai/)
* LibreChat 本地安装文档：[librechat.ai/zh/docs/local/npm](https://www.librechat.ai/zh/docs/local/npm)
* LibreChat 环境变量示例：[github.com/danny-avila/LibreChat/blob/main/.env.example](https://github.com/danny-avila/LibreChat/blob/main/.env.example)

更新时间：2026-07-03