直接接続では、接続の設定を指定した AI ツールへ書き込み、そのツールが OcHub ゲートウェイを経由せずにプロバイダーへ接続します。初回利用に最も適した方法です。
直接接続を使う場面
- OcHub を初めて設定する。
- 1 つのツールから 1 つのプロバイダーへ直接接続する。
- ツール自身の公式アカウントログインを使い続ける。
複数ツールでルーティング、モデル別名、予備の上流を共有する場合は、 モデルプロバイダーを使用します。
接続を追加する
-
アプリを選びます。 サイドバーの「アプリ」から設定するツールを開きます。
-
エディターを開きます。 接続を追加を選びます。既存のローカル設定が検出済み なら、重複を作らずその項目を編集できます。
-
開始点を選びます。 適切なプリセットがあれば使用し、なければ空の設定から始めます。 「仕事用アカウント」「予備エンドポイント」など用途が分かる名前を付けます。
-
接続情報を入力します。 プロバイダーの資料に従って API アドレスとキーを入力します。 モデルプロバイダーのエディターは
/v1を処理しますが、直接接続では生成ファイルのプレビューを 基準にしてください。 -
設定を確認します。 下部の操作で書式と必須項目を確認します。対応するネットワーク チェックは詳細ページにあり、URL テストだけではアカウント権限やモデル要求を検証しません。
-
候補設定を確認します。 設定ファイルで対象パスと項目を確認します。最終ファイルは 対象環境で統合されます。
-
下書きを保存するか適用します。 OcHub に保存は未完成の内容も独立した下書きとして 保持します。準備ができたらアプリに適用または書き込みを選びます。保存だけでは正式な接続も 対象ファイルも変更しません。
追加と切り替え
| 操作 | 意味 |
|---|---|
| ツールに追加 | 現在の接続を変えずにツール設定へ追加 |
| 切り替え | 書き込みまたは選択し、現在の接続にする |
| インポート | Cherry Studio のように対象アプリを開き、そこでインポートを確認する |
| ツールから削除 | OcHub のデータを残し、ツール側だけから削除 |
| 削除 | OcHub から完全に削除。元に戻せません |
切り替えに成功すると、ページ上部の「現在の接続」とカードの「現在」表示が更新されます。
反映を確認する
- 設定をキャッシュした既存プロセスを避けるため、対象 CLI を終了して開き直します。
- 短いリクエストを送ります。
- 成功したら OcHub の使用量を更新し、セッションまたはリクエストを確認します。
- 古い設定を使い続ける場合は、アプリ設定のディレクトリと実際のインストール先を 比較します。
外部変更を処理する
現在の接続ファイルが OcHub 外で変更されると、次の切り替え時に左右の差分が表示されます。
- 新しいバージョンとして保存:現在のファイルを現在の接続へ保存してから切り替えます。 後で戻ると、このバージョンが復元されます。
- 保存済みに戻す:現在のファイル変更を破棄し、保存済みバージョンを復元してから 切り替えます。
- キャンセル:現在のファイルも OcHub 内の接続も変更しません。
Codex では auth.json と config.toml を別々に比較し、不正な auth.json の原文も
対象に含めます。
元に戻す
エディターの今回の適用を取り消すは完全な書き込み記録がある場合だけ表示され、 後から加わった変更を上書きしません。詳しくは編集、保存、適用を参照してください。
- 別の接続へ戻すには、そのカードで切り替えを選びます。
- ツール自身のログインへ戻すには、公式ログインの接続へ切り替えます。
- 管理を停止するには設定 → アプリとプラグインで管理を無効にするを選びます。現在の実設定は 自動的には変更されません。

