준비 사항
설정 전에 다음을 확인하세요.- LibreChat이 설치되어 실행 중입니다. v0.7.5 이상을 권장합니다.
- AIHubMix 콘솔에서 API Key를 만들었습니다. 보통
sk-***형식입니다. - LibreChat 설치 디렉터리의
.env파일을 수정할 수 있습니다. 보통package.json,docker-compose.yml과 같은 프로젝트 루트에 있습니다. - 경로는 일반적으로
설치경로/LibreChat/.env입니다. 파일이 없다면 같은 디렉터리의.env.example을 복사해.env로 이름을 바꿉니다.
.env 설정
LibreChat 프로젝트 루트의 .env를 열고 다음 줄을 추가하거나 수정합니다.
.env에 저장하지 않으려면 LibreChat의 사용자 입력 모드를 사용합니다.
user_provided는 현재 사용자가 UI에서 API Key를 입력하도록 하는 설정입니다. 두 방식 모두 AIHubMix 모델은 OpenAI 엔드포인트 아래에 표시됩니다.
기본 API 도메인을 사용할 수 없다면 백업 도메인을 사용합니다.
OPENAI_MODELS를 설정할 필요가 없습니다. 특정 모델만 표시하려면 쉼표로 구분해 추가합니다.
OPENAI_MODELS를 설정하지 않거나 기존 # OPENAI_MODELS=... 줄을 주석 상태로 둡니다.
LibreChat 재시작
.env를 수정한 뒤에는 LibreChat을 재시작해야 합니다.
- 로컬 스크립트: 기존 LibreChat 시작 스크립트를 다시 실행합니다.
- 소스 또는 npm 실행:
.env가 있는 LibreChat 프로젝트 루트에서 평소 시작 명령을 다시 실행합니다. - Docker:
docker-compose.yml이 있는 디렉터리에서docker compose restart를 실행하거나 컨테이너를 재시작합니다.
결과
재시작 후 LibreChat의 엔드포인트/모델 선택에서 OpenAI를 고르고 사용할 AIHubMix 모델을 선택합니다.OPENAI_MODELS를 설정하지 않았다면 목록은 AIHubMix에서 제공됩니다.
참고 자료
- AIHubMix: aihubmix.com
- LibreChat: librechat.ai
- LibreChat 로컬 설치 문서: librechat.ai/docs/local/npm
- LibreChat
.env.example: github.com/danny-avila/LibreChat/blob/main/.env.example
마지막 업데이트: 2026-07-03