> ## 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 中使用

> 透過 OpenAI 相容端點將 LibreChat 接入 AIHubMix。

LibreChat 是一個開源多模型對話客戶端。接入 AIHubMix 後，可以在 LibreChat 的 **OpenAI** 端點下使用 AIHubMix 支援的 OpenAI、Claude、Gemini、DeepSeek、GLM 等模型。

## 環境準備

設定前請確認：

* 已安裝並啟動可用的 LibreChat，建議 v0.7.5 或更高版本。
* 已在 [AIHubMix 控制台](https://aihubmix.com/token)建立 API Key，通常為 `sk-***` 格式。
* 可以修改 LibreChat 安裝目錄中的 `.env` 檔案。它通常位於 LibreChat 專案根目錄，與 `package.json`、`docker-compose.yml` 同級。
* 檔案位置通常是 `你的安裝路徑/LibreChat/.env`。如果不存在，可將同目錄下的 `.env.example` 複製一份並重新命名為 `.env`。

## 設定 `.env`

開啟 LibreChat 專案根目錄下的 `.env`，新增或修改以下內容：

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

如果不想把 Key 寫入 `.env`，可以使用 LibreChat 的使用者自填模式：

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

`user_provided` 表示 LibreChat 會在介面中請目前使用者自行填寫 API Key。兩種方式下，模型都會出現在 **OpenAI** 端點中。

如目前 API 主網域不可用，可改用備用網域：

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

模型列表預設由 AIHubMix 返回，通常不需要設定 `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

修改 `.env` 後必須重新啟動 LibreChat：

* 使用本機腳本啟動：重新執行原本的 LibreChat 啟動腳本。
* 使用原始碼或 npm 啟動：進入 `.env` 所在的 LibreChat 專案根目錄，重新執行原本的啟動命令。
* 使用 Docker 部署：在 `docker-compose.yml` 所在目錄執行 `docker compose restart`，或重新啟動對應容器。

## 效果說明

重新啟動後，在 LibreChat 的端點/模型選擇區選擇 **OpenAI**，再選擇要使用的 AIHubMix 模型。如果未設定 `OPENAI_MODELS`，模型列表會由 AIHubMix 返回。

<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/docs/local/npm](https://www.librechat.ai/docs/local/npm)
* LibreChat `.env.example`：[github.com/danny-avila/LibreChat/blob/main/.env.example](https://github.com/danny-avila/LibreChat/blob/main/.env.example)

***

最後更新：2026-07-03