CC Switch 導入 Claude Desktop チュートリアル：ローカルルーティングで OpenRouter と DeepSeek を切り替える
CC Switch を使って Claude Desktop のサードパーティー・プロバイダー設定を管理し、モデルマッピングとローカルルーティングで OpenRouter や DeepSeek など非 Claude 系モデルを接続する方法を解説します。
CC Switch v3.15.0 から、Claude Desktop が独立管理パネルに対応しました。これの核心価値は「もう一枚皮をかぶせる」ことではなく、Claude Desktop のサードパーティー推論設定、モデルマッピング、ローカルルーティングを1つのGUIパネルで一元管理し、設定の手動編集、エンドポイント入力、モデルID指定の手間を減らす点にあります。（CC Switch の基本的な用途と対応ツールがまだ分からない場合は、先に 「CC Switch とは？ AI コーディングツールとモデルプロバイダーを統合管理するコンソール」 を読むことをおすすめします。）
Claude Desktop 公式は、サードパーティー推論のエントリを既に提供しています。一般的な有効化手順は Help → Troubleshooting → Enable Developer Mode、その後 Developer → Configure third-party inference です。問題は、新規ユーザーには手動設定が分かりにくい点です。Gatewayアドレス、API Key、認証方式、モデル一覧などを埋める必要があり、どこか1項目でも間違えると接続失敗になりがちです。
CC Switch はこれらの手順を1つのツールに集約するためのものです。特に、Claude Desktop を OpenRouter や DeepSeek のような非 Claude 系モデルに接続したい場合、CC Switch の「モデルマッピング」と「ローカルルーティング」が非常に有効です。
一、これが解決する問題
Claude Desktop がサードパーティー・プロバイダーを使う際、主に2つの悩みがあります。
1. 設定入口が深い：開発者モードを有効にした後、サードパーティー推論設定ウィンドウへ移動する必要がある。 2. モデル名の互換性問題：Claude Desktop 側は通常、Claude の役割名（Sonnet、Opus、Haiku）でモデルを解釈しますが、サードパーティ側は独自のモデルID（例: inclusionai/ring-2.6-1t、deepseek-v4-pro、deepseek-v4-flash）を使います。
CC Switch はこの中間で変換レイヤーを持ちます。
Claude Desktop → CC Switch ローカルルーティング → サードパーティー・プロバイダーこの層は主に次の3つを担当します。
- Claude Desktop のリクエストをサードパーティーへ転送する
- Sonnet / Opus / Haiku といった Claude 側のモデル役割を実際のモデルIDにマッピングする
- Claude Desktop が必要とするサードパーティー推論設定を自動的に書き込む
二、いつモデルマッピングを有効化すべきか
判定はシンプルです。
| プロバイダー種別 | モデルマッピングが必要 | ローカルルーティングが必要 |
|---|---|---|
| Claude 系モデル（公式 Claude API、または Claude 系モデルのみを中継するサービス） | 通常不要 | 通常不要 |
| 非 Claude 系モデル（OpenRouter 上の Ring、DeepSeek V4 など） | 必要 | 必要 |
本文の2例とも非 Claude 系モデルなので、どちらも有効化します。
- 「モデルマッピング」オン
- 「ローカルルーティング」オン
非 Claude 系モデルを使う場合は、ローカルルーティングを起動し続ける必要があります。CC Switch を停止したり、ルーティングスイッチをオフにすると、Claude Desktop はサードパーティーモデルへの接続が切断されます。
三、準備
開始前に次の3点を準備します。
1. CC Switch v3.15.0 以上 公式サイト：https://ccswitch.io
2. Claude Desktop 公式ダウンロード：https://claude.ai/download
3. サードパーティー・プロバイダーのアカウントと API Key 以下から1つを選んで準備します。
- OpenRouter：https://openrouter.ai
- DeepSeek Platform：https://platform.deepseek.com
四、CC Switch のインストール／アップデート
既にCC Switchを入れている場合は、自動更新で対応できます。
初回インストールは以下を参考にします。
## macOS
brew tap farion1231/ccswitch
brew install --cask cc-switchWindows ユーザーは .msi インストーラーをダウンロードし、Linux ユーザーは配布形態に合わせて .deb、.rpm、.AppImage を選びます。
インストール完了後に CC Switch を起動します。App スイッチャーに独立した「Claude Desktop」項目が表示され、「Claude Code」と並列になっていれば、Claude Desktop 管理に対応した新バージョンです。
五、Claude Desktop パネルへ移動
CC Switch の左側または上部の App スイッチャーで選択します。
Claude Desktop選択後、「追加プロバイダー（Add Provider）」をクリックし、接続したいプラットフォームを選択して、API Key とリクエストURLを入力します。
以下に2つの一般的な設定例を示します。
六、設定例 A：OpenRouter + Ring 2.6 1T
OpenRouter は複数モデルへ単一エントリでアクセスできるモデル集約プラットフォームです。無料モデル、従量課金、エンタープライズプランを提供しており、モデル比較テストや一時的なプロバイダー切替に向いています。
1. OpenRouter API Key の作成
OpenRouter を開きます。
Keys ページで API Key を作成します。
2. CC Switch で OpenRouter を追加
「追加プロバイダー」で OpenRouter のプリセットを選び、以下を入力します。
| 項目 | 入力内容 |
|---|---|
| プロバイダー名 | OpenRouter |
| 公式サイト | https://openrouter.ai |
| API Key | OpenRouter Key を貼り付け |
| リクエストURL | https://openrouter.ai/api |
| API フォーマット | Anthropic Messages（ネイティブ） |
| モデルマッピングが必要 | 有効 |
注意：リクエストURLの末尾に / は付けないでください。
3. モデルマッピングの推奨設定
Ring 2.6 1T は Claude 系モデルではないため、Claude Desktop の役割を OpenRouter の実際のモデルIDにマッピングする必要があります。
以下の3行を追加します。
| モデル役割 | メニュー表示名 | 実際のリクエストモデル | 1M 対応を宣言 |
|---|---|---|---|
| Sonnet | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | 未選択 |
| Opus | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | 未選択 |
| Haiku | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | 未選択 |
これはつまり、Claude Desktop で Sonnet / Opus / Haiku を選んでも、最終的には OpenRouter 上の inclusionai/ring-2.6-1t がリクエストされることを意味します。
七、設定例 B：DeepSeek 公式 V4
DeepSeek の公式ドキュメントは Anthropic 互換インターフェースを提供しており、ベースURLは次のとおりです。
https://api.deepseek.com/anthropicつまり、一部の Anthropic API エコシステムツールに接続できます。DeepSeek ドキュメントでは Claude Code 向け環境変数例として、deepseek-v4-pro[1m]、deepseek-v4-flash などのモデル名も示されています。
1. DeepSeek API Key の作成
DeepSeek Platform を開きます。
API Keys ページで Key を作成します。DeepSeek は通常、先にチャージしてから API を呼び出す必要があります。
2. CC Switch で DeepSeek を追加
「追加プロバイダー」で DeepSeek のプリセットを選択し、以下を入力します。
| 項目 | 入力内容 |
|---|---|
| プロバイダー名 | DeepSeek |
| 公式サイト | https://platform.deepseek.com |
| API Key | DeepSeek Key を貼り付け |
| リクエストURL | https://api.deepseek.com/anthropic |
| API フォーマット | Anthropic Messages（ネイティブ） |
| モデルマッピングが必要 | 有効 |
注意：ここでは /anthropic を使用し、 /v1 ではありません。
3. モデルマッピングの推奨設定
「日常タスクは安価モデル、複雑なタスクは高性能モデル」という方針でマッピングできます。
| モデル役割 | メニュー表示名 | 実際のリクエストモデル | 1M 対応を宣言 |
|---|---|---|---|
| Sonnet | deepseek-v4-flash | deepseek-v4-flash | チェックあり |
| Opus | deepseek-v4-pro | deepseek-v4-pro | チェックあり |
| Haiku | deepseek-v4-flash | deepseek-v4-flash | 任意 |
これにより、Claude Desktop で Sonnet を選ぶと安価な deepseek-v4-flash が呼ばれ、Opus を選ぶと高性能な deepseek-v4-pro が呼ばれます。
DeepSeek ドキュメントの 1M 表記も使いたい場合は、実際のリクエストモデルで次を試せます。
deepseek-v4-pro[1m]利用可否は DeepSeek 公式ドキュメントおよび現行 CC Switch の実際のサポート範囲でご確認ください。
八、ローカルルーティングを有効化
モデルマッピングを設定したら、ローカルルーティングも有効化する必要があります。
経路は一般的に次のとおりです。
CC Switch → 設定 → ルーティング次の2項目を有効にしてください。
1. ルートスイッチ：オンにすると状態が「実行中」になります。 2. Claude アプリルート：Claude をチェックして、Claude Desktop のリクエストをローカルルートへ流します。
既定のサービスアドレスは次の通りです。
http://127.0.0.1:15721通常は変更不要です。
「ホーム画面にローカルルーティングスイッチを表示」を同時にオンにすると、メインパネルからルート稼働状態をすぐ確認できて便利です。
九、プロバイダーを有効化し Claude Desktop を再起動
設定が終わったら、Claude Desktop パネルで追加したプロバイダーを選択し、「有効化（Enable）」をクリックします。
その後、Claude Desktop を再起動します。
ここで重要なのは、ウィンドウを閉じるだけでなく、実際に終了することです。
- macOS：
Command + Qで完全終了 - Windows：タスクトレイの Claude アイコンを右クリックして終了
Claude Desktop を再起動したら、次のテスト文を送信します。
こんにちは、一文で返信してください。正常に返信が返れば、CC Switch に戻ってプロキシトラフィックログを確認してください。リクエスト記録が見えれば、経路は接続済みです。
十、よくある質問
1. 公式 Claude アカウントに戻したい場合は？
CC Switch の Claude Desktop パネルで現在のサードパーティープロバイダーを無効化するか、公式設定に戻して Claude Desktop を再起動します。
2. 複数プロバイダーを切り替えるには？
Claude Desktop パネルで別のプロバイダーを選択し、有効化してから再起動します。ローカルルーティングの再設定は不要です。
3. Claude Code も同じ方法で接続できますか？
できます。CC Switch は Claude Code と Claude Desktop を別パネルで管理します。違いは、Claude Code が主にコマンドライン開発向けで、Claude Desktop が日常会話、資料整理、デスクトップ利用に向く点です。
DeepSeek 公式ドキュメントでも Claude Code 向けに ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL といった環境変数設定例が示されています。
4. エラー時の切り分けはどうすればよい？
優先して次を確認します。
1. リクエストURLの末尾に不要な / が付いていないか 2. API Key が完全にコピーされているか 3. API フォーマットが Anthropic Messages に設定されているか 4. 「モデルマッピング」が有効になっているか 5. モデルマッピング内の実際のモデルIDが正しいか 6. ローカルルーティングの全体スイッチが実行中か 7. Claude アプリルートがチェックされているか 8. Claude Desktop が本当に終了して再起動されたか
接続失敗の多くは、API Key、エンドポイントアドレス、モデル ID、またはローカルルーティング未有効化のいずれかです。
5. CC Switch を常時起動しておく必要がありますか？
非 Claude 系モデルを使い、かつモデルマッピングに依存する場合、CC Switch は常駐している必要があります。
「軽量モード（Lightweight Mode）」を有効にすれば、メインウィンドウを閉じてもトレイ常駐のみで済み、ローカルルーティングは継続して動作します。
十一、どのように使い分けるべきか
推奨の使い分けは次のとおりです。
- 日常のライティング・ウェブコンテンツの推敲：OpenRouter のコストパフォーマンスが高いモデルを接続
- 中国語の長文処理、コード補助、複雑な推論：DeepSeek V4 Pro を試す
- 低コストでのテスト：安価モデルまたは無料モデルを優先
- 重要タスク：引き続き公式 Claude、OpenAI、または安定した有料モデルを選ぶ
サードパーティープロバイダーの利点は柔軟性と低コストですが、安定性、プライバシー、レイテンシ、モデル能力の差にも注意が必要です。すべての重要ワークフローを低価格の単一プロバイダーに固定せず、予備手段を持つのが安全です。
十二、まとめ
CC Switch v3.15.0 の意義は、Claude Desktop のサードパーティーモデル接続を「設定を手で埋める」作業から「GUIで切り替える」運用へ変えたことです。
全体のコアフローは、次の5ステップで要約できます。
CC Switch をインストール → Claude Desktop パネルに入る → プロバイダーを追加 → モデルマッピングを設定 → ローカルルーティングを有効化して Claude Desktop を再起動「モデルマッピング」と「ローカルルーティング」という2つの概念を理解すれば、OpenRouter や DeepSeek のような非 Claude 系モデルも、比較的スムーズに Claude Desktop に接続できます。
参考リンク
Share