プロバイダーの追加

追加パネルを開く

メイン画面右上の + ボタンをクリックして、プロバイダー追加パネルを開きます。

パネルは 2 つのタブに分かれています：

• アプリ専用プロバイダー：現在選択中のアプリ（Claude Code / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes）専用
• 統一プロバイダー：アプリ間で共有する設定

プリセットで追加

プリセットは事前に設定されたプロバイダーテンプレートで、API Key を入力するだけで使用できます。

操作手順

1. 「プリセット」ドロップダウンからプロバイダーを選択
2. 名前とエンドポイントが自動入力される
3. API Key を入力
4. （任意）メモを入力
5. 「追加」をクリック

主なプリセット

Claude プリセット

⭐ は公式パートナーを示します。プリセットリストはバージョンの更新に伴い変更される場合があります。アプリ内の実際の表示を基準にしてください。

Claude Desktop プリセット

Claude Desktop パネルには、Claude Code のプリセットカタログから変換されたプロバイダープリセットが含まれます。追加時には次のモードを選択できます：

• 直結モード：プロバイダーがネイティブの Anthropic Messages API を提供し、Claude Desktop から直接アクセスできる場合
• モデルマッピングモード：非 Claude モデルを Olenro ローカルゲートウェイ経由で Sonnet / Opus / Haiku ルートへマッピング
• Claude Desktop Official：Claude Desktop の公式サインインモードへ戻す

詳しい手順は 2.6 Claude Desktop を参照してください。

Codex プリセット

Codex プリセットは上流プロトコルにより 2 種類に分かれます。

ネイティブ Responses プロトコル（直接接続または標準プロキシ転送）：

Chat Completions プロトコル（「ローカルルーティングが必要」トグルが必要。プロキシが自動変換）：

💡 Chat Completions 系プリセットを選択すると、「ローカルルーティングが必要」トグルとモデルマッピング表が自動的に設定されます。詳細は下記の「Codex ローカルルーティングとモデルマッピング」セクションを参照してください。プリセット一覧は継続的に更新されます。アプリ内の表示を正としてください。

Gemini プリセット

OpenCode プリセット

プリセットリストは継続的に更新されています。アプリ内の実際の表示を基準にしてください。

OpenClaw プリセット

モデル自動取得

プロバイダーの追加や編集時に、プロバイダーのエンドポイントから利用可能なモデルを自動検出でき、モデル ID の手動コピー＆ペーストの手間を省けます。

1. API Key と エンドポイントアドレス が入力されていることを確認
2. モデル入力フィールドの横にある モデル取得 ボタン（ダウンロードアイコン）をクリック
3. Olenro が設定された API Key で OpenAI 互換の /v1/models エンドポイントを呼び出し
4. カテゴリ別にグループ化されたドロップダウンからモデルを選択

この機能は Claude Code / Claude Desktop / Codex / Gemini / OpenCode / OpenClaw / Hermes のうちモデル項目を持つプロバイダーフォームで利用でき、/v1/models エンドポイントをサポートするプロバイダーに対応します。Codex OAuth 系プロバイダーでは、必要に応じて ChatGPT Codex バックエンドからライブモデル一覧を取得します。

よくあるエラー：

• 認証失敗（401/403）：API Key が正しいか確認してください
• エンドポイント未対応（404/405）：プロバイダーが /v1/models エンドポイントを公開していません。手動でモデル ID を入力してください
• 解析失敗：レスポンスが OpenAI 互換フォーマットに準拠していません
• タイムアウト：エンドポイントの応答が遅いです。後ほど再試行するかネットワークを確認してください

カスタム設定

「カスタム」プリセットを選択した場合、JSON 設定を手動で編集する必要があります。

Claude 設定形式

{
  "env": {
    "ANTHROPIC_API_KEY": "your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.example.com"
  }
}

Codex 設定形式

Codex は 2 つの設定ファイルを使用します：

1. auth.json（~/.codex/auth.json）- API キーを保存：

{
  "OPENAI_API_KEY": "your-api-key"
}

2. config.toml（~/.codex/config.toml）- モデルとエンドポイントの設定を保存：

# 基本設定
model_provider = "custom"
model = "gpt-5.2"
model_reasoning_effort = "high"
disable_response_storage = true

# カスタムプロバイダー設定
[model_providers.custom]
name = "custom"
base_url = "https://api.example.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json フィールド説明：

config.toml フィールド説明：

API Key またはカスタムエンドポイントのプロバイダーへ切り替えた後、Codex が /goal を認識しているのに目標を設定できない場合は、プロバイダー編集画面の Goal mode スイッチを有効にしてください。Olenro はそのプロバイダーの ~/.codex/config.toml の [features] に goals = true を書き込みます。その後、Codex を再起動してください。Goal mode 有効化後に想定より頻繁に承認を求められる場合は、Codex の設定画面を再読み込みし、approval_policy と sandbox_mode が意図した権限と一致しているか確認してください。

Gemini 設定形式

{
  "env": {
    "GEMINI_API_KEY": "your-api-key",
    "GOOGLE_GEMINI_BASE_URL": "https://api.example.com"
  }
}

認証タイプは Olenro が自動的に検出します（PackyCode API プロキシ / Google OAuth / 汎用 API Key）。手動設定は不要です。

統一プロバイダー

統一プロバイダーは Claude Code / Codex / Gemini 間で設定を共有でき、複数の API 形式をサポートする中継サービスに適しています。

統一プロバイダーの作成

1. 「統一プロバイダー」タブに切り替え
2. 「統一プロバイダーを追加」をクリック
3. 共通設定を入力：
   • 名前
   • API Key
   • エンドポイントアドレス
4. 同期するアプリにチェック（Claude Code / Codex / Gemini）
5. 保存

同期の仕組み

統一プロバイダーはチェックしたアプリに自動的に同期されます：

• 統一プロバイダーを変更すると、関連するすべてのアプリの設定が同期更新される
• 統一プロバイダーを削除すると、関連するアプリの設定も削除される

保存して同期

統一プロバイダーの編集時に選択できます：

手動同期

手動で同期をトリガーする場合：

1. 統一プロバイダーカードの「同期」ボタンをクリック
2. 同期操作を確認
3. 各アプリの関連プロバイダーの設定が上書きされる

プロバイダーのインポート

Olenro は 2 つの方法でプロバイダー設定をインポートできます：

方法 1：ディープリンクでインポート

olenro:// プロトコルリンクでワンクリックインポート：

1. ディープリンクをクリックまたはアクセス
2. Olenro が自動的に開き、インポート確認を表示
3. 設定情報をプレビュー
4. 「インポートを確認」をクリック

ディープリンクの取得方法：

• 他の人からの共有で取得
• オンライン生成ツール で作成

方法 2：データベースバックアップからインポート

SQL バックアップファイルから一括インポート：

1. 「設定 → 詳細 → データ管理」を開く
2. 「ファイルを選択」をクリック
3. 以前にエクスポートした .sql バックアップファイルを選択
4. 「インポート」をクリック
5. 既存の設定の上書きを確認

インポート内容：

• すべてのプロバイダー設定
• MCP サーバー設定
• Prompts プリセット
• 使用量ログ

注意：インポートは既存のデータベースを上書きするため、事前に現在の設定をエクスポートしてバックアップすることをお勧めします。エクスポートファイル名の形式は olenro-export-{タイムスタンプ}.sql です。

Codex OAuth リバースプロキシ（Claude プロバイダー）

v3.13.0 より、Olenro は Codex OAuth リバースプロキシ 経路を追加しました。ChatGPT アカウント を使って Claude Code 内から Codex サービスを再利用できます。

位置ヒント：この機能は 新しい Claude プロバイダーカードタイプ として表示され、Codex 側のプリセットではありません。追加後は通常の API Key プロバイダーと並んで Claude のプロバイダーリストに表示されます。

前提条件

• ログイン可能な ChatGPT アカウント
• auth.openai.com および chatgpt.com にアクセスできる
• 利用前に必ず本節末尾の ⚠️ リスク通知 をお読みください

2 つの入口

以下のどちらの入口からでも開始できます：

入口 A：プロバイダー追加パネルから（新規ユーザー推奨）

1. Claude アプリに切り替える
2. 右上の + ボタンをクリックしてプロバイダー追加パネルを開く
3. プリセットリストの第三者カテゴリから Codex (ChatGPT Plus/Pro) プリセットを選択（UI に表示される名称を優先）
4. まだ ChatGPT アカウントにログインしていない場合、パネルが 自動的に ログインフローへ誘導します（下記「ログインフロー」を参照）
5. ログイン成功後、プロバイダーフォームにログイン済みアカウントが表示されるので「保存」をクリックして完了

入口 B：OAuth 認証センターから（マルチアカウント管理に適する）

1. 設定 → OAuth 認証センター を開く（タブに Beta マーク）
2. ChatGPT (Codex OAuth) セクションで ChatGPT でログイン ボタンをクリック
3. ログインフローを完了（下記参照）
4. ログイン完了後、Claude アプリに戻る → プロバイダーの追加 → 同じ Codex (ChatGPT Plus/Pro) プリセットを選択
5. フォーム内の「アカウント選択」ドロップダウンから、先ほどログインしたアカウントを選択して保存

ログインフロー（Device Code）

どちらの入口から入っても、ログインフローは同一です：

1. 認証コードを取得：Olenro が OpenAI Device Code フローを呼び出し、以下を表示：
   • 認証コード（約 8 文字、例：ABCD-1234）
   • 認証コード右側の コピー ボタン
   • その下の認証 URL https://auth.openai.com/codex/device
   • 「認証を待っています...」のアニメーション表示
2. ブラウザ認証：リンクをクリック（または URL を手動で訪問）し、ブラウザで：
   • ChatGPT アカウントにログイン
   • 先ほどコピーした認証コードを入力
   • 認証を確認
3. 自動ポーリング完了：Olenro はバックグラウンドで OpenAI サーバーをポーリングし、認証成功を検知すると待機画面を自動的に閉じます
4. ログイン済みアカウントを表示：ログインした ChatGPT アカウント（ログインメール）が OAuth 認証センター → ログイン済みアカウント リストに表示されます

⏱️ 認証コードの有効期限は約 15 分 です。タイムアウトすると「Device Code の有効期限切れ」が表示されるので、再試行 をクリックして新しい認証コードを取得してください。

有効化と使用

Codex OAuth プロバイダーを追加・保存した後：

1. Claude のプロバイダーリストから探す
2. カードの 有効化 ボタンをクリック —— 通常のプロバイダーと同じ
3. Claude Code CLI がリバースプロキシ経由で Codex サービスを使用します
4. トレイメニューの Claude サブメニューにもこのプロバイダーが表示され、素早く切り替え可能

内部動作：Olenro はリクエストを https://chatgpt.com/backend-api/codex にルーティングし、base URL が強制的に書き換えられます —— フォームにエンドポイントを手動入力する 必要はありません。API フォーマットは openai_responses に固定されます。

デフォルトモデル

Codex OAuth プリセットのデフォルトモデルマッピング：

v3.15.0 以降、Codex OAuth のモデル選択は固定リストだけに依存しません。モデルセレクターを開くと、Olenro は必要に応じて ChatGPT Codex バックエンドから利用可能モデルを取得します。デフォルトマッピングは引き続き上書きできます。

プロバイダーの JSON エディタで ANTHROPIC_MODEL などの環境変数を上書きしてカスタマイズできます。

マルチアカウント管理（OAuth 認証センター）

OAuth 認証センター は複数の ChatGPT アカウントの同時管理をサポートします：

使用シーン：チームで開発マシンを共有する場合、各メンバーの ChatGPT アカウントごとに 1 つのプロバイダーを作成し、トレイメニューから素早く切り替えできます。

Token 自動更新

• Token は 有効期限の 60 秒前 に自動更新され、すべてバックグラウンドで処理されるため手動介入は不要です
• Refresh Token はローカルデータディレクトリに保存され、どこにもアップロードされません
• Token のエクスポートは サポートされていません（漏洩防止）

クォータ表示

ログインしてプロバイダーを有効化すると、プロバイダーカード下部 に自動的にアカウントクォータが表示されます：

⚠️ セッション期限切れ：Token が完全に無効になった（自動更新できない）場合、カード下部に黄色い警告枠「セッション期限切れ」が表示されます。OAuth 認証センター からこのアカウントを削除し、再ログインしてください。

よくある失敗

⚠️ リスク通知（重要）

Codex OAuth リバースプロキシは リバースエンジニアリングされた OAuth フロー で ChatGPT アカウントの Codex サービスにアクセスします。有効化前に必ず以下のリスクをご理解ください：

1. 利用規約違反：OpenAI の利用規約に違反する可能性があります。同規約は未承認の自動化アクセス、サービスの複製、および既定のアクセス経路の迂回を禁止しています
2. アカウントリスク：OpenAI は異常な使用パターンを疑わしい自動化として検知し、ChatGPT アカウントに一時的または永続的な制限を課す可能性があります
3. 長期的な可用性は保証されません：OpenAI は認証および検出メカニズムをいつでも更新する可能性があり、現在利用可能な方法が将来ブロックされる可能性があります

この機能を有効化することは、すべてのリスクを自己責任で負うことを意味します。Olenro は本機能の使用による一切のアカウント制限、警告、サービス停止について責任を負いません。

📖 完全な免責事項と背景は v3.13.0 Release Notes をご覧ください。

高度なオプション

API フォーマット（Claude のみ）

サードパーティ API を使用する Claude プロバイダーを追加する際、高度なオプションセクションで正しい API フォーマット を選択する必要がある場合があります：

注意：API フォーマットの変換はプロキシサービスが担当します。Anthropic 以外のフォーマットを使用する場合、リクエスト/レスポンスの正しい変換のためにプロキシが接管有効の状態で稼働している必要があります。詳しくは 4.1 プロキシサービス をご覧ください。

デフォルト以外の API フォーマットが設定されている場合、高度なオプションセクションが自動展開されます。

完全URLエンドポイントモード

v3.13.0 で追加された高度なオプション。デフォルトでは、Olenro は設定された base_url を プレフィックス として扱い、/v1/chat/completions などの固定パスを後ろに連結します。一部のベンダー（非標準の URL レイアウトを必要とする第三者サービスなど）では、この連結方式ではリクエストが失敗します。

有効化方法：

1. プロバイダーを編集し、「高度なオプション」を展開
2. 完全 URL モード チェックボックスにチェックを入れる
3. 完全なアップストリームエンドポイント（プレフィックスではなく）を base_url に入力

例の比較：

使用シーン：

• ベンダーが非標準パスを要求する場合（/v1/chat/completions 以外）
• ベンダーに多階層のパス構造がある場合
• ベンダー専用の API ゲートウェイパス

ヒント：プロキシ転送および Stream Check のいずれも「完全 URL モード」の設定に従うため、有効化後に追加調整は不要です。このオプションを無効化すると、パス連結はデフォルトの動作に戻ります。

Claude 共通設定クイックトグル

Claude プロバイダーの編集時、JSON エディタの上部に クイックトグル が利用できます：

トグルのチェックを外すと、対応する設定エントリが完全に削除されます。変更は JSON エディタにリアルタイムで反映されます。

また、共通設定を書き込み チェックボックスを有効にすると、グローバル設定スニペットをプロバイダーにマージできます。共通設定を編集 をクリックして共有スニペットをカスタマイズできます。

Codex ローカルルーティングとモデルマッピング

一部の第三者プロバイダーは OpenAI Chat Completions プロトコルのみをサポートするか、非 GPT モデル名（DeepSeek、Kimi、MiniMax など）を使用します。Codex はネイティブには OpenAI Responses API と GPT 系列モデルのみを認識するため、これらのプロバイダーでは Olenro がローカルでプロトコルとモデルを変換する必要があります。

ローカルルーティングが必要

Codex プロバイダーの編集時、ローカルルーティングが必要 トグルが利用できます：

• 有効にするタイミング：プロバイダーが Chat Completions プロトコルを使用する、またはモデル名が Codex デフォルトの GPT 系列でない場合
• 有効時：Olenro のローカルプロキシが、Codex の送信する Responses リクエストを上流の Chat Completions に変換し、レスポンス（ストリーミング SSE、推論内容、ツール呼び出しを含む）を Responses 形式に再変換します
• 前提条件：変換を有効にするにはローカルルーティングを起動し、Codex の引き継ぎを有効にする必要があります。使用中はローカルルーティングを起動したままにしてください

💡 DeepSeek や Kimi などの Chat 形式プリセットを選択すると、このトグルはデフォルトで有効になっており、手動設定は不要です。

モデルマッピング

ローカルルーティングが必要 を有効にすると、その下に モデルマッピング 表が表示され、このプロバイダーで利用可能なモデルを宣言できます：

• マッピング表は Codex の model_catalog_json を生成し、/model コマンドでこれらの第三者モデル名を表示できるようにします
• リストの内容はそのまま保存され、モデルリストの唯一の情報源となります
• 変更後、モデルリストを更新するには Codex の再起動が必要 です（model_catalog_json は Codex 起動時に読み込まれます）

思考能力（Reasoning）の自動判定

ローカルルーティングを有効にすると、Olenro はプロバイダーの「思考」（reasoning）インターフェースを自動判定し、Codex が送る思考リクエストを上流が理解できるパラメータに変換します（手動設定は不要）。判定はプロバイダーの名前・エンドポイント・モデル名に基づきます：

• 集約 / ホスティングプラットフォーム優先：OpenRouter、SiliconFlow などはプラットフォーム規則で処理（同じモデルでもプラットフォームごとに思考インターフェースが全く異なる場合があるため）
• それ以外はモデルブランド別：DeepSeek、Kimi / Moonshot、Zhipu GLM、Qwen、MiniMax、Xiaomi MiMo、StepFun などにそれぞれ規則あり

プロバイダーの「思考」能力は 2 種類に分かれます：

⚠️ 一部のプロバイダーでは思考レベルが効きません：オン / オフ切替のみのプロバイダーでは、Codex で思考レベル（model_reasoning_effort の low / medium / high）を変えても効果はありません——Olenro はこれらの上流にレベルを送りません（API がパラメータを受け付けず、無理に送るとリクエストが拒否される可能性があるため）。これらのプロバイダーの思考はデフォルトでオンで、「調整」ではなく「オン / オフ」で動作します。実際にレベル変更が効くのは、思考レベルに対応したプロバイダー（DeepSeek、OpenRouter など）だけです。

💡 判定は名前 / エンドポイント / モデル名のキーワードマッチングであり、実際の能力探索ではありません。公式ドメイン（api.deepseek.com、api.moonshot.cn など）は常に認識されますが、ドメインとモデル名を書き換えた中継サービスでは判定できないことがあり、その場合は思考パラメータが一切注入されません。

Codex 1M コンテキストウィンドウ

Codex プロバイダーの追加時、1M コンテキストウィンドウを有効化 トグルが利用できます：

• 有効時：config.toml に model_context_window = 1000000 を設定し、model_auto_compact_token_limit = 900000 を自動入力
• 無効時：両方のフィールドを削除

トグルがオンの場合に表示されるテキストフィールドで、自動コンパクト制限をカスタマイズできます。v3.15.0 以降、このトグルは Codex プロバイダーの新規追加時のみ表示されます。既存プロバイダーの編集時は、必要に応じて高度な設定で該当フィールドを直接調整してください。

カスタムアイコン

名前の左側にあるアイコンエリアをクリックすると：

• プリセットアイコンを選択
• アイコンの色をカスタマイズ

Web サイトリンク

プロバイダーの公式サイトやコンソールのアドレスを入力して、素早くアクセスできます：

• プロバイダーカードのリンクアイコンをクリックすると直接開く
• 残額の確認や API Key の取得などに使用

メモ

以下のようなメモ情報を追加できます：

• アカウントの用途（個人/仕事）
• プランの情報
• 有効期限

メモはプロバイダーカードに表示され、検索にも対応しています。

エンドポイント速度テスト

プロバイダーを追加した後、API エンドポイントの速度テストができます：

1. プロバイダーカードの「テスト」ボタンをクリック
2. テストパネルで複数のエンドポイント URL を追加
3. 「テスト」をクリックして実行
4. レイテンシが最も低いエンドポイントを選択

テスト結果：

• 緑：レイテンシ < 500ms（優秀）
• 黄：レイテンシ 500-1000ms（普通）
• 赤：レイテンシ > 1000ms（遅い）