RikkaHub の設定

RikkaHub は、オープンソースのネイティブ Android AI チャットクライアントです。Material You デザインを採用し、OpenAI / Google / Anthropic 互換のカスタムエンドポイントをサポートするほか、MCP、Web 検索、メモリ、マルチモーダル入力などの機能を内蔵しています。

前提条件

OfoxAI アカウントを登録済みで API Key を取得済みであること（こちらで取得）
Android スマートフォンに RikkaHub がインストール済みであること（公式サイトからダウンロードまたは Google Play ）

プロトコルを選択

RikkaHub のプロバイダーには OpenAI、Google、Claude の 3 種類があります。いずれも OfoxAI に接続できます：

プロバイダータイプ	対応モデル	API Base Url
OpenAI（汎用）	すべてのモデル。例：`openai/gpt-6-luna`、`deepseek/deepseek-v4.1-flash`	`https://api.ofox.io/v1`
Claude（Claude シリーズに推奨）	`anthropic/claude-sonnet-5`、`anthropic/claude-opus-4.8` など	`https://api.ofox.io/anthropic/v1`
Google（Gemini モデルに推奨）	`google/gemini-3.5-flash` など	`https://api.ofox.io/gemini/v1beta`

中国本土のネットワークではミラードメイン api.ofox.io に切り替えられます。パスは同じで、API Key も共通です。以下のスクリーンショットはミラーアドレスを使用しています。

OpenAI プロトコルの設定

ステップ 1：設定を開く

RikkaHub の左サイドバーを開き、右下の設定アイコンをタップします。

ステップ 2：プロバイダーに移動

設定ページの モデルとサービス グループで プロバイダー をタップします。

ステップ 3：プロバイダーを追加

右上の + をタップして、新しいプロバイダーを作成します。

ステップ 4：設定を入力

タイプで OpenAI を選択し、以下を入力して保存をタップします：

項目	値
名前	`ofox`（任意の名前で可）
API Key	あなたの OfoxAI API Key
API Base Url	`https://api.ofox.io/v1`
有効にする	オン
Response API	OpenAI モデルを使う場合はオン推奨。API パスは自動的に `/responses` になります

RikkaHub は API Base Url と APIパス をそのまま連結してリクエスト URL にします。Base Url の末尾にスラッシュを付けたり、/chat/completions を含めたりしないでください。Response API をオフにすると、API パスはデフォルトの /chat/completions となり、OfoxAI 上のすべてのモデルを呼び出せます。オンにすると OfoxAI 推奨の Responses API 経由になり、ネイティブの Prompt Caching がより効果的です。

ステップ 5：モデルを追加

下部の モデル タブに切り替えます。RikkaHub は OfoxAI のモデルカタログを自動取得するので、利用可能なモデル の一覧から直接チェックして選べます。新しいモデルを追加 をタップして、モデル ID（例：openai/gpt-6-luna）を手動で入力することもできます。

モデル ID にはベンダープレフィックスが必要です。gpt-6-luna 単体ではなく openai/gpt-6-luna と指定します。全カタログはモデルマーケットプレイスで確認できます。

ステップ 6：接続をテスト

設定タブに戻り、左下のプラグアイコンをタップして 接続テスト を開き、モデルを選択して テスト をタップします。非ストリーミング、ストリーミング、ツール呼び出し の 3 項目すべてに緑のチェックマークが表示されれば、設定は成功です。

Claude プロトコルの設定（Claude モデルに推奨）

Claude シリーズのモデルを使う場合は、Anthropic ネイティブプロトコルを推奨します。全機能とネイティブキャッシュの利点が得られます。

ステップ 1：Claude タイプのプロバイダーを作成

上記のステップ 1〜3 と同じ手順でもう 1 つプロバイダーを作成します（例：ofox-claude と命名）。こうすると OpenAI と Claude の両プロトコルを同時に使えます。タイプで Claude を選択し、以下を入力して保存をタップします：

項目	値
名前	`ofox-claude`（任意の名前で可）
API Key	あなたの OfoxAI API Key
API Base Url	`https://api.ofox.io/anthropic/v1`
有効にする	オン
プロンプトキャッシュ（cache_control）	任意。オンにすると長い会話で入力コストを節約できます。詳細は Prompt Caching を参照

Claude タイプの Base Url には 必ず /v1 を含めてください。RikkaHub は末尾に /messages を自動で連結するため、/v1 を省くと /anthropic/messages にリクエストされ、404 が返ります。

ステップ 2：モデルを追加してテスト

モデル タブで Claude モデル（例：anthropic/claude-sonnet-5）を追加し、設定タブに戻ってプラグアイコンをタップし、接続をテストします。3 項目すべてに緑のチェックマークが表示されれば OK です。

Gemini プロトコルの設定（Gemini モデルに推奨）

Gemini モデルを使う場合は、Gemini ネイティブプロトコルを推奨します。

ステップ 1：Google タイプのプロバイダーを作成

上記のステップ 1〜3 と同じ手順でもう 1 つプロバイダーを作成します（例：ofox-gemini と命名）。タイプで Google を選択し、以下を入力して保存をタップします：

項目	値
名前	`ofox-gemini`（任意の名前で可）
API Key	あなたの OfoxAI API Key
API Base Url	`https://api.ofox.io/gemini/v1beta`
Vertex AI	オフ

Google タイプの API Base Url は、デフォルトで Google 公式アドレスを指しています。必ず https://api.ofox.io/gemini/v1beta に変更してください（/v1beta を付け、末尾にスラッシュは付けません）。RikkaHub は末尾に /models/<モデル ID>:generateContent を自動で連結します。Vertex AI のスイッチはオフのままにしてください。

ステップ 2：モデルを追加してテスト

モデル タブで Gemini モデル（例：google/gemini-3.5-flash、google/ プレフィックス付き）を追加し、設定タブに戻ってプラグアイコンをタップし、接続をテストします。3 項目すべてに緑のチェックマークが表示されれば OK です。

推奨モデル

モデル ID	推奨プロバイダータイプ	説明
`openai/gpt-6-luna`	OpenAI	GPT-6 ファミリーで最速かつ最低コストのモデル。日常の会話に最適
`anthropic/claude-sonnet-5`	Claude	Claude Sonnet のフラッグシップ。1M コンテキストで総合力が高い
`google/gemini-3.5-flash`	Google	マルチモーダル対応で高速。頻繁な利用に最適
`deepseek/deepseek-v4.1-flash`	OpenAI	コストパフォーマンスが高く、中国語に強い

使い始める

チャットページに戻り、モデルセレクターで追加した OfoxAI プロバイダーを探し、モデルを選択すれば会話を始められます。RikkaHub の MCP、Web 検索、マルチモーダル入力などの機能は、すべて OfoxAI のモデルと組み合わせて使えます。

よくある質問

Q：接続テストで選択できるモデルがない

接続テストでは、現在のプロバイダーに追加済みのモデルからしか選べません。先に モデル タブで少なくとも 1 つモデルを追加し、その後設定ページに戻ってテストしてください。

Q：Claude タイプのプロバイダーのテストで 404 が返る

API Base Url が https://api.ofox.io/anthropic になっていて、末尾の /v1 が抜けていないか確認してください。正しくは https://api.ofox.io/anthropic/v1 です。

Q：API Key が無効と表示される

API Key を OfoxAI コンソールから完全にコピーできているか、前後に余分な空白がないか確認してください。

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 は共通です。