利用ガイドAPIリファレンスAIアプリケーション

CC Switch

CC Switch は、オープンソースでクロスプラットフォーム対応の AI CLI 統合管理デスクトップツールです。Claude Code、Codex、Gemini CLI のモデルエンドポイントをワンクリックで切り替え、アプリケーションを横断して MCP サーバーやシステムプロンプト(Prompts)を一元管理できるため、開発者は煩雑な設定ファイルの手動編集から解放されます。

⚡ ワンクリック起動によるインポート(推奨)

CC Switch はネイティブで ccswitch:// Deep Link プロトコルをサポートしています。パラメータを手動でコピー&ペーストする必要はなく、OpenRely コンソールからワンクリックでエンドポイントの挿入を完了できます:

OpenRely API キー管理ページ で、任意のキーの右側にある操作メニューをクリックし、「CC Switch」 オプションを選択すると、システムが自動的に CC Switch クライアントを起動し、Base URL とキーがあらかじめ入力されます。


🔑 事前準備


🚀 手順

CC Switch のインストール

お使いのオペレーティングシステムに応じたインストール方法を選択するか、直接 GitHub Releases から最新のインストーラーをダウンロードしてください:

brew tap farion1231/ccswitch
brew install --cask cc-switch

GitHub Releases から .msi インストーラー、または解凍するだけで使えるポータブル版 .zip をダウンロードします。

GitHub Releases から .deb パッケージまたは .AppImage をダウンロードします。

Arch Linux ユーザーは AUR を直接利用できます:

paru -S cc-switch-bin

GUI のないリモート開発サーバーや SSH ターミナル環境に適しています:

wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch-web-linux-x64.tar.gz
tar -xzf cc-switch-web-linux-x64.tar.gz
cd cc-switch-web/
./cc-switch-web

起動後、ローカルブラウザで http://<サーバーIP>:17666 にアクセスすると Web 管理ダッシュボードを開くことができます。

OpenRely プロバイダーの設定

コンソールからワンクリックで起動することも、CC Switch のインターフェースで手動でプロバイダーを追加し、以下の設定項目を入力することもできます:

設定項目推奨入力値説明
対象アプリケーションClaude / Codex / Gemini切り替える AI CLI ツールを選択
プロバイダー名OpenRely任意の識別ラベル
API サービスアドレスhttps://api.openrely.ai/v1必ず末尾に /v1 を含めてください
API キーsk-...OpenRely コンソールで作成した専用アクセストークン
モデル設定自由に選択ドロップダウンメニューから選択するか、モデル識別子を手動入力

ワンクリックで切り替えて利用開始

  1. ポップアップ右下の 「CC Switch を開く」(または保存)をクリックすると、対応する CLI の設定環境に設定が永続化されます。
  2. CC Switch のメインパネルで、該当する Provider の右側にあるスイッチをクリックすると、現在アクティブな API エンドポイントをワンクリックで切り替えることができます。
  3. ターミナルを開いて claude または codex を実行すれば、OpenRely ゲートウェイを経由してすぐにコーディングを開始できます。

💡 主な管理機能

機能モジュール説明
🔌 Provider 管理Claude Code、Codex、Gemini の API エンドポイントとキーをワンクリックで切り替え、複数ノードのレイテンシ測定に対応
🛠️ MCP サーバー管理アプリケーションを横断して MCP サービスを一元管理し、stdio、HTTP、SSE の 3 つのプロトコルおよび双方向同期に対応
💬 Prompts 管理アプリケーション横断のシステムプロンプト(CLAUDE.md、AGENTS.md、GEMINI.md)とクイックプリセットを一元管理
🔄 クロスプラットフォーム自動同期ローカルでの変更を各 CLI ツールのネイティブ設定ファイルへ即座に同期・適用

❓ よくある質問

その他の呼び出しエラーや請求に関する疑問については、完全版の よくある質問とトラブルシューティングガイド をご参照ください。

このドキュメントは役に立ちましたか?

CC Switch | OpenRely Docs