アプリケーションルーティング
機能説明
アプリケーションルーティングとは、Olenro のルーティングサービスが特定アプリの API リクエストをルーティングすることです。
ルーティングを有効にすると:
- アプリの API リクエストがローカルルーティング経由で転送される
- リクエストログと使用量の統計を記録できる
- フェイルオーバー機能を使用できる
前提条件
アプリケーションルーティング機能を使用する前に、ルーティングサービスを起動する必要があります。
ルーティングの有効化
操作場所
設定 → 詳細 → ルーティングサービス → アプリケーションルーティングエリア
操作手順
- ルーティングサービスが起動していることを確認
- 「アプリケーションルーティング」エリアを見つける
- 必要なアプリのスイッチをオンにする
ルーティングスイッチ
| スイッチ | 作用 |
|---|---|
| Claude ルーティング | Claude Code のリクエストをルーティング |
| Codex ルーティング | Codex のリクエストをルーティング |
| Gemini ルーティング | Gemini CLI のリクエストをルーティング |
複数のアプリのルーティングを同時に有効にできます。
ルーティングの仕組み
設定の変更
ルーティングを有効にすると、Olenro はアプリの設定ファイルを変更し、API エンドポイントをローカルルーティングに向けます。
Claude 設定の変更:
// ルーティング前
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.anthropic.com"
}
}
// ルーティング後
{
"env": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:15721"
}
}Codex 設定の変更:
# ルーティング前
base_url = "https://api.openai.com/v1"
# ルーティング後
base_url = "http://127.0.0.1:15721/v1"Gemini 設定の変更:
# ルーティング前
GOOGLE_GEMINI_BASE_URL=https://generativelanguage.googleapis.com
# ルーティング後
GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:15721リクエストの転送
ルーティングサービスがリクエストを受信すると:
- リクエスト元を識別(Claude/Codex/Gemini)
- そのアプリで現在有効なプロバイダーを検索
- プロバイダーの実際のエンドポイントにリクエストを転送
- リクエストログを記録
- アプリにレスポンスを返却
ルーティングステータスの表示
メイン画面の表示
ルーティングを有効にすると、メイン画面に以下の変化があります:
- ルーティング Logo の色:無色から緑に変化
- プロバイダーカード:現在アクティブなプロバイダーに緑の枠が表示
プロバイダーカードの状態
| 状態 | 枠の色 | 説明 |
|---|---|---|
| 現在有効 | 青 | 設定ファイル内のプロバイダー(非ルーティングモード) |
| ルーティングアクティブ | 緑 | ルーティングが実際に使用しているプロバイダー |
| 通常 | デフォルト | 使用されていないプロバイダー |
ルーティングの無効化
操作手順
- ルーティングパネルで対応するアプリのルーティングスイッチをオフにする
- またはルーティングサービスを直接停止
設定の復元
ルーティングを無効にすると、Olenro は以下を実行します:
- アプリの設定をルーティング前の状態に復元
- 現在のリクエストログを保存
ルーティングとプロバイダーの切り替え
ルーティングモードでのプロバイダー切り替え
ルーティングモードでプロバイダーを切り替える場合:
- メイン画面でプロバイダーの「有効化」ボタンをクリック
- ルーティングサービスが新しいプロバイダーを使用してリクエストを即座に転送
- CLI ツールの再起動は不要
これがルーティングモードの大きなメリットです:プロバイダーの切り替えが即座に反映されます。
非ルーティングモードでのプロバイダー切り替え
非ルーティングモードでプロバイダーを切り替える場合:
- 設定ファイルを変更
- CLI ツールの再起動が必要
複数アプリのルーティング
複数のアプリを同時にルーティングでき、それぞれ独立して管理されます:
- 独立したプロバイダー設定
- 独立したフェイルオーバーキュー
- 独立したリクエスト統計
使用シーン
シーン 1:使用量の監視
ルーティング + ログ記録を有効にして、API の使用状況を監視します。
シーン 2:素早い切り替え
ルーティングを有効にすると、プロバイダーの切り替えに CLI ツールの再起動が不要になります。
シーン 3:フェイルオーバー
ルーティングの有効化はフェイルオーバー機能を使用するための前提条件です。
注意事項
パフォーマンスへの影響
ルーティングにより少量のレイテンシ(通常 < 10ms)が追加されますが、ほとんどのシーンでは無視できます。
ネットワーク要件
ルーティングモードでは、CLI ツールがローカルルーティングアドレスにアクセスできる必要があります。
設定のバックアップ
ルーティングを有効にする前に、Olenro は元の設定をバックアップし、無効化時に復元します。
よくある質問
ルーティング後にリクエストが失敗する
確認事項:
- ルーティングサービスが正常に実行されているか
- プロバイダーの設定が正しいか
- ネットワークが正常か
ルーティングを無効にしても設定が復元されない
考えられる原因:
- ルーティングサービスの異常終了
- 設定ファイルが他のプログラムに変更された
解決方法:
- プロバイダーを手動で編集して保存し直す
- または再度ルーティングを有効にしてから無効にする