# LobeHub

LobeHub는 사용자 지정 AI 공급자를 추가할 수 있습니다. 요청 형식을 OpenAI로 선택하고 주소를 /v1까지 입력하면 NezhaGate의 모든 모델을 쓸 수 있으며, 자체 호스팅 인스턴스는 환경 변수로도 설정할 수 있습니다.

> https://nezhagate.com/ko/docs/integrations/lobehub

작성 기준 버전: LobeHub 2.2

## 사용자 지정 공급자 추가하기

1. **App Settings** → **AI Providers**를 열고 **Add Custom Provider**를 클릭하세요.

2. 소문자로 **Provider ID**를 입력하고(소문자, 숫자, `-`, `_`만 가능하며 나중에 바꿀 수 없습니다), **Request Format**에서 **OpenAI**를 선택하고, **Proxy URL**에 `https://nezhagate.com/v1`을, **API Key**에 자신의 키를 입력한 뒤 **Create**를 클릭하세요.

3. 공급자 페이지에서 **Fetch models**를 클릭하거나 **Add Model**로 직접 모델을 추가하세요. 이때 최대 컨텍스트 창을 설정하고, 모델이 지원하면 도구 호출과 비전에 체크하세요.

4. 원하는 모델을 활성화한 뒤 채팅에서 선택하세요.

Proxy URL`https://nezhagate.com/v1`

**Use Client Request Mode**는 꺼 두세요(NezhaGate의 API는 브라우저의 크로스 오리진 요청을 받지 않습니다). **Use Responses API Specification**도 꺼 두세요.

## Claude(선택 사항)

**Request Format**을 **Anthropic**으로, **Proxy URL**을 `https://nezhagate.com/anthropic`로 설정해 사용자 지정 공급자를 하나 더 추가하세요.

## 자체 호스팅: 환경 변수

자체 호스팅 LobeHub는 환경 변수만으로 NezhaGate를 가리키게 할 수 있습니다:

```
OPENAI_API_KEY=YOUR_API_KEY
OPENAI_PROXY_URL=https://nezhagate.com/v1
OPENAI_MODEL_LIST=-all,+gpt-5.5,+claude-sonnet-5
ANTHROPIC_API_KEY=YOUR_API_KEY
ANTHROPIC_PROXY_URL=https://nezhagate.com/anthropic
```

`OPENAI_MODEL_LIST`에서 `-all`은 내장 모델을 모두 숨기고, `+model-id`는 NezhaGate의 모델을 추가하며, `+model-id=Display name`은 표시 이름도 함께 지정합니다.

## 테스트

공급자 페이지의 **Connectivity Check**에서 모델을 고르고 **Check**를 클릭하세요(짧은 메시지 하나를 보냅니다). Check passed가 뜨면 완료입니다.

## 자주 나오는 오류

**응답이 없거나 빈 응답이 올 때**

Proxy URL에는 반드시 `/v1`이 포함되어야 합니다: `https://nezhagate.com/v1`.

**Failed to fetch models**

키와 Proxy URL을 확인하세요. **Add Model**로 모델을 직접 추가할 수도 있습니다.

**브라우저 콘솔에 CORS 오류가 뜰 때**

**Use Client Request Mode**를 꺼서 요청이 LobeHub의 서버에서 나가도록 하세요.