接続を管理する

OcHub はアプリごとに接続を分けて保存します。Claude Code の接続が Codex に自動で現れることはありませんが、アプリへコピーで対象形式の新しい設定を 生成できます。

既存設定を検出する

アプリページを開くと、OcHub はツールの現在の実設定を読み取ります。

• 認識できる接続は「直接接続」に表示されます。
• ツールに存在するが現在ではない項目は「追加済み」と表示されます。
• 使用中の接続は「現在」と表示されます。
• フォームで完全に表現できないカスタム項目は、保存前に書き込みプレビューを確認します。

日常の操作

現在使用中の接続を削除する前に、別の接続へ切り替えます。

公式ログイン

公式ログインを使用はサードパーティーの Base URL や API キーを書き込まず、 ツール自身のログイン状態を利用します。

• Claude Code または Codex ですでに公式アカウントへログイン済み。
• サードパーティー API から一時的に公式サービスへ戻す。
• ツール固有のアカウントやサブスクリプション機能を維持する。

Codex では auth.json と config.toml の両方が現在の接続バージョンに含まれます。 OcHub 外で変更した内容を残す場合は、別の接続へ切り替える前に差分を確認して新しい バージョンとして保存します。

アプリ固有設定

アプリページ右上のアプリ設定を開きます。

カスタムディレクトリは、設定、MCP、セッション履歴の読み取り先を変更します。保存後に OcHub と対象ツールを再起動してください。

エディター内のチェック

• URL をテスト：HTTP 応答のレイテンシーを測定。
• モデルを取得：現在のアドレスとキーでモデル一覧を取得。
• 残高を確認：互換する残高 API がある上流サービスのみ。
• 書き込むファイル：生成内容と保存先を表示。
• 共通設定：アプリ単位の共有スニペットを有効な接続へマージ。

テスト成功はモデル呼び出しの成功を保証しません。最終確認は対象 CLI の実リクエストです。

外部で設定が変更された場合

OcHub は現在の接続を、保存済みの設定バージョンとして扱います。切り替え前に、その バージョンとディスク上の現在のファイルを比較します。

1. 左右のファイル差分を確認します。赤は保存済みバージョン、緑は現在のファイルです。
2. 新しいバージョンとして保存を選ぶと、現在のファイルを現在の接続へ保存してから 切り替えます。後で戻ると、この新しいバージョンが復元されます。
3. 保存済みに戻すを選ぶと、ディスク上の変更を破棄し、保存済みバージョンを復元して から切り替えます。
4. キャンセルでは OcHub のデータも現在のファイルも変更しません。

この処理は、Claude Code、Codex、Grok Build、Kimi Code、切り替え型プラグインなど、 OcHub が実設定を読み取れるすべての切り替え型アプリに適用されます。Codex では auth.json と config.toml を別々に表示し、不正な JSON の auth.json も原文のまま 差分、保存、復元の対象になります。

OcHub、cc-switch、手動エディターで同じファイルを同時に編集しないでください。

新しい接続を確認する

任意のアプリで接続を保存または切り替えた後：

1. 生成ファイルとパスを確認。
2. 保存後に「追加済み」または「現在」を確認。
3. 対象ツールを完全に再起動。
4. 新しいプロバイダーとモデルを選択。
5. 短いリクエストを送信。
6. ツールエラー、OcHub 使用量、上流ログを確認。

アプリ別フィールドガイド

旧管理ツールから接続を移す場合は、手作業でコピーせず cc-switch から移行を利用してください。