CC Switch 使い方ガイド：Claude Code、Codex、MCP の安全な管理とロールバック

CC Switch は、CCSwitch または cc switch としても検索されることが多く、AI プログラミングのヘビーユーザー向けのデスクトップ管理ツールです。解決しようとしている問題は非常に直接的です。現在、多くの人が Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw を同時に使用していますが、各ツールには独自の構成形式、プロバイダーの記述方法、MCP 構成、スキル管理方法があります。

使用するツールが 1 つだけの場合、構成を手動で変更することは問題ありません。複数のツールに加え、公式アカウント、サードパーティ API、転送サービス、ローカルモデル、チーム共有設定が混在すると、JSON、TOML、.env を手動で編集するのはすぐに非常に面倒な作業になります。

`CC Switch` の位置付けは、これらの分散した構成をクロスプラットフォームのデスクトップアプリケーションに統合することです。それはどのような問題を解決しますか?

最新の AI プログラミングツールはますます「コマンドラインの開発仲間」のようなものになってきていますが、各ツールの生態はまだ完全には統一されていません。

一般的な問題点は次のとおりです。

・Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw では設定形式が異なります。・ APIプロバイダを切り替える場合、設定ファイルを繰り返し変更する必要があります。

MCP サーバーは、さまざまなツール間で繰り返し構成されます。
CLAUDE.md、AGENTS.md、GEMINI.md などのプロンプトファイルは、統一的に管理することが困難です。
スキルのインストール、同期、バックアップ、アンインストールには一元化された入り口がありません。
複数のアカウント、複数のリレー、複数のモデルのサービス切り替えは混同されやすいです。
設定ファイルを手動で変更してエラーが発生すると、トラブルシューティングのコストが非常に高くなります。

`CC Switch` のアイデアは、ユーザーに各ツールの構成の詳細を覚えさせず、統一インターフェイスを使用してプロバイダー、MCP、プロンプト、スキル、セッション、エージェントを管理することです。どのようなツールがサポートされていますか?

README にリストされているコアサポートオブジェクトには、次の 5 つのカテゴリが含まれています。

Claude Code
Codex
Gemini CLI
OpenCode
OpenClaw

これらのツール自体は同様の位置付けを持っており、すべて AI プログラミング、エージェントワークフロー、コマンドラインコラボレーションを中心に展開しています。ただし、構成システムは異なります。CC Switch の価値は、これらの違いをパッケージ化することにあります。

さまざまな AI プログラミングツールを頻繁に比較する人にとって、毎回手動で構成ファイルをめくることよりもはるかに手間がかかりません。プロバイダー管理

CC Switch の最初の層の機能はプロバイダー管理です。

50 を超える組み込みプロバイダープリセットがあり、README に記載されている指示には、AWS Bedrock、NVIDIA NIM、さまざまなコミュニティリレーが含まれています。ユーザーは API キーをコピーし、ワンクリックでインポートして、インターフェースに切り替えることができます。

実用的な主なポイントがいくつかあります。

ワンクリックでプロバイダーを追加します。
プロバイダーのドラッグアンドドロップによる並べ替え。
システムトレイの素早い切り替え。
プロバイダーのインポートとエクスポート。
一部の一般的なプロバイダーは、複数のアプリケーションと同期できます。

多くの人にとって、この機能は十分に魅力的です。 AI プログラミングツールは日常的に使用されているため、混乱しやすいのは「モデルが使用できない」ということではなく、「今日このキーにどのツール、どのエンドポイント、どのアカウントを使用するか」ということです。ローカルプロキシとフェイルオーバー

構成ファイルの作成に加えて、CC Switch はローカルプロキシモードも提供します。

この機能の焦点は次のとおりです。

ホットスイッチングプロバイダー。
フォーマット変換。
自動フェイルオーバー。
ヒューズ。
プロバイダーのヘルスチェック。
修正を要求します。

簡単に言うと、ターゲットツールに構成を書き込むだけでなく、中間にローカルプロキシの層を追加して、さまざまなツールがプロキシ経由でモデルサービスにアクセスできるようにします。

これは、マルチプロバイダーのユーザーにとって便利です。1 つのサービスがダウンした場合、別のサービスに切り替えることができます。あるモデルが高価であれば、より安価なモデルに置き換えることができます。特定のリクエスト形式に互換性がない場合は、プロキシ層を通じて適応させることもできます。 MCP、プロンプト、スキル

`CC Switch` より重要な第 2 レベルの機能は、MCP、プロンプト、スキルの統合管理です。 MCP

複数のアプリケーション間で MCP サーバーを管理できる統合 MCP パネルを提供し、双方向同期とディープリンクインポートをサポートします。

これは、MCP を使用しているユーザーにとって非常に便利です。 MCP サーバーが多数あるため、構成がさまざまなクライアント間で簡単に分散する可能性があります。統合されたパネルにより、繰り返しの構成が減り、移行が容易になります。プロンプト

プロンプト部分はマークダウン編集をサポートしており、対応するファイルは異なるツール間で同期できます。次に例を示します。

CLAUDE.md
AGENTS.md
GEMINI.md

これらの文書は基本的にエージェントのプロジェクト仕様書です。統合管理の後は、チームのルール、プロジェクトのコミットメント、およびグローバルなリマインダーを維持することが容易になります。スキル

Skills は、GitHub リポジトリまたは ZIP ファイルからのワンクリックインストールをサポートしており、カスタムリポジトリ管理、シンボリックリンク、ファイルコピーもサポートしています。

Claude Code、Codex、OpenClaw などのツールを同時に使用すると、スキルが異なるディレクトリに散在するファイルの束になりやすくなります。 `CC Switch` それらを一元化すると、メンテナンスコストを削減できます。セッションとワークスペース

README には、セッションマネージャーとワークスペース関連の機能についても記載されています。

複数のアプリケーションにわたるセッション履歴を参照、検索、復元できます。 AI プログラミングツールを長期間使用している人にとって、セッション管理は実際には非常に重要です。多くの貴重なコンテキスト、デバッグプロセス、ソリューションの比較が古い会話に埋もれています。

さらに、Markdown プレビューで AGENTS.md や SOUL.md などのエージェントファイルを編集できる OpenClaw 用のワークスペースエディターも提供します。

これは、`CC Switch` が単なる「キーを切り替えるための小さなツール」ではなく、AI Agent ワークベンチに向けて拡張されていることを示しています。クラウド同期とデータストレージ

CC Switch は、Dropbox、OneDrive、iCloud、NAS、または WebDAV を介したプロバイダーデータの同期をサポートします。

ローカルデータの保存方法も比較的明確です。

データベース: ~/.cc-switch/cc-switch.db
ローカル設定: ~/.cc-switch/settings.json
自動バックアップ: ~/.cc-switch/backups/
スキル：~/.cc-switch/skills/
スキルバックアップ：~/.cc-switch/skill-backups/

SQLite をプライマリデータソースとして使用し、切り替えまたは書き込み時の構成ファイルの破損を回避することを目的として、アトミック書き込みと自動バックアップを重視しています。

この設計はヘビーユーザーにとって重要です。なぜなら、構成管理ツール自体が不適切な構成を作成すると、すべての AI プログラミングツールに影響を与えるからです。インストール方法

CC Switch は、Tauri 2 上に構築されたクロスプラットフォームのデスクトップアプリケーションです。

システム要件はおおよそ次のとおりです。

Windows: Windows 10以降
macOS: macOS 12 モントレー以降
Linux: Ubuntu 22.04+、Debian 11+、Fedora 34+、およびその他の主流ディストリビューション

Windows ユーザーは、.msi インストールパッケージまたはポータブルバージョンの圧縮パッケージをダウンロードできます。

macOS ユーザーは Homebrew を使用できます。

1
2


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

更新:

1

brew upgrade --cask cc-switch

Linux ユーザーは、.deb、.rpm、または AppImage を選択できます。 Arch Linux ユーザーは、paru -S cc-switch-bin 経由でインストールすることもできます。

2026 年 5 月 6 日の時点で、リポジトリページには、最新リリースが `CC Switch v3.14.1` であり、リリース時期が 2026 年 4 月 23 日であることが示されています。テクノロジースタック

リポジトリ構造の観点から見ると、CC Switch は典型的な Tauri デスクトップアプリケーションです。

フロントエンド: React 18、TypeScript、Vite、TailwindCSS、TanStack Query、shadcn/ui
バックエンド: Tauri 2、Rust、SQLite、Tokio
テスト: Vitest、MSW、テストライブラリ

主要な設計パターンには次のものが含まれます。

唯一の信頼できる情報源としての SQLite。
JSON はデバイスレベルのローカル設定を保存します。
切り替え時に対象ツールのライブコンフィグを書き込みます。
現在のプロバイダーを編集するときにライブ構成からバックフィルします。
一時ファイルと名前変更を使用して、アトミック書き込みを実行します。
同時書き込みの問題を回避するためのデータベース接続ロック。

このタイプのアーキテクチャは、プロジェクトが単純なスクリプトではなく、長期的なデスクトップツールとして設計されていることを示しています。誰に適していますか?

CC Switch は、次のタイプのユーザーに適しています。

Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw を同時に使用します。
公式アカウント、サードパーティのリレー、ローカルモデル、またはチームプロバイダーを頻繁に切り替えます。
MCP の大規模な使用が始まりました。・CLAUDE.md、AGENTS.md、GEMINI.mdを一元的にメンテナンスしたい。
スキルを頻繁にインストール、テスト、移行します。
セッション履歴や各種ツールの使用状況を確認したい。

AI プログラミングツールを 1 つだけ使用し、常に公式ログインを使用し、プロバイダー、MCP、スキルを気にしない場合、その価値はそれほど明白ではないかもしれません。

ただし、「マルチツール、複数アカウント、複数プロバイダー、複数プロジェクト」の状態に入っていれば、些細な設定作業を大幅に節約できます。注意すべき点

このようなツールは便利ですが、境界に注意してください。

まず、複数の AI CLI の構成を管理するため、このツールとその作成ロジックが信頼できることを確認してください。

次に、API キー、リレーエンドポイント、MCP サーバーはすべて機密性の高い構成です。クラウド同期を有効にする前に、同期されたディレクトリと WebDAV サービス自体が安全で信頼できることを確認してください。

第三に、プロバイダーを切り替えた後も、ほとんどのツールを有効にするには、端末または CLI を再起動する必要があります。 README には、Claude コードがプロバイダーデータのホットスイッチングをサポートしていると記載されていますが、通常は他のツールを再起動する必要があります。

4 番目に、公式ログインに戻す場合は、プロジェクトの説明に従って公式プロバイダーを追加し、対応するツールのログインプロセスを再度実行することをお勧めします。インストール前に公式チャンネルを確認してください

現在プロジェクトによって述べられている唯一の公式情報源は次のとおりです。

公式ウェブサイト：ccswitch.io
ソースコード: github.com/farion1231/cc-switch
ダウンロード: この GitHub リポジトリのリリース

CC Switch は無料のオープンソースソフトウェアです。リチャージを要求したり、公式アカウントのパスワードを要求したり、偽名を使用したりするダウンロードサイトは使用しないでください。 Windows は最初にリリースで MSI をダウンロードします。 macOS では以下を使用できます。

1

brew install --cask cc-switch

のインストール後、「バージョン情報」またはツール管理インターフェイスでインストールされているバージョンを確認してください。サードパーティのチュートリアルの古いバージョン番号に基づいて修正ファイルをダウンロードしないでください。変更前にバックアップするファイル

公式 CC Switch README に現在リストされているローカルデータの場所は次のとおりです。

1
2
3
4
5


数据库：~/.cc-switch/cc-switch.db
设置：~/.cc-switch/settings.json
自动备份：~/.cc-switch/backups/
Skills：~/.cc-switch/skills/
Skill 备份：~/.cc-switch/skill-backups/

backups デフォルトのローテーションでは最後の 10 コピーが保持され、スキルのアンインストール前のバックアップでは最後の 20 コピーが保持されます。自動バックアップは完全な災害復旧と同等ではありません。最初の大規模な切り替えを行う前に、CC Switch を終了し、~/.cc-switch ディレクトリ全体を管理された場所にコピーする必要があります。

同時に、ターゲットツールの元の設定 (Codex `config.toml` など) をユーザーディレクトリに別途保存します。 API キーを含むバックアップを Git に送信したり、パブリックネットワークディスクにアップロードしたりしないでください。安全なプロバイダースイッチ

元の CLI で最小限のリクエストを実行し、通常のベースラインを保存します。
CC Switch に新しいプロバイダーを追加します。これには、利用可能な唯一の公式プロバイダーは含まれません。
エンドポイント、モデル名、キーに対応する環境変数を確認します。
切り替え後完全に終了し、ターゲット CLI を再起動します。
最初に通常のテキストをテストし、次にストリーミング応答とツール呼び出しをテストします。
例外が発生した場合は、元のプロバイダーに切り替えて、元の CLI が復元されていることを確認します。

Codex ネイティブカスタムプロバイダーは、応答プロトコルを使用します。 CC Switch 3.16 のネイティブプロキシは、Codex Response リクエストを一部のサードパーティベンダーが使用する Chat Completion に変換し、ストリーミング応答とツール呼び出しを再構築できます。安定して動作できるかどうかは、特定のバージョン、上流モデル、エージェント構成によって異なります。チャットがテキスト文を返すからといって、すべての Codex ワークフローに互換性があるとは考えられません。検証と障害箇所

Codex プロバイダーを切り替えた後、少なくとも以下を実行します。

1
2


codex --version
codex --help

は、一時 Git リポジトリで 3 つのテストを完了しました。

ファイルを読んで質問に答えます。
テストファイルを変更し、差分を表示します。
副作用のないツールを呼び出します。

一般的な判断:

現象	優先順位のチェック
`401`	キー、環境変数、認証ヘッダー
`404`	ベース URL、エンドポイントパス、モデル ID
チャットはできるがツールが失敗する	応答/チャットのプロトコル変換とツール呼び出し形式
切り替え後も古いプロバイダーが引き続き使用されます。 CLI が再起動されているかどうか、および構成ディレクトリに一貫性があるかどうか。
`codex resume` セッションが見つかりません	`model_provider` セッションレコードのグループ化

CC スイッチの README 特記事項: デフォルトではアプリケーション設定の Codex ディレクトリに設定されており、`CODEX_HOME` は自動的に読み取られません。 CLI にカスタムディレクトリを使用する場合は、CC スイッチにも同じ「プロファイルディレクトリ」を設定する必要があります。ロールバック手順

CC スイッチで、以前に予約した公式プロバイダーまたは検証済みプロバイダーに戻ります。
CC スイッチとターゲット CLI を終了します。
~/.cc-switch/backups/ から変更前のバックアップを選択します。不明な場合はデータベースを上書きしないでください。
必要に応じて、別途保存した config.toml を復元します。
公式プロバイダーに再度ログインし、最小限のベースラインリクエストを再実行します。

CC スイッチの「最小限の侵入」設計ではアクティブな構成が保持されるため、現在アクティブな唯一のプロバイダーを削除することはできません。正しいアプローチは、まず利用可能なプロバイダーに切り替えてから、構成ミスをクリーンアップすることです。セキュリティ境界

提供元不明の中継サイトや有料ミラーサイトを利用しないでください。
スクリーンショット、ログ、同期ディレクトリで API キーを漏洩しないでください。
WebDAV を使用して同期する前に、サーバー側の暗号化、アクセス許可、およびデータ保持ポリシーを確認します。
サードパーティプロバイダーを使用する前に、そのプロバイダーの請求、データ保持、およびサービス条件をお読みください。

- 通常の認証パスを回避するために、ChatGPT を使用して OAuth リバースプロキシにサブスクライブしないでください。プロジェクトのリリースノートには、これが OpenAI の利用規約に違反する可能性があることも記載されています。概要

CC Switch の価値は、別の AI プログラミングツールの作成にあるのではなく、AI プログラミングエコシステムが複数のツールが共存する段階に入ったという現実の認識にあります。

Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw にはそれぞれ独自の構成システムがあり、MCP、スキル、プロンプト、プロバイダーは急速に拡張されています。手動で構成を変更し続けることは、遅かれ早かれ負担になります。

`CC Switch` はこれらをデスクトップアプリケーションに収集し、ユーザーがプロバイダーの切り替え、MCP の同期、スキルの管理、プロンプトファイルの維持、セッションの表示をより簡単にできるようにします。 AIプログラミングのヘビーユーザーにとって、こうしたツールは「オプションのガジェット」から「日常のインフラ」へと移行する可能性が高い。よくある質問

CC Switch と CCSwitch は同じツールですか?

はい。ユーザーが検索する場合、`CC Switch`、`CCSwitch`、または `cc switch` と書き込むことがあります。ここで説明するのは、クロスプラットフォームデスクトップツール farion1231/cc-switch です。 CC Switch はどのような AI プログラミングツールを管理できますか?

これは主に、Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw などの AI CLI およびエージェントツールを対象としており、プロバイダー、MCP、プロンプト、スキル、エージェント、セッションの管理に重点を置いています。 CC スイッチは API キーを切り替えるためにのみ使用されますか?

それだけではありません。プロバイダーの切り替えがその基本機能ですが、MCP 管理、スキル同期、即時ファイルメンテナンス、セッション表示、クラウド同期などの AI エージェントワークベンチにも拡張されています。 CC Switch をインストールする価値があるのはいつですか?

複数の AI プログラミングツールセット、複数の API プロバイダーセット、ローカルモデル、リレー、またはチーム共有構成を同時に使用する場合、CC Switch は手動による構成変更のコストを大幅に削減できます。参考文献

Ollama のローカルモデル Provider を作る

設定を変更する前に、CC Switch と Claude Code を使う同じユーザー環境で Ollama と正確なモデルタグを確認します。

1
2


ollama list
Invoke-RestMethod -Uri 'http://127.0.0.1:11434/api/tags'

CC Switch で Ollama Local という Provider を作り、Base URL を http://127.0.0.1:11434/v1、プロトコルを OpenAI-compatible / Chat Completions にします。モデル名は ollama list のタグをそのまま使います。API Key が必須なら、クラウドの秘密鍵ではなくローカル用のダミー文字列を入力します。

切り替える前に現在の Provider をバックアップし、読み取り専用のリポジトリで通常応答、ファイル読み取り tool call、要求をキャンセルした後の復帰を確認します。会話だけ成功しても Claude Code の Agent 処理全体が互換とは限りません。tool calling や出力形式が合わない場合はモデルを変更し、利用可能なら CC Switch のプロトコル変換を使うか、元へ戻します。

CLI は動くのに API が失敗する場合、Ollama が Windows と WSL の反対側にいないか、11434 が待ち受けているか、ファイアウォールを確認します。“model not found” はタグの不足が典型です。認証のないポートをインターネットへ公開しないでください。

CC Switch の位置付けは、これらの分散した構成をクロスプラットフォームのデスクトップ アプリケーションに統合することです。 それはどのような問題を解決しますか?

さまざまな AI プログラミング ツールを頻繁に比較する人にとって、毎回手動で構成ファイルをめくることよりもはるかに手間がかかりません。 プロバイダー管理

CC Switch より重要な第 2 レベルの機能は、MCP、プロンプト、スキルの統合管理です。 MCP

これらの文書は基本的にエージェントのプロジェクト仕様書です。統合管理の後は、チームのルール、プロジェクトのコミットメント、およびグローバルなリマインダーを維持することが容易になります。 スキル

これは、CC Switch が単なる「キーを切り替えるための小さなツール」ではなく、AI Agent ワークベンチに向けて拡張されていることを示しています。 クラウド同期とデータストレージ

この設計はヘビーユーザーにとって重要です。なぜなら、構成管理ツール自体が不適切な構成を作成すると、すべての AI プログラミング ツールに影響を与えるからです。 インストール方法

2026 年 5 月 6 日の時点で、リポジトリ ページには、最新リリースが CC Switch v3.14.1 であり、リリース時期が 2026 年 4 月 23 日であることが示されています。 テクノロジースタック

このタイプのアーキテクチャは、プロジェクトが単純なスクリプトではなく、長期的なデスクトップ ツールとして設計されていることを示しています。 誰に適していますか?

ただし、「マルチツール、複数アカウント、複数プロバイダー、複数プロジェクト」の状態に入っていれば、些細な設定作業を大幅に節約できます。 注意すべき点