> ## 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를 연결하면 AIHubMix가 지원하는 OpenAI, Claude, Gemini, DeepSeek, GLM 등의 모델을 LibreChat의 **OpenAI** 엔드포인트에서 사용할 수 있습니다.

## 준비 사항

설정 전에 다음을 확인하세요.

* LibreChat이 설치되어 실행 중입니다. v0.7.5 이상을 권장합니다.
* [AIHubMix 콘솔](https://aihubmix.com/token)에서 API Key를 만들었습니다. 보통 `sk-***` 형식입니다.
* LibreChat 설치 디렉터리의 `.env` 파일을 수정할 수 있습니다. 보통 `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`는 현재 사용자가 UI에서 API Key를 입력하도록 하는 설정입니다. 두 방식 모두 AIHubMix 모델은 **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`를 설정하지 않거나 기존 `# 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
