BotGem 설정
BotGem 은 크로스플랫폼 AI 데스크톱 클라이언트(macOS, Windows, iOS, Android 지원)로, 커스텀 API 제공자를 지원합니다.
사전 요구사항
설정 단계
1단계: 설정 열기
BotGem을 실행하고 왼쪽 사이드바에서 설정을 클릭합니다.
2단계: Service Provider로 이동
Service Provider를 클릭합니다.
3단계: + 클릭 후 프로토콜 선택
+ 버튼을 클릭하고 프로토콜 유형을 선택합니다. OpenAI를 권장합니다:
| 프로토콜 | 선택 | 지원 모델 |
|---|---|---|
| OpenAI Chat（권장） | OpenAI | openai/gpt-4.1, openai/gpt-4.1-mini, openai/gpt-5.4-mini 등 (일부 예시) |
| Claude | Claude | Claude 시리즈 |
| Gemini | Gemini | Gemini 시리즈 |
BotGem은 OpenAI Responses 프로토콜(/v1/responses)을 지원하지 않습니다. 이 프로토콜은 messages 대신 input 필드를 사용하며, BotGem은 표준 Chat Completions 형식만 지원합니다.
4단계: 설정 정보 입력
프로토콜별 API Server:
| 프로토콜 | API Server |
|---|---|
| OpenAI Chat（권장） | https://api.ofox.ai |
| Claude | https://api.ofox.ai/anthropic |
| Gemini | https://api.ofox.ai/gemini |
OpenAI Chat 예시:
| 항목 | 값 |
|---|---|
| Name | ofox (원하는 이름) |
| API Server | https://api.ofox.ai |
| API Key | OfoxAI API Key |
| Models | Refresh로 자동 가져오기, 또는 직접 입력, 예: gpt-4.1 |
https://api.ofox.ai 입력 시 BotGem이 자동으로 https://api.ofox.ai/v1/chat/completions로 보완합니다. OpenAI Chat으로 모든 모델을 사용할 수 있으며, 직접 입력 시 제공자/모델명 형식을 사용하세요 (예: anthropic/claude-opus-4.5).
5단계: 연결 확인 및 저장
연결 확인을 클릭합니다. “연결 성공!”이 표시되면 저장을 클릭합니다.
사용 시작
저장 후 메인 화면으로 돌아가 대화 시작을 클릭합니다. 채팅 창 상단에 현재 모델 이름이 표시됩니다. 메시지를 입력하여 대화를 시작하세요.
문제 해결
Q: 연결 확인이 실패합니다
- API Server 주소가 올바른지 확인 (위 표 참조)
- API Key가 OfoxAI 콘솔 에서 완전히 복사되었는지 확인
- 네트워크 연결 확인
Q: 원하는 모델이 목록에 없습니다
Refresh를 클릭하면 자동으로 목록을 가져옵니다 (접두사 없음, 예: gpt-4.1). 다른 모델은 제공자/모델명 형식으로 직접 입력하세요:
| 모델 | 입력 이름 |
|---|---|
| DeepSeek V3 | deepseek/deepseek-v3.2 |
| Claude Sonnet | anthropic/claude-sonnet-4.6 |
| Gemini Flash | google/gemini-3.1-flash-lite-preview |
전체 목록은 모델 목록 에서 확인하세요.