OcHub の基本操作はシンプルです。AI ツールを選び、プロバイダーへ直接接続するか、 OcHub のローカルゲートウェイを経由するかを決めます。初回はどちらか一方だけを 完了させてください。
初回設定や、ツールごとに 1 つの上流を使う場合に最適
ツールがプロバイダー設定を直接使用
上流共有、モデル変換、プロトコル変換、フォールバック向け
リクエストは OcHub のローカルゲートウェイを通過
初回設定の完了条件
次の 3 点をすべて満たせば、最初の設定は完了です。
- 対象アプリのページで、目的の接続が「現在」と表示される。
- 新しく起動した CLI から実リクエストを 1 回送信できる。
- 公式ログインまたは以前の接続へ戻す方法が分かる。
この最小フローが動くまでは、MCP、スキル、価格、同期、複雑なルーティングを設定しないでください。
始める前に
- cc-switch を終了し、2 つのアプリが同じツール設定へ同時に書き込まないようにします。
~/.claudeや~/.codexなど、対象ツールの設定ディレクトリをバックアップします。- 利用する API エンドポイントとキーを用意します。ツール自身の公式ログインを使う場合、 サードパーティーのキーは不要です。
cc-switch を長く使用してきた場合は、初回起動時にインポートするか決める前に 移行ガイドを確認してください。
初回起動
-
ウェルカム通知を確認します。 設定ファイルへの書き込み説明を読みます。 cc-switch が検出されると、インポート可能な接続、MCP サーバー、スキル リポジトリが表示されます。
-
移行するか決めます。 インポートして開始は cc-switch データを読み込みます。 スキップしても cc-switch は変更されず、後から設定 → データとバックアップで インポートできます。
-
管理するアプリを選びます。 設定 → アプリとプラグインで必要なツールだけを 有効にします。無効化してもデータやツール設定ファイルは削除されません。
-
アプリページを開きます。 サイドバーの「アプリ」から Claude Code、Codex、 Cherry Studio、Grok Build、Kimi Code、OpenCode、OpenClaw、Hermes、Claude Desktop の いずれかを選びます。
主な画面
| 領域 | 用途 |
|---|---|
| アプリ | ツールごとの直接接続と固有設定 |
| MCP サーバー | MCP 設定を一元保存し、対応ツールへ同期 |
| スキル | 再利用可能なスキルの検索、インストール、更新、配布 |
| 使用量 | トークン、コスト、キャッシュ、レイテンシー、個別リクエスト |
| セッション | ローカル CLI の会話履歴 |
| 高度なツール | CLI、バックアップ、環境変数、ツール固有ファイル |
| モデルプロバイダー | ゲートウェイ上流、モデルマッピング、バックアップ切り替え |
| テーマ / 設定 | 外観、アプリ動作、データ、リモート同期 |
接続方法を選ぶ
| 目的 | 推奨方法 |
|---|---|
| 1 つのツールへ 1 つの API を設定 | 直接接続 |
| ツール自身のアカウントログインを継続 | 直接接続内の「公式ログイン」 |
| 複数ツールで同じ上流を共有 | モデルプロバイダー |
| モデル名変更、プロトコル変換、予備上流への切り替え | モデルプロバイダー |
最初は直接接続がおすすめです。対象 CLI から実際のリクエストが成功してから、MCP、 スキル、複雑なルーティングを追加します。