cc-switchとは?7つのAIコーディングツールを1アプリで管理する方法【初心者向け完全ガイド】
複数のAIコーディングツールを使っていて、こんな悩みを抱えていませんか?
- Claude Codeを使いたいのに、APIキーの設定ファイルがどこにあるかわからない
- Gemini CLIに乗り換えようとしたら、また別の設定ファイルを手で書き直す羽目になった
- MCPサーバー(AIにファイル読み書きや外部ツール連携をさせる拡張機能)の設定を、ツールごとに何度も繰り返している
これは「あなたが不慣れだから」ではありません。AIコーディングツールの世界が急速に多様化し、各ツールがバラバラの設定ファイル形式を持つようになった結果、誰もが抱える構造的な問題です。
この記事では、そのすべての悩みを一気に解消する無料のオープンソースツール 「cc-switch」 について、何ができるか・どう使うか・似たツールとの違いまで、エンジニア経験ゼロの方でも理解できるように解説します。
---
cc-switchとは?30秒でわかる概要
<cite index="29-4,29-5">cc-switchは、TauriとRust・Reactで構築されたクロスプラットフォームのデスクトップアプリで、MITライセンスで公開されているオープンソースプロジェクトです。2026年7月時点でGitHub上に10万件を超えるスターが集まっています。</cite>
一言で表すなら「複数のAIコーディングツールの設定を、1つの画面でまとめて管理するコントロールパネル」です。
レストランのPOSシステムに例えると、わかりやすいかもしれません。以前は料理・ドリンク・デザートそれぞれ別の伝票帳に手書きしていたのが、1台のタブレットですべて管理できるようになったイメージです。cc-switchは、AIコーディングツール版のその「統合管理タブレット」です。
対応している7つのツール
<cite index="11-13">cc-switchは「One App, Seven Tools」を掲げており、Claude Code・Claude Desktop・Codex・Gemini CLI・OpenCode・OpenClaw・Hermes Agentの7ツールを1つの画面から管理できます。</cite>
主要ツールの詳細はこちらの紹介記事も参考にしてください:
- Gemini CLI — Googleが公式に提供するコマンドラインAIアシスタント
- Codex CLI — OpenAI製のコーディング支援CLIツール
- OpenCode — オープンソースのターミナルAIコーディングエージェント
公式サイトとGitHub
<cite index="29-2">唯一の公式サイトは ccswitch.io です。</cite>ダウンロードやドキュメントはGitHub(farion1231/cc-switch)と公式サイトから取得してください。料金については公式サイトを参照してください。
---
cc-switchで「何ができるか」を先に理解しよう
機能の説明に入る前に、「これを使うと何が変わるか」を具体的に見てみましょう。
Before(cc-switch導入前)
<cite index="3-3,3-4,3-5">Claude Code・Codex・Gemini CLI・OpenCode・OpenClawなど複数のツールを使う場合、それぞれ異なる設定フォーマット・Provider構文・MCPセットアップ・Skillsの管理方法があります。1つのツールだけなら設定ファイルを手で編集するのはまだ我慢できますが、複数ツール・複数APIサービス・ローカルモデルが混在すると、JSON・TOML・.envファイルを手動で書き換えるのはすぐに苦痛になります。</cite>
After(cc-switch導入後)
<cite index="1-31">設定ファイルを手で書き換える必要がなくなります。プロバイダーをワンクリックでインポートしてすぐに切り替えられる視覚的なインターフェース、50以上のビルトイン・プロバイダープリセット、統合されたMCP・Skillsの管理、システムトレイからのクイック切り替え、そしてSQLiteデータベースによる設定破損防止——これらすべてが1アプリで揃います。</cite>
---
cc-switchの主要機能6選
1. プロバイダー一括管理(50以上のプリセット搭載)
「プロバイダー」とは、AIモデルのAPIを提供する会社やサービスのこと(Anthropic・OpenAI・AWS Bedrockなど)です。
<cite index="13-6,13-7">cc-switchには、Anthropic・OpenRouter・AWS Bedrockなど主要なAI APIプロバイダーを網羅した50以上のプリセット設定が搭載されています。各CLIツールに対して複数のプロバイダー設定を作成でき、ドラッグで並び替え、よく使うものを上に置いておくことも可能。ワンクリックでアクティブなプロバイダーを切り替えられます。</cite>
2. MCPサーバーの統合管理
「MCP」(Model Context Protocol)とは、AIに手持ちのファイルや外部ツールを読ませて作業させるための接続規格です。
<cite index="2-11">統合MCP管理パネルでは、Claude・Codex・Gemini用のMCPサーバーをひとつの画面から管理できます。stdio・HTTP・SSE(Server-Sent Events)の3種類の接続方式に対応し、設定の自動同期と双方向の同期機能も備えています。</cite>
MCPサーバーについてもっと知りたい方はAwesome MCP Serversもご覧ください。
3. ローカルプロキシによる自動フェイルオーバー
「プロキシ」とは中継サーバーのこと、「フェイルオーバー」とはメインのサービスが落ちたとき自動でバックアップに切り替わる仕組みのことです。
<cite index="7-6,7-7">ローカルプロキシを有効にすると、AIコーディングツールからのリクエストがすべてcc-switchのローカルプロキシを経由して実際のモデルサービスに転送されます。これにより、プロバイダー切り替え時にツールを再起動せずに済むホットスイッチング、APIフォーマットの差異を自動吸収するフォーマット変換、主プロバイダーが利用できない場合に自動でバックアッププロバイダーへ切り替わるフェイルオーバー、異常検知時にリクエストを自動停止するサーキットブレーカーが利用可能になります。</cite>
4. システムトレイからのクイック切り替え
<cite index="4-5,4-6">デスクトップUIは集中管理に使い、システムトレイはアプリを開かずに素早くプロバイダーを変更するためのものです。</cite>作業中に「ちょっとClaudeからGeminiに切り替えたい」という場合でも、タスクバーのアイコンから数秒で完了します。
5. セッション管理・使用量トラッキング
<cite index="4-9">複数ツールのトークン使用量・リクエストログ・会話履歴・モデル料金をコンテキスト切り替えなしに一画面で確認できます。</cite>
6. クラウド同期
<cite index="12-4">Dropbox・OneDrive・iCloud・WebDAVサーバーを通じてプロバイダーデータを複数デバイスで同期できます。</cite>自宅PCと職場PCで同じ設定を使いたい場合に便利です。
---
cc-switchの導入手順【前提条件〜起動まで】
前提条件
- OS: Windows 10以上 / macOS 12以上 / 主要Linuxディストリビューション
- <cite index="15-3">プログラミングの知識は不要。ダウンロードしてインストールするだけで使い始められます。</cite>
- 使用したいAIツール(Claude Code・Codex・Gemini CLIなど)のAPIキーは別途必要(各サービスで取得してください)
インストール手順
macOS(Homebrewを使う場合)
Homebrew(macOSのパッケージ管理ツール)がインストール済みであれば、ターミナルで以下を実行するだけです:
brew tap farion1231/ccswitch
brew install --cask cc-switch
macOS(手動インストール)
- ccswitch.io または GitHub Releasesページにアクセス
.dmgファイルをダウンロード- ダウンロードしたファイルを開いてアプリをApplicationsフォルダにドラッグ
Windows
1. GitHub Releases または ccswitch.io にアクセス
2. cc-switch_x.x.x_x64-setup.msi をダウンロード
3. インストーラーをダブルクリックして実行
Linux(Debian/Ubuntu系)
# .debパッケージをGitHub Releasesからダウンロード後
sudo dpkg -i cc-switch_*.deb
Arch Linux
paru -S cc-switch-bin
> 注意: <cite index="26-1">CC Switchの入手は必ずccswitch.io・GitHub Releasesまたはプロジェクトのソースリポジトリから行ってください。料金の支払いやログイン情報の入力を求める「CC Switch」サイトやクライアントは公式チャンネルではありません。</cite>
初回起動後の設定手順
1. CC Switchを起動
2. 画面上部で管理したいAIツールを選択(Claude / Codex / Gemini など)
3. 「プロバイダーを追加」ボタンをクリック
4. 50以上のプリセットから使用するサービスを選ぶ(例:Anthropic公式)
5. APIキーを入力して保存
6. システムトレイアイコンから即座に切り替え可能になる
<cite index="25-4,25-5">設定データはすべてユーザーのホームディレクトリ(~/.ccswitch)に保存されます。新しいバージョンをインストールしても設定は引き継がれます。</cite>
---
類似ツールとの比較:cc-switchは何が違うのか
cc-switchとよく比較されるツールを整理します。
| ツール | カテゴリ | 主な用途 | GUIあり | 対応ツール数 |
|---|---|---|---|---|
| cc-switch | 設定管理ツール | 複数CLIの設定を一括管理 | ✅ デスクトップアプリ | 7ツール |
| Cline | AIコーディングエージェント | エディタ内でAIにコードを書かせる | ✅ VSCode拡張 | 単体 |
| Aider | AIコーディングエージェント | ターミナルでコード編集・コミット | ❌ CLI | 単体 |
| 9Router | ルーティング層 | リクエストを最適なプロバイダーに振り分け | ⚠️ ブラウザUI | 複数 |
| Claude Code Router | ルーティング層 | Claude Code専用のAPI切り替え | ❌ CLI | Claude Code専用 |
<cite index="32-27">重要な違いを一言でいうと、9RouterはAIリクエストの「どこに送るか」を決めるルーティング層であり、cc-switchは複数のAIツールが設定・APIキーをどう保存・切り替えるかを管理する設定管理層です。</cite>
<cite index="13-10,13-11">Claude Code Routerと比較した場合、Claude Codeだけを使っていてコマンドラインが好きな人にはそちらで十分ですが、複数のAIコーディングツールにわたって使いたい場合や視覚的・集中管理型のインターフェースが欲しい場合は、cc-switchが有力な選択肢になります。</cite>
---
cc-switchに向いている人・向いていない人
ここが重要です。cc-switchは便利なツールですが、万人向けではありません。自分に合うか判断する材料を渡します。
✅ cc-switchが向いている人
<cite index="3-9,3-10,3-11,3-12,3-13">以下のような方には特に価値があります:
- Claude Code・Codex・Gemini CLI・OpenCode・OpenClawを複数同時に使っている方
- 公式アカウント・サードパーティAPIリレー・ローカルモデルなど複数プロバイダーを頻繁に切り替える方
- MCPサーバーをヘビーに使っている方
- CLAUDE.md・AGENTS.md・GEMINI.mdを1か所でまとめて管理したいチーム
- Skillsのインストール・テスト・移行を頻繁に行う方</cite>
❌ cc-switchが向いていない人
<cite index="3-15,3-16">AIコーディングツールを1つしか使っておらず、公式ログインで済んでいて、プロバイダー・MCP・Skillsにほとんど触れない場合は、cc-switchの価値は見えにくいでしょう。ただし「複数ツール・複数アカウント・複数プロバイダー・複数プロジェクト」という状態に入ってきたなら、繰り返しの設定作業を大幅に削減できます。</cite>
また、Ollamaでローカルモデルのみを使用していて、クラウドAPIを一切使わない方にとっても、cc-switchの恩恵は限定的です。
判断チェックリスト
| 項目 | 該当する? |
|---|---|
| 複数のAIコーディングCLIツールを使っている | ⬜ |
| APIプロバイダーを週1回以上切り替えることがある | ⬜ |
| 複数ツールに同じMCPサーバーを設定している | ⬜ |
| CLAUDE.md / AGENTS.md などのプロンプトファイルを管理したい | ⬜ |
| 設定ファイルを手で編集してミスったことがある | ⬜ |
| APIの使用量・コストを一画面で確認したい | ⬜ |
3つ以上あてはまれば、cc-switchの導入価値は高いと考えて良いでしょう。
---
cc-switchとAIコーディングツールの関係図
cc-switchは単体では動きません。下図のような位置づけで動作します。
[あなた]
↓ 設定・切り替え操作
[cc-switch デスクトップアプリ]
↓ 設定ファイルを自動書き換え/ローカルプロキシ経由でリクエスト転送
[Claude Code / Codex / Gemini CLI / OpenCode / ...]
↓ API呼び出し
[Anthropic / OpenAI / Google / AWS Bedrock / ...(プロバイダー)]
<cite index="7-5,7-6">cc-switchはただ設定ファイルを書き換えるだけでなく、ローカルプロキシモードも提供しています。ローカルプロキシを有効にすると、AIコーディングツールからのすべてのリクエストが一度cc-switchのローカルプロキシを経由してから実際のモデルサービスに転送されます。</cite>
このプロキシ経由の動作が「ホットスイッチング(ツール再起動なしの即時切り替え)」や「自動フェイルオーバー」を実現しています。
DeepSeekやAwesome ChatGPT Promptsなど複数の外部リソースを組み合わせてAI開発をしている方には、このプロキシ層が特に役立ちます。
---
よくある質問
Q1. cc-switchは無料ですか?料金はかかりますか?
<cite index="10-10,10-11">cc-switch自体は完全無料・オープンソース(MITライセンス)です。費用が発生するのはAPIキーを使って各プロバイダーに接続した際のAPI利用料のみで、これはcc-switchではなく各プロバイダーへの支払いになります。</cite>各プロバイダーの料金は公式サイトをご確認ください。
Q2. プロバイダーを切り替えたあと、ターミナルを再起動する必要はありますか?
<cite index="13-19,13-20,13-21,13-22">Claude Codeについては、ホットスイッチングが有効なため再起動は不要です。切り替えはすぐに反映され、現在のターミナルセッションを中断なく継続できます。</cite>ただし、<cite index="4-15,4-16">ツールによってはターミナルまたは該当CLIの再起動が必要な場合もあります。</cite>
Q3. 設定データはどこに保存されますか?クラウドに送られますか?
<cite index="13-23,13-24">ローカルデータベースは ~/.cc-switch/cc-switch.db、設定は ~/.cc-switch/settings.json に保存されます。</cite><cite index="25-4">APIキーを含むすべての設定データはユーザーのホームディレクトリにセキュアに保存されます。</cite>クラウド同期は任意機能であり、使用しない場合はデータはローカルにのみ保存されます。
Q4. ClineやAiderをすでに使っています。cc-switchに乗り換える必要がありますか?
乗り換えの必要はありません。<cite index="32-26,32-27">cc-switchと他のAIコーディングツール(Clineなど)は競合ではなく、役割が異なります。cc-switchはCLIツールがAPIキーや設定をどのように保存・切り替えるかを管理する設定管理層であり、Clineのようなコーディングエージェントツールはその上で動くものです。</cite>Clineを使いながら、Clineのプロバイダー設定をcc-switchで管理することも可能なケースがあります。
---
まとめ:次のアクション
<cite index="3-18,3-19">cc-switchの価値は「また新しいAIコーディングツールを作ること」ではなく、「AIコーディングのエコシステムが複数ツール共存の段階に入った現実を受け入れ、その分散した設定を1か所に集約すること」にあります。</cite>
今すぐできる3ステップ:
- チェックリストを見直す — 前述の6項目のうち3つ以上あてはまれば試す価値あり
- 公式サイトからダウンロード — ccswitch.io または GitHub(farion1231/cc-switch)
- まず1つのツールで試す — いきなり全ツールを設定しようとせず、最もよく使うCLIツール1つのプロバイダー管理から始める
<cite index="17-44,17-45">プロバイダーを切り替えるたびに設定ファイルを手で書き換えていたり、複数ツールにまたがってMCPの設定を別々に管理していたりするなら、インストールを試してみてください。セットアップに10分かかりますが、そのあとに取り除かれる手間は毎回のセッションで積み重なっていきます。</cite>
複数のAIツールを活用して開発効率を上げたい方は、System Prompts of AI ToolsでAIツールの使いこなし方も併せて学んでみてください。