RikkaHub 설정
RikkaHub 는 Material You 디자인을 적용한 오픈소스 네이티브 Android AI 채팅 클라이언트입니다. OpenAI / Google / Anthropic 호환 엔드포인트를 직접 지정할 수 있고, MCP, 웹 검색, 메모리, 멀티모달 입력 등의 기능이 내장되어 있습니다.
사전 요구사항
- OfoxAI 계정과 API Key(여기서 발급 )
- Android 휴대폰에 RikkaHub 설치(공식 사이트에서 다운로드 또는 Google Play )
프로토콜 선택
RikkaHub의 제공업체 유형은 OpenAI, Google, Claude 세 가지이며, 모두 OfoxAI에 연결할 수 있습니다:
| 제공업체 유형 | 적용 모델 | API Base Url |
|---|---|---|
| OpenAI(범용) | 모든 모델, 예: openai/gpt-6-luna, deepseek/deepseek-v4.1-flash | https://api.ofox.ai/v1 |
| Claude(Claude 시리즈 권장) | anthropic/claude-sonnet-5, anthropic/claude-opus-4.8 등 | https://api.ofox.ai/anthropic/v1 |
| Google(Gemini 모델 권장) | google/gemini-3.5-flash 등 | https://api.ofox.ai/gemini/v1beta |
중국 본토 네트워크에서는 미러 도메인 api.ofox.io를 사용할 수 있습니다. 경로는 동일하고 API Key도 공용입니다. 아래 스크린샷은 미러 주소를 사용한 것입니다.
OpenAI 프로토콜 설정
1단계: 설정 열기
RikkaHub 왼쪽 사이드바를 열고 오른쪽 아래의 설정 아이콘을 탭하세요.
2단계: 제공업체로 이동
설정 페이지의 모델 및 서비스 그룹에서 제공업체를 탭하세요.
3단계: 제공업체 추가
오른쪽 위의 + 를 탭해 새 제공업체를 만드세요.
4단계: 설정 정보 입력
유형은 OpenAI를 선택하고, 아래 정보를 입력한 뒤 저장을 탭하세요:
| 설정 항목 | 값 |
|---|---|
| 이름 | ofox(또는 원하는 이름) |
| API 키 | 본인의 OfoxAI API Key |
| API 기본 URL | https://api.ofox.ai/v1 |
| 활성화 | 켜기 |
| 응답 API | OpenAI 모델 사용 시 켜는 것을 권장하며, API 경로가 자동으로 /responses로 바뀝니다 |
RikkaHub는 API 기본 URL과 API 경로를 그대로 이어 붙여 요청 주소를 만듭니다. Base URL 끝에 슬래시를 붙이지 말고, /chat/completions도 붙이지 마세요. 응답 API를 끄면 API 경로는 기본값인 /chat/completions가 되어 OfoxAI의 모든 모델을 호출할 수 있고, 켜면 OfoxAI가 권장하는 Responses API를 사용하므로 네이티브 Prompt Caching 효율이 더 좋습니다.
5단계: 모델 추가
아래쪽의 모델 탭으로 전환하세요. RikkaHub가 OfoxAI 모델 카탈로그를 자동으로 가져오므로 사용 가능한 모델 목록에서 바로 선택할 수 있습니다. 새 모델 추가를 탭해 openai/gpt-6-luna처럼 모델 ID를 직접 입력해도 됩니다.
모델 ID에는 벤더 접두사가 필요합니다. 접두사 없는 gpt-6-luna가 아니라 openai/gpt-6-luna로 입력하세요. 전체 목록은 모델 마켓플레이스 에서 확인하세요.
6단계: 연결 테스트
구성 탭으로 돌아가 왼쪽 아래의 플러그 아이콘을 탭해 연결 테스트를 열고, 모델을 선택한 뒤 테스트를 탭하세요. 비스트리밍, 스트리밍, 도구 호출 세 항목에 모두 초록색 체크가 표시되면 설정이 완료된 것입니다.
Claude 프로토콜 설정 (Claude 모델 권장)
Claude 시리즈 모델을 호출할 때는 Anthropic 네이티브 프로토콜을 권장합니다. 전체 기능과 네이티브 캐싱의 이점을 누릴 수 있습니다.
1단계: Claude 유형 제공업체 만들기
위의 1–3단계를 따라 제공업체를 하나 더 만드세요(예: ofox-claude라는 이름). 이렇게 하면 OpenAI와 Claude 두 프로토콜을 동시에 사용할 수 있습니다. 유형은 Claude를 선택하고, 아래 정보를 입력한 뒤 저장을 탭하세요:
| 설정 항목 | 값 |
|---|---|
| 이름 | ofox-claude(또는 원하는 이름) |
| API 키 | 본인의 OfoxAI API Key |
| API 기본 URL | https://api.ofox.ai/anthropic/v1 |
| 활성화 | 켜기 |
| 프롬프트 캐싱 (cache_control) | 선택 사항이며, 켜면 긴 대화에서 입력 비용을 절약할 수 있습니다. 자세한 내용은 Prompt Caching 참고 |
Claude 유형의 Base URL에는 반드시 /v1을 붙여야 합니다. RikkaHub가 뒤에 /messages를 자동으로 이어 붙이므로, /v1을 빠뜨리면 /anthropic/messages로 요청이 가서 404가 반환됩니다.
2단계: 모델 추가 및 테스트
모델 탭에서 Claude 모델(예: anthropic/claude-sonnet-5)을 추가하고, 구성 탭으로 돌아가 플러그 아이콘을 탭해 연결을 테스트하세요. 세 항목 모두 초록색 체크가 표시되면 됩니다.
Gemini 프로토콜 설정 (Gemini 모델 권장)
Gemini 모델을 사용할 때는 Gemini 네이티브 프로토콜을 권장합니다.
1단계: Google 유형 제공업체 만들기
위의 1–3단계를 따라 제공업체를 하나 더 만드세요(예: ofox-gemini라는 이름). 유형은 Google을 선택하고, 아래 정보를 입력한 뒤 저장을 탭하세요:
| 설정 항목 | 값 |
|---|---|
| 이름 | ofox-gemini(또는 원하는 이름) |
| API 키 | 본인의 OfoxAI API Key |
| API 기본 URL | https://api.ofox.ai/gemini/v1beta |
| Vertex AI | 끄기 |
Google 유형의 API Base Url은 기본적으로 Google 공식 주소를 가리킵니다. 반드시 https://api.ofox.ai/gemini/v1beta로 변경하세요(/v1beta를 붙이고 끝에 슬래시는 붙이지 않습니다). RikkaHub가 뒤에 /models/<모델 ID>:generateContent를 자동으로 이어 붙입니다. Vertex AI 스위치는 꺼 둔 상태로 두세요.
2단계: 모델 추가 및 테스트
모델 탭에서 Gemini 모델(예: google/gemini-3.5-flash, google/ 접두사 포함)을 추가하고, 구성 탭으로 돌아가 플러그 아이콘을 탭해 연결을 테스트하세요. 세 항목 모두 초록색 체크가 표시되면 됩니다.
추천 모델
| 모델 ID | 권장 제공업체 유형 | 설명 |
|---|---|---|
openai/gpt-6-luna | OpenAI | GPT-6 패밀리에서 가장 빠르고 저렴한 모델로, 일상 대화에 적합 |
anthropic/claude-sonnet-5 | Claude | Claude Sonnet 플래그십, 1M 컨텍스트, 뛰어난 종합 성능 |
google/gemini-3.5-flash | 멀티모달 지원, 빠른 속도, 잦은 사용에 적합 | |
deepseek/deepseek-v4.1-flash | OpenAI | 가성비가 좋고 중국어 성능이 우수 |
시작하기
채팅 화면으로 돌아가 모델 선택기에서 방금 추가한 OfoxAI 제공업체를 찾아 모델을 선택하면 바로 대화를 시작할 수 있습니다. RikkaHub의 MCP, 웹 검색, 멀티모달 입력 등의 기능도 모두 OfoxAI 모델과 함께 사용할 수 있습니다.
자주 묻는 질문
Q: 연결 테스트에서 선택할 수 있는 모델이 없습니다
연결 테스트는 현재 제공업체에 이미 추가된 모델 중에서만 선택할 수 있습니다. 먼저 모델 탭에서 모델을 하나 이상 추가한 뒤 구성 페이지로 돌아가 테스트하세요.
Q: Claude 유형 제공업체 테스트에서 404가 반환됩니다
API Base Url이 https://api.ofox.ai/anthropic으로 입력되어 끝의 /v1이 빠지지 않았는지 확인하세요. 올바른 값은 https://api.ofox.ai/anthropic/v1입니다.
Q: API Key가 유효하지 않다고 표시됩니다
OfoxAI 콘솔 에서 API Key를 통째로 복사했는지, 앞뒤에 불필요한 공백이 없는지 확인하세요.
Q: 모델이 존재하지 않는다고 표시됩니다
모델 ID에 벤더 접두사가 빠져 있습니다. OfoxAI의 모델 ID 형식은 벤더/모델명이며, 예를 들면 openai/gpt-6-luna, anthropic/claude-sonnet-5입니다.
Q: 중국 본토 네트워크에서 연결이 실패합니다
API Base Url을 미러 주소로 바꾸세요. OpenAI 유형은 https://api.ofox.io/v1, Claude 유형은 https://api.ofox.io/anthropic/v1을 입력하며, API Key는 공용입니다.